> ⚠️ Lưu trữ: Prompt này được viết cho kiến trúc v4.0. Kiến trúc hiện tại là v5.0 (Context Loading, 21 tuần).

PROMPT: Deep Research — Kiến trúc Project và Kế hoạch Triển khai Trợ lý AI Cơ Xương Khớp

Loại: Prompt deep research + architecture design + academic presentation planning
Target: Agent có khả năng đọc file, phân tích, và tạo deliverable
Phiên bản: 2.0 (nâng cấp từ v1.0 ngày 23/09/2026)
Ngày cập nhật: 23/09/2026
Workspace: CXK/ (project root)

Bối cảnh

Dự án "Trợ lý AI hỗ trợ người cao tuổi tự chăm sóc hệ vận động (cơ – xương – khớp)" thuộc đề tài nghiên cứu khoa học của công ty Vaga. Do đó cần cả deliverable kỹ thuật lẫn deliverable học thuật (bài trình bày, báo cáo tiến độ, báo cáo cuối).

Hạ tầng sẵn có:
- Server: Windows Server 2022 + IIS (Internet Information Services)
- Database: Microsoft SQL Server 2022 (MSSQL 2022)
- Agent thiết kế kiến trúc phải tận dụng hạ tầng này thay vì đề xuất stack hoàn toàn mới.

Nhiệm vụ

Bạn là kiến trúc sư dự án (Project Architect) cho dự án trên. Nhiệm vụ gồm 4 phần:

Phần 1: Deep Research — Phân tích toàn bộ tài liệu nghiên cứu

Đọc và phân tích tất cả các file trong thư mục Research/:

Đồng thời tham khảo thư mục Knowledge/:
- Knowledge/Huong_Dan_Chan_Doan_Va_Dieu_Tri_Cac_Benh_Co_Xuong_Khop.md — Hướng dẫn BYT QĐ 361
- Knowledge/DHYHN/Tap1/ — 39 chương sách y khoa (hô hấp, tim mạch, thận, lão khoa...)
- Knowledge/DHYHN/Tap2/ — 65 chương (tiêu hóa, cơ xương khớp, nội tiết, huyết học, cấp cứu)

Yêu cầu phân tích:

1. Tổng hợp scope dự án: Xác định rõ các deliverable chính, phân biệt MVP vs. các giai đoạn sau.
2. Gap analysis: Những gì đã có (nghiên cứu, tài liệu y khoa, kế hoạch) vs. những gì còn thiếu (code, data pipeline, UI, test, deployment, bài trình bày).
3. Rủi ro và ràng buộc: Y khoa (an toàn, kiểm duyệt), pháp lý (Luật BVDLCN 91/2025, Luật CNCNS 71/2025, Luật KCB 15/2023), kỹ thuật (RAG quality, voice accuracy, IIS/MSSQL integration), UX (accessibility người cao tuổi).
4. Đánh giá tính khả thi của kế hoạch 16 tuần với nguồn lực 1 Nghiên cứu sinh + AI + bác sĩ reviewer.

Phần 2: Đề xuất Kiến trúc Folder/File (Tích hợp & Tái cấu trúc)

Thiết kế kiến trúc tích hợp — tái cấu trúc file hiện có vào vị trí hợp lý:

