← Danh mục tài liệu · raw markdown

SẢN PHẨM: BỆNH NHÂN ẢO PHỤC VỤ ĐÀO TẠO LÂM SÀNG

Hạng mụcGiá trị
Mã tài liệusan-pham-benh-nhan-ao
Cập nhật08/11/2026
Người tổng hợpHỗ trợ kỹ thuật (Hermes), từ khảo sát trực tiếp hệ thống đang chạy
Trạng thái sản phẩmĐang vận hành thật, có người dùng thật
Địa chỉhttps://dv.badt.vn/ai/virtualpatient (sau đăng nhập)
Tài liệu liên quande-an (mốc/chỉ số), mcp-benh-nhan (công cụ soạn ca), thiet-ke (thiết kế hệ thống quản trị)

Tài liệu này mô tả sản phẩm bệnh nhân ảo theo ba góc mà đội dự án cần: (1) sản phẩm thực thi

mục tiêu nào và sinh ra số liệu gì, (2) mô tả kỹ thuật để bàn giao/vận hành, (3) danh sách phần

chưa hoàn thiện để làm tiếp. Con số trong tài liệu là số đo trên hệ thống ngày 08/11/2026,

không phải số trong hồ sơ đề án.

---

PHẦN A — SẢN PHẨM GẮN VỚI MỤC TIÊU DỰ ÁN NHƯ THẾ NÀO

A.1. Mục tiêu và kết quả mà sản phẩm trực tiếp phục vụ

MãNội dungSản phẩm đóng góp gì
OS2Sinh viên y khoa (năm 4–6) cải thiện năng lực lập luận lâm sàng và ra quyết định chẩn đoánSản phẩm chính: sinh viên hỏi bệnh với bệnh nhân ảo theo ca được giao, tự tra dữ liệu lâm sàng, chốt chẩn đoán; giảng viên chấm và phản hồi
OS1Giảng viên UPNT và bác sĩ hành nghề nâng năng lực sư phạm, tự chủ vận hànhCông cụ giảng viên: giao ca, xem phiên, chấm theo tiêu chí, xuất báo cáo, đường dẫn tài liệu tham khảo
OS3Hợp tác Pháp–Việt, chuyển giao năng lực thực chấtCùng một kho ca bệnh cho hai bên cùng soạn/thẩm định; công cụ soạn ca qua MCP để chuyên gia Pháp làm việc từ xa
OS4Đánh giá tác động, tài liệu hoá, chuẩn bị mở rộngNhật ký phiên, điểm, khảo sát, nhật ký thao tác — nguồn số liệu cho đánh giá pre/post và mở rộng
R1Nền tảng G-NI + ≥100 ca bệnh song ngữNền tảng đã chạy; kho ca 300 ca nhưng chưa song ngữ (xem Ghi chú G2)
R3≥500 sinh viên dùng mô phỏngNhật ký phiên và phân công ca đã có, nhưng chưa có truy vấn chuẩn để đếm (xem Ghi chú G5)
R4Module MRC được công nhận + tài liệu hướng dẫnSản phẩm là nơi chạy thực hành của module; tài liệu hướng dẫn sinh viên/giảng viên đã có trong ứng dụng
R6Đánh giá cuối kỳ, công bố khoa họcBộ số liệu phiên + điểm + khảo sát dùng lại được cho phân tích

A.2. Chỉ số sản phẩm phải sinh ra — hiện có gì, còn thiếu gì

