Trang Chủ Portal Dự Án Trợ Lý AI Cơ Xương Khớp
Trợ Lý AI Cơ Xương Khớp Tuổi Bạc (CXK)
Hệ thống trí tuệ nhân tạo hỗ trợ người cao tuổi Việt Nam tự quản lý, chăm sóc các vấn đề cơ xương khớp thông thường và nhận diện sớm các dấu hiệu nguy hiểm (red flags) cần đi khám y tế kịp thời.
Triết Lý Thiết Kế & 4 Trụ Cột Cốt Lõi
1. Safety-First (An Toàn Đa Tầng)
Bộ lọc an toàn đa tầng với Pre-check & Post-check nhận diện cờ đỏ khẩn cấp, triệt tiêu nguy cơ chẩn đoán sai hoặc bỏ sót cấp cứu y khoa. Phân loại triage 3 mức GREEN, AMBER, RED.
2. RAG Y Văn Chính Thống
Retrieval-Augmented Generation dựa trên kho tri thức y khoa đã thẩm định: Hướng dẫn BYT QĐ 361, Giáo trình ĐHYHN (104 chương), NICE, ACR/EULAR và Cochrane.
3. Trích Dẫn Minh Bạch (Citations)
Mọi khuyến nghị y khoa đều gắn kèm nguồn dẫn chứng cụ thể từ Ma trận Bằng chứng (Evidence Matrix) và Bộ Thẻ Chứng Cứ (Evidence Cards), đảm bảo độ tin cậy và kiểm chứng được.
4. Accessibility-First (Lão Khoa)
Font chữ lớn tùy biến (Senior Font Resizer), độ tương phản cao đạt chuẩn WCAG 2.2 AA, thao tác tối giản và hỗ trợ tương tác giọng nói hai chiều (Voice STT / TTS tiếng Việt).
📊 Phân Bổ Tri Thức & Tài Liệu
Tỷ trọng 158 tài liệu số hóa theo từng chuyên khoa và phân hệ dự án
⏱️ Lộ Trình 8 Sprint (16 Tuần)
Phân bổ khối lượng công việc và checkpoint 4 Gate kiểm soát
Kiến Trúc Thư Mục 6 Tầng Chuẩn (README.md)
Tài Liệu Dự Án & Nghiên Cứu
Thư mục docs/ gồm 27 tài liệu: Hồ sơ nghiên cứu, Project Charter, Intended Use, Sổ đăng ký rủi ro, 4 Cổng kiểm soát (Gate A-D), Nhật ký NCKH, Báo cáo tuần & slide thuyết trình.
Kho Tri Thức Y Khoa Curated
Thư mục knowledge-base/ gồm 117+ tài liệu: Hướng dẫn BYT QĐ 361, Giáo trình ĐHYHN (104 chương), Bộ 6 Thẻ chứng cứ lâm sàng (Evidence Cards), 50+ FAQ và Ma trận xung đột Guideline.
An Toàn Y Khoa (Safety-First)
Thư mục safety/ gồm: Hiến chương an toàn, Chính sách an toàn đa tầng v0.1, Quy tắc nhận diện cờ đỏ khẩn cấp (Red Flag Rules), Triage protocol (GREEN/AMBER/RED) và Mẫu tuyên bố miễn trừ.
Kỹ Thuật Hệ Thống & API
Gồm 5 phân hệ kỹ thuật: data-pipeline/ (ChromaDB RAG), backend/ (FastAPI), frontend/ (Vue 3 WCAG 2.2), voice/ (STT/TTS tiếng Việt) và telegram-bot/.
Kiểm Thử & Nghiên Cứu Người Dùng
testing/: Khung kiểm thử Benchmark 100 cases, Red team đối kháng y khoa. user-research/: Khảo sát thực địa, phỏng vấn sâu lão khoa, persona và mẫu đồng ý nghiên cứu.
Vận Hành & Triển Khai Doanh Nghiệp
community/: Giáo dục và gắn kết cộng đồng người cao tuổi. deployment/: Cấu hình IIS 10 Reverse Proxy, thiết kế CSDL MSSQL 2022, monitoring và audit log.
Văn Bản Cốt Lõi Tiếp Cận Nhanh (README.md)
| Tên Tài Liệu | Phân Loại | Dung Lượng / Quy Mô | Trọng Tâm | Thao Tác |
|---|---|---|---|---|
| Mục Lục Toàn Bộ Hồ Sơ Nghiên Cứu | Nghiên Cứu | 11 Báo cáo | Mục lục tra cứu toàn bộ đề cương, lộ trình và kết quả NCKH | Xem chi tiết → |
| 02 — Báo Cáo Nghiên Cứu Tổng Thể | Nghiên Cứu | 70 KB (36 nguồn) | Cơ sở khoa học, 7 nhóm bệnh, kiến trúc RAG | Xem chi tiết → |
| 04 — Kế Hoạch Triển Khai 16 Tuần | Lộ Trình | 112 ngày (8 Sprint) | Lộ trình chi tiết từng tuần qua 4 Cổng Gate A → Gate D | Xem chi tiết → |
| 10 — Kiến Trúc Chi Tiết & Kế Hoạch 8 Sprint | Kiến Trúc | 56 KB (1.012 dòng) | Đặc tả 6 tầng, tech stack Windows Server 2022, IIS + MSSQL | Xem chi tiết → |
| 07 — Danh Mục Nguồn Tham Khảo & SHA | Nguồn Y Văn | 36 Nguồn quốc tế | Danh mục y văn quốc tế khôi phục, kiểm tra tính toàn vẹn và SHA | Xem chi tiết → |
| Điều Lệ Dự Án (Project Charter v0.1) | Điều Lệ | 150 dòng | Tuyên ngôn dự án, mục tiêu, MVP 7 bệnh, ma trận RACI | Xem chi tiết → |
| Mục Đích Sử Dụng & Giới Hạn (Intended Use) | Pháp Lý | 10 điều cấm | Ranh giới AI y khoa, tuân thủ Luật KCB 15/2023 & BVDL 91/2025 | Xem chi tiết → |
| Hướng Dẫn Chẩn Đoán & Điều Trị CXK (QĐ 361) | Bộ Y Tế | 540 KB (Toàn văn) | Kim chỉ nam y khoa chính thống Bộ Y tế Việt Nam | Xem chi tiết → |
| Thẻ Chứng Cứ: Thoái Hóa Khớp Gối | Chứng Cứ | Thẻ EC-001 | Chứng cứ lâm sàng, triệu chứng, tự chăm sóc thoái hóa khớp gối | Xem chi tiết → |
| 50+ Câu Hỏi Thường Gặp Về CXK (FAQ) | Hỏi Đáp | 50+ Q&A | Phân loại theo Action Class (EDU, SELFCARE, CLINICIAN, URGENT) | Xem chi tiết → |
| Tầng 3: An Toàn Y Khoa (Safety Charter) | An Toàn | Quy chuẩn Gate C | Pre/Post check, bộ lọc cờ đỏ, triage protocol | Xem chi tiết → |
| Sổ Đăng Ký Rủi Ro (Risk Register) | Rủi Ro | 18 Rủi ro | Ma trận định lượng rủi ro lâm sàng, pháp lý, UX và kỹ thuật | Xem chi tiết → |
Hạ Tầng Kỹ Thuật & Khởi Động (README.md Quickstart)
💻 Yêu Cầu Môi Trường
- Ngôn ngữ: Python 3.11+ & Node.js 18+ (Frontend Vue 3)
- Hệ điều hành: Windows Server 2022 / Windows 10/11
- Web Server: IIS 10 + URL Rewrite Module + Application Request Routing (ARR 3.0)
- Cơ sở dữ liệu: MSSQL Server 2022 (Audit Log, Session, User Data)
- Vector Store: ChromaDB / FAISS nội bộ phục vụ RAG
⚡ Cài Đặt Môi Trường Python
python -m venv .venv
.venv\Scripts\activate
pip install -e .
Xem hướng dẫn chi tiết tại: Hướng Dẫn Cấu Hình IIS 10 & Reverse Proxy FastAPI →
Khuyến Cáo & Miễn Trừ Trách Nhiệm Y Khoa
Hệ thống Trợ lý AI đóng vai trò hỗ trợ giáo dục sức khỏe và hướng dẫn tự chăm sóc hệ vận động. AI không thay thế chẩn đoán hoặc chỉ định điều trị của bác sĩ chuyên khoa. Khi xuất hiện các triệu chứng cờ đỏ (sốt, sụt cân, đau dữ dội, mất kiểm soát tiêu tiểu), người bệnh cần đến ngay cơ sở y tế gần nhất.