Governance
VN Core hiện là bộ artifact trial-use do Omi HealthTech duy trì. Trang này mô tả cách dự án vận hành, cách tiếp nhận đóng góp chuyên môn và ranh giới giữa governance của IG với quy trình công nhận một tổ chức HL7 Affiliate.
Mọi bản nháp profile, extension và ValueSet đều được công bố tại nguồn kỹ thuật canonical của dự án trên 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ồ.
Mã và ràng buộc dẫn xuất từ danh mục Việt Nam phải trích văn bản nguồn. Thuật ngữ quốc tế, nội dung lâm sàng và quyết định kỹ thuật dùng nguồn chuẩn, bằng chứng chuyên môn hoặc design rationale phù hợp; không gắn căn cứ pháp lý giả tạo cho mọi code.
VN Core không tự tuyên bố thay thế XML 4210/3176. Mapping hoặc ConceptMap chỉ được công bố cho phạm vi đã mô hình hóa, có nguồn, trạng thái và kiểm thử; khả năng cùng tồn tại phụ thuộc hợp đồng tích hợp cụ thể.
Văn bản mới được triage theo hiệu lực, phạm vi và rủi ro tương thích. Legal patch có thể phát hành out-of-cycle sau review; dự án chưa công bố SLA thời gian cố định cho bản đánh giá hoặc release.
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. |
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 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
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. Thời gian phản hồi phụ thuộc mức tác động và năng lực review; chưa có SLA công khai được phê duyệt.
3
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
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.
VN Core đang ở v0.9.0, phát hành thành 8 package mô-đun:
7 gói chuyên biệt (core.base, pharmacy, bhyt.submission, patient-access, terminology.clinical,
terminology.traditional-medicine và device) cùng 1 gói tổng hợp core. Từ v0.9.0, hai trục có nhịp thay đổi
pháp lý nhanh được tách khỏi lõi theo ADR-0020: hl7.fhir.vn.pharmacy (đơn thuốc điện tử, cấp phát,
liên thông Cơ sở dữ liệu về dược) và hl7.fhir.vn.patient-access (Sổ sức khỏe điện tử VNeID,
khám sức khỏe định kỳ). Chuỗi phụ thuộc: core.base ← pharmacy ← patient-access,
và hl7.fhir.vn.bhyt.submission phụ thuộc hl7.fhir.vn.core.base;
đây không phải các gói độc lập về mô hình dữ liệu.
Quy ước phiên bản theo SemVer giai đoạn 0.x với ba loại thay đổi:
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.
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.
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)
Trạng thái HL7 Affiliate
Tên "HL7 Vietnam" trên site này là định danh dự án cộng đồng và không đại diện cho HL7 International hoặc một HL7 Affiliate. Việc xem xét hồ sơ Affiliate trong tương lai phải do một tổ chức hoặc liên minh các bên liên quan đủ điều kiện quyết định theo quy trình của HL7 International; dự án không mặc định Omi HealthTech là bên chủ trì.
VN Core được công bố mở theo CC-BY-4.0. Đây là trạng thái của tài liệu dự án; tư cách HL7 Affiliate áp dụng cho một tổ chức và là quy trình riêng với HL7 International.
Mở rộng Technical Steering, thu thập implementation report từ các đơn vị đủ điều kiện công bố hoặc review, và trao đổi với cộng đồng FHIR quốc tế. Các hoạt động này nâng chất lượng IG nhưng không tự tạo ra tư cách Affiliate.
Nếu các bên liên quan đủ điều kiện đạt đồng thuận, một tổ chức hoặc liên minh đại diện phù hợp có thể xem xét quy trình Affiliate của HL7 International. Dự án VN Core không chỉ định Omi HealthTech hay bất kỳ đơn vị nào làm bên chủ trì hồ sơ.
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à Implementation Guide trial-use của dự án, không phải một Affiliate và không được trình bày như ấn phẩm đã được HL7 International hay một HL7 Affiliate phê duyệt. 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 tổ chức HL7 Affiliate.
