10 — Kiến Trúc Project và Kế Hoạch Triển Khai

# Kiến trúc Project và Kế hoạch Triển khai — Trợ lý AI Cơ Xương Khớp Tuổi Bạc

Ngày: 23/09/2026 | Cập nhật: v2.0
Tác giả: AI Project Architect (thực hiện từ prompt 09_PROMPT_DEEP_RESEARCH_KIEN_TRUC_PROJECT.md v2.0)
Phạm vi: Phân tích toàn bộ thư mục Research/ (10 file, ~560 KB) và Knowledge/ (1 file + 104 chương sách, ~2.1 MB)
Bối cảnh: Đề tài nghiên cứu khoa học (NCKH) | Hạ tầng: IIS + Windows Server 2022 + MSSQL 2022
Trạng thái: Đề xuất — cần review và phê duyệt trước khi triển khai

---

1. Executive Summary

Dự án "Trợ lý AI hỗ trợ người cao tuổi tự chăm sóc hệ vận động" thuộc đề tài nghiên cứu khoa học của công ty Vaga. Dự án đã có nền tảng nghiên cứu rất vững: 1 báo cáo tổng thể ~70 KB với 36 nguồn quốc tế, 1 đề cương 3 phần, 1 kế hoạch 16 tuần chi tiết đến từng ngày, 2 bản triển khai Tuần 1, và ~2 MB tài liệu y khoa đã số hóa (Hướng dẫn BYT + sách ĐHYHN).

Điểm mạnh đã có:
- Scope y khoa rõ ràng (7 nhóm bệnh/vấn đề MVP)
- Kiến trúc RAG + Safety Layer đã được thiết kế
- Pipeline phân vai AI–con người với 8 vai trò AI
- 4 Gate kiểm soát (Knowledge → Technical → Clinical → Pilot)
- Khung pháp lý và đạo đức đã được khảo sát
- Hạ tầng sẵn có: Windows Server 2022 + IIS + MSSQL 2022

Gap chính cần lấp:
- Chưa có dòng code nào, chưa có repository
- Chưa có knowledge cards/taxonomy có cấu trúc (chỉ có raw markdown)
- Chưa có data pipeline (chunk → embed → vector DB)
- Chưa có UI/UX prototype
- Chưa có bộ test 100 case với gold label
- Chưa phỏng vấn người dùng/chuyên gia thật
- Chưa có bài trình bày NCKH (kickoff, báo cáo tiến độ, báo cáo cuối)

Đề xuất: Tổ chức lại workspace theo kiến trúc 6 tầng (Phần 3), tận dụng hạ tầng IIS + MSSQL hiện có, bao gồm deliverable học thuật (Phần 5), bắt đầu bằng Quick Wins AI có thể làm ngay trong tuần đầu.

---

2. Deep Research Findings

2.1 Tổng hợp Scope Dự án

Từ file 01 và 02, dự án có 4 giai đoạn:

Deliverable MVP (từ file 02, mục "Đề xuất lộ trình sản phẩm"):
1. Website hỏi đáp có RAG + citations
2. Kho tri thức y khoa curated (knowledge cards)
3. Red-flag safety layer
4. 300–500 FAQ/cases có gold label
5. Clinician dashboard cơ bản
6. Bộ benchmark test độc lập
7. Báo cáo đề tài (đề cương + nhật ký + kết luận)

2.2 Gap Analysis

ĐÃ CÓ (trong Research/ và Knowledge/)

Đặc biệt quan trọng trong Knowledge/DHYHN/Tap2/:
- 14-viem-khop-dang-thap.md (39 KB)
- 21-thoai-hoa-khop.md (24 KB) ← Trực tiếp cho MVP
- 22-loang-xuong.md (32 KB) ← Trực tiếp cho MVP
- 25-nhiem-khuan-co-xuong-khop.md (30 KB)
- 27-dinh-huong-chan-doan-dau-xuong-khop.md (29 KB) ← Red flag rules
- 28-dau-vung-that-lung.md (52 KB) ← Trực tiếp cho MVP
- 20-benh-gut.md (45 KB) ← Safety corpus
- 35-kham-benh-o-nguoi-cao-tuoi.md trong Tap1 (58 KB) ← Lão khoa

CHƯA CÓ (cần tạo)

2.3 Rủi ro và Ràng buộc