Chỉ sốYêu cầuSản phẩm đang cóCòn thiếu để điền số
1.1.1Nền tảng triển khai, truy cập trực tuyến (đúng/sai)Đang chạy công khai, có đăng nhập và đồng bộ tài khoản từ hệ thống đào tạoBiên bản nghiệm thu (việc hành chính, không phải kỹ thuật)
1.1.2Tỷ lệ sẵn sàng (uptime) ≥99%Có nhật ký máy chủ, không có công cụ tính uptime riêngBật giám sát theo tháng + mẫu báo cáo uptime (G9)
1.2.1Số ca bệnh song ngữ vi/fr được thẩm định chung300 ca, tất cả tiếng ViệtDịch + thẩm định Pháp–Việt ≥100 ca; giao diện đã nhận tham số ngôn ngữ (G2)
1.2.2Tỷ lệ ca gắn nhãn GEEIE (giới, công bằng, đạo đức, hoà nhập, môi trường)Ca bệnh có giới, tuổi, nghề nghiệp; chưa có nhãn GEEIELưới nhãn + công cụ gắn nhãn + biên bản thẩm định (G3)
2.1Tỷ lệ sinh viên cải thiện điểm chẩn đoán (delta ≥25%)Có điểm chấm phiên và 8.438 lượt làm trắc nghiệmChưa có cặp pre/post gắn cùng một sinh viên và chưa có báo cáo delta (G4)
3.1.1Số sinh viên dùng mô phỏng (≥500)4.732 lượt phân công ca, 438 phiên hỏi bệnh, 13.191 tài khoản, 92 lớp đã đồng bộChốt định nghĩa "đã dùng" (hoàn thành ≥1 buổi) và viết truy vấn chuẩn (G5)
3.1.3Tỷ lệ sinh viên hài lòngCó mô-đun khảo sát trong ứng dụng, mới 2 bảng hỏi / 1 phản hồiĐưa khảo sát vào quy trình sau mỗi buổi + ngưỡng thu tối thiểu (G12)

A.3. Cách lấy số (dùng cho báo cáo mốc)

Nguồn dữ liệu sản phẩm nằm ở cơ sở dữ liệu pnt_bnao_yhgd (máy 244); bảng dùng thật:

BảngDùng để đếm
chat_logsMọi tin nhắn hỏi–đáp: số phiên, số lượt, thời điểm, ca bệnh
patient_assignmentsPhân công ca cho sinh viên, hoàn thành, chẩn đoán cuối, điểm chấm
quiz_resultsĐiểm trắc nghiệm (dùng cho pre/post)
session_ratings, surveys, survey_responsesMức hài lòng
chamilo_classes, chamilo_class_membersLớp và thành viên đồng bộ từ hệ thống đào tạo
sso_sync_log, activity_logs, bug_reportsTruy vết đăng nhập, thao tác, lỗi người dùng báo

Lưu ý: bảng sessions tồn tại nhưng rỗng (0 dòng) — dữ liệu phiên thật nằm ở chat_logs.

Đừng viết báo cáo dựa trên sessions (xem G6).

A.4. Phân vai

ViệcPhụ trách
Nội dung ca bệnh, thẩm định chuyên môn, nhãn GEEIEChuyên gia lâm sàng UPNT + chuyên gia CHU Angers
Giao ca, chấm, phản hồi sinh viênGiảng viên đã được tập huấn
Vận hành máy chủ, bản vá, chất lượng câu trả lờiKỹ thuật (3 chuyên gia UPNT theo mốc M4)
Tổng hợp số liệu mốcĐiều phối dự án (dùng mục A.3)

---

PHẦN B — MÔ TẢ KỸ THUẬT SẢN PHẨM

B.1. Kiến trúc hai tầng

Trình duyệt (điện thoại/máy tính)
   │ HTTPS
   ▼
[Máy 245] Ứng dụng web PHP 8.3 (Apache)      ← giao diện, đăng nhập, giao ca, chấm, dữ liệu lâm sàng
   │ HTTP nội bộ (LAN)
   ▼
[Máy 250] Dịch vụ mô phỏng FastAPI :8025      ← dựng lời nhắc, gọi mô hình, hậu kỳ câu trả lời
   │
   ├─► :8094 mô hình lớn (Qwen3-14B, ưu tiên số 1)
   ├─► :8091 Qwen2.5-7B (dự phòng, ngữ cảnh 12.288 token)
   └─► :8092 Gemma-4-E2B (dự phòng cuối)

Tách hai tầng để: sửa giao diện không ảnh hưởng chất lượng trả lời; thay mô hình không cần

triển khai lại ứng dụng web; máy 250 hỏng thì ứng dụng web vẫn hiển thị được ca bệnh và báo lỗi

rõ ràng thay vì treo.

B.2. Thành phần và đường dẫn

