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
Dự án cộng đồng mở, minh bạch trước khi chính thức hóa.
VN Core hiện là dự án cộng đồng do Omi HealthTech (OmiGroup) duy trì. Trang này mô tả cách đội ngũ duy trì, cộng đồng đóng góp, 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 cộng đồng 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 (OmiGroup) | Duy trì repo, review và merge PR, 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, NĐ 356/2025), 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 qua GitHub Issues, Pull Request, hoặc 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. Repo công khai trên GitHub sau khi phát hành v0.5.0; trong thời gian chờ, mọi góp ý gửi qua email [email protected].
1
Mở issue hoặc discussion
Trước khi code, mở issue 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
Pull Request
Fork repo, tạo branch, commit theo Conventional Commits. PR phải chạy qua CI (SUSHI build, QA report) và được ít nhất 1 maintainer phê duyệt.
4
Merge và release
Sau merge vào main, thay đổi vào build CI. Phát hành chính thức diễn ra theo nhịp quý hoặc khi có legal-patch cần thiết.
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 và có đủ implementation report, Omi HealthTech sẽ chủ trì nộp hồ sơ HL7 Affiliate chính thức.
Hiện tại (2026) Đang áp dụng
Dự án cộng đồng do Omi 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 cộng đồng, không nhân danh HL7 International.
Q3/2026 — Q2/2027 Đang chuẩn bị
Thí điểm ≥5 CSKCB và mở Working Group
Thành lập Technical Steering Committee đa bên. Bắt đầu thu thập implementation report. Kết nối với cộng đồng FHIR quốc tế (Asia-Pacific WG).
Q3/2027+ Kế hoạch
Nộp hồ sơ HL7 Affiliate Việt Nam
Khi VN Core đạt v1.0.0 và có đủ implementation report, nộp hồ sơ xin tư cách HL7 Affiliate tại Việt Nam. Từ thời điểm này, tên "HL7 Vietnam" chính thức thay vì dự án cộng đồng.
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.