2.4 Đánh giá Tính khả thi

Nguồn lực: 1 Nghiên cứu viên fulltime (56h/tuần) + AI agent + bác sĩ part-time

Đánh giá:
- Kế hoạch 16 tuần trong file 04 là tham vọng nhưng có cấu trúc tốt
- File 06 cho thấy Tuần 1 đã được bóc tách rất chi tiết (12 deliverable)
- Rủi ro lớn nhất: bác sĩ reviewer không có đủ thời gian → bottleneck tại clinical review
- Điểm thuận lợi: AI agent có thể đảm nhận ~60% khối lượng (literature search, extraction, structuring, test generation, UI scaffolding)
- Đề xuất thực tế: Chuyển từ 16 tuần sang 8 sprint × 2 tuần, có checkpoint giữa mỗi sprint, chấp nhận MVP tối giản hơn kế hoạch gốc

---

3. Project Architecture — Kiến trúc Folder/File

3.1 Tree Diagram — Kiến trúc Tích hợp (file cũ + file mới)

Nguyên tắc tái cấu trúc:
- File đang có trong Research/ và Knowledge/ được di chuyển vào vị trí nghiệp vụ hợp lý
- Mỗi file cũ giữ nguyên nội dung, chỉ thay đổi vị trí
- Vị trí cũ để redirect stub (file nhỏ chứa link đến vị trí mới) để không gãy tham chiếu
- Ký hiệu: 📦 CŨ = file đã có được di chuyển đến, 🆕 = file mới cần tạo

