HL7 Vietnam VN Core FHIR Implementation Guide

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.6.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.6.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ó gói 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 vai trò ở mức tóm tắt

Vai trò Gói tối thiểu Capability / điểm vào 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ủ Ranh giới gói, vòng đời artifact, quản trị phát hành
HIS, EMR, FHIR server nội bộ hl7.fhir.vn.core.base VNCoreServer, VNCoreEMRServer Trao đổi FHIR-native, tìm kiếm, kiểm tra hợp lệ, Must Support
Client gửi hồ sơ thanh toán BHYT hl7.fhir.vn.core.base + hl7.fhir.vn.bhyt.submission VNBHYTGatewayClient Bundle, operation, ánh xạ 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, kiểm toán và ghi log
Ứng dụng người dân / cổng bệnh nhân hl7.fhir.vn.core.base VNCitizenAppClient Scope đọc tối thiểu, consent, kiểm toán, provenance
LIS / hệ thống xét nghiệm hl7.fhir.vn.core.base Capability profile cục bộ của LIS Specimen, DiagnosticReportLab, ObservationLab
RIS/PACS / hệ thống CĐHA hl7.fhir.vn.core.base Capability profile cục bộ của RIS ImagingStudy, DiagnosticReportImaging, DICOM siêu dữ liệu
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, người rà soát cộng đồng, nhóm độ trưởng thành Toàn bộ bản phát hành trong phạm vi đánh giá Tập lệnh kiểm tra hợp lệ, báo cáo triển khai Kiểm tra lặp lại được, chất lượng phát hành, mức sẵn sàng thí điểm

Vai trò 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õ vai trò nào tiêu thụ gói nào; không để logic hướng đến bên thanh toán quay lại thay đổi ngữ nghĩa lõi FHIR.
  • Có chính sách hiện hành / lịch sử / ngừng dùng cho định danh và thuật ngữ.
  • Xác định bản phát hành nào đủ điều kiện thí điểm và bản phát hành nào chỉ rà soát nội bộ.

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

  • Ma trận vai trò/gói cho hệ thống triển khai, chính sách canonical URL/versioning, và ngưỡng phát hành theo Phát hành và quản trị.

Vai trò 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 Kiểm tra hợp lệ

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.

Vai trò 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 Kiểm tra hợp lệ

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 xuất dữ liệu/cổng 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ụ ánh xạ 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 siêu dữ liệu 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

  • Qua validate-bhyt-submission.sh và validate-bhyt-roundtrip.sh; có bộ dữ liệu kiểm thử dương tính/âm tính.

Vai trò 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 chính sách gửi hồ sơ; 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à kiểm tra hợp lệ 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 siêu dữ liệu 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ó ghi log, kiểm toán và truy vết đầy đủ; có giới hạn trách nhiệm rõ giữa gateway và hệ thống nguồn.

Vai trò 5: LIS / hệ thống xét nghiệm

LIS — Tài liệu

hl7.fhir.vn.core.base VNCoreSpecimen VNCoreObservationLab VNCoreDiagnosticReportLab Kiểm tra hợp lệ

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

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

  • Có bộ dữ liệu kiểm thử order/result đi qua ServiceRequest → Specimen → ObservationLab → DiagnosticReportLab, qua kiểm tra hợp lệ và giữ được mã xét nghiệm LOINC/CLS theo chính sách thuật ngữ.

Vai trò 6: RIS/PACS / hệ thống CĐHA

RIS/PACS — Tài liệu

hl7.fhir.vn.core.base VNCoreImagingStudy VNCoreDiagnosticReportImaging Clinical Scenarios Kiểm tra hợp lệ

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ó bộ dữ liệu kiểm thử 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ả.

Vai trò 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.

Vai trò 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.

Vai trò 9: QA, người rà soát cộng đồng, nhóm độ trưởng thành

QA — Tài liệu

Ổn định và tuân thủ Kiểm tra hợp lệ Phát hành và quản trị

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

  • Checklist lặp lại được cho từng vai trò; phân biệt lỗi nội dung / gói / hướng dẫn / môi trường.

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

  • Tập lệnh 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 báo cáo triển khai; có ghi chú phát hành giải thích thay đổi phá vỡ tương thích.

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 vai trò 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 gói nào tương ứng với từng vai trò 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 phần tử Hướng dẫn Must Support
Biết cách kiểm tra hệ thống trước thí điểm 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.