{
  "schema_name": "kenh_xay_gold_reference_metadata",
  "schema_version": "1.0",
  "description": "Metadata contract cho ingest gold reference project mẫu Kênh xây xã Kiến Minh vào retrieval store của DSCons.",
  "project_defaults": {
    "project_code": "DS-HĐ26-004",
    "project_name": "Kênh Xây",
    "source_project_template": "kenh_xay_kien_minh",
    "source_project_role": "gold_reference_template",
    "template_code": "KX-KM-2026-TEMPLATE",
    "schema_version": "1.0",
    "is_gold_reference": true
  },
  "required_keys": [
    "project_code",
    "project_name",
    "source_project_template",
    "source_project_role",
    "template_code",
    "raw_path",
    "source_file",
    "source_filename",
    "source_format",
    "document_group",
    "document_type",
    "stage",
    "status",
    "version_role",
    "is_gold_reference",
    "gold_reference_role",
    "is_ingest_candidate",
    "requires_ocr",
    "used_for_tasks"
  ],
  "recommended_keys": [
    "id",
    "schema_version",
    "package_label",
    "package_code",
    "package_name",
    "task_type",
    "knowledge_type",
    "business_group",
    "doc_family",
    "title",
    "section_title",
    "folder_scope",
    "required_for",
    "evidence_role",
    "dependency_on",
    "related_docs",
    "decision_no",
    "issue_date",
    "effective_date",
    "payment_stage",
    "consulting_role",
    "retrieval_priority",
    "training_value",
    "confidence_note",
    "notes",
    "ingest_batch",
    "chunk_index"
  ],
  "allowed_values": {
    "document_group": [
      "project_overview",
      "technical_design_estimate",
      "legal_approvals",
      "construction_package",
      "consulting_packages",
      "execution_quality_payment",
      "system_noise"
    ],
    "document_type": [
      "danh_muc_ho_so",
      "ban_ve",
      "khoi_luong",
      "du_toan",
      "vat_tu_dinh_muc",
      "danh_sach_nha_thau",
      "quyet_dinh",
      "ke_hoach_lua_chon_nha_thau",
      "phe_duyet_ket_qua_lcnt",
      "don_nhan_thau",
      "bien_ban_thuong_thao",
      "hop_dong",
      "phap_ly",
      "mau_bieu_02a",
      "nghiem_thu",
      "de_nghi_thanh_toan",
      "phu_luc_thanh_toan",
      "nhat_ky",
      "ho_so_chat_luong",
      "quyet_toan",
      "bia_ho_so",
      "noise"
    ],
    "stage": [
      "overview",
      "design_estimate",
      "legal_setup",
      "procurement",
      "contracting",
      "execution",
      "acceptance",
      "payment",
      "settlement",
      "post_audit",
      "unknown"
    ],
    "status": [
      "available",
      "missing",
      "needs_verification",
      "needs_update",
      "excluded_noise"
    ],
    "version_role": [
      "effective",
      "draft",
      "duplicate",
      "template_form",
      "archival",
      "unknown"
    ],
    "gold_reference_role": [
      "required",
      "optional",
      "example",
      "exclude"
    ],
    "package_label": [
      "package_01_tcxd",
      "package_02_tvgs",
      "package_03_tvqlda",
      "package_04_kiem_toan_doc_lap",
      "package_design",
      "package_tham_tra",
      "package_project_wide",
      "package_unknown"
    ],
    "used_for_tasks": [
      "template_training",
      "inventory_mapping",
      "legal_timeline_check",
      "package_classification",
      "contract_review",
      "execution_guidance",
      "quality_check",
      "payment_check",
      "settlement_check",
      "audit_preparation",
      "missing_doc_detection",
      "retrieval_grounding"
    ],
    "task_type": [
      "legal_compliance",
      "project_planning",
      "procurement_tender",
      "contract_management",
      "technical_delivery",
      "payment_settlement",
      "audit_inspection"
    ],
    "knowledge_type": [
      "decision_document",
      "procurement_plan",
      "bidding_document",
      "bid_negotiation_record",
      "contract_document",
      "boq_norms_pricing",
      "technical_drawing",
      "construction_diary",
      "acceptance_record",
      "as_built_record",
      "payment_dossier",
      "interim_payment",
      "settlement_dossier",
      "template_form",
      "internal_process",
      "legal_normative"
    ]
  },
  "package_code_map": {
    "package_project_wide": "KX-KM-P00-ALL",
    "package_01_tcxd": "KX-KM-P01-TCXD",
    "package_02_tvgs": "KX-KM-P02-TVGS",
    "package_03_tvqlda": "KX-KM-P03-TVQLDA",
    "package_04_kiem_toan_doc_lap": "KX-KM-P04-KTDL",
    "package_design": "KX-KM-P05-TK",
    "package_tham_tra": "KX-KM-P06-TTR",
    "package_unknown": "KX-KM-P99-UNK"
  },
  "mapping_hints": {
    "document_group_to_business_group": {
      "project_overview": "project_planning",
      "technical_design_estimate": "technical_delivery",
      "legal_approvals": "legal",
      "construction_package": "contract_management",
      "consulting_packages": "contract_management",
      "execution_quality_payment": "acceptance",
      "system_noise": "system_noise"
    },
    "document_type_to_knowledge_type": {
      "danh_muc_ho_so": "template_form",
      "ban_ve": "technical_drawing",
      "khoi_luong": "boq_norms_pricing",
      "du_toan": "boq_norms_pricing",
      "vat_tu_dinh_muc": "boq_norms_pricing",
      "danh_sach_nha_thau": "bidding_document",
      "quyet_dinh": "decision_document",
      "ke_hoach_lua_chon_nha_thau": "procurement_plan",
      "phe_duyet_ket_qua_lcnt": "decision_document",
      "don_nhan_thau": "bidding_document",
      "bien_ban_thuong_thao": "bid_negotiation_record",
      "hop_dong": "contract_document",
      "phap_ly": "decision_document",
      "mau_bieu_02a": "template_form",
      "nghiem_thu": "acceptance_record",
      "de_nghi_thanh_toan": "payment_dossier",
      "phu_luc_thanh_toan": "interim_payment",
      "nhat_ky": "construction_diary",
      "ho_so_chat_luong": "acceptance_record",
      "quyet_toan": "settlement_dossier"
    }
  },
  "record_template": {
    "project_code": "DS-HĐ26-004",
    "project_name": "Kênh Xây",
    "source_project_template": "kenh_xay_kien_minh",
    "source_project_role": "gold_reference_template",
    "template_code": "KX-KM-2026-TEMPLATE",
    "schema_version": "1.0",
    "raw_path": "HĐ-2026/Phòng KT xã Kiến Minh-2026/Kênh xây/Gói TCXD/4. HD TCXD kenh xay.docx",
    "source_file": "HĐ-2026/Phòng KT xã Kiến Minh-2026/Kênh xây/Gói TCXD/4. HD TCXD kenh xay.docx",
    "source_filename": "4. HD TCXD kenh xay.docx",
    "source_format": "docx",
    "document_group": "construction_package",
    "document_type": "hop_dong",
    "business_group": "contract_management",
    "knowledge_type": "contract_document",
    "task_type": "contract_management",
    "stage": "contracting",
    "status": "available",
    "version_role": "effective",
    "is_gold_reference": true,
    "gold_reference_role": "required",
    "is_ingest_candidate": true,
    "requires_ocr": false,
    "package_label": "package_01_tcxd",
    "package_code": "KX-KM-P01-TCXD",
    "package_name": "Gói 01 - Thi công xây dựng",
    "used_for_tasks": [
      "template_training",
      "contract_review",
      "payment_check",
      "settlement_check",
      "retrieval_grounding"
    ],
    "required_for": [
      "contracting",
      "execution",
      "payment",
      "settlement"
    ],
    "doc_family": "contract",
    "evidence_role": "payment_basis",
    "retrieval_priority": 100,
    "training_value": "high",
    "confidence_note": "Phân loại chắc chắn theo tên file và vị trí thư mục.",
    "notes": "Anchor doc cho chuỗi thương thảo -> hợp đồng -> nghiệm thu -> thanh toán."
  },
  "chunk_overlay_template": {
    "id": "DS-HĐ26-004::hop_dong::4-hd-tcxd-kenh-xay::chunk-1",
    "section_title": "Hợp đồng thi công Kênh xây",
    "chunk_index": 1,
    "ingest_batch": "kenh_xay_gold_reference_v1"
  }
}