CXK/
├── README.md                                    🆕 Giới thiệu dự án, cách cài đặt, link docs
│
│
│ ══════════════════════════════════════════════════
│  TẦNG 1: TÀI LIỆU DỰ ÁN & NGHIÊN CỨU
│ ══════════════════════════════════════════════════
│
├── docs/                                        🆕 Toàn bộ tài liệu dự án
│   │
│   ├── research/                                📦 CŨ ← từ Research/
│   │   ├── 00_MUC_LUC.md                       📦 CŨ Research/00_MUC_LUC.md
│   │   │
│   │   ├── requirements/                        Yêu cầu gốc & phạm vi
│   │   │   └── 01_YEU_CAU_GOC_VA_LICH_SU_NGHIEN_CUU.md
│   │   │                                        📦 CŨ Research/01_*.md
│   │   │
│   │   ├── reports/                             Báo cáo nghiên cứu
│   │   │   ├── 02_BAO_CAO_NGHIEN_CUU_TONG_THE.md
│   │   │   │                                    📦 CŨ Research/02_*.md (70 KB, 36 nguồn)
│   │   │   ├── 03_TOM_TAT_DE_CUONG_NGHIEN_CUU.md
│   │   │   │                                    📦 CŨ Research/03_*.md
│   │   │   └── 08_TOAN_BO_NOI_DUNG_NGHIEN_CUU.md
│   │   │                                        📦 CŨ Research/08_*.md (bản gộp)
│   │   │
│   │   ├── plans/                               Kế hoạch triển khai
│   │   │   ├── 04_KE_HOACH_TRIEN_KHAI_16_TUAN.md
│   │   │   │                                    📦 CŨ Research/04_*.md (79 KB)
│   │   │   ├── 05_TUAN_1_KE_HOACH_VA_DAU_RA_BAN_DAU.md
│   │   │   │                                    📦 CŨ Research/05_*.md
│   │   │   ├── 06_TUAN_1_TASK_CHI_TIET_VA_BIEU_MAU.md
│   │   │   │                                    📦 CŨ Research/06_*.md
│   │   │   └── 10_KIEN_TRUC_VA_KE_HOACH_TRIEN_KHAI.md
│   │   │                                        📦 CŨ Research/10_*.md (file này)
│   │   │
│   │   ├── references/                          Nguồn tham khảo
│   │   │   └── 07_NGUON_THAM_KHAO_VA_GHI_CHU_XUAT.md
│   │   │                                        📦 CŨ Research/07_*.md (36 nguồn + SHA)
│   │   │
│   │   └── prompts/                             Prompt nghiên cứu
│   │       └── 09_PROMPT_DEEP_RESEARCH_KIEN_TRUC_PROJECT.md
│   │                                            📦 CŨ Research/09_*.md
│   │
│   ├── project/                                 🆕 Tài liệu quản lý dự án
│   │   ├── project_charter.md                   🆕 Hiến chương dự án (từ nội dung file 01+02)
│   │   ├── intended_use.md                      🆕 Phạm vi sử dụng — pháp lý
│   │   ├── risk_register.md                     🆕 Đăng ký rủi ro
│   │   └── stakeholder_map.md                   🆕 Bản đồ các bên liên quan
│   │
│   ├── architecture/                            🆕 Quyết định kiến trúc
│   │   ├── ADR-001_rag_over_finetune.md         🆕 RAG thay vì fine-tune
│   │   ├── ADR-002_safety_first.md              🆕 Safety pre/post check
│   │   ├── ADR-003_voice_first_not_only.md      🆕 Voice-first, không voice-only
│   │   └── system_architecture.md               🆕 Sơ đồ tổng thể (Mermaid)
│   │
│   ├── gates/                                   🆕 Cổng kiểm soát
│   │   ├── gate_a_knowledge.md                  🆕 Gate A: Knowledge
│   │   ├── gate_b_technical.md                  🆕 Gate B: Technical
│   │   ├── gate_c_clinical.md                   🆕 Gate C: Clinical Safety
│   │   └── gate_d_pilot.md                      🆕 Gate D: Pilot/Go-live
│   │
│   ├── diary/                                   🆕 Nhật ký nghiên cứu
│   │   ├── _template.md                         🆕 Mẫu nhật ký
│   │   └── 2026-09-23.md                        🆕 Entry đầu tiên
│   │
│   ├── reports/                                 🆕 Báo cáo tiến độ
│   │   ├── weekly/
│   │   └── final/
│   │
│   ├── presentations/                           🆕 Bài trình bày NCKH
│   │   ├── kickoff/
│   │   │   ├── kickoff_outline.md               🆕 Outline bài trình bày khởi động
│   │   │   └── kickoff_slides.md                🆕 Nội dung slides (md → pptx)
│   │   ├── weekly/
│   │   │   └── weekly_progress_template.md      🆕 Template báo cáo tiến độ tuần
│   │   └── final/
│   │       ├── final_outline.md                 🆕 Outline bài bảo vệ cuối
│   │       └── final_slides.md                  🆕 Nội dung slides bảo vệ
│   │
│   └── legal/                                   🆕 Pháp lý
│       ├── privacy_impact_assessment.md         🆕 Đánh giá tác động quyền riêng tư
│       ├── data_processing_agreement.md         🆕 Thỏa thuận xử lý dữ liệu
│       └── license_audit.md                     🆕 Kiểm tra bản quyền tài liệu
│
│
│ ══════════════════════════════════════════════════
│  TẦNG 2: TRI THỨC Y KHOA
│ ══════════════════════════════════════════════════
│
├── knowledge-base/                              🆕 Kho tri thức y khoa có cấu trúc
│   ├── README.md                                🆕 Quy trình tạo/duyệt knowledge items
│   │
│   ├── sources/                                 Tài liệu y khoa nguồn (raw)
│   │   │
│   │   ├── guidelines/                          Hướng dẫn chính thống
│   │   │   └── byt-qd361/
│   │   │       └── Huong_Dan_Chan_Doan_Va_Dieu_Tri_Cac_Benh_Co_Xuong_Khop.md
│   │   │                                        📦 CŨ Knowledge/Huong_Dan_*.md (540 KB)
│   │   │
│   │   ├── textbooks/                           Sách giáo khoa y khoa
│   │   │   └── dhyhn/                           Đại học Y Hà Nội
│   │   │       ├── README.md                    🆕 Mô tả nguồn, phiên bản, quyền sử dụng
│   │   │       ├── tap1/                        📦 CŨ Knowledge/DHYHN/Tap1/
│   │   │       │   ├── 02-viem-phe-quan-cap.md  ... (39 chương)
│   │   │       │   ├── 35-kham-benh-o-nguoi-cao-tuoi.md  ← Đặc biệt: Lão khoa
│   │   │       │   └── ...
│   │   │       └── tap2/                        📦 CŨ Knowledge/DHYHN/Tap2/
│   │   │           ├── 14-viem-khop-dang-thap.md
│   │   │           ├── 20-benh-gut.md
│   │   │           ├── 21-thoai-hoa-khop.md     ← Trực tiếp MVP
│   │   │           ├── 22-loang-xuong.md         ← Trực tiếp MVP
│   │   │           ├── 25-nhiem-khuan-co-xuong-khop.md
│   │   │           ├── 27-dinh-huong-chan-doan-dau-xuong-khop.md ← Red flag
│   │   │           ├── 28-dau-vung-that-lung.md  ← Trực tiếp MVP
│   │   │           └── ... (65 chương)
│   │   │
│   │   └── utilities/                           📦 CŨ Scripts OCR/fix
│   │       ├── fix_ocr.py                       📦 CŨ DHYHN/Tap1/fix_ocr.py
│   │       ├── fix_more.py                      📦 CŨ DHYHN/Tap1/fix_more.py
│   │       ├── super_fix.py                     📦 CŨ DHYHN/Tap1/super_fix.py
│   │       ├── ocr_fix.py                       📦 CŨ DHYHN/Tap2/ocr_fix.py
│   │       └── refine.py                        📦 CŨ DHYHN/Tap2/refine.py
│   │
│   ├── taxonomy/                                🆕 Phân loại y khoa
│   │   ├── msk_taxonomy_v1.yaml                 🆕 Phân loại bệnh/vấn đề CXK
│   │   ├── body_regions.yaml                    🆕 Vùng cơ thể
│   │   ├── symptoms.yaml                        🆕 Triệu chứng
│   │   └── risk_factors.yaml                    🆕 Yếu tố nguy cơ
│   │
│   ├── evidence-matrix/                         🆕 Ma trận bằng chứng
│   │   ├── source_registry.csv                  🆕 36+ nguồn (từ file 07)
│   │   └── evidence_pyramid.yaml                🆕 Phân tầng A→E (từ file 02)
│   │
│   ├── knowledge-cards/                         🆕 Thẻ tri thức có cấu trúc
│   │   ├── _schema.json                         🆕 Schema cho knowledge card
│   │   ├── knee-oa/
│   │   │   ├── KC-OA-001_exercise.yaml          🆕 Knowledge card mẫu
│   │   │   ├── KC-OA-002_red-flags.yaml
│   │   │   └── KC-OA-003_self-care.yaml
│   │   ├── low-back-pain/
│   │   ├── osteoporosis/
│   │   ├── sarcopenia/
│   │   ├── falls-prevention/
│   │   ├── neck-shoulder/
│   │   └── frailty/
│   │
│   ├── faq/                                     🆕 Ngân hàng câu hỏi
│   │   ├── _schema.json                         🆕 Schema cho FAQ
│   │   ├── faq_knee_oa.yaml
│   │   ├── faq_low_back.yaml
│   │   └── faq_general.yaml
│   │
│   └── case-bank/                               🆕 Ngân hàng tình huống lâm sàng
│       ├── _schema.json                         🆕 Schema cho clinical case
│       ├── green/                               Cases an toàn cho self-care
│       ├── amber/                               Cases cần thăm khám
│       └── red/                                 Cases khẩn cấp
│
│
│ ══════════════════════════════════════════════════
│  TẦNG 3: AN TOÀN Y KHOA
│ ══════════════════════════════════════════════════
│
├── safety/                                      🆕 An toàn y khoa
│   ├── README.md
│   ├── safety_charter.md                        🆕 Hiến chương an toàn (từ file 04)
│   ├── red_flag_rules.yaml                      🆕 Quy tắc nhận diện nguy hiểm
│   ├── triage_protocol.yaml                     🆕 Logic GREEN/AMBER/RED
│   ├── scope_boundaries.yaml                    🆕 AI được/không được trả lời
│   ├── medication_safety.yaml                   🆕 Quy tắc an toàn thuốc
│   └── disclaimers/
│       ├── vi_general.md                        🆕 Disclaimer tiếng Việt
│       └── vi_emergency.md                      🆕 Cảnh báo khẩn cấp
│
│
│ ══════════════════════════════════════════════════
│  TẦNG 4: KỸ THUẬT & SẢN PHẨM
│ ══════════════════════════════════════════════════
│
├── data-pipeline/                               🆕 Xử lý dữ liệu
│   ├── README.md
│   ├── requirements.txt
│   ├── scripts/
│   │   ├── 01_extract_knowledge.py              Trích xuất sources/ → structured
│   │   ├── 02_create_chunks.py                  Chunk theo topic + metadata
│   │   ├── 03_generate_embeddings.py            Tạo embeddings
│   │   ├── 04_ingest_vectordb.py                Nhập vào vector DB
│   │   ├── 05_validate_ingestion.py             Kiểm tra sau nhập
│   │   └── utils/
│   │       ├── markdown_parser.py
│   │       ├── metadata_extractor.py
│   │       └── dedup_checker.py
│   ├── config/
│   │   ├── embedding_config.yaml
│   │   └── chunking_config.yaml
│   └── data/                                    (gitignored)
│       ├── chunks/
│       └── embeddings/
│
├── backend/                                     🆕 Server API
│   ├── README.md
│   ├── requirements.txt
│   ├── app/
│   │   ├── main.py                              FastAPI entry point
│   │   ├── config.py
│   │   ├── routers/
│   │   │   ├── chat.py                          Endpoint hỏi đáp
│   │   │   ├── search.py                        Endpoint tìm kiếm
│   │   │   └── health.py                        Health check
│   │   ├── services/
│   │   │   ├── retriever.py                     RAG retriever
│   │   │   ├── safety_engine.py                 Safety pre/post check
│   │   │   ├── citation_engine.py               Trích dẫn nguồn
│   │   │   ├── llm_service.py                   LLM integration
│   │   │   ├── conversation.py                  Quản lý hội thoại
│   │   │   └── triage.py                        Phân loại rủi ro
│   │   ├── models/
│   │   │   ├── schemas.py                       Pydantic models
│   │   │   └── enums.py                         GREEN/AMBER/RED
│   │   └── middleware/
│   │       ├── logging.py                       Audit log
│   │       └── privacy.py                       PII filter
│   └── tests/
│       ├── test_retriever.py
│       ├── test_safety.py
│       └── test_citation.py
│
├── frontend/                                    🆕 Website accessibility-first
│   ├── README.md
│   ├── package.json
│   ├── public/
│   │   └── index.html
│   ├── src/
│   │   ├── App.vue
│   │   ├── components/
│   │   │   ├── ChatWindow.vue                   Cửa sổ chat chính
│   │   │   ├── MessageBubble.vue                Bong bóng tin nhắn
│   │   │   ├── VoiceInput.vue                   Nút nói
│   │   │   ├── CitationCard.vue                 Hiển thị nguồn
│   │   │   ├── EmergencyBanner.vue              Banner khẩn cấp
│   │   │   ├── FontSizer.vue                    Điều chỉnh cỡ chữ
│   │   │   └── SafetyDisclaimer.vue             Disclaimer
│   │   ├── styles/
│   │   │   ├── accessibility.css                WCAG 2.2 base
│   │   │   ├── elderly-theme.css                Theme tối giản cho NCT
│   │   │   └── high-contrast.css                Tương phản cao
│   │   └── assets/
│   └── tests/
│
├── voice/                                       🆕 STT/TTS integration
│   ├── README.md
│   ├── stt/
│   │   ├── stt_service.py                       Speech-to-Text wrapper
│   │   ├── transcript_confirmer.py              Xác nhận transcript
│   │   └── vietnamese_postprocess.py            Hậu xử lý tiếng Việt
│   └── tts/
│       ├── tts_service.py                       Text-to-Speech wrapper
│       └── voice_config.yaml                    Cấu hình giọng đọc
│
├── telegram-bot/                                🆕 Tích hợp Telegram
│   ├── README.md
│   ├── bot.py                                   Bot entry point
│   ├── handlers/
│   │   ├── text_handler.py
│   │   ├── voice_handler.py
│   │   └── webapp_handler.py                    Mini App
│   └── config.yaml
│
│
│ ══════════════════════════════════════════════════
│  TẦNG 5: KIỂM THỬ & NGHIÊN CỨU NGƯỜI DÙNG
│ ══════════════════════════════════════════════════
│
├── testing/                                     🆕 Kiểm thử
│   ├── README.md
│   ├── benchmark/
│   │   ├── testset_v1.yaml                      Bộ 100+ test cases
│   │   ├── gold_labels/                         Gold label từ bác sĩ
│   │   └── scoring_rubric.yaml                  Rubric chấm điểm
│   ├── red-team/
│   │   ├── adversarial_cases.yaml               Tình huống đối kháng
│   │   ├── misinformation_cases.yaml            Thông tin sai
│   │   └── edge_cases.yaml                      Biên case
│   ├── accessibility/
│   │   ├── wcag_checklist.md                    WCAG 2.2 checklist
│   │   └── elderly_usability.md                 Checklist cho NCT
│   ├── scripts/
│   │   ├── run_benchmark.py
│   │   ├── score_results.py
│   │   └── generate_report.py
│   └── results/                                 (gitignored)
│
├── user-research/                               🆕 Nghiên cứu người dùng
│   ├── README.md
│   ├── survey/
│   │   ├── survey_elderly_v1.md                 Bộ khảo sát NCT
│   │   └── survey_caregiver_v1.md               Bộ khảo sát người chăm sóc
│   ├── interview/
│   │   ├── interview_guide_elderly.md           Hướng dẫn PV người cao tuổi
│   │   ├── interview_guide_doctor.md            Hướng dẫn PV bác sĩ
│   │   └── coding_framework.yaml                Khung phân tích
│   ├── personas/
│   │   └── persona_template.yaml
│   ├── insights/
│   │   └── README.md                            Tổng hợp insight
│   └── consent/
│       └── consent_form_vi.md                   Mẫu đồng ý tham gia
│
│
│ ══════════════════════════════════════════════════
│  TẦNG 6: NỘI DUNG & VẬN HÀNH
│ ══════════════════════════════════════════════════
│
├── community/                                   🆕 Giáo dục & cộng đồng
│   ├── README.md
│   ├── education/
│   │   ├── content_matrix.yaml                  Ma trận nội dung (từ file 02)
│   │   ├── articles/                            Bài viết giáo dục
│   │   └── exercises/                           Bài tập đã duyệt
│   └── engagement/
│       ├── challenge_templates.yaml             Thử thách vận động
│       └── checkin_schedule.yaml                Lịch check-in
│
├── deployment/                                  🆕 Triển khai (IIS + Windows Server)
│   ├── iis/
│   │   ├── web.config                           🆕 IIS reverse proxy config
│   │   ├── applicationHost.config               🆕 IIS site binding
│   │   └── setup_iis.ps1                        🆕 Script cấu hình IIS
│   ├── database/
│   │   ├── init_schema.sql                      🆕 MSSQL schema khởi tạo
│   │   ├── migrations/                          🆕 Database migrations
│   │   └── seed_data.sql                        🆕 Dữ liệu khởi tạo
│   ├── .env.example
│   └── monitoring/
│       └── alerts.yaml
│
│
│ ══════════════════════════════════════════════════
│  GỐC: REDIRECT STUBS (giữ tương thích)
│ ══════════════════════════════════════════════════
│
├── Research/                                    ⚠️ REDIRECT STUBS
│   └── _MOVED.md                                Link đến docs/research/
│
├── Knowledge/                                   ⚠️ REDIRECT STUBS
│   └── _MOVED.md                                Link đến knowledge-base/sources/
│
│
│ ══════════════════════════════════════════════════
│  CONFIG
│ ══════════════════════════════════════════════════
│
├── .gitignore
├── pyproject.toml                               Python project config
└── Makefile                                     Lệnh tiện ích

