Trợ lý AI Cơ Xương Khớp Tuổi Bạc (CXK)

NCS1: Võ Trần Gia Hiếu · NCS2: Đỗ Đoàn Anh Tuấn · Lớp 10A6, PTTH Xuân Đỉnh.
: · : Nguyễn Đảm · Bảo trợ: Công ty Vaga.
Cập nhật 26/09/2026. Dự án nghiên cứu, chưa được phép phục vụ hỏi đáp sức khỏe thật.

1. Hiện trạng có bằng chứng

Mục tiêu là nghiên cứu trợ lý hỗ trợ người cao tuổi tìm hiểu cách chăm sóc .
Mục tiêu này không phải tuyên bố hệ thống đã hoạt động hoặc bảo đảm an toàn.

Thành phần Đã có Chưa có hoặc chưa được phép
Backend ngoại tuyến; kiểm tra tiến trình và từ chối cố định Mô hình, bộ lọc y khoa, nạp tri thức, lưu hội thoại
Frontend Vue mô phỏng nội bộ; ba nút mẫu, chỉnh chữ, test và build Giao diện hỏi đáp thật, kết nối , kiểm thử người dùng
Tri thức KC/FAQ/EC dự thảo; công cụ kiểm đệ quy Gói tri thức được duyệt để trả lời thật
Công cụ Kiểm , cấu trúc, thuật ngữ, liên kết có kiểm thử Kiểm chứng y khoa, pháp lý hoặc toàn bộ tính đúng của nguồn
Camera, voice, Telegram Tài liệu; camera có đặc tả kỹ thuật chờ GCA Truy cập thiết bị, triển khai hoặc thử trên người
/ Script và hướng dẫn cũ Bằng chứng triển khai, quyền truy cập và phục hồi
HTML Website tài liệu dẫn xuất có từ trước Quyền công bố toàn kho hoặc bộ sinh đã lọc đủ nội dung

/api/health trả 200 chỉ chứng minh tiến trình phản hồi.
/api/readiness và yêu cầu hợp lệ tới /api/chat luôn trả 503 trong bản ngoại tuyến.
Không gọi dịch vụ khi điều kiện tuổi, chủ thể và mục đích chưa rõ, kể cả bằng dữ liệu giả.

2. Cấu trúc đang có

Tầng Vị trí Vai trò
Tài liệu docs/ Nghiên cứu, quản trị, pháp lý, nhật ký và hướng dẫn
Tri thức knowledge-base/ Nguồn, thẻ, FAQ, schema và
An toàn safety/ Chính sách nháp, sổ rủi ro, ca kiểm thử
Kỹ thuật backend/, frontend/, data-pipeline/, voice/, telegram-bot/ Mức triển khai khác nhau, xem bảng hiện trạng
Kiểm thử testing/, backend/tests/, user-research/ Test mã và tài liệu nghiên cứu người dùng
Vận hành deployment/, community/ Hướng dẫn; chưa xác nhận vận hành thật
Công cụ tools/, .agents/ Kiểm tra và tự động hóa có giới hạn

Không coi thư mục đề xuất trong kiến trúc là thành phần đã được tạo.
Giữ nguồn y khoa nguyên bản. Không dùng nhãn DRAFT làm bằng chứng được phép trả lời.

3. Điểm bắt đầu

  1. Đọc sổ theo dõi T01–T20 để biết phần đã làm và phần bị chặn.
  2. Kiểm tra Q01–Q08, không dùng kết quả test để đóng quyết định con người.
  3. Làm theo môi trường và đóng góp; không cần cài SDK nhà cung cấp để kiểm thử.
  4. Đọc hợp đồng API ngoại tuyến trước khi dùng dữ liệu tổng hợp.
  5. Không sinh trang trước khi đáp ứng quy trình xuất bản HTML.
  6. Thử giao diện mô phỏng và đọc hướng dẫn; không nhập dữ liệu thật.

Python khai báo từ 3.11; phiên này kiểm thử trên 3.14.3, chưa xác nhận các phiên bản khác.
Lệnh python -m pytest -q phải dùng môi trường được chọn; không tự cài tất cả gói tùy chọn.
Windows có tools/KIEM_TRA_CXK.ps1 -TestsOnly; lệnh không kèm cờ này kiểm tra dữ liệu thực.
tools/KIEM_TRA_MOI_TRUONG_SACH.ps1 đã kiểm cài sạch Python trong TEMP; cần PyPI, không thay .venv hiện có.
tools/KIEM_TRA_FRONTEND.ps1 kiểm frontend trên bản sao cục bộ bằng npm ci, test và build, rồi dọn bản sao.
Kiểm tra dữ liệu thực có thể trả lỗi vì phát hiện nội dung chưa hoàn chỉnh. Không sửa dữ liệu để che lỗi công cụ.

4. Tài liệu tham chiếu

tự thực hiện phần nghiên cứu bắt buộc.
Mọi phê duyệt y khoa, pháp lý và thuộc người có thẩm quyền.