Chuẩn hóa dữ liệu y tế Việt Nam theo HL7 FHIR
Data-first · Interoperable · Implementation-ready

HL7-org-vn là GitHub organization tập hợp các repository công khai phục vụ việc xây dựng, công bố và hoàn thiện dần hệ sinh thái chuẩn dữ liệu y tế Việt Nam dựa trên HL7 FHIR.

Trọng tâm hiện tại là VN Core FHIR Implementation Guide: một bộ lõi FHIR R4 được thiết kế cho bối cảnh Việt Nam, với định hướng:

• lấy dữ liệu làm trung tâm
• tăng khả năng liên thông giữa HIS, EMR, HSSK, gateway và các nền tảng tích hợp
• hỗ trợ các luồng triển khai thực tế như VNeID, EMR/HSSK, LGSP/API facade, BHYT submission
• giữ ranh giới rõ giữa lõi FHIR-native và các lớp tích hợp nghiệp vụ đặc thù

Đây không chỉ là nơi lưu mã nguồn của một website hay một bộ profile riêng lẻ. Organization này tập hợp các thành phần cần thiết để một chuẩn dữ liệu có thể:

• được biên soạn và xuất bản
• được kiểm chứng và rà soát
• được triển khai thí điểm
• và trưởng thành dần thành nền tảng liên thông y tế quy mô rộng hơn

Organization này phản ánh một cách tiếp cận thực dụng:

1. Không dừng ở đặc tả
   Chuẩn dữ liệu chỉ có giá trị khi đi được vào build, validate, review và pilot.

2. Không gom mọi thứ vào một gói duy nhất
   Lõi dữ liệu, thuật ngữ, template xuất bản và các lớp tích hợp đặc thù cần được tách ranh giới rõ ràng.

3. Không tách kỹ thuật khỏi pháp lý và vận hành
   Thiết kế dữ liệu y tế tại Việt Nam chịu ảnh hưởng trực tiếp từ định danh công dân, địa giới hành chính, bệnh án điện tử, bảo vệ dữ liệu cá nhân, BHYT và an ninh hệ thống.

4. Không xem chuẩn hóa là việc của riêng một đơn vị
   Các tài sản công khai tại đây được tổ chức theo hướng mở, để cộng đồng Y tế số Việt Nam có thể theo dõi, phản biện và đóng góp.

• Core FHIR profiles cho các tài nguyên nền tảng của Việt Nam
• Terminology & bindings cho ICD-10 VN, SNOMED CT VN, CLS VN và các danh mục dùng chung
• NamingSystem & identifier governance cho CCCD, BHYT, BHXH, mã cơ sở, mã nghiệp vụ
• Implementation guidance cho Unicode, tìm kiếm, Must Support, conformance và governance
• Publication tooling cho website, template package, CI/CD và public build
• Boundary design giữa VN Core Base, thuật ngữ, YHCT và BHYT Submission

• Website giới thiệu: hl7.org.vn
• Bộ đặc tả kỹ thuật: fhir.hl7.org.vn
• Template package dùng chung: hl7.fhir.vn.template

Các repository trong organization này được giữ tách vai trò để dễ bảo trì và dễ công bố:

• vncore-ig: mã nguồn của bộ Implementation Guide công khai
• vn-ig-template: template package dùng chung cho các IG của HL7 Vietnam
• các repository nguồn dữ liệu, phân tích hoặc tooling được tách riêng khi cần để giữ build public gọn và tái lập được

VN Core FHIR IG hiện ở giai đoạn trial-use / public draft, được xây dựng để đi chậm nhưng chắc:

• ưu tiên đúng mô hình dữ liệu trước
• công bố rõ boundary kiến trúc
• hấp thụ thay đổi pháp lý liên tục
• mở đường cho thí điểm thay vì ép chín giả tạo

VN Core hiện được Omi HealthTech khởi xướng và duy trì ở giai đoạn đầu, với mục tiêu đóng góp các tài sản công khai có thể tái sử dụng cho cộng đồng Y tế số Việt Nam và tạo nền tảng FHIR có thể áp dụng trong triển khai thật.

Nếu bạn là:

• cơ quan quản lý hoặc đơn vị điều phối
• bệnh viện, cơ sở khám chữa bệnh hoặc đơn vị triển khai
• đội ngũ HIS, EMR, LIS, RIS, PACS, HSSK, cổng tích hợp
• thành viên cộng đồng HL7/FHIR, dữ liệu y tế, terminology hoặc interoperability

thì phản biện, issue, pull request và góp ý triển khai thực tế đều có giá trị lớn đối với dự án.

Liên hệ:

• Email: info@hl7.org.vn
• Website: https://hl7.org.vn

HL7-org-vn is the GitHub organization for public repositories that support healthcare data standardization in Vietnam using HL7 FHIR.

Its current focus is the VN Core FHIR Implementation Guide: a practical FHIR R4 foundation for Vietnam, shaped by real implementation needs such as citizen identity, VNeID, EMR/HSSK, LGSP/API integration, BHYT interoperability, terminology governance, privacy, and system security.

The current work is still in an open trial-use stage. VN Core was initially started and is currently maintained by Omi HealthTech, with the goal of contributing reusable public assets to the broader Vietnam digital health community.