3.2 Bảng Migration — Ánh xạ Cũ → Mới

Bảng này là kế hoạch di chuyển cụ thể. Mỗi file cũ có đường dẫn mới và lý do xếp vào vị trí đó.

Research/ → docs/research/

Knowledge/ → knowledge-base/sources/

3.3 Redirect Stubs

Sau khi di chuyển, tạo file _MOVED.md ở vị trí cũ để tránh gãy tham chiếu:

Research/_MOVED.md:

# ⚠️ Thư mục đã di chuyển

Toàn bộ nội dung Research/ đã được di chuyển đến `docs/research/`.

| Nhóm | Vị trí mới |
|---|---|
| Yêu cầu gốc | `docs/research/requirements/` |
| Báo cáo nghiên cứu | `docs/research/reports/` |
| Kế hoạch triển khai | `docs/research/plans/` |
| Nguồn tham khảo | `docs/research/references/` |
| Prompts | `docs/research/prompts/` |

Knowledge/_MOVED.md:

# ⚠️ Thư mục đã di chuyển

Toàn bộ nội dung Knowledge/ đã được di chuyển đến `knowledge-base/sources/`.

| Nhóm | Vị trí mới |
|---|---|
| Hướng dẫn BYT | `knowledge-base/sources/guidelines/byt-qd361/` |
| Sách ĐHYHN | `knowledge-base/sources/textbooks/dhyhn/` |
| Scripts OCR | `knowledge-base/sources/utilities/` |

