Mở trước, công bố trước, thảo luận sau
Mọi bản nháp profile, extension, ValueSet đều được công bố tại fhir.hl7.org.vn trước khi thảo luận rộng. Cộng đồng review bằng đối chiếu văn bản cụ thể thay vì mô tả mơ hồ.
Governance
Đóng góp mở trial-use, minh bạch trước khi chính thức hóa.
VN Core hiện là bộ artifact trial-use do Omi HealthTech duy trì. Trang này mô tả cách đội ngũ vận hành, cách tiếp nhận đóng góp chuyên môn, và lộ trình tiến tới tư cách HL7 Affiliate Việt Nam.
Nguyên tắc
Mỗi thay đổi có căn cứ pháp lý
Mọi code trong CodeSystem phải kèm tham chiếu QĐ/TT/NĐ/Luật. Mọi cardinality constraint phải có lý do trong narrative hoặc design rationale.
Không thay thế format đang dùng; bổ sung
VN Core không ép bệnh viện bỏ XML 4210/3176. Thay vào đó, bộ ConceptMap song song cho phép hai format cùng tồn tại cho đến khi thực tế sẵn sàng.
Phản ứng nhanh với pháp lý mới
Legal-patch release có thể phát hành out-of-cycle. Khi có VBPL mới, trong vòng 30 ngày cộng đồng sẽ có bản nháp đánh giá tác động.
Vai trò
Cấu trúc quản trị hiện tại gọn nhẹ. Khi Working Group mở rộng, vai trò sẽ được chính thức hóa theo quy trình bầu cử minh bạch.
| Vai trò | Đơn vị đảm nhận | Trách nhiệm |
|---|---|---|
| Maintainer | Omi HealthTech | Duy trì repo, tiếp nhận đề xuất kỹ thuật qua email, quyết định release, quản lý canonical URL và hạ tầng publish. |
| Technical Steering | Chờ thành lập Working Group | Review thiết kế profile, phê duyệt breaking change, đồng thuận về binding strength và conformance. |
| Legal Advisor | Chờ cộng tác với luật sư y tế/DPO | Rà soát phần bảo vệ DLCN (Luật 91/2025/QH15, NĐ 356/2025/NĐ-CP), chính sách Consent, quy định chuyển dữ liệu xuyên biên giới. |
| Contributors | Mở cho mọi cá nhân và tổ chức | Đóng góp bằng đề xuất kỹ thuật có căn cứ pháp lý/lâm sàng, ví dụ dữ liệu và báo cáo triển khai thực tế từ các CSKCB thí điểm. |
Cách đóng góp
Dự án nhận đóng góp từ mọi cá nhân, cơ sở y tế, doanh nghiệp phần mềm và cơ quan nhà nước. Quy trình đóng góp theo CONTRIBUTING với mẫu Issue (bug-report, profile-change, terminology-change) và Pull Request template; kho mã nguồn sẽ được công khai khi hoàn tất thủ tục phát hành. Hiện tại, gửi góp ý qua email [email protected] hoặc theo hướng dẫn tại trang Cộng đồng.
1
Gửi đề xuất kỹ thuật
Gửi email mô tả vấn đề hoặc đề xuất. Nếu liên quan đến pháp lý, cần trích dẫn văn bản cụ thể.
2
Thảo luận scope
Maintainer và cộng đồng xác nhận scope: bổ sung mới, điều chỉnh profile hiện có, hay chỉ sửa narrative. Mỗi loại có SLA phản hồi khác nhau.
3
Dự thảo thay đổi
Maintainer chuẩn bị hoặc hướng dẫn nhánh thay đổi, chạy SUSHI build và QA report trước khi review.
4
Review và release
Thay đổi được review, ghi nhận căn cứ và đưa vào release theo nhịp quý hoặc khi có legal-patch cần thiết.
Phiên bản, phát hành & phân lớp gói
VN Core đang ở v0.6.0, phát hành thành 6 package mô-đun (core.base, bhyt.submission, terminology.clinical, terminology.traditional-medicine, device và gói tổng hợp core). Quy ước phiên bản theo SemVer giai đoạn 0.x với ba loại thay đổi:
Patch (0.6.x)
Sửa lỗi narrative, ví dụ, chính tả, đồng bộ số liệu. Không đổi nghĩa artifact, không cần migration.
Additive (0.x.0)
Thêm profile/extension/ValueSet/CodeSystem mới hoặc nới ràng buộc. Tương thích ngược với bản trước.
Breaking (0.X.0 → 1.0.0)
Siết cardinality, đổi binding strength, đổi/loại canonical. Bắt buộc có migration note; mã đã ngừng dùng KHÔNG tái sử dụng cho nghĩa khác.
Tài liệu quản trị kỹ thuật (IG)
Lộ trình HL7 Affiliate
Chưa phải HL7 Affiliate — nhưng có kế hoạch rõ ràng.
Hiện tại tên "HL7 Vietnam" được dùng như tên dự án cộng đồng, không nhân danh HL7 International. Khi VN Core đạt v1.0.0, có đủ implementation report và governance đủ điều kiện, Omi HealthTech đặt mục tiêu chủ trì chuẩn bị hồ sơ HL7 Affiliate chính thức.
Hiện tại (2026) Đang áp dụng
Trial-use do Omi HealthTech duy trì
Công bố mở theo CC-BY-4.0. Chưa phải HL7 Affiliate. Dùng tên "HL7 Vietnam" ở mức dự án kỹ thuật, không nhân danh HL7 International.
Q3/2026 — Q2/2027 Đang chuẩn bị
Chuẩn bị pilot công bố và mở Working Group
Thành lập Technical Steering Committee đa bên. Bắt đầu thu thập implementation report từ các đơn vị đủ điều kiện công bố hoặc review. Kết nối với cộng đồng FHIR quốc tế (Asia-Pacific WG).
Q3/2027+ Kế hoạch
Chuẩn bị hồ sơ HL7 Affiliate Việt Nam
Khi VN Core đạt v1.0.0 và có đủ implementation report, Working Group có thể chuẩn bị hồ sơ xin tư cách HL7 Affiliate tại Việt Nam theo quy trình của HL7 International.
Tuyên bố thương hiệu
"HL7®", "FHIR®" và logo liên quan là nhãn hiệu của Health Level Seven International. VN Core là dự án cộng đồng độc lập, chưa được HL7 International ủy quyền là Affiliate chính thức của Việt Nam. Tên "HL7 Vietnam" trong tài liệu này phản ánh định danh dự án, không phải tư cách pháp nhân HL7 Affiliate.