v0.1.0 03/2026 Hoàn thành
Dự thảo dùng thử 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
Đợt 1 — Bản công bố công khai
Công bố công khai đầu tiên: nhân khẩu học, gói gửi BHYT, 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
Đợt 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.3 05/2026 Hoàn thành
Sẵn sàng QĐ 697/QĐ-BYT + thư viện pháp lý có cấu trúc + đóng góp CHC
Dòng 0.5 ổn định QĐ 697/QĐ-BYT, danh mục pháp lý và đóng góp thuộc phạm vi lõi cho CHC/TYT xã. Phạm vi chính: bảng kê chi phí 12 nhóm, dịch vụ y tế cơ bản TYT xã, vòng đời mã cơ sở, thiết bị và dấu hiệu hiệu lực trong tương lai; danh mục pháp lý công khai hiện hành là 132 nguồn.
v0.6.0 06/2026 Hiện hành
Quản lý chăm sóc + KSK liên thông + Tương tác quốc tế (IPS)
Bản phát hành phụ dạng bổ sung, giữ nguyên canonical URL/package id. Trọng tâm: quản lý chăm sóc, KSK cấu trúc theo HL7 SDC, IPS/$summary để trao đổi quốc tế và QĐ 2919/QĐ-BYT; chi tiết kỹ thuật nằm ở changelog/IG.
v0.7.0 Q1/2027 Dự kiến
Gia cố pháp lý + chiều sâu liên thông + khám từ xa
Đào sâu quyền riêng tư/kiểm toán theo Luật 91/2025/QH15, NĐ 356/2025/NĐ-CP và Luật 116/2025/QH15; mở rộng ConceptMap YHCT/SNOMED, điều phối Task, đơn thuốc điện tử và khám từ xa. Các mốc pháp lý 2026 được xử lý bằng ngày hiệu lực rõ ràng.
v0.8.0 Q2/2027 Dự kiến
Nền tảng & sử dụng thứ cấp + phản hồi triển khai
Mở năng lực nền tảng khi có phản hồi triển khai đủ điều kiện rà soát: Bulk Data, SMART-on-FHIR, báo cáo chất lượng, Subscription theo ca sử dụng, khử định danh và chốt kiểm soát Provenance. Phạm vi điều chỉnh theo bằng chứng triển khai và văn bản mới.
v1.0.0 Mục tiêu Q3/2027 Dự kiến
STU1 — Phiên bản ổn định, chuẩn bị quản trị chính thức
Mục tiêu ổn định sau khi báo cáo triển khai được công bố hoặc đủ điều kiện rà soát, kiểm thử tuân thủ theo phạm vi thống nhất và ConceptMap ưu tiên XML đầu ra KCB ↔ FHIR được kiểm tra hợp lệ theo phạm vi. Hồ sơ Affiliate chỉ chuẩn bị khi quản trị đủ điều kiện.
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/TT-BYT — đị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/QH15 + TT 13/2025/TT-BYT + NĐ 163/2025/NĐ-CP
Mô hình 34 tỉnh, bệnh án điện tử bắt buộc, NĐ 163/2025/NĐ-CP thay NĐ 54/2017/NĐ-CP Luật Dược.
Ảnh hưởng: CodeSystem ĐVHC 2 cấp, DocumentReference EMR, Medication profiles.
07-08/2025 QĐ 2427/QĐ-BYT + 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/QH15 + NĐ 356/2025/NĐ-CP
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Đ-BYT + 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ỉ nên phát hành sau khi có implementation report từ các CSKCB thí điểm được công bố hoặc đủ điều kiện review, conformance testing đầy đủ, và các ConceptMap ưu tiên cho XML đầu ra KCB theo QĐ 3176/QĐ-BYT được validate theo phạm vi đã thống nhất. Đây cũng là mốc chuẩn bị nền tảng kỹ thuật cho hồ sơ HL7 Affiliate Việt Nam nếu governance đủ điều kiện.