3.4 Tổng kết Kiến trúc 6 Tầng

graph TD
    subgraph T1["TẦNG 1: TÀI LIỆU"]
        docs["docs/"]
        docs --> research["research/ ← Research/*"]
        docs --> project["project/"]
        docs --> arch["architecture/"]
        docs --> gates["gates/"]
        docs --> diary["diary/"]
        docs --> legal["legal/"]
        docs --> pres["presentations/"]
    end

    subgraph T2["TẦNG 2: TRI THỨC"]
        kb["knowledge-base/"]
        kb --> sources["sources/ ← Knowledge/*"]
        kb --> taxonomy["taxonomy/"]
        kb --> evidence["evidence-matrix/"]
        kb --> cards["knowledge-cards/"]
        kb --> faq["faq/"]
        kb --> cases["case-bank/"]
    end

    subgraph T3["TẦNG 3: AN TOÀN"]
        safety["safety/"]
    end

    subgraph T4["TẦNG 4: KỸ THUẬT"]
        pipeline["data-pipeline/"]
        backend["backend/"]
        frontend["frontend/"]
        voice["voice/"]
        telegram["telegram-bot/"]
    end

    subgraph T5["TẦNG 5: KIỂM THỬ"]
        testing["testing/"]
        uresearch["user-research/"]
    end

    subgraph T6["TẦNG 6: VẬN HÀNH"]
        community["community/"]
        deploy["deployment/"]
    end

    sources --> pipeline
    pipeline --> backend
    safety --> backend
    cards --> backend
    backend --> frontend
    backend --> telegram
    backend --> voice
    testing --> backend

