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à 134 nguồn.
v0.6.1 06/2026 Hoàn thà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 07/2026 Hoàn thành
Gia cố dữ liệu BHYT + kiểm toán phát hành + rollover pháp lý 07/2026
Bản gia cố sau kiểm toán hậu phát hành v0.6.1 (v0.6.1 rút lại): sửa nhóm lỗi tài chính BHYT và người ký giấy chuyển tuyến, operations đúng scope, gói bhyt.submission nhận đủ delta XML13–15, rollover trạng thái pháp lý chạm mốc 01/07/2026 và corpus 145 văn bản (rà soát bổ sung 8 văn bản đợt hiệu lực 01/07/2026); công bố đúng SemVer 3 breaking change tồn đọng kèm hướng dẫn migration. Phần chiều sâu liên thông/khám từ xa của kế hoạch 0.7.0 cũ chuyển sang chu kỳ v0.8.0.
v0.8.0 07/2026 Hiện hành
Tái cấu trúc dữ liệu KSK theo QĐ 2062/QĐ-BYT + gia cố hậu kiểm toán Codex
Bản minor có thay đổi phá vỡ tương thích: tái cấu trúc dữ liệu khám sức khỏe định kỳ theo QĐ 2062/QĐ-BYT (mẫu phiếu theo nhóm tuổi, danh mục đối tượng mở rộng, kênh liên thông mới) và đợt gia cố chất lượng sau hai vòng kiểm toán độc lập — chuẩn hóa viện dẫn pháp lý theo văn bản ban hành, tách kỷ nguyên terminology kèm bản đồ chuyển đổi, chính sách đặt tên bền vững (ADR-0017). v0.7.0 đóng băng nguyên trạng; kho pháp lý 172 văn bản. Chi tiết: Lịch sử thay đổi.
v0.9.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. Tiếp nhận phần chiều sâu liên thông (YHCT/SNOMED ConceptMap, Task, đơn thuốc điện tử, khám từ xa) dời từ kế hoạch chu kỳ trước. Gỡ hẳn extension vn-ext-encounter-code (retired từ v0.7.0 — dời từ kế hoạch v0.8.0 để kéo dài cửa sổ migration).
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, chuyển tiếp phần mềm hoàn tấ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.