Một hệ thống tiền giám định có thể được xây theo hai cách.
Cách thứ nhất là viết trực tiếp hàng nghìn điều kiện trong mã nguồn:
nếu thuốc A thì kiểm tra bệnh B;
nếu dịch vụ X thì kiểm tra khoa Y;
nếu mã Z thì áp dụng ngưỡng N;
nếu ngày sau thời điểm T thì dùng quy định mới.
Cách này có thể hoạt động ở quy mô nhỏ.
Nhưng khi hệ thống phải quản lý:
- hàng nghìn thuốc;
- hàng nghìn DVKT;
- nhiều loại VTYT;
- nhiều mã bệnh;
- nhiều cơ sở KCB;
- các danh mục thay đổi theo thời gian;
- các văn bản liên tục sửa đổi, bổ sung;
- các điều kiện thanh toán có nhiều ngoại lệ;
thì mô hình hard-code sẽ nhanh chóng trở nên:
khó hiểu;
khó kiểm thử;
khó cập nhật;
khó truy vết căn cứ;
và rất dễ tạo sai sót khi pháp luật thay đổi.
Vì vậy Dr5-XML lựa chọn kiến trúc:
Generic Rule Engine + Versioned Knowledge Catalogs.
Nguyên tắc trung tâm của Bài 8.3 là:
Mã nguồn phải chứa logic kiểm tra tổng quát; còn mã, danh mục, ngưỡng, điều kiện nghiệp vụ, quan hệ và căn cứ phải được quản lý bằng dữ liệu có phiên bản.
Hay nói ngắn gọn:
Logic ổn định trong engine.
Nghiệp vụ thay đổi trong catalog.
1. Vì sao không nên viết một rule riêng cho từng thuốc hoặc dịch vụ?
Giả sử cần kiểm tra 2.000 thuốc.
Nếu mỗi thuốc có một đoạn code:
if MA_THUOC == "A":
...
if MA_THUOC == "B":
...
if MA_THUOC == "C":
...thì mỗi lần:
- thuốc được bổ sung;
- thay mã;
- thay điều kiện;
- thay thời gian áp dụng;
lập trình viên phải:
sửa source code;
chạy lại test;
build;
deploy.
Nếu có hàng chục bệnh viện:
mức độ phức tạp tăng rất nhanh.
Đây là thiết kế không phù hợp với hệ thống BHYT có nhiều danh mục và thay đổi theo thời gian.
2. Mã nguồn không nên chứa “tri thức pháp lý chi tiết”
Python nên biết:
làm thế nào kiểm tra một giá trị có nằm trong danh mục hay không.
Python không nên phải biết:
mã thuốc cụ thể nào đang có hiệu lực ngày 01/10/2026.
Python nên biết:
làm thế nào so sánh hai mốc thời gian.
Python không nên hard-code:
DVKT X phải thực hiện cách DVKT Y bao nhiêu ngày.
Python nên biết:
làm thế nào đánh giá một điều kiện có cấu trúc.
Catalog quyết định:
điều kiện đó là gì.
Đây là sự phân tách giữa:
computation
và:
knowledge.
3. Kiến trúc này đặc biệt phù hợp với môi trường pháp lý thay đổi
Trong thực tế, một quy định có thể:
có hiệu lực từ ngày A;
sau đó:
được sửa từ ngày B;
rồi:
bị thay thế từ ngày C.
Nếu nội dung nằm trong source code:
việc tái dựng rule lịch sử rất khó.
Nếu nội dung nằm trong catalog có:
effective_from;effective_to;- version;
- legal basis;
thì hệ thống có thể:
đánh giá hồ sơ cũ bằng đúng quy định cũ.
Đây là yêu cầu nền tảng của Dr5.
4. Không nên có “một bảng rule khổng lồ chứa tất cả”
Một cách khác cũng không tối ưu là tạo:
một bảng
rules
rồi nhét vào đó:
- field;
- catalog;
- thời gian;
- payment;
- legal basis;
- relation;
- exception;
- mọi thứ khác.
Kết quả thường là:
cấu trúc khó quản lý;
dữ liệu lặp;
provenance mơ hồ.
Dr5 lựa chọn mô hình phân tách tri thức thành sáu catalog chuẩn.
5. Sáu catalog chuẩn của Dr5
Kiến trúc hiện tại thống nhất chỉ sử dụng:
dr5_xml_fielddr5_xml_requireddr5_xml_relationdr5_catalog_bindingdr5_payment_conditiondr5_legal_basis
Sáu catalog này không phải:
sáu loại cảnh báo.
Chúng là:
sáu lớp tri thức cần thiết để Generic Rule Engine hiểu dữ liệu, quan hệ, danh mục, điều kiện thanh toán và căn cứ áp dụng.
6. dr5_xml_field — dữ liệu này là gì?
dr5_xml_field mô tả:
cấu trúc và ý nghĩa kỹ thuật của field XML.
Có thể bao gồm các thuộc tính như:
- bảng XML;
- tên field;
- datatype;
- kích thước;
- format;
- phiên bản;
- thời gian hiệu lực;
- các metadata kỹ thuật cần thiết.
Ví dụ:
XML1.MA_BENH_CHINH
XML2.MA_THUOC
XML3.MA_DICH_VU
Engine không cần hard-code:
danh sách tất cả field.
Nó đọc:
dr5_xml_field.
7. dr5_xml_field không quyết định mọi field đều bắt buộc
Đây là điểm rất quan trọng.
Một field tồn tại trong chuẩn:
không có nghĩa mọi hồ sơ đều phải có giá trị.
Requiredness phụ thuộc:
- loại hình KCB;
- loại chi phí;
- context;
- đối tượng;
- version.
Do đó:
field definition
và:
requiredness
phải tách nhau.
8. dr5_xml_required — khi nào field bắt buộc?
Catalog này trả lời:
Trong context nào field này phải có giá trị?
Ví dụ conceptual:
XML3 field X
có thể:
- bắt buộc khi condition A;
- không áp dụng khi condition B;
- optional trong condition C.
Nhờ đó Generic Rule Engine có thể xử lý:
contextual requiredness.
Không cần viết:
một chuỗi
ifriêng trong code.
9. Đây là cách tránh sai lầm “field có trong chuẩn = bắt buộc mọi lúc”
Rule generic có thể là:
resolve applicability
→ đọc dr5_xml_required
→ nếu applicable:
kiểm tra value.
Nếu không applicable:
NOT_APPLICABLE.
Đây là mô hình an toàn hơn nhiều so với:
kiểm tra
NOT NULLtrên mọi hồ sơ.
10. dr5_xml_relation — các dữ liệu phải liên hệ với nhau như thế nào?
Nhiều lỗi không nằm ở một field đơn lẻ.
Chúng nằm ở:
quan hệ giữa nhiều field hoặc nhiều record.
Ví dụ:
tổng bằng tổng các thành phần;
ngày thực hiện phải phù hợp với ngày y lệnh;
một dịch vụ phải liên kết được với một đối tượng khác;
dữ liệu ở XML1 phải nhất quán với XML2/XML3.
Những yêu cầu này thuộc:
dr5_xml_relation.
11. Các loại relation đã chuẩn hóa trong Dr5
Có thể biểu diễn bằng các loại như:
ARITHMETIC_EQUALITY;SUM_COMPONENTS;ATTRIBUTE_CONSISTENCY;TEMPORAL_RELATION;CROSS_TABLE_RECONCILIATION;CONDITIONAL_REFERENCE;SERVICE_SUPPLY_LINK;PROVIDER_CONTEXT;SERVICE_DEPARTMENT_COMPATIBILITY;BED_DEPARTMENT_LINK;ORDERER_CONTEXT;PERFORMER_CONTEXT;SERVICE_EQUIPMENT_LINK.
Đây là:
relation type
bên trong dr5_xml_relation.
Không phải:
mỗi loại tạo một catalog mới.
12. Ví dụ ARITHMETIC_EQUALITY
Engine generic biết:
lấy A, B, C;
tính theo biểu thức đã cấu hình;
so kết quả.
Ví dụ conceptual:
A = B + C.
Nếu pháp luật hoặc chuẩn thay đổi:
thành phần nào được dùng
có thể thay đổi trong catalog.
Không cần sửa:
arithmetic engine.
13. Ví dụ TEMPORAL_RELATION
Engine generic biết cách kiểm tra:
event A trước/sau event B.
Catalog quyết định:
- field/event nào;
- relation nào;
- context nào;
- khoảng thời gian nào nếu có;
- effective period.
Như vậy cùng một implementation có thể xử lý:
hàng trăm rule thời gian.
14. dr5_catalog_binding — giá trị này phải đối chiếu danh mục nào?
Một code không thể được kiểm tra chỉ bằng:
“có tồn tại ở đâu đó không?”
Phải biết:
thuộc danh mục nào;
phiên bản nào;
áp dụng tại thời điểm nào;
áp dụng cho cơ sở nào nếu relevant.
dr5_catalog_binding đảm nhận việc:
nối field/context với catalog candidate phù hợp.
15. Candidate resolution phải đi trước membership check
Không nên:
lấy
MA_DICH_VU
→ tra vào “danh mục dịch vụ hiện tại”.
Phải:
MA_DICH_VU
→ xác định loại record;
→ xác định event date;
→ xác định facility/context;
→ resolve applicable catalog;
→ kiểm tra membership.
Đây là vai trò của:
CatalogCandidateResolver.
16. Một mã có thể đúng hôm nay nhưng sai ở thời điểm khác
Ví dụ:
code X có hiệu lực từ 01/08/2026.
Hồ sơ ngày:
15/09/2026
có thể hợp lệ.
Nhưng hồ sơ ngày:
01/06/2026
không thể được đánh giá chỉ bằng:
danh mục hiện tại.
Do đó membership phải luôn là:
code ∈ catalog(event_date)
không phải:
code ∈ current_catalog.
17. dr5_payment_condition — điều kiện thanh toán thực sự là gì?
Đây là catalog quan trọng nhất khi Dr5 tiến từ:
validation
sang:
pre-adjudication.
dr5_payment_condition dùng để mô tả:
một khoản chi chỉ được thanh toán khi condition cụ thể được đáp ứng.
Condition có thể liên quan:
- đối tượng;
- thuốc;
- dịch vụ;
- VTYT;
- chẩn đoán;
- khoa;
- người hành nghề;
- thời gian;
- kết quả;
- evidence;
- các điều kiện kết hợp.
18. Không đưa mọi cảnh báo vào dr5_payment_condition
Một rule:
DVKT trên P95
không phải payment condition nếu không có căn cứ tương ứng.
Một rule:
thuốc hiếm gặp với ICD này
cũng không mặc nhiên là payment condition.
Những nội dung đó thuộc:
analytics/review layer.
dr5_payment_condition chỉ dành cho:
điều kiện thanh toán có căn cứ phù hợp.
19. Đây là ranh giới cực kỳ quan trọng
Nếu không tách:
statistical rule
khỏi:
legal payment condition,
Dr5 sẽ dần biến:
practice pattern
thành:
“luật thanh toán”.
Đây là thiết kế phải tránh tuyệt đối.
20. dr5_legal_basis — vì sao rule tồn tại?
Mỗi condition chính thức phải có thể trả lời:
căn cứ nào?
dr5_legal_basis có thể quản lý:
- văn bản;
- điều;
- khoản;
- điểm;
- phụ lục;
- ngày ban hành;
- ngày hiệu lực;
- ngày hết hiệu lực;
- quan hệ sửa đổi;
- nguồn tài liệu.
Nhờ đó finding không chỉ nói:
“Sai điều kiện.”
Mà có thể nói:
“Condition này được xác lập từ căn cứ X, áp dụng tại thời điểm Y.”
21. Legal basis không nên chỉ là một trường text
Nếu chỉ lưu:
“Theo Thông tư X”,
hệ thống không thể:
- quản lý amendment;
- effective period;
- provenance;
- impact analysis.
Do đó căn cứ cần được:
cấu trúc hóa.
22. Sáu catalog tạo thành một chuỗi tri thức
Có thể hình dung:
dr5_xml_field
xác định:
field là gì
↓
dr5_xml_required
xác định:
khi nào phải có
↓
dr5_catalog_binding
xác định:
đối chiếu danh mục nào
↓
dr5_xml_relation
xác định:
phải liên hệ với dữ liệu khác ra sao
↓
dr5_payment_condition
xác định:
điều kiện thanh toán nào cần đáp ứng
↓
dr5_legal_basis
xác định:
vì sao condition đó tồn tại và áp dụng khi nào.
23. Generic Rule Engine chỉ cần biết “cách đánh giá”
Engine có thể cung cấp các implementation tổng quát như:
- field validation;
- requiredness;
- catalog membership;
- catalog attribute match;
- effective period;
- conditional constraint;
- record relationship;
- sequence constraint;
- rolling-window frequency;
- cross-record/cross-table;
- aggregate/reconciliation.
Engine không cần biết trước:
danh sách tất cả bệnh, thuốc, dịch vụ.
24. Catalog là tham số của generic implementation
Ví dụ:
catalog_membership
là một implementation.
Nó có thể dùng cho:
- ICD;
- thuốc;
- DVKT;
- VTYT;
- khoa;
- nhân viên.
Khác nhau ở:
candidate catalog được resolve.
Không cần:
icd_membership.py
drug_membership.py
service_membership.py
cho từng nhóm.
25. Tương tự với relation
Một TEMPORAL_RELATION implementation có thể phục vụ:
- y lệnh → thực hiện;
- thực hiện → kết quả;
- vào viện → ra viện;
- hai lần KCB liên tiếp.
Khác nhau ở:
relation record.
Không cần code riêng:
từng cặp field.
26. Đây là mô hình “data-driven behavior”
Có thể hiểu:
code quyết định engine có khả năng làm loại việc gì.
Catalog quyết định:
hôm nay engine phải làm việc đó với dữ liệu nào và condition nào.
Đây là sự khác nhau giữa:
software capability
và:
business configuration.
27. Khi nào thực sự cần sửa code?
Không phải khi:
thêm một thuốc.
Không phải khi:
đổi một mã dịch vụ.
Không phải khi:
ngưỡng từ 2 thành 3.
Không phải khi:
condition có thêm một ICD.
Code mới chỉ cần khi xuất hiện:
một loại logic mà generic engine hiện chưa thể biểu diễn.
28. Ví dụ về thay đổi chỉ cần cập nhật catalog
Giả sử một condition:
trước đây áp dụng cho dịch vụ A, B.
Sau văn bản mới:
thêm dịch vụ C.
Nếu logic không thay đổi:
chỉ thêm C vào dữ liệu applicable.
Không sửa implementation.
29. Ví dụ thay đổi ngưỡng
Giả sử condition:
số lượng tối đa = 2.
Sau quy định mới:
tối đa = 3.
Nếu evaluator đã biết:
numeric threshold comparison,
thì chỉ cần:
version condition mới với threshold 3.
Không sửa Python.
30. Ví dụ thay đổi thời gian hiệu lực
Nếu rule cũ:
đến 30/6.
Rule mới:
từ 1/7.
Catalog quản lý:
V1 effective_to = 30/6;
V2 effective_from = 1/7.
Không overwrite V1.
31. Đây là nguyên tắc “append version, do not mutate history”
Một record đã được dùng để đánh giá hồ sơ:
không nên bị sửa lại như thể nội dung mới luôn tồn tại.
Nếu thay đổi nghiệp vụ:
tạo version mới.
Nhờ vậy:
finding lịch sử vẫn tái dựng được.
32. Không nên xóa mã hết hiệu lực khỏi catalog lịch sử
Mã ngừng sử dụng ngày hôm nay:
vẫn có thể hợp lệ trong hồ sơ năm trước.
Do đó:
stop validity
khác:
delete record.
Catalog phải giữ:
lịch sử hiệu lực.
33. Candidate resolver là cầu nối giữa XML và catalog
Một generic rule không nên tự hỏi:
“Tôi phải tra danh mục nào?”
Candidate resolver thực hiện trước:
field/context
→ event date
→ facility
→ applicable binding
→ catalog version
→ candidate record.
Sau đó implementation chỉ:
evaluate.
34. Điều này giúp rule không bị lặp logic resolve
Nếu 500 rule đều tự code:
cách xác định version catalog,
sớm muộn sẽ có:
500 cách hiểu khác nhau.
Central resolver bảo đảm:
consistency.
35. Tách logic khỏi dữ liệu còn giúp kiểm thử tốt hơn
Có thể test generic implementation bằng:
synthetic data.
Ví dụ test:
catalog_membership:
- member;
- non-member;
- missing value;
- wrong version;
- boundary date.
Không cần test riêng engine cho:
từng thuốc.
36. Nhưng catalog data cũng phải được kiểm thử
Generic engine đúng không có nghĩa:
catalog đúng.
Một record condition sai có thể làm:
hàng nghìn hồ sơ bị cảnh báo sai.
Do đó cần hai tầng test:
Engine tests
Kiểm tra logic generic.
Catalog tests
Kiểm tra nội dung nghiệp vụ/version.
37. Catalog phải có validation riêng
Ví dụ cần phát hiện:
- effective period overlap;
- gap không mong muốn;
- duplicate code;
- legal basis thiếu;
- binding không resolve;
- condition không có applicable object;
- relation tham chiếu field không tồn tại.
Đây là:
knowledge validation.
38. Một catalog record không nên được publish nếu thiếu provenance
Ví dụ có condition:
thuốc X cần Y.
Nhưng không biết:
condition lấy từ đâu.
Record đó có thể ở:
DRAFT.
Không nên:
PUBLISHED.
39. Cần quản lý trạng thái catalog record
Một lifecycle nội bộ có thể là:
DRAFT
→ REVIEWED
→ TESTED
→ PUBLISHED
→ RETIRED.
Đây là governance metadata.
Không cần tạo:
catalog mới.
40. Published version nên gần như immutable
Nếu phát hiện sai:
tạo correction/version mới.
Không âm thầm sửa dữ liệu cũ.
Điều này đặc biệt quan trọng vì:
finding đã được sinh từ version cũ.
41. Catalog version phải xuất hiện trong finding
Một finding nên cho biết:
rule/implementation version;
catalog version;
condition version;
legal basis version.
Nếu chỉ lưu:
“Rule 123”
mà Rule 123 thay đổi theo thời gian:
finding không thể giải thích sau này.
42. Finding phải truy ngược được toàn bộ chain
Ví dụ:
XML3 STT 25
→ MA_DICH_VU = X
→ dr5_catalog_binding B17
→ catalog version V3
→ dr5_payment_condition PC42
→ dr5_legal_basis LB9
→ generic implementation conditional_constraint
→ result FALSE.
Đây là:
traceability chain.
43. Traceability quan trọng hơn việc chỉ có message đẹp
Một message:
“Dịch vụ không đủ điều kiện thanh toán”
có thể hữu ích cho người dùng.
Nhưng để audit phải biết:
hệ thống đi đến kết luận bằng con đường nào.
Dr5 cần cả:
human-readable explanation
và:
machine trace.
44. Không nên đưa dữ liệu analytics vào sáu catalog pháp lý nếu bản chất không phù hợp
Ví dụ:
P95 frequency của khoa A tháng 10.
Đây là:
analytics configuration/result.
Không phải:
dr5_payment_condition.
Tương tự:
benchmark chi phí;
review priority score;
override rate
không thuộc sáu catalog.
45. Workflow metadata cũng không nên bị nhét vào catalog nghiệp vụ
Những nội dung như:
- owner;
- deadline;
- escalation;
- notification channel;
- UI popup;
- hard stop;
thuộc:
workflow/execution layer.
Không phải:
legal knowledge.
46. Cần giữ ba lớp kiến trúc tách biệt
Layer 1 — Generic Engine
biết cách tính.
Layer 2 — Knowledge Catalogs
biết phải kiểm tra cái gì và vì sao.
Layer 3 — Workflow/UI
biết kiểm tra ở đâu, ai xử lý và hiển thị thế nào.
Ba lớp này không nên trộn.
47. Ví dụ cùng một condition nhưng workflow khác nhau
Payment condition X có thể được dùng:
Khi chỉ định
soft warning.
Khi khóa hồ sơ
require review.
Pre-send
final payment warning.
Condition:
giống nhau.
Workflow:
khác nhau.
Nếu hard-code workflow vào condition:
rule khó tái sử dụng.
48. Cùng một engine có thể phục vụ nhiều bệnh viện
Đây là lợi ích lớn của kiến trúc catalog-driven.
Core Dr5 có thể:
giống nhau.
Khác biệt từng bệnh viện nằm ở:
- facility catalog;
- master mapping;
- integration;
- internal thresholds;
- workflow.
Không cần:
fork source code cho từng cơ sở.
49. Nhưng rule pháp lý dùng chung không được bị local customization làm sai nghĩa
Ví dụ condition pháp lý:
X.
Bệnh viện không nên sửa:
X thành X'
chỉ để giảm cảnh báo.
Nếu cần local behavior:
điều chỉnh enforcement/workflow.
Không thay:
meaning của legal condition.
50. Có thể có facility-specific bindings mà vẫn dùng cùng logic
Ví dụ cùng một DVKT chuẩn:
Bệnh viện A mapping từ mã nội bộ A123.
Bệnh viện B:
B456.
dr5_catalog_binding có thể xử lý:
mapping/context.
Engine không cần biết:
hai mã nội bộ khác nhau.
51. Đây là cách chuẩn bị cho mô hình SaaS
Nếu Dr5 phục vụ:
100 bệnh viện,
không thể duy trì:
100 codebase.
Phải có:
one engine
- versioned knowledge
- facility-scoped configuration.
Đây là yêu cầu kiến trúc dài hạn.
52. Không tạo thêm catalog theo từng domain nếu sáu catalog đã đủ
Ví dụ không cần:
dr5_drug;
dr5_service;
dr5_supply;
dr5_diagnosis_service;
dr5_frequency;
dr5_time_rule;
dr5_evidence_requirement.
Các nội dung này được biểu diễn bằng:
sáu catalog chuẩn
- generic implementation
- workflow/analytics layer khi phù hợp.
53. Vì sao hạn chế số catalog là quan trọng?
Nếu mỗi use case lại tạo một bảng:
schema tăng rất nhanh.
Sau đó:
- cùng khái niệm bị lưu nhiều nơi;
- versioning khác nhau;
- provenance không thống nhất;
- engine phải biết hàng chục cấu trúc.
Sáu catalog chuẩn giúp:
normalize knowledge architecture.
54. Tuy nhiên “sáu catalog” không có nghĩa sáu bảng đơn giản cố định mãi mãi
Bên trong mỗi catalog có thể có:
- nhiều loại record;
- metadata;
- version;
- relationship;
- attributes.
Điều cần giữ là:
semantic responsibility của từng catalog.
Không phải:
mọi use case phải ép vào một row schema nghèo nàn.
55. dr5_xml_relation đặc biệt cần linh hoạt
Một relation có thể có:
- source;
- target;
- join key;
- operator;
- condition;
- scope;
- cardinality;
- effective period.
Nhờ đó một engine generic có thể xử lý:
nhiều mô hình quan hệ.
56. dr5_payment_condition cũng cần cấu trúc biểu đạt condition
Không nên chỉ lưu:
một đoạn text tự do.
Phải có khả năng map tới:
- operands;
- operator;
- candidate set;
- exception;
- evidence requirement;
- applicability.
Phần text chỉ dùng:
human description.
57. Machine-readable và human-readable phải cùng tồn tại
Ví dụ condition:
machine-readable để evaluator chạy.
Đồng thời:
human-readable để chuyên gia BHYT kiểm tra.
Nếu chỉ machine-readable:
khó audit nghiệp vụ.
Nếu chỉ text:
không tự động hóa được.
58. Không nên để SQL trở thành nơi chứa business rule
Một anti-pattern khác:
viết hàng trăm câu SQL đặc thù.
Ví dụ:
query riêng cho từng mã.
Khi đó business logic nằm:
rải rác trong database layer.
Dr5 nên giữ:
business knowledge trong catalog
và:
query/execution generic trong engine.
59. Tương tự không nên để UI chứa rule
Ví dụ JavaScript trên màn hình:
nếu mã X thì popup Y.
Nếu backend/pre-send không biết rule đó:
inconsistency xuất hiện.
Rule phải có:
một source of truth trung tâm.
UI chỉ:
consume result.
60. Đây là nguyên tắc “single source of rule truth”
Một condition được định nghĩa một lần.
Sau đó có thể sử dụng ở:
- CPOE;
- HIS;
- EMR;
- billing;
- pre-submission;
- retrospective audit.
Không copy:
cùng rule thành năm phiên bản code khác nhau.
61. Khi rule thay đổi, tất cả control point nên nhận version mới
Nếu condition thay đổi:
update catalog.
Các hệ thống nguồn gọi:
cùng rule service
sẽ tự dùng:
version phù hợp.
Không cần:
sửa từng màn hình.
62. Nhưng rollout vẫn cần kiểm soát
Version mới có thể:
chạy shadow trước.
Sau đó:
warning.
Rồi:
enforced nếu phù hợp.
Knowledge publication và workflow rollout:
là hai việc khác nhau.
63. Điều 16 nhắc lại ranh giới giữa catalog nội bộ và tiêu chí chính thức
BHXH Việt Nam là cơ quan ban hành tiêu chí, tiêu chuẩn áp dụng trên Hệ thống thông tin giám định BHYT.
Vì vậy một record trong catalog Dr5:
không tự động trở thành “tiêu chí BHXH”.
Phải biết nguồn:
legal / official technical / internal / analytics.
64. Catalog nội bộ có thể mạnh hơn yêu cầu pháp lý nhưng phải gọi đúng tên
Ví dụ bệnh viện muốn:
kiểm tra một practice safety condition chặt hơn.
Hoàn toàn có thể.
Nhưng finding phải nói:
Quy tắc an toàn nội bộ.
Không:
“Không được BHYT thanh toán”
nếu không có căn cứ payment.
65. Đây là lý do provenance phải nằm ở mọi level
Một record phải biết:
source_type.
Một finding phải biết:
inherited source_type.
Một UI phải:
hiển thị phù hợp.
Nhờ đó người dùng hiểu:
thẩm quyền của cảnh báo.
66. Generic Rule Engine phải hỗ trợ UNKNOWN tự nhiên
Nếu catalog condition yêu cầu:
evidence X
nhưng source chưa có,
engine không được:
tự tạo FALSE.
Nó phải:
trả UNKNOWN.
Catalog-driven không có nghĩa:
mọi thứ đều binary.
67. Catalog cần mô tả evidence requirement đủ rõ
Ví dụ condition:
cần result Y.
Engine phải biết:
tìm ở đâu;
relation nào;
nếu không tìm thấy thì:
NOT_RESOLVED
hay:
FALSE
theo logic.
Đây là yếu tố quyết định false positive.
68. Không dùng catalog để “bù” dữ liệu nguồn sai
Nếu source field sai:
catalog không nên map tùy tiện để làm hồ sơ pass.
Binding phải dựa trên:
mapping chính thức/được quản trị.
Không biến:
normalization
thành:
data laundering.
69. Một mapping cũng phải có version và provenance
Nếu mã nội bộ:
A
map sang mã chuẩn:
X
từ ngày 01/01.
Sau đó đổi:
Y
từ 01/07.
Không sửa mapping cũ.
Phải giữ:
historical binding.
70. Điều này đặc biệt quan trọng cho retrospective review
Khi re-run hồ sơ tháng 3:
mapping A → X.
Hồ sơ tháng 9:
A → Y.
Nếu chỉ giữ mapping hiện tại:
historical analytics sai.
71. Một thay đổi catalog phải có impact analysis
Trước publish version mới, nên biết:
bao nhiêu rule phụ thuộc?
bao nhiêu hồ sơ chưa gửi bị ảnh hưởng?
bao nhiêu finding có thể thay đổi?
Đây là:
controlled knowledge deployment.
72. Không nên cập nhật catalog production trực tiếp bằng thao tác không kiểm soát
Một record sai có thể:
ảnh hưởng hàng nghìn hồ sơ tức thì.
Cần workflow:
draft
→ validation
→ review
→ test
→ publish.
Catalog cũng là:
production code ở dạng dữ liệu.
73. Có thể coi catalog như “executable knowledge”
Nó không phải dữ liệu tham khảo đơn thuần.
Một thay đổi trong:
dr5_payment_condition
có thể làm:
finding thay đổi.
Do đó mức quản trị phải tương đương:
source code.
74. Nhưng catalog có lợi thế cập nhật nhanh hơn code
Nếu thiết kế tốt:
chuyên gia nghiệp vụ có thể đề xuất/update knowledge
mà không phải:
viết Python.
Tuy nhiên vẫn cần:
kiểm duyệt;
test;
audit.
Không có nghĩa:
ai cũng được sửa trực tiếp.
75. Mục tiêu dài hạn là “low-code rule authoring”
Chuyên gia có thể cấu hình:
- applicability;
- operator;
- threshold;
- catalog;
- evidence;
- exception;
- legal basis.
Engine generic thực hiện phần còn lại.
Đây là hướng mở rộng hợp lý của Dr5.
76. Nhưng low-code không được biến thành no-governance
Càng dễ tạo rule:
nguy cơ tạo rule sai càng cao.
Do đó publication workflow phải chặt.
Đặc biệt với:
PAYMENT_CONDITION
và:
clinical/safety rule.
77. Ví dụ kiến trúc conceptual — kiểm tra mã
Giả sử cần kiểm tra:
mã X.
Không viết:
if X not in [...]Mà flow là:
field →
dr5_catalog_binding
→ candidate catalog/version
→ generic catalog_membership
→ result.
Danh sách mã nằm:
catalog data.
78. Ví dụ kiến trúc conceptual — kiểm tra ngưỡng
Giả sử condition:
quantity ≤ N.
Generic evaluator biết:
numeric comparison.
dr5_payment_condition cung cấp:
field;
operator;
N;
applicability;
effective period;
legal basis.
Nếu N thay đổi:
condition version mới.
79. Ví dụ kiến trúc conceptual — kiểm tra sequence
Condition:
A phải trước B.
Generic:
sequence_constraint.
dr5_xml_relation cung cấp:
- source event A;
- target event B;
- applicable context;
- operator;
- effective period.
Không code riêng:
từng event pair.
80. Ví dụ kiến trúc conceptual — kiểm tra provider context
Một dịch vụ có thể cần:
người thực hiện phù hợp.
Generic relation:
PERFORMER_CONTEXT.
Catalog cung cấp:
relation/context.
Engine resolve:
performer + service + date + relevant source.
Không cần:
if doctor == ....
81. Một rule có thể kết hợp nhiều catalog
Ví dụ payment condition:
dịch vụ X
chỉ thanh toán nếu:
relation Y
và:
evidence Z.
Flow có thể sử dụng:
dr5_catalog_binding;dr5_xml_relation;dr5_payment_condition;dr5_legal_basis.
Đây là bình thường.
Không cần gom tất cả:
vào một catalog duy nhất.
82. Catalog-driven architecture giúp giải thích finding tự nhiên hơn
Vì mỗi thành phần có metadata, Dr5 có thể hiển thị:
Đối tượng: dịch vụ X
Condition: ...
Observed: ...
Expected: ...
Applicable version: ...
Evidence: ...
Basis: ...
Nếu hard-code trong Python:
thông tin này thường bị mất.
83. Nó cũng giúp tạo tài liệu tự động
Từ catalog có thể sinh:
- danh sách rule;
- rule matrix;
- legal-basis report;
- change log;
- release notes.
Như vậy cùng một nguồn knowledge phục vụ:
engine
và:
documentation.
84. Điều này giảm nguy cơ “tài liệu nói một đằng, code chạy một nẻo”
Nếu tài liệu được viết riêng:
dễ lệch với code.
Nếu description được sinh từ:
catalog published,
khả năng lệch giảm đáng kể.
85. Không nên sử dụng tên catalog như tên business rule trên UI
Người dùng không cần thấy:
dr5_payment_condition#423.
UI nên hiển thị:
“Điều kiện thanh toán ...”
Catalog ID chỉ dành:
audit/debug.
Tách:
technical identifier
và:
human explanation.
86. Mỗi catalog record cần stable identifier
Version có thể thay đổi.
Nhưng cần biết:
V1 và V2 là hai version của cùng một business concept.
Có thể có:
stable logical ID
- version ID.
Nhờ đó:
impact/history dễ theo dõi.
87. Không tái sử dụng ID cho concept khác
Nếu condition A bị bãi bỏ:
retire.
Không dùng lại ID A cho:
condition B.
Đây là nguyên tắc dữ liệu cơ bản nhưng quan trọng cho audit.
88. Catalog-driven architecture hỗ trợ “rule diff”
Có thể so:
V1 và V2
để biết:
- thêm mã nào;
- bỏ mã nào;
- đổi threshold;
- đổi applicability;
- đổi basis.
Đây là công cụ rất giá trị khi văn bản thay đổi.
89. Diff còn giúp xác định regression test
Nếu V2 chỉ đổi:
threshold,
test tập trung:
boundary mới.
Nếu đổi:
applicability,
test thêm:
context mới.
Knowledge diff có thể dẫn:
test generation.
90. Không nên chạy toàn bộ catalog cho mọi record
Catalog-driven không có nghĩa:
brute force tất cả rule.
Candidate resolver phải thu hẹp:
applicable candidates.
Ví dụ một dòng thuốc:
chỉ resolve condition liên quan thuốc đó/context đó.
Điều này quan trọng cho:
hiệu năng.
91. Candidate selection cần deterministic và giải thích được
Nếu một condition được chọn:
phải biết tại sao.
Ví dụ:
code match;
group match;
date match;
facility match.
Không nên dùng:
black-box similarity
để quyết định applicability của payment rule.
92. AI có thể hỗ trợ tạo catalog nhưng không tự publish
AI có thể:
- trích candidate condition từ văn bản;
- đề xuất mapping;
- sinh test cases;
- tìm amendment.
Nhưng trước publish cần:
chuyên gia xác nhận.
Đặc biệt với:
dr5_payment_condition
và:
dr5_legal_basis.
93. AI không được tự tạo code list pháp lý từ pattern dữ liệu
Ví dụ thấy:
thuốc X thường đi với ICD Y.
AI không được tự thêm:
Y là indication bắt buộc
vào payment catalog.
Đây chỉ là:
analytic association
cho đến khi có căn cứ khác.
94. Cần phân biệt catalog knowledge và learned model
Catalog:
explicit, versioned, governed.
Machine-learning model:
statistical.
Hai lớp có thể hỗ trợ nhau.
Nhưng ML output không nên:
âm thầm ghi vào legal catalog.
95. Một kiến trúc hoàn chỉnh của Dr5 có thể mô tả
Raw XML / Source data
↓
Field resolution
dr5_xml_field
↓
Requiredness
dr5_xml_required
↓
Catalog resolution
dr5_catalog_binding
↓
Relationship evaluation
dr5_xml_relation
↓
Payment-condition evaluation
dr5_payment_condition
↓
Legal provenance
dr5_legal_basis
↓
Finding
↓
Workflow / review.
96. Nhưng evaluator không nhất thiết luôn đi qua cả sáu catalog
Một lỗi datatype có thể chỉ cần:
dr5_xml_field.
Một cross-table relation:
dr5_xml_relation.
Một payment finding phức tạp:
có thể dùng nhiều catalog.
Sáu catalog là:
available knowledge layers.
Không phải:
pipeline bắt buộc từng bước cho mọi rule.
97. Mức độ chắc chắn của finding phụ thuộc knowledge chain đã resolve được
Ví dụ:
Field format sai
Deterministic.
→ ERROR_TECH.
Catalog chưa resolve
→ INFO_EVIDENCE hoặc technical unresolved state.
Statistical outlier
→ WARN_REVIEW.
Payment condition + legal basis + evidence đầy đủ + failure
→ PAYMENT_CONDITION.
Không nên dùng cùng outcome.
98. Rule source vẫn phải được hiển thị
Điều 16 quy định tiêu chí chính thức trên Hệ thống thông tin giám định do BHXH Việt Nam ban hành.
Do đó mỗi finding cần cho người dùng biết nó đến từ:
legal source;
official technical source;
internal hospital control;
analytics screening.
Đây là một phần của explainability.
99. Thành công của catalog-driven architecture không đo bằng số catalog record
Không phải:
càng nhiều record càng tốt.
Phải đo:
- coverage;
- accuracy;
- provenance completeness;
- version correctness;
- false-positive rate;
- maintainability.
Một catalog ít nhưng chính xác:
tốt hơn catalog lớn nhưng không kiểm soát.
100. Mục tiêu dài hạn: thay đổi nghiệp vụ mà không cần thay đổi engine
Một kiến trúc trưởng thành sẽ cho phép:
thêm condition mới cùng loại logic
→ thêm catalog record;
đổi threshold
→ version data;
đổi code list
→ catalog update;
đổi effective period
→ version metadata;
đổi căn cứ
→ legal-basis update.
Engine:
không thay đổi.
Đây là mục tiêu cốt lõi của Dr5.
Kết luận
Kiểm tra dựa trên danh mục dr5_... không đơn giản là:
chuyển một số danh sách mã từ Python sang database.
Mục tiêu sâu hơn là:
tách tri thức nghiệp vụ đang thay đổi khỏi logic tính toán cần ổn định.
Sáu catalog chuẩn đảm nhận sáu trách nhiệm khác nhau:
dr5_xml_field
mô tả dữ liệu.
dr5_xml_required
mô tả khi nào dữ liệu bắt buộc.
dr5_xml_relation
mô tả quan hệ giữa dữ liệu.
dr5_catalog_binding
xác định danh mục và phiên bản cần đối chiếu.
dr5_payment_condition
mô tả điều kiện thanh toán thực sự.
dr5_legal_basis
mô tả căn cứ và thời gian áp dụng.
Mười nguyên tắc cần giữ:
Không hard-code từng thuốc, dịch vụ, VTYT hoặc ICD vào source code nếu logic có thể biểu diễn bằng generic implementation và catalog.
Engine phải biết cách kiểm tra; catalog phải cho biết kiểm tra đối tượng nào, với tham số nào và tại thời điểm nào.
Requiredness, relation, catalog membership và payment condition là các lớp tri thức khác nhau, không nên nhập thành một rule monolithic.
Candidate resolver phải xác định đúng catalog, context, facility và event date trước khi generic evaluator chạy.
Code phải được kiểm tra theo catalog/version có hiệu lực tại thời điểm sự kiện, không phải danh mục hiện tại.
dr5_payment_conditionchỉ dành cho điều kiện thanh toán có căn cứ; statistical threshold, benchmark và practice pattern không được đưa vào đó chỉ vì chúng tạo cảnh báo.
Mọi condition chính thức phải truy được tới
dr5_legal_basis; provenance không phải phần trang trí mà là thành phần của rule.
Khi nghiệp vụ thay đổi, tạo version mới và giữ lịch sử; không sửa ngược published record làm mất khả năng tái dựng hồ sơ cũ.
Workflow, owner, SLA, popup, hard stop và analytics configuration thuộc execution layer, không cần tạo thêm catalog nghiệp vụ ngoài sáu catalog chuẩn.
Điều 16 Thông tư 12 vẫn phải được tôn trọng: catalog nội bộ Dr5 không tự trở thành tiêu chí chính thức của Hệ thống thông tin giám định BHYT; nguồn và thẩm quyền của từng rule phải được thể hiện rõ.
Đối với Dr5-XML, kiến trúc này có thể tóm tắt bằng công thức:
**Generic Implementation
- Candidate Resolution
- Versioned Catalog Data
- Evidence
- Legal Provenance
= Explainable Rule Evaluation.**
Và nguyên tắc phát triển dài hạn là:
Nếu thay đổi chỉ là mã, danh mục, ngưỡng, phạm vi áp dụng, thời gian hiệu lực hoặc condition nghiệp vụ đã nằm trong khả năng của engine
→ cập nhật catalog.
Chỉ khi:
xuất hiện một kiểu logic hoàn toàn mới mà generic engine chưa thể biểu diễn
→ mới sửa source code.
Đó là điều kiện để Dr5 có thể phát triển từ vài chục rule thành hàng nghìn rule mà vẫn:
dễ bảo trì;
dễ kiểm thử;
dễ truy vết;
dễ cập nhật pháp lý;
và quan trọng nhất:
không phải sửa mã nguồn mỗi khi một thuốc, một DVKT hoặc một điều kiện nghiệp vụ thay đổi.
- Đăng nhập để gửi ý kiến