3.5 Quy ước Đặt tên

---

4. Implementation Roadmap

4.1 Tech Stack Recommendation (tận dụng hạ tầng sẵn có)

Nguyên tắc: Ưu tiên tận dụng Windows Server 2022 + IIS + MSSQL 2022 đã có sẵn. Chỉ thêm component mới khi không có giải pháp tương đương.

Sơ đồ Hạ tầng

graph LR
    subgraph WS["Windows Server 2022"]
        IIS["IIS 10\nReverse Proxy\nSSL + Static"]
        FastAPI["FastAPI\n:8000\nRAG + Safety"]
        ChromaDB["ChromaDB\nVector Store"]
        MSSQL[("MSSQL 2022\nMetadata\nAudit Log")]
        TG["Telegram Bot\nService"]
    end

    User -->|HTTPS| IIS
    IIS -->|Proxy /api| FastAPI
    IIS -->|Static /| Frontend["Vue 3 Build"]
    FastAPI --> ChromaDB
    FastAPI --> MSSQL
    FastAPI -->|API| LLM["Gemini/GPT\nCloud API"]
    TG --> FastAPI

4.2 Sprint Plan (8 Sprint × 2 tuần)

gantt
    title Lộ trình 16 tuần - 8 Sprint
    dateFormat YYYY-MM-DD
    axisFormat %d/%m

    section Sprint 1: Nền móng
    Tái cấu trúc + source registry              :s1, 2026-09-23, 14d

    section Sprint 2: Knowledge Base
    Taxonomy + Knowledge Cards + Evidence Matrix  :s2, after s1, 14d

    section Sprint 3: Data Pipeline
    Chunk + Embed + Vector DB + Retrieval API     :s3, after s2, 14d

    section Sprint 4: Safety + Backend
    Safety engine + Backend API + LLM integration :s4, after s3, 14d

    section Sprint 5: Frontend + Voice
    Website MVP + Voice integration               :s5, after s4, 14d

    section Sprint 6: Testing
    100-case benchmark + Red team + Clinical gate :s6, after s5, 14d

    section Sprint 7: Telegram + Pilot
    Telegram bot + Pilot 20-30 NCT                :s7, after s6, 14d

    section Sprint 8: Báo cáo
    Phân tích + Báo cáo đề tài + Roadmap         :s8, after s7, 14d