Thành phầnVị trí
Ứng dụng web/var/www/html/dv.badt.vn/public_html/ai/virtualpatient (máy 245, PHP 8.3-FPM + Apache)
Dịch vụ mô phỏng~/llm_research/llm_project/medical_patient_simulator (máy 250, Python + FastAPI, cổng 8025)
Kho ca bệnhpatient_data/patients/.json (300 ca), patient_data/clinical/.clinical.json (298 hồ sơ + 5 bộ tham chiếu)
Cơ sở dữ liệu phiênpnt_bnao_yhgd (máy 244)
Công cụ soạn ca cho chuyên giaMCP tools/vp_mcp.py, CLI tools/vp_cli.py — xem tài liệu mcp-benh-nhan
Nhật kýmáy 245: /var/log/apache2/; máy 250: /tmp/vp.log, logs/server.log

B.3. Một lượt hỏi–đáp đi qua đâu

1. Sinh viên gõ câu hỏi (hoặc dùng gợi ý câu hỏi có sẵn).

2. process_chat.php kiểm phiên, đếm lượt chỉ theo tin của sinh viên, lấy 8 tin gần nhất

(4 cặp hỏi–đáp) làm lịch sử, ghi câu hỏi vào chat_logs.

3. Gọi POST /chat sang máy 250 kèm mã ca, câu hỏi, lịch sử, ngôn ngữ.

4. Máy 250 dựng lời nhắc: thẻ nhân vật (tuổi, giới, nghề, hoàn cảnh, mức hiểu biết) + hồ sơ ca +

luật trả lời; chọn mô hình theo thứ tự ưu tiên; sinh câu trả lời.

5. Hậu kỳ tất định (không phải mô hình): chuẩn hoá cách nói, khoá cách tự xưng đúng nhân vật,

che tên người thân, đồng bộ tình trạng hôn nhân với hồ sơ, chặn đọc kết quả xét nghiệm,

bỏ câu rỗng/lặp, giữ mốc thời gian lấy từ hồ sơ.

6. Trả về, ghi vào chat_logs, hiện bong bóng trả lời. Ở lượt 10/20/30/40 có nhắc sinh viên về

thời lượng; một lần duy nhất ở lượt 50 có thông báo kết thúc phiên.

7. Sinh viên chốt chẩn đoán (submit_session.php) → ghi vào phân công; giảng viên chấm

(instructor/grade_session.php) và xuất báo cáo (instructor/export_report.php).

B.4. Dữ liệu ca bệnh

dấu chứng thực thể, cận lâm sàng (ảnh, âm thanh, video, giá trị số).

trống vì danh mục dùng chung.

nam/nữ lớn tuổi (≥60).

B.5. Quy ước giá trị tham chiếu (quan trọng khi đọc bảng lâm sàng)

Quy ước nghiệp vụ: mục nào hồ sơ ca bệnh không có hoặc để trống thì hiển thị theo

giá trị tham chiếu chuẩn, coi như kết quả bình thường của ca; mục nào ca có giá trị riêng thì

giá trị riêng thắng.

Đo trên 249.663 mục: 93,2% lấy từ bộ tham chiếu, 3,3% giữ giá trị riêng của ca, 3,1% bị

lớp "sự thật ca bệnh" sửa lại theo lời kể của bệnh nhân, 0% còn ô trống (mục mà cả hai nguồn

đều không có giá trị thì không hiển thị).

Hai lớp chạy sau khi gộp, cần biết để không báo nhầm là lỗi:

nhồi máu cơ tim: danh mục ghi "đau ngực chỉ khi chấn thương" → sửa thành "đau ngực trái lan ra

cánh tay trái, cổ, hàm". Trên toàn kho: 7.670 mục được sửa như vậy.

tham chiếu (bản đồ vùng cơ thể), vì ảnh dùng để dạy khám.

B.6. Quy tắc chất lượng câu trả lời (đã hiệu chỉnh, có đo)

Đo bằng bộ kiểm thử 6 ca × 18 lượt liên tiếp (108 lượt), chấm tự động 9 loại lỗi:

Quy tắcTrạng thái
Không đọc kết quả xét nghiệm, hình ảnhĐạt 100% lượt kiểm
Không bịa dấu chứng thực thể khi sinh viên xin khámĐạt; bệnh nhân đồng ý cho khám và chỉ nói cảm giác
Không lộ từ khoá về bản chất hệ thốngĐạt
Chặn thông tin định danh (họ tên, địa chỉ)Đạt
Không lặp lại câu trả lời trước1/108 lượt bị cảnh báo, là dương tính giả (ca trẻ em: lý do khám và mốc khởi phát trùng nội dung)
Không dùng số liệu không có trong hồ sơĐạt
Không lẫn tiếng khác, không markdown, không quá dàiĐạt
Tự xưng đúng nhân vật (tôi/em/cháu/con)Đạt
Không mở đầu giống nhau mọi lượtĐã sửa: sau 4 lượt liên tiếp mở bằng "Dạ" thì lượt sau nói thẳng vào việc

