| Hạng mục | Giá trị |
|---|---|
| Mã tài liệu | san-pham-benh-nhan-ao |
| Cập nhật | 08/11/2026 |
| Người tổng hợp | Hỗ 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 quan | de-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.
---
| Mã | Nội dung | Sản phẩm đóng góp gì |
|---|---|---|
| OS2 | Sinh 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án | Sả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 |
| OS1 | Giả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ành | Cô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 |
| OS3 | Hợp tác Pháp–Việt, chuyển giao năng lực thực chất | Cù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ộng | Nhậ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 |
| R1 | Nề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ỏng | Nhậ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) |
| R4 | Module MRC được công nhận + tài liệu hướng dẫn | Sả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ọc | Bộ số liệu phiên + điểm + khảo sát dùng lại được cho phân tích |
| Chỉ số | Yêu cầu | Sản phẩm đang có | Còn thiếu để điền số |
|---|---|---|---|
| 1.1.1 | Nề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ạo | Biên bản nghiệm thu (việc hành chính, không phải kỹ thuật) |
| 1.1.2 | Tỷ lệ sẵn sàng (uptime) ≥99% | Có nhật ký máy chủ, không có công cụ tính uptime riêng | Bật giám sát theo tháng + mẫu báo cáo uptime (G9) |
| 1.2.1 | Số ca bệnh song ngữ vi/fr được thẩm định chung | 300 ca, tất cả tiếng Việt | Dịch + thẩm định Pháp–Việt ≥100 ca; giao diện đã nhận tham số ngôn ngữ (G2) |
| 1.2.2 | Tỷ 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 GEEIE | Lưới nhãn + công cụ gắn nhãn + biên bản thẩm định (G3) |
| 2.1 | Tỷ 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ệm | Chư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.1 | Số 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.3 | Tỷ lệ sinh viên hài lòng | Có 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) |
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ảng | Dùng để đếm |
|---|---|
chat_logs | Mọi tin nhắn hỏi–đáp: số phiên, số lượt, thời điểm, ca bệnh |
patient_assignments | Phâ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_responses | Mức hài lòng |
chamilo_classes, chamilo_class_members | Lớp và thành viên đồng bộ từ hệ thống đào tạo |
sso_sync_log, activity_logs, bug_reports | Truy 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).
| Việc | Phụ trách |
|---|---|
| Nội dung ca bệnh, thẩm định chuyên môn, nhãn GEEIE | Chuyên gia lâm sàng UPNT + chuyên gia CHU Angers |
| Giao ca, chấm, phản hồi sinh viên | Giả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ời | Kỹ 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) |
---
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.
| Thành phần | Vị 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ệnh | patient_data/patients/.json (300 ca), patient_data/clinical/.clinical.json (298 hồ sơ + 5 bộ tham chiếu) |
| Cơ sở dữ liệu phiên | pnt_bnao_yhgd (máy 244) |
| Công cụ soạn ca cho chuyên gia | MCP 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 |
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).
dấu chứng cơ năng, dấu chứng quan sát, dấu chứng thực thể, cận lâm sàng (ảnh, âm thanh, video, giá trị số).
<mã ca>.clinical.json) là danh mục ~800–900 mục/ca; phần lớn đểtrống vì danh mục dùng chung.
nam/nữ lớn tuổi (≥60).
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.
dấu chứng quan sát có chữ mô tả hướng nhìn bị thay bằng ảnh của bộtham chiếu (bản đồ vùng cơ thể), vì ảnh dùng để dạy khám.
Đ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ắc | Trạ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ước | 1/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.
| Vai trò | Quyền chính |
|---|---|
| Sinh viên | Nhậ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ên | Giao 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).
| Hạng mục | Giá trị |
|---|---|
| Máy ứng dụng | 192.168.1.245 (Apache + PHP 8.3-FPM) |
| Máy mô phỏng | 192.168.1.250, dịch vụ :8025, GPU |
| Khởi động lại dịch vụ mô phỏng | cd ~/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ống | curl http://127.0.0.1:8025/health (máy 250) |
| Thay đổi giao diện | sử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ưu | theo 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 |
đã được che khi trả lời.
trang dữ liệu đều yêu cầu đăng nhập.
---
| Chỉ số vận hành | Giá trị |
|---|---|
| Ca bệnh trong kho | 300 |
| Hồ sơ lâm sàng chi tiết | 298 ca + 5 bộ giá trị tham chiếu |
| Mục dữ liệu lâm sàng | 249.663 (93,2% theo giá trị tham chiếu, 0 ô trống) |
| Tài khoản người dùng | 13.191 |
| Lớp đã đồng bộ từ hệ thống đào tạo | 92 |
| Lượt phân công ca cho sinh viên | 4.732 |
| Phiên hỏi bệnh thực tế | 438 |
| Tin nhắn trong các phiên | 17.547 (từ 08/12/2025 đến 08/11/2026) |
| Lượt làm trắc nghiệm | 8.438 |
| Phiếu đánh giá phiên | 19 |
| Bảng hỏi hài lòng | 2 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ất | 108 lượt/6 ca: 1 cảnh báo (dương tính giả) |
---
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).
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.
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.
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.
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.
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.
sessions rỗng, dễ gây báo cáo sai — ưu tiên trung bìnhHiệ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.
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.
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ỳ.
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ủ.
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.
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.
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.
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.
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.
---
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.