---

Sprint 1: Nền móng (Tuần 1–2) — Gate A prep

---

Sprint 2: Knowledge Base (Tuần 3–4) — Gate A

---

Sprint 3: Data Pipeline (Tuần 5–6)

---

Sprint 4: Safety + Backend (Tuần 7–8) — Gate B

---

Sprint 5: Frontend + Voice (Tuần 9–10)

---

Sprint 6: Testing (Tuần 11–12) — Gate C

---

Sprint 7: Telegram + Pilot (Tuần 13–14)

---

Sprint 8: Báo cáo + Bảo vệ (Tuần 15–16) — Gate D

---

5. Academic Presentations — Bài trình bày Nghiên cứu Khoa học

Đây là đề tài NCKH — cần deliverable trình bày ở 3 thời điểm chính trong vòng đời dự án.

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

• Thời điểm: Sprint 1 (Tuần 1–2)
• Đối tượng: Hội đồng hướng dẫn, Ban giám đốc
• Thời lượng: 20–30 phút + 10 phút Q&A
• File: docs/presentations/kickoff/

Outline:

5.2 Template Báo cáo Tiến độ Hàng tuần

• Tần suất: Mỗi thứ Sáu
• File: docs/presentations/weekly/weekly_progress_template.md
• Format: Markdown tái sử dụng, copy → điền → gửi

