_schema.json — Dữ Liệu Kỹ Thuật

📁 Đường dẫn tệp gốc: ../knowledge-base/faq/_schema.json
📥 Tải tệp gốc xuống

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "FAQItem",
  "description": "Schema cho Ngân hàng Câu hỏi thường gặp (FAQ Bank)",
  "type": "object",
  "required": [
    "id",
    "topic",
    "question_variations",
    "short_answer",
    "detailed_explanation",
    "safety_level",
    "source_ids"
  ],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^FAQ-[A-Z0-9]+-[0-9]{3}$",
      "description": "Mã định danh câu hỏi, ví dụ: FAQ-OA-001"
    },
    "topic": {
      "type": "string",
      "description": "Chủ đề bệnh lý hoặc vấn đề (knee-oa, low-back-pain, general,...)"
    },
    "question_variations": {
      "type": "array",
      "items": { "type": "string" },
      "minItems": 1,
      "description": "Các cách diễn đạt khác nhau của câu hỏi từ người dùng"
    },
    "short_answer": {
      "type": "string",
      "description": "Câu trả lời ngắn gọn (1-2 câu, phù hợp đọc qua voice hoặc màn hình nhỏ)"
    },
    "detailed_explanation": {
      "type": "string",
      "description": "Giải thích chi tiết kèm hướng dẫn thực hành an toàn"
    },
    "safety_level": {
      "type": "string",
      "enum": ["GREEN", "AMBER", "RED"],
      "description": "Phân loại rủi ro của tình huống câu hỏi"
    },
    "red_flag_alert": {
      "type": "string",
      "description": "Cảnh báo cờ đỏ bắt buộc kèm theo nếu có dấu hiệu rủi ro"
    },
    "source_ids": {
      "type": "array",
      "items": { "type": "string" },
      "description": "Danh sách mã nguồn dẫn chứng từ source_registry"
    },
    "gold_standard_review": {
      "type": "object",
      "properties": {
        "reviewed_by": { "type": "string" },
        "date": { "type": "string", "format": "date" },
        "is_approved": { "type": "boolean" }
      }
    }
  }
}