v0.1.0 03/2026 Hoàn thành
Dự thảo cộng đồng khởi điểm
Nền tảng ban đầu cho Profiles, Extensions, bộ mã và ví dụ dữ liệu.
Lộ trình
Sản phẩm bám sát pháp lý, pháp lý định hình sản phẩm.
Mỗi phiên bản VN Core ra đời gắn với một đợt thay đổi pháp lý. Trang này tổng hợp toàn bộ cột mốc sản phẩm, các VBPL chi phối thiết kế, và quy tắc phát hành để các đội triển khai có thể lập kế hoạch đồng bộ.
Lộ trình sản phẩm
v0.2.0 03/2026 Hoàn thành
Rà soát nội bộ
Củng cố quy tắc tuân thủ, cách công bố và chuẩn bị trước khi công bố rộng rãi.
v0.3.0 03/2026 Hoàn thành
Wave 1 — Bản công bố công khai
Công bố công khai đầu tiên: nhân khẩu học, BHYT Submission, thuật ngữ nền tảng và các kịch bản ngoại trú.
v0.4.0 04/2026 Hoàn thành
Wave 2 — Mở rộng CĐHA, Dược, Thiết bị, Khoa phòng
Bổ sung 6 profiles mới và cập nhật căn cứ pháp lý 2025-2026.
v0.5.1 05/2026 Hiện hành
Sẵn sàng QĐ 697 + structured legal reference
Bảng kê chi phí 12 nhóm theo QĐ 697/QĐ-BYT (deadline 01/07/2026), VNLegalDocumentRefCS 101 văn bản, device cluster hardening (registration number, class A/B/C/D), audit tooling và future-effective marker.
v0.6.0 Q3/2026 Kế tiếp
Consent + AuditEvent + nội trú/chuyển tuyến
Hardening Consent + AuditEvent theo Luật 91/2025 (BVDLCN) và NĐ 356/2025; mở rộng kịch bản nội trú, chuyển tuyến, cấp cứu; YHCT mapping (QĐ 2552 + QĐ 3080) đầy đủ; ePrescription workflow theo TT 26/2025.
v0.7.0 Q1/2027 Dự kiến
Phủ EMR toàn quốc & SNOMED Đợt 3
Bám deadline TT 13/2025 (100% CSKCB EMR trước 31/12/2026; ngừng bệnh án giấy 01/01/2027); SNOMED CT VN Đợt 3 (QĐ 2805 Allergy + Finding); secondary-use data access và FHIR Bulk Data ($export); SMART-on-FHIR App Launch guidance.
v0.8.0 Q2/2027 Dự kiến
Bảo trì theo phản hồi thí điểm
Điều chỉnh theo phản hồi thực tế từ ≥5 CSKCB thí điểm, các đợt cập nhật pháp lý và nhu cầu vận hành phát sinh; AI-ready data, de-identification và provenance guardrails.
v1.0.0 Mục tiêu Q3/2027 Dự kiến
STU1 — Phiên bản ổn định, sẵn sàng HL7 Affiliate
Implementation reports từ ≥5 pilot sites, conformance testing đầy đủ, ConceptMap XML đầu ra KCB (QĐ 3176/QĐ-BYT, 12 loại XML1-XML12) ↔ FHIR hoàn chỉnh; nền tảng kỹ thuật cho hồ sơ HL7 Affiliate Việt Nam; sẵn sàng adoption rộng rãi.
Pháp lý chi phối thiết kế
07/2024 TT 17/2024/TT-BCA
Căn cứ cho số định danh cá nhân/CCCD và quy tắc validation định danh công dân.
Ảnh hưởng: Identifier slicing trong VNCorePatient.
10/2024 TT 23/2024/TT-BYT
Danh mục kỹ thuật hiện hành thay TT 43/2013 — định hình lại phân loại dịch vụ kỹ thuật.
Ảnh hưởng: CodeSystem DVKT, ValueSet dịch vụ.
12/2024 QĐ 4152/QĐ-BYT
Kiến trúc số Bộ Y tế chuyển sang khung 3.0, nhấn mạnh dữ liệu dùng chung.
Ảnh hưởng: Định hướng architecture của VN Core.
06/2025 QĐ 2010/QĐ-BYT
54 mã khoa/phòng dùng chung — nền tảng cho VNCoreOrganizationDepartment.
Ảnh hưởng: CodeSystem vn-department-cs.
07/2025 NQ 202/2025 + TT 13/2025 + NĐ 163/2025
Mô hình 34 tỉnh, bệnh án điện tử bắt buộc, NĐ 163/2025 thay NĐ 54/2017 Luật Dược.
Ảnh hưởng: CodeSystem ĐVHC 2 cấp, DocumentReference EMR, Medication profiles.
07-08/2025 QĐ 2427 + QĐ 2493/QĐ-BYT
SNOMED CT Việt Nam Đợt 1 (Body Structure) và Đợt 2 (Morphologic Abnormality).
Ảnh hưởng: ConceptMap SNOMED CT VN cho BodySite.
11/2025 QĐ 3516/QĐ-BYT
Chiến lược chuyển đổi số đẩy trọng tâm về dữ liệu, CCCD và EMR/HSSK.
Ảnh hưởng: Priority profiles hướng đến EMR và HSSK.
01/2026 Luật 91/2025 + NĐ 356
Dữ liệu y tế trở thành nhạy cảm; Consent và AuditEvent là bắt buộc.
Ảnh hưởng: Consent profile, AuditEvent, Provenance tích hợp core.
03/2026 QĐ 697 + QĐ 586/QĐ-BYT
Mẫu bảng kê chi phí KCB mới (12 nhóm; hiệu lực 19/03/2026, triển khai phần mềm chậm nhất 01/07/2026) và kế hoạch EMR toàn quốc 2026.
Ảnh hưởng: Claim/EOB restructure, bảng kê 12 nhóm.
Chính sách phát hành
Semantic versioning, có tính đến thực tế pháp lý VN.
VN Core tuân thủ semver nhưng bổ sung một nhánh "legal-patch" để phản ứng nhanh với văn bản mới. Bản vá pháp lý không kéo theo breaking change về cấu trúc, nhưng có thể thay đổi binding hoặc mã code.
major Dự kiến 12–18 tháng
Bản chính (x.0.0)
Breaking change về profile (cardinality, required bindings), thay đổi canonical URL pattern, loại bỏ profile cũ. Mỗi bản chính đi kèm migration guide và ít nhất 1 release candidate.
minor Hàng quý
Bản phụ (x.y.0)
Thêm profile, extension, ValueSet mới. Mở rộng binding từ preferred → extensible. Không thay đổi semantics của các element đã có.
patch Khi cần
Bản vá (x.y.z)
Sửa lỗi typo, bổ sung examples, cập nhật narrative pages. Không chạm vào StructureDefinition.
legal Theo VBPL
Bản cập nhật pháp lý
Bất kỳ khi nào có QĐ/TT/NĐ/Luật mới ảnh hưởng trực tiếp đến profile. Có thể release out-of-cycle, tag rõ là "legal-patch".
Về phiên bản 1.0.0
Phiên bản 1.0.0 chỉ phát hành sau khi có implementation report từ tối thiểu 5 CSKCB thí điểm, conformance testing đầy đủ, và ConceptMap 12 loại XML (XML1-XML12) theo QĐ 3176/QĐ-BYT hoàn chỉnh. Đây cũng là mốc nền tảng kỹ thuật để nộp hồ sơ HL7 Affiliate Việt Nam.