Template:

# Báo cáo Tiến độ Tuần [N]/16

> **Sprint:** [N]/8 | **Ngày:** [DD/MM/YYYY]  
> **Gate hiện tại:** [A/B/C/D]

## 1. Tóm tắt
[1–2 câu mô tả tổng quan tuần]

## 2. Mục tiêu vs. Kết quả

| Mục tiêu đặt ra | Kết quả | Trạng thái |
|---|---|---|
| [Task 1] | [Kết quả] | ✅/⚠️/❌ |
| [Task 2] | [Kết quả] | ✅/⚠️/❌ |

## 3. Metrics

| Metric | Tuần trước | Tuần này | Δ |
|---|---|---|---|
| Knowledge Cards | [N] | [N] | +[N] |
| Test cases pass | [N]/100 | [N]/100 | +[N] |
| Retrieval recall | [%] | [%] | +[%] |
| Safety sensitivity | [%] | [%] | +[%] |

## 4. Vấn đề & Giải pháp

| Vấn đề | Ảnh hưởng | Giải pháp |
|---|---|---|
| [Mô tả] | [Cao/TB/Thấp] | [Giải pháp] |

## 5. Kế hoạch Tuần tiếp
- [ ] [Task 1]
- [ ] [Task 2]

## 6. Rủi ro Cập nhật
[Rủi ro mới hoặc thay đổi mức rủi ro]

## 7. Demo/Screenshot
[Ảnh hoặc mô tả demo nếu có]

5.3 Bài trình bày Bảo vệ Cuối (Final Defense)

• Thời điểm: Sprint 8 (Tuần 15–16)
• Đối tượng: Hội đồng đánh giá, Ban giám đốc, Đối tác
• Thời lượng: 30–45 phút + 15 phút Q&A
• File: docs/presentations/final/

Outline:

5.4 Tích hợp Presentations vào Sprint Plan

---

6. Quick Wins & Next Steps

10 Quick Wins AI có thể thực hiện ngay (tuần này)

Next Steps sau Quick Wins

1. NCV review tất cả output QW (1–2 ngày)
2. Trình bày Kickoff cho hội đồng/BGĐ
3. Gửi BS reviewer KC nhóm nguy cơ cao
4. Setup Python environment trên Windows Server (pyproject.toml, ChromaDB, FastAPI)
5. Bắt đầu Sprint 2 — trích xuất knowledge cards từ toàn bộ tài liệu CXK

---

7. Appendix: Mapping Kiến trúc ↔ Nội dung Đã Có

7.1 File cũ → Vị trí mới (tóm tắt)

7.2 Thư mục mới → Nội dung trích từ nghiên cứu

---

Ghi chú cuối: File này là đề xuất kiến trúc và kế hoạch v2.0. Mọi nội dung y khoa cần được bác sĩ rà soát. Mọi quyết định pháp lý cần luật sư chuyên ngành. Kế hoạch cần được điều chỉnh theo nguồn lực thực tế. Hạ tầng IIS + MSSQL cần được kiểm tra khả dụng trước khi bắt đầu Sprint 3.