Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide
0.10.0 - Draft for Community Review
Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide - Draft for Community Review (v0.10.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| URL chính thức: http://fhir.hl7.org.vn/core/ValueSet/vn-imaging-report-code-vs | Phiên bản: 0.10.0 | ||||
| Computable Name: VNImagingReportCodeVS | |||||
| Định danh khác: OID:2.25.161089673617632664299011809196868855799.48.73 | |||||
Bản quyền/Pháp lý: Bộ Y tế Việt Nam — QĐ 1227/QĐ-BYT ngày 11/4/2025. LOINC là tài sản của Regenstrief Institute, Inc., dùng theo LOINC License. |
|||||
Tập giá trị cho DiagnosticReport.code của báo cáo CHẨN ĐOÁN HÌNH ẢNH:
http://loinc.org) — mã báo cáo hình ảnh quốc tế (vd 36643-5 XR Chest 2 Views).vn-cls-cs Phụ lục 05, QĐ 1227/QĐ-BYT — 1.240 chỉ số).Trước 0.10.0 child profile Imaging chỉ fix category mà kế thừa binding toàn danh mục
vn-cls-vs của base — báo cáo hình ảnh nhận được cả mã xét nghiệm/giải phẫu bệnh, và example
LOINC nằm ngoài declared VS (CORE-P1-03/T-03, review 97). Từ 0.10.0 phần LOINC ĐƯỢC lọc theo miền ngay ở tầng
compose bằng property chuẩn của chính LOINC: CLASS regex ^(RAD|OB[.]US|CARD[.]US|GEN[.]US|EYE[.]US)$
cộng STATUS in ACTIVE, TRIAL (loại mã đã khai tử/không khuyến nghị). Hai tầng canh: filter VS khi
có máy chủ thuật ngữ, và graph gate [LOINC-DOMAIN] đối chiếu offline cho corpus ví dụ bằng
bảng thuộc tính LOINC thu từ nguồn Bộ Y tế.
ĐÃ ĐO LẠI 03/09/2026: nhánh LOINC nay expand ĐÚNG. $expand trên máy chủ thuật ngữ nội bộ trả
9.712 mã — 8.475 từ http://loinc.org cộng 1.237 từ vn-cls-cs. Con số LOINC khớp chính xác
phép đếm độc lập trên bảng thuộc tính nguồn (data/loinc/loinc_detail.jsonl): 8.905 mã có CLASS
khớp biểu thức, còn 8.475 sau khi áp thêm STATUS in ACTIVE,TRIAL. Phân bố: RAD 7.295 · CARD.US 809
· OB.US 793 · GEN.US 5 · EYE.US 3.
Vì sao lần đo 30/08/2026 ra rỗng, và vì sao KHÔNG cần Part file của Regenstrief như dự kiến ban đầu:
lúc đó máy chủ chưa được nạp property CLASS, nên biểu thức không có gì để so. Ngày 02/09/2026
scripts/txserver-load.py bổ sung CLASS (kiểu string, lấy từ trường loinc_class) và
ORDER_OBS vào lô nạp LOINC; cổng txgw tự đánh giá regex/in cho hai property này vì tx.fhir.org
không hiểu chúng. Chẩn đoán cũ — LOINC mô hình hoá CLASS như Coding nên phải ánh xạ sang LP… —
đúng với máy chủ dùng bản LOINC gốc của Regenstrief, nhưng KHÔNG áp dụng cho bản do Bộ Y tế công bố:
bản đó mang tên lớp ngắn ở dạng chuỗi, và khi nạp đúng kiểu thì filter khớp thẳng.
Đã kiểm txgw dùng so khớp toàn chuỗi, không phải so khớp một phần: nếu dùng search thay
fullmatch, cùng biểu thức sẽ khớp 9.096 mã thay vì 8.905 — số trả về chứng minh nó khớp chặt.
Hệ quả cho bên triển khai. Hàng rào miền LOINC nay có HAI tầng đều hiệu lực: filter tập giá trị
khi có máy chủ thuật ngữ, và graph gate [LOINC-DOMAIN] đối chiếu offline cho bản dựng không có máy
chủ. $expand của tập giá trị này dùng được để liệt kê mã hình ảnh hợp lệ.
References
This value set includes codes based on the following rules:
http://loinc.org version Not Stated (use latest from terminology server) where CLASS matches (by regex) ^(RAD|OB[.]US|CARD[.]US|GEN[.]US|EYE[.]US)$ and STATUS in ACTIVE,TRIALhttp://fhir.hl7.org.vn/core/CodeSystem/vn-cls-cs version 📦0.10.0 where appendix = 05
This value set cannot be expanded because the terminology server(s) deemed it too costly to do so