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

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

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "KnowledgeCard",
  "description": "Schema cho Thẻ Tri Thức Y Khoa Cơ Xương Khớp có cấu trúc",
  "type": "object",
  "required": [
    "id",
    "condition",
    "topic",
    "population",
    "clinical_statement",
    "evidence_source",
    "when_to_refer",
    "review_status"
  ],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^KC-[A-Z0-9]+-[0-9]{3}$",
      "description": "Mã định danh thẻ tri thức, ví dụ: KC-OA-001"
    },
    "condition": {
      "type": "string",
      "description": "Tên bệnh lý hoặc hội chứng cơ xương khớp (ví dụ: Knee Osteoarthritis)"
    },
    "topic": {
      "type": "string",
      "description": "Chủ đề can thiệp (ví dụ: Therapeutic exercise, Pain management, Self-care)"
    },
    "population": {
      "type": "string",
      "description": "Nhóm đối tượng áp dụng (ví dụ: Older adults >= 60 tuổi)"
    },
    "clinical_statement": {
      "type": "string",
      "description": "Phát biểu y khoa cốt lõi dựa trên bằng chứng lâm sàng"
    },
    "evidence_source": {
      "type": "string",
      "description": "Mã nguồn tham khảo trong source_registry (ví dụ: SRC-NICE-NG226, SRC-BYT-QD361)"
    },
    "evidence_level": {
      "type": "string",
      "enum": ["A", "B", "C", "D", "E"],
      "description": "Phân tầng bằng chứng từ A (RCT/Systematic review) đến E (Ý kiến chuyên gia)"
    },
    "evidence_date": {
      "type": "string",
      "description": "Năm xuất bản hoặc cập nhật của hướng dẫn"
    },
    "contraindications": {
      "type": "array",
      "items": { "type": "string" },
      "description": "Chống chỉ định hoặc các trường hợp loại trừ"
    },
    "red_flags": {
      "type": "array",
      "items": { "type": "string" },
      "description": "Dấu hiệu cảnh báo nguy hiểm đi kèm chủ đề"
    },
    "patient_friendly_explanation": {
      "type": "string",
      "description": "Giải thích bằng ngôn ngữ dễ hiểu, thân thiện cho người cao tuổi"
    },
    "questions_to_ask": {
      "type": "array",
      "items": { "type": "string" },
      "description": "Các câu hỏi AI cần hỏi làm rõ tình trạng người bệnh trước khi tư vấn"
    },
    "when_to_refer": {
      "type": "string",
      "description": "Tiêu chí chỉ định người bệnh cần đến cơ sở y tế thăm khám"
    },
    "reviewed_by": {
      "type": "string",
      "description": "Bác sĩ hoặc chuyên gia thẩm định nội dung"
    },
    "review_date": {
      "type": "string",
      "format": "date",
      "description": "Ngày thẩm định chuyên môn"
    },
    "review_status": {
      "type": "string",
      "enum": ["draft", "peer_reviewed", "approved", "deprecated"],
      "default": "draft",
      "description": "Trạng thái phê duyệt tri thức"
    }
  }
}