Thời gian trả lời trung bình 4–10 giây/lượt tùy câu hỏi ngắn hay dài.

B.7. Người dùng, phân quyền, tích hợp

Vai tròQuyền chính
Sinh viênNhận ca được giao, hỏi bệnh, tra dữ liệu lâm sàng, chốt chẩn đoán, xem lại phiên, làm trắc nghiệm
Giảng viênGiao ca, xem danh sách phiên, chấm theo tiêu chí, phản hồi, xuất báo cáo, xem tiến độ lớp
Quản trịQuản lý người dùng, ca bệnh, cấu hình, nhật ký, báo lỗi

Tích hợp đang chạy: đăng nhập một lần và đồng bộ tài khoản/lớp từ hệ thống đào tạo

(Chamilo, sso/), công cụ soạn ca qua MCP cho chuyên gia Pháp, đường dẫn tài liệu tham khảo

gắn theo ca (reference_links), báo lỗi trong ứng dụng (bug_reports).

B.8. Hạ tầng và vận hành

Hạng mụcGiá trị
Máy ứng dụng192.168.1.245 (Apache + PHP 8.3-FPM)
Máy mô phỏng192.168.1.250, dịch vụ :8025, GPU
Khởi động lại dịch vụ mô phỏngcd ~/llm_research/llm_project/medical_patient_simulator && ./stop.sh && ./start.sh (chạy 1 tiến trình, semaphore nội bộ)
Kiểm tra sốngcurl http://127.0.0.1:8025/health (máy 250)
Thay đổi giao diệnsửa PHP → php -l → sudo systemctl reload php8.3-fpm (bắt buộc, nếu không sẽ chạy mã cũ)
Sao lưutheo lịch chung của cụm (máy 239); dữ liệu phiên nằm trong bản sao lưu cơ sở dữ liệu

B.9. Bảo mật dữ liệu y tế

đã được che khi trả lời.

trang dữ liệu đều yêu cầu đăng nhập.

---

PHẦN C — HIỆN TRẠNG ĐO ĐƯỢC (08/11/2026)

Chỉ số vận hànhGiá trị
Ca bệnh trong kho300
Hồ sơ lâm sàng chi tiết298 ca + 5 bộ giá trị tham chiếu
Mục dữ liệu lâm sàng249.663 (93,2% theo giá trị tham chiếu, 0 ô trống)
Tài khoản người dùng13.191
Lớp đã đồng bộ từ hệ thống đào tạo92
Lượt phân công ca cho sinh viên4.732
Phiên hỏi bệnh thực tế438
Tin nhắn trong các phiên17.547 (từ 08/12/2025 đến 08/11/2026)
Lượt làm trắc nghiệm8.438
Phiếu đánh giá phiên19
Bảng hỏi hài lòng2 bảng, 1 phản hồi
Mô hình đang phục vụQwen3-14B (ưu tiên), Qwen2.5-7B, Gemma-4-E2B (dự phòng)
Kiểm thử chất lượng gần nhất108 lượt/6 ca: 1 cảnh báo (dương tính giả)

---

PHẦN D — GHI CHÚ: PHẦN CHƯA HOÀN THIỆN (để làm sau)

Mỗi mục ghi rõ: hiện trạng → vì sao quan trọng → cách làm → gợi ý phụ trách. Thứ tự theo mức ưu

tiên đối với chỉ số dự án. Chưa mục nào trong danh sách này được đưa lên bảng công việc, để đội

dự án tự xếp lịch (tránh làm thay đổi tiến độ đang báo cáo).

G1. Bộ giá trị tham chiếu trẻ em đang là bản sao của người lớn — ưu tiên cao

Hiện trạng: so 791 mục giữa bộ "trẻ em" và "nam trưởng thành" chỉ khác 6 mục. Nghĩa là ca trẻ em

