HL7 Vietnam VN Core FHIR Implementation Guide

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.5.0 - Draft for Community Review Viet Nam cờ

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Draft for Community Review (v0.5.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Tuân thủ theo vai trò triển khai

Tuân thủ theo vai trò triển khai — Conformance by Actor

Mỗi vai trò triển khai có package tối thiểu, CapabilityStatement, ngưỡng kỹ thuật và dấu hiệu sẵn sàng riêng.

Nếu cần lớp tự kiểm tra ngắn hơn, xem Checklist sẵn sàng thí điểm theo vai trò.

Quy tắc đọc trang này

  • Profile không đủ để chứng minh tuân thủ nếu thiếu CapabilityStatement, examples, search behavior và kiểm tra thực thi được.
  • Một actor chỉ nên cam kết những gì đúng với phạm vi của mình; không phải mọi hệ thống đều phải hỗ trợ toàn bộ IG.

Ma trận actor ở mức tóm tắt

Actor Package tối thiểu Capability / entry point Trọng tâm đánh giá
Kiến trúc tiêu chuẩn, quản trị dữ liệu hl7.fhir.vn.core Kiến trúc gói phát hành, Ổn định và tuân thủ Boundary, vòng đời artifact, release governance
HIS, EMR, FHIR server nội bộ hl7.fhir.vn.core.base VNCoreServer, VNCoreEMRServer FHIR-native exchange, search, validation, Must Support
Client gửi hồ sơ thanh toán BHYT hl7.fhir.vn.core.base + hl7.fhir.vn.bhyt.submission VNBHYTGatewayClient Bundle, operation, mapping hồ sơ thanh toán
Server tiếp nhận hồ sơ BHYT / facade tích hợp hl7.fhir.vn.bhyt.submission VNBHYTGatewayServer Kiểm tra bundle, phản hồi lỗi, audit và logging
Ứng dụng người dân / cổng bệnh nhân hl7.fhir.vn.core.base VNCitizenAppClient Minimal read scope, consent, audit, provenance
LIS / hệ thống xét nghiệm hl7.fhir.vn.core.base Local LIS capability profile Specimen, DiagnosticReportLab, ObservationLab
RIS/PACS / hệ thống CĐHA hl7.fhir.vn.core.base Local RIS capability profile ImagingStudy, DiagnosticReportImaging, DICOM metadata
Terminology, định danh, dữ liệu chủ hl7.fhir.vn.core.base Danh mục định danh, Hướng dẫn thuật ngữ NamingSystem, CodeSystem, ValueSet, provenance
QA, reviewer cộng đồng, nhóm maturity Toàn bộ release trong phạm vi đánh giá Validation scripts, implementation reports Repeatable checks, release quality, pilot readiness

Actor 1: Kiến trúc tiêu chuẩn, quản trị dữ liệu

Kiến trúc — Tài liệu

Trang chủ Kiến trúc gói phát hành Ổn định và tuân thủ Phát hành và quản trị Danh mục định danh Hướng dẫn thuật ngữ

Kiến trúc — Ngưỡng tối thiểu

  • Chốt rõ actor nào tiêu thụ package nào; không để logic payer-facing quay lại thay đổi semantic lõi FHIR.
  • Có policy hiện hành / lịch sử / ngừng dùng cho định danh và thuật ngữ.
  • Xác định release nào đủ điều kiện pilot và release nào chỉ review nội bộ.

Kiến trúc — Bằng chứng sẵn sàng

  • Ma trận actor/package cho hệ thống triển khai, policy canonical URL/versioning, và release threshold theo Phát hành và quản trị.

Actor 2: HIS, EMR và FHIR server nội bộ

HIS/EMR — Tài liệu

hl7.fhir.vn.core.base VNCoreServer / VNCoreEMRServer Bắt đầu nhanh Hướng dẫn chung Must Support Tìm kiếm Validation

HIS/EMR — Ngưỡng tối thiểu

HIS/EMR — Bằng chứng sẵn sàng

  • Examples pass ./scripts/validate.sh và validate-tier2.sh; có CapabilityStatement nội bộ đối chiếu với VNCoreServer/VNCoreEMRServer.

Actor 3: Client gửi hồ sơ thanh toán BHYT

Client BHYT — Tài liệu

hl7.fhir.vn.core.base + hl7.fhir.vn.bhyt.submission VNBHYTGatewayClient Liên thông BHYT Danh mục định danh Validation

Client BHYT — Ngưỡng tối thiểu

  • Sinh đúng VNCoreBHYTSubmissionBundle; nhất quán giữa Coverage, Claim, Encounter, Patient.
  • Không đẩy ngược logic export/gateway vào profile lõi.
  • SHALL hỗ trợ VNCoreMedicationDispense khi hồ sơ có dữ liệu cấp phát thuốc phục vụ mapping MA_THUOC, SO_DANG_KY, NGAY_CAP trong chuỗi XML thuốc/DVKT.
  • MAY gửi/nhận VNCoreImagingStudy khi cần bổ sung metadata CĐHA cho XML4 hoặc đối soát chi phí nhóm CĐHA.

Client BHYT — Bằng chứng sẵn sàng

  • Pass validate-bhyt-submission.sh và validate-bhyt-roundtrip.sh; có bộ positive/negative fixtures.

Actor 4: Server tiếp nhận hồ sơ BHYT / facade tích hợp

Server BHYT — Tài liệu

hl7.fhir.vn.bhyt.submission VNBHYTGatewayServer Liên thông BHYT Kiến trúc gói Bảo mật

Server BHYT — Ngưỡng tối thiểu

  • Kiểm tra bundle theo policy submission; phân biệt lỗi cú pháp / ngữ nghĩa / nghiệp vụ.
  • Ghi AuditEvent và Provenance phù hợp vai trò gateway.
  • SHALL chấp nhận và validate VNCoreMedicationDispense khi bundle khai báo dữ liệu cấp phát thuốc.
  • MAY chấp nhận VNCoreImagingStudy nếu gateway hoặc facade hỗ trợ đối soát CĐHA giàu metadata hơn DiagnosticReport đơn lẻ.

Server BHYT — Bằng chứng sẵn sàng

  • Operation có đầu vào/đầu ra/mã lỗi kiểm thử được; có logging, audit, tracing đủ truy vết; có giới hạn trách nhiệm rõ giữa gateway và hệ thống nguồn.

Actor 5: LIS / hệ thống xét nghiệm

LIS — Tài liệu

hl7.fhir.vn.core.base VNCoreSpecimen VNCoreObservationLab VNCoreDiagnosticReportLab Validation

LIS — Ngưỡng tối thiểu

LIS — Bằng chứng sẵn sàng

  • Có fixtures order/result đi qua ServiceRequest → Specimen → ObservationLab → DiagnosticReportLab, pass validation và giữ được mã xét nghiệm LOINC/CLS theo policy terminology.

Actor 6: RIS/PACS / hệ thống CĐHA

RIS/PACS — Tài liệu

hl7.fhir.vn.core.base VNCoreImagingStudy VNCoreDiagnosticReportImaging Clinical Scenarios Validation

RIS/PACS — Ngưỡng tối thiểu

  • SHALL hỗ trợ VNCoreImagingStudy cho DICOM StudyInstanceUID, accession, modality và thông tin thực hiện chụp.
  • SHALL hỗ trợ VNCoreDiagnosticReportImaging cho báo cáo đọc phim, resultsInterpreter, imagingStudy reference và presentedForm.

RIS/PACS — Bằng chứng sẵn sàng

  • Có fixtures CĐHA chứng minh ServiceRequest → ImagingStudy → DiagnosticReportImaging, bao gồm ít nhất một modality CT hoặc US và PDF kết quả.

Actor 7: Ứng dụng người dân, cổng bệnh nhân, tích hợp VNeID

Citizen App — Tài liệu

hl7.fhir.vn.core.base VNCitizenAppClient Bảo mật Hướng dẫn chung Hồ sơ

Citizen App — Ngưỡng tối thiểu

  • Chỉ truy cập đúng tập dữ liệu đã công bố; tách quyền người dùng cuối / tài khoản dịch vụ / break-glass.
  • Không mô tả VNeID như patient identifier lõi song song với CCCD.

Citizen App — Bằng chứng sẵn sàng

  • Ma trận quyền truy cập tối thiểu; luồng chứng minh Consent, AuditEvent, Provenance hoạt động đúng.

Actor 8: Terminology, định danh và dữ liệu chủ

Terminology — Tài liệu

Danh mục định danh Hướng dẫn thuật ngữ Thuật ngữ Phát hành và quản trị

Terminology — Ngưỡng tối thiểu

  • Duy trì trạng thái hiện hành / lịch sử / ngừng dùng nhất quán; ghi rõ provenance và căn cứ pháp lý khi thay đổi.
  • Ưu tiên LOINC, SNOMED CT, ICD trước khi tạo mã địa phương mới.

Terminology — Bằng chứng sẵn sàng

  • Registry nhất quán cho NamingSystem/CodeSystem/ValueSet; có snapshot khác biệt trước mỗi đợt cập nhật.

Actor 9: QA, reviewer cộng đồng, nhóm maturity

QA — Tài liệu

Ổn định và tuân thủ Validation Phát hành và quản trị

QA — Ngưỡng tối thiểu

  • Checklist lặp lại được cho từng actor; phân biệt lỗi nội dung / package / guidance / môi trường.

QA — Bằng chứng sẵn sàng

  • Script kiểm tra mức cơ sở xanh trên bản phát hành mục tiêu; có ít nhất một implementation report; có release note giải thích breaking changes.

Nếu một hệ thống đóng nhiều vai trò

Nhiều hệ thống ở Việt Nam vừa là EMR server, vừa là client BHYT, đôi khi kiêm cổng bệnh nhân. Khuyến nghị:

  • Không dùng một CapabilityStatement duy nhất cho mọi vai trò.
  • Không trộn ràng buộc BHYT Submission vào profile lõi nếu chúng chỉ đúng cho một luồng.
  • Tách đánh giá theo actor trước, sau đó mới lập ma trận tích hợp tổng thể.

Liên hệ với các trang khác

Nếu cần Nên đọc tiếp
Biết package nào tương ứng với từng actor Kiến trúc gói phát hành
Tự kiểm tra nhanh mức sẵn sàng thí điểm Checklist sẵn sàng thí điểm theo vai trò
Biết cách diễn giải nghĩa vụ đọc/ghi ở cấp element Hướng dẫn Must Support
Biết cách kiểm tra hệ thống trước pilot Hướng dẫn kiểm tra hợp lệ

English Summary

This page organizes VN Core conformance by implementation actor. For each actor, it states the minimum package scope, the relevant CapabilityStatement or registry, the minimum obligations that must be supported, and the evidence that should exist before the actor is considered pilot-ready. The page is intended to prevent implementers from inferring conformance from profiles alone.