Nguyên tắc tái cấu trúc:
- Research/* → di chuyển vào docs/research/ phân theo nhóm (requirements, reports, plans, references, prompts)
- Knowledge/* → di chuyển vào knowledge-base/sources/ phân theo loại (guidelines, textbooks, utilities)
- Vị trí cũ để redirect stub (_MOVED.md) để không gãy tham chiếu
- Ký hiệu rõ: 📦 CŨ = file di chuyển, 🆕 = file mới

Kiến trúc 6 Tầng phải bao phủ:

Lưu ý hạ tầng:
- Backend chạy trên IIS (Windows Server 2022) — cần xem xét ASP.NET Core / FastAPI behind IIS / reverse proxy
- Database dùng MSSQL 2022 — thay SQLite/PostgreSQL cho metadata, audit log, patient profile
- Vector DB vẫn dùng giải pháp chuyên biệt (ChromaDB/Qdrant) nhưng cần chạy được trên Windows Server

Bao gồm:
- Bảng Migration chi tiết (file cũ → vị trí mới + lý do)
- Redirect stubs cho Research/ và Knowledge/
- Mermaid diagram tổng kết kiến trúc 6 tầng
- Quy ước đặt tên

Phần 3: Kế hoạch Triển khai Chi tiết

Dựa trên gap analysis (Phần 1) và kiến trúc (Phần 2):

1. Ưu tiên hóa: Sắp xếp work package theo thứ tự phụ thuộc và mức ảnh hưởng.
2. Sprint plan: 8 sprint × 2 tuần, mỗi sprint có:
   - Mục tiêu cụ thể
   - Task list với phân công AI/con người
   - Deliverable và tiêu chí hoàn thành
   - Gate/checkpoint
3. Tech stack recommendation: Cập nhật để phù hợp với hạ tầng IIS + MSSQL 2022:
   - Backend: FastAPI behind IIS reverse proxy hoặc ASP.NET Core
   - Database: MSSQL 2022 cho metadata/audit/profile
   - Vector DB: giải pháp tương thích Windows Server
   - Các component khác: LLM, embedding, voice, frontend
4. Quick wins: 8–10 task AI có thể thực hiện ngay.
5. Milestones: Các mốc quan trọng và criteria Go/No-Go.

Phần 4: Bài trình bày Nghiên cứu Khoa học (MỚI)

Đây là đề tài nghiên cứu khoa học, cần bộ deliverable trình bày ở 3 thời điểm:

4.1 Bài trình bày Khởi động (Kickoff Presentation)

• Thời điểm: Đầu dự án (Tuần 1–2)
• Đối tượng: Hội đồng hướng dẫn, Ban giám đốc
• Nội dung cần có:
• Bối cảnh và tính cấp thiết
• Mục tiêu nghiên cứu
• Phạm vi (scope/out-of-scope)
• Phương pháp nghiên cứu
• Kiến trúc hệ thống đề xuất
• Lộ trình thực hiện
• Nguồn lực và rủi ro
• Format: Markdown → có thể chuyển sang PowerPoint/Google Slides

4.2 Báo cáo Tiến độ Hàng tuần (Weekly Progress Report Template)

• Tần suất: Mỗi tuần
• Nội dung cần có:
• Tuần: [N]/16 | Sprint: [N]/8
• Mục tiêu tuần vs. kết quả đạt được
• Metrics: số KC tạo, số test pass, accuracy, ...
• Vấn đề gặp phải và cách xử lý
• Kế hoạch tuần tiếp
• Rủi ro cập nhật
• Screenshot/demo (nếu có)
• Format: Template markdown tái sử dụng

4.3 Bài trình bày Kết thúc (Final Presentation & Defense)

• Thời điểm: Tuần 15–16
• Đối tượng: Hội đồng đánh giá, Ban giám đốc, Đối tác
• Nội dung cần có:
• Tóm tắt đề tài
• Literature review (từ file 02)
• Phương pháp thực hiện
• Kiến trúc hệ thống (thực tế sau triển khai)
• Kết quả nghiên cứu (số liệu benchmark, pilot)
• Demo sản phẩm (screenshot, video, live)
• Đóng góp khoa học và thực tiễn
• Hạn chế và hướng phát triển
• Q&A
• Format: Markdown → có thể chuyển sang PowerPoint/Google Slides

Yêu cầu: Tạo outline chi tiết cho cả 3 bài trình bày, tích hợp vào thư mục docs/presentations/ trong kiến trúc.

Ràng buộc

• Không bịa dữ liệu. Mọi nhận định phải dựa trên nội dung thực tế đã đọc từ các file.
• Phân biệt "đã có" vs. "đề xuất". Ghi rõ nội dung nào đến từ file nghiên cứu, nội dung nào là đề xuất mới.
• Y khoa an toàn trước tiên. Kiến trúc phải thể hiện nguyên tắc "medical knowledge first, AI second" từ file 04.
• Thực tế nguồn lực. Kế hoạch phải khả thi với 1 Nghiên cứu sinh fulltime + AI agent + bác sĩ part-time reviewer.
• Tận dụng hạ tầng. Ưu tiên sử dụng IIS + Windows Server 2022 + MSSQL 2022 đã có sẵn thay vì đề xuất hạ tầng mới. Chỉ đề xuất thêm khi không có giải pháp tương đương trên hạ tầng hiện có.
• Bối cảnh học thuật. Đây là đề tài NCKH — cần deliverable trình bày (presentation) bên cạnh deliverable kỹ thuật.
• Tiếng Việt. Toàn bộ output bằng tiếng Việt.
• Tích hợp không phá. Kiến trúc phải tái cấu trúc file cũ vào vị trí mới, kèm redirect stub, không xóa file gốc.

Đầu ra

Một file markdown duy nhất lưu tại Research/KIEN_TRUC_DU_AN.md gồm:

1. Executive Summary (1 trang)
2. Deep Research Findings (Phần 1) — scope, gap analysis, rủi ro, khả thi
3. Project Architecture (Phần 2) — tree diagram 6 tầng + migration table + redirect stubs + Mermaid
4. Implementation Roadmap (Phần 3) — tech stack (IIS + MSSQL), sprint plan, Gantt
5. Academic Presentations (Phần 4) — outline 3 bài trình bày + weekly template
6. Quick Wins & Next Steps — những việc có thể bắt tay làm ngay
7. Appendix — mapping kiến trúc ↔ nội dung đã có

Changelog v2.0

Cách dùng

Copy toàn bộ prompt này và chạy trong một phiên agent có quyền đọc toàn bộ workspace CXK/. Agent sẽ đọc tất cả file, phân tích, và tạo/cập nhật file output tại Research/KIEN_TRUC_DU_AN.md.