CIO bệnh viện
Cần quyết định lộ trình, rủi ro và cách ghép FHIR vào HIS/EMR hiện hữu.
Mở playbook
Bài nên đọc
Kiến thức HL7 / FHIR · Việt Nam
Bản đồ đọc để đi từ khái niệm HL7 đến triển khai VN Core
Trung tâm kiến thức này không chỉ giải thích FHIR theo kiểu nhập môn. Mỗi bài đặt HL7, FHIR và VN Core vào bài toán thật của Việt Nam: bệnh án điện tử, BHYT, VNeID, bảo vệ dữ liệu cá nhân, thuật ngữ lâm sàng và governance liên thông.
Triết lý biên tập
Chuẩn trước, nhanh sau: định nghĩa rõ, đối chiếu pháp lý, gắn với artifact VN Core và chỉ nêu claim có bằng chứng. Đây là cách Omi đưa tri thức triển khai từ các hệ thống y tế khắt khe về phục vụ hạ tầng dữ liệu Việt Nam.
HL7 FHIR R4VN Core IGBHYTEMRDữ liệu nhạy cảm
38
bài kiến thức
VI + EN song hành
134
văn bản pháp lý
được đối chiếu trong registry
73
FHIR profiles
VN Core v0.6.0
139
CodeSystems
thuật ngữ và mã dùng chung
Mô hình triển khai 6 lớp
Đọc kiến thức theo đường đi từ chính sách đến dữ liệu chạy được.
Một đội triển khai FHIR không nên bắt đầu bằng việc copy JSON mẫu. Trật tự đúng là: xác định phạm vi pháp lý, hiểu workflow, chọn resource, áp profile, bind terminology, rồi mới đóng bundle và validate. Knowledge Hub được tổ chức theo chính đường đi này.
01
Chính sách và phạm vi
Xác định văn bản chi phối, dữ liệu nhạy cảm, trách nhiệm chia sẻ và ranh giới trial-use trước khi mô hình hóa.
02
Nghiệp vụ và sự kiện
Tách bài toán thành luồng EMR, BHYT, VNeID, chuyển tuyến, đơn thuốc hoặc tiêm chủng để tránh thiết kế resource theo màn hình HIS.
03
Resource nền
Chọn đúng Patient, Encounter, Observation, DiagnosticReport, MedicationRequest, Coverage, Claim, Bundle và các quan hệ cần giữ provenance.
04
Profile và Extension
Áp constraint Việt Nam bằng Must Support, slicing, extension, cardinality và invariant; phần này phải đọc cùng example thật.
05
Terminology và định danh
Quản trị CodeSystem, ValueSet, NamingSystem, ConceptMap, CCCD/BHYT/mã cơ sở KCB và quy tắc Coding.display.
06
Bundle, validation, vận hành
Đóng gói hồ sơ trao đổi, chạy validator, kiểm thử sandbox/connectathon và ghi nhận issue vào quy trình Working Group.
Overview trước khi vào IG
Đọc VN Core như một hệ thống, không đọc từng profile rời rạc.
IG là nguồn normative để validate. Track này là lớp định hướng: giúp người đọc hiểu artifact nào quyết định hình dạng dữ liệu, artifact nào quyết định mã, artifact nào quyết định API và cách kiểm thử trước khi triển khai.
01
Bản đồ artifact
Nắm toàn cảnh 73 profiles, 139 CodeSystems, 144 ValueSets, examples, capability và operation trước khi mở artifact index.
02
Cách đọc Profile
Đọc differential, snapshot, Must Support, slicing, binding, extension và example để biết constraint Việt Nam nằm ở đâu.
03
Terminology
Phân biệt CodeSystem, ValueSet, ConceptMap, NamingSystem và cách xử lý Coding.display khi trao đổi dữ liệu thật.
04
Bundle và validation
Nối từng resource thành hồ sơ trao đổi, claim, IPS, example và kiểm thử validator trước go-live.
Đọc theo nhiệm vụ
Không phải ai cũng cần bắt đầu cùng một trang.
Chọn đường đọc theo vai trò để đi thẳng từ câu hỏi công việc đến các bài nền tảng, thay vì đọc tuần tự cả thư viện.
Lập trình viên
Cần endpoint, payload, validation và lỗi thường gặp để bắt đầu làm thật.
Mở playbook
Bài nên đọc
Bác sĩ và đội nghiệp vụ
Cần hiểu FHIR giúp hồ sơ bệnh án, chỉ định, kết quả và theo dõi vòng đời nói cùng ngôn ngữ.
Mở playbook
Bài nên đọc
Cơ quan quản lý
Cần nhìn được governance, căn cứ pháp lý, dữ liệu nhạy cảm và năng lực liên thông quốc gia.
Mở playbook
Bài nên đọc
Đối chiếu Việt Nam
Nội dung tạo khác biệt nằm ở chỗ FHIR gặp thực tế Việt Nam.
Các bài này nối chuẩn quốc tế với văn bản pháp lý, workflow bệnh viện, dữ liệu BHYT và yêu cầu bảo vệ dữ liệu cá nhân. Đây là lớp tri thức giúp đội triển khai tránh hiểu FHIR như một API chung chung.
Bệnh án điện tử
Đọc TT 13/2025/TT-BYT dưới góc nhìn dữ liệu: định danh, tài liệu lâm sàng, kết nối và audit trail.
BHYT và XML đầu ra
Giữ XML theo quy định, nhưng tổ chức dữ liệu nội bộ theo Coverage, Claim, EOB và Invoice.
VNeID và Sổ sức khỏe điện tử
FHIR như lớp mô hình hóa hồ sơ sức khỏe cá nhân, không đồng nhất VNeID với định danh bệnh nhân.
Bảo vệ dữ liệu cá nhân
Phân biệt dữ liệu cơ bản, dữ liệu nhạy cảm, consent, logging và trách nhiệm chia sẻ dữ liệu.
AI y tế
Dữ liệu FHIR có provenance là điều kiện nền để AI y tế có thể giải trình và kiểm soát rủi ro.
Toàn bộ thư viện
Tám cụm nội dung, từ nhập môn đến use case.
Nền tảng khái niệm
Nhập môn
P0 · 6 trang
HL7, FHIR, lịch sử, so sánh và bản đồ tiêu chuẩn dữ liệu y tế. Dành cho người cần xây nền trước khi đọc IG.
Từ spec đến triển khai
Khái niệm cốt lõi FHIR
P0 · 5 trang
Resource, REST API, Profile, Extension, Terminology và versioning — phần phải hiểu nếu muốn triển khai FHIR đúng.
FHIR Resource — mô hình dữ liệu nền
/kien-thuc/fhir-resource/
FHIR RESTful API
/kien-thuc/fhir-restful-api/
Profile, Extension, IG
/kien-thuc/profiling-va-implementation-guide/
Terminology Binding (CodeSystem, ValueSet)
/kien-thuc/terminology-binding/
FHIR Versions: DSTU1 → R5
/kien-thuc/fhir-versions/
Đọc VN Core trước khi triển khai
VN Core Deep Dive
P0 · 4 trang
Bản đồ đọc trước khi vào IG: artifact nào là normative, profile đọc ra sao, terminology được bind thế nào, bundle/validation dùng ở đâu.
Nội địa hóa có căn cứ
Đối chiếu Việt Nam
P0 · 5 trang
FHIR trong các bài toán thật của Việt Nam: bệnh án điện tử, BHYT, VNeID, bảo vệ dữ liệu cá nhân và AI y tế.
FHIR trong Bệnh án điện tử (TT 13/2025/TT-BYT)
/kien-thuc/fhir-trong-benh-an-dien-tu/
FHIR và BHYT (XML 4210, QĐ 130/4750/3176)
/kien-thuc/fhir-va-bhyt/
FHIR và VNeID (Sổ SKĐT)
/kien-thuc/fhir-va-vneid/
FHIR và Luật 91/2025/QH15 BVDLCN
/kien-thuc/fhir-va-luat-bvdlcn/
FHIR và Luật AI 134/2025
/kien-thuc/fhir-va-luat-ai/
Đường đọc theo công việc
Theo vai trò
P1 · 4 trang
Cùng một nền tảng, nhưng câu hỏi khác nhau: CIO cần roadmap, DEV cần API, bác sĩ cần ý nghĩa dữ liệu, cơ quan quản lý cần governance.
Tra cứu nhanh
Tham chiếu
P1 · 4 trang
Thuật ngữ Anh-Việt, FAQ 50 câu, bản đồ FHIR quốc tế, timeline VN.
Từ nghiệp vụ đến resource
Use case end-to-end
P2 · 4 trang
Liên thông BV-TYT, chuyển tuyến, đơn thuốc điện tử, tiêm chủng TCMR.
Phương pháp biên soạn
Viết như tài liệu triển khai, không viết như bài giới thiệu.
Mỗi bài phải giúp đội kỹ thuật, nghiệp vụ và quản lý ra quyết định tốt hơn: hiểu đúng thuật ngữ, biết ranh giới pháp lý, biết artifact nào trong VN Core chịu ảnh hưởng.
1. Đối chiếu pháp lý
Mỗi trích dẫn văn bản pháp lý được đối chiếu với 130 văn bản/mục trong Khung pháp lý y tế VN — đảm bảo số hiệu, ngày ban hành, hiệu lực và trạng thái superseded chính xác.
2. Gắn với artifact thật
Các bài không dừng ở khái niệm. Nội dung được nối với profile, CodeSystem, ValueSet, package và guide của VN Core để người đọc biết triển khai ở đâu.
3. Đa vòng kiểm chứng
Mỗi trang trải qua nhiều vòng review chéo: kiểm tra fact, ngôn ngữ, mạch truyện, SEO và validation tự động đối chiếu code legal IDs với spec FHIR và CodeSystem của VN Core IG.