được điền creatinine 0,75 mg/dL, mạch 80 lần/phút, nhịp thở 16 lần/phút — với trẻ 3 tuổi đây là giá

trị bất thường, sinh viên có thể chẩn đoán sai. Ảnh hưởng 30 ca trẻ em.

Vì sao quan trọng: quy ước "thiếu thì lấy giá trị chuẩn" chỉ đúng nếu giá trị đó thật sự bình

thường theo tuổi; sai chuẩn nhi sẽ phản tác dụng sư phạm.

Cách làm: hiệu chỉnh theo nhóm tuổi (0–1, 1–5, 6–10, 11–14) cho các mục nhạy cảm: creatinine,

urê, huyết sắc tố, bạch cầu, tiểu cầu, glucose, mạch, nhịp thở, huyết áp, cân nặng/chiều cao; cần

chuyên gia nhi duyệt trước khi áp dụng.

Phụ trách: chuyên gia nhi UPNT + kỹ thuật.

G2. Chưa có ca bệnh song ngữ vi/fr — ưu tiên cao (chỉ số 1.2.1)

Hiện trạng: 300 ca đều tiếng Việt. Giao diện và dịch vụ đã nhận tham số ngôn ngữ (vi/en/fr),

nhưng nội dung hồ sơ và lời nhắc chỉ tiếng Việt.

Vì sao quan trọng: R1 yêu cầu ≥100 ca song ngữ được thẩm định chung Pháp–Việt; đây là chỉ số

đang bằng 0.

Cách làm: chọn 100 ca ưu tiên → dịch hồ sơ (có từ điển thuật ngữ để giữ đúng tên bệnh, xét

nghiệm) → chuyên gia hai bên thẩm định từng ca và ghi biên bản → đánh dấu ca đã song ngữ trong dữ

liệu để đếm được tự động.

Phụ trách: điều phối dự án + chuyên gia CHU Angers + kỹ thuật.

G3. Chưa gắn nhãn GEEIE cho ca bệnh — ưu tiên cao (chỉ số 1.2.2)

Hiện trạng: ca bệnh có giới, tuổi, nghề nghiệp nhưng không có trường nhãn giới/công

bằng/đạo đức/hoà nhập/môi trường.

Cách làm: chốt lưới nhãn với chuyên gia GEEIE → thêm trường nhãn vào hồ sơ ca → công cụ gắn

nhãn (có thể làm ngay trong trang quản lý ca) → xuất báo cáo tỷ lệ ca có nhãn.

Phụ trách: chuyên gia GEEIE + kỹ thuật.

G4. Chưa có cặp điểm pre/post và báo cáo delta — ưu tiên cao (chỉ số 2.1)

Hiện trạng: có điểm chấm phiên và 8.438 lượt trắc nghiệm, nhưng không có cặp "trước/sau" gắn

cùng một sinh viên, nên chưa tính được tỷ lệ cải thiện ≥25%.

Cách làm: đánh dấu bài đánh giá là pre hay post (thêm loại bài), gắn cùng sinh viên, viết báo

cáo delta theo lớp/năm học/giới, xuất được tệp để nộp kèm báo cáo mốc.

Phụ trách: kỹ thuật + điều phối dự án.

G5. Chưa chốt định nghĩa "sinh viên đã dùng mô phỏng" — ưu tiên trung bình (chỉ số 3.1.1)

Hiện trạng: 4.732 lượt phân công, 438 phiên hỏi bệnh, 13.191 tài khoản. Nếu đếm theo tài khoản

sẽ phóng đại; nếu đếm theo phiên sẽ thiếu người.

Cách làm: chốt định nghĩa (ví dụ: có ≥1 phiên ≥10 lượt hỏi trong một ca được giao) → viết một

truy vấn chuẩn, lưu thành báo cáo cố định để mọi mốc dùng cùng một cách đếm.

Phụ trách: điều phối dự án + kỹ thuật.

G6. Bảng sessions rỗng, dễ gây báo cáo sai — ưu tiên trung bình

Hiện trạng: bảng sessions có 0 dòng; toàn bộ dữ liệu phiên thật nằm ở chat_logs.

Cách làm: ghi chú rõ trong tài liệu báo cáo (đã ghi ở A.3) và, khi có điều kiện, tạo khung nhìn

(view) tổng hợp từ chat_logs để người làm báo cáo không chọn nhầm bảng.

G7. Còn 15 phiên cũ có dòng "kết thúc phiên" lặp — ưu tiên thấp

Hiện trạng: lỗi đếm lượt cũ đã sửa (phiên mới chỉ có một thông báo ở lượt 50), nhưng dữ liệu

lịch sử vẫn còn 15 phiên có nhiều dòng trùng.

Cách làm: nếu cần số liệu sạch cho phân tích, lọc bỏ các dòng thông báo hệ thống khi truy vấn,

hoặc dọn một lần có sao lưu trước.

G8. Tài khoản thử nghiệm còn sót — ưu tiên thấp

Hiện trạng: tài khoản tmp_vidview (mã 13322, tạo 01/11/2026) dùng để thử tính năng xem video.

Cách làm: xoá khi rà soát người dùng định kỳ.

G9. Chưa có báo cáo uptime tự động — ưu tiên trung bình (chỉ số 1.1.2)

Cách làm: bật kiểm tra định kỳ 1 phút/lần, ghi nhật ký, xuất báo cáo tháng (thời gian sống,

số lần gián đoạn, nguyên nhân). Có thể dùng công cụ giám sát sẵn có của cụm máy chủ.

G10. Bộ kiểm thử chất lượng chưa chạy tự động — ưu tiên trung bình

Hiện trạng: bộ 108 lượt (6 ca × 18 câu) hiện chạy tay sau mỗi lần sửa.

Cách làm: đưa vào lịch chạy hằng tuần, lưu kết quả theo ngày để làm minh chứng chất lượng và

phát hiện sớm khi thay mô hình.

G11. Chưa đo tải khi nhiều lớp cùng giờ — ưu tiên trung bình

Hiện trạng: dịch vụ mô phỏng chạy một tiến trình, giới hạn đồng thời theo tiến trình; chưa có

số đo khi ≥4 lớp thực hành cùng lúc.

Cách làm: đo tải với 30–50 người dùng đồng thời, xác định ngưỡng, ghi lại cấu hình an toàn.

G12. Khảo sát hài lòng chưa thành quy trình — ưu tiên trung bình (chỉ số 3.1.3)

Hiện trạng: mô-đun khảo sát có sẵn nhưng mới 2 bảng hỏi, 1 phản hồi.

Cách làm: bật khảo sát sau mỗi buổi (3–5 câu), đặt nhắc nhở cho giảng viên, chốt ngưỡng tối

thiểu (ví dụ ≥30% sinh viên tham gia) để số liệu dùng được cho báo cáo.

G13. Xét nghiệm chỉ hiển thị một giá trị chuẩn, chưa có khoảng tham chiếu — ưu tiên thấp

Hiện trạng: mỗi mục có một giá trị bình thường; sinh viên phải tự nhớ khoảng bình thường để

nhận ra bất thường.

Cách làm: bổ sung khoảng tham chiếu (thấp–cao) cho các xét nghiệm thường dùng và đánh dấu

cao/thấp khi giá trị của ca nằm ngoài khoảng.

G14. Tên mô hình ở một cổng không khớp thực tế — ưu tiên thấp (kỹ thuật)

Hiện trạng: cổng 8094 khai báo tên medgemma-1.5-4b-it nhưng thực chạy Qwen3-14B. Dễ cấu hình

nhầm khi bàn giao.

Cách làm: đặt lại tên hiển thị đúng mô hình đang chạy và ghi vào tài liệu vận hành.

---

PHẦN E — CÁCH CẬP NHẬT TÀI LIỆU NÀY

1. Sửa tệp docs/SAN_PHAM_BENH_NHAN_AO.md trong kho mã dự án, giữ nguyên cấu trúc A–D.

2. Xoá mục Ghi chú khi đã hoàn thành (hoặc đánh dấu [xong dd/mm/yyyy]), không để tồn tại mục đã

xử lý — danh sách ghi chú phải phản ánh đúng việc còn lại.

3. Cập nhật lại bảng số liệu Phần C bằng số đo mới, ghi rõ ngày đo.

4. Triển khai theo quy trình: bash deploy.sh → mở /docs/san-pham-benh-nhan-ao kiểm tra.