Prompt: Rà soát & Cập nhật Toàn bộ Project CXK — NCS2 + Camera Module

Bối cảnh thực tế

NCS2 (Đỗ Đoàn Anh Tuấn, lớp 10A6 PTTH Xuân Đỉnh) đã triển khai song song
module camera cùng lúc với việc NCS1 (Võ Trần Gia Hiếu)
thu thập nguồn tài liệu y khoa. Tuy nhiên, thông tin này mới chỉ được ghi nhận
vào một phần tài liệu dự án. Nhiều file quan trọng vẫn chưa phản ánh
hiện trạng 2 .

Kết quả audit hiện tại

Files ĐÃ CÓ NCS2 (11 file) ✅

File NCS2 Camera Ghi chú
AGENTS.md 2 2 Vai trò + quy tắc tên
docs/research/plans/CAMERA_MODULE_TASK_BOARD.md 35 24 board đầy đủ
docs/research/reports/12_DEEP_RESEARCH_CAMERA_...md 13 61 Báo cáo nghiên cứu
docs/research/plans/_PHUONG_AN_NANG_CAP_V6_CAMERA.md 11 33 Phương án v6.0
docs/research/reports/02_BAO_CAO_NGHIEN_CUU_TONG_THE.md 9 27 Báo cáo tổng thể
docs/diary/2026-09-26.md 11 20 Nhật ký hôm nay
safety/risk_register.md 8 3 10 RSK-CAM
docs/research/plans/10_KIEN_TRUC_VA_KE_HOACH...md 7 13 Kiến trúc v6.0
docs/project/project_charter.md 2 4 Điều lệ dự án
docs/reports/final/OUTLINE_BAO_CAO_15_TRANG.md 2 2 Outline báo cáo
docs/project/kpi_dashboard.yaml () 7 6 KPI camera

Files CHƯA CÓ NCS2 nhưng CẦN CẬP NHẬT (15+ file) ❌

# File Lý do cần cập nhật Mức
1 README.md Giới thiệu dự án chính — thiếu NCS2, camera 🔴
2 docs/INDEX.md Bản đồ dự án — thiếu camera module files 🔴
3 docs/research/reports/03_TOM_TAT_DE_CUONG_NGHIEN_CUU.md Đề cương — thiếu NCS2, camera scope 🔴
4 docs/research/00_MUC_LUC.md Mục lục nghiên cứu — thiếu file 12 + camera 🟡
5 docs/project/intended_use.md Đã có camera (3), nhưng thiếu NCS2 🟡
6 docs/project/LICH_GVHD.md Lịch — cần thêm slot review NCS2 🟡
7 docs/legal/W1_D04_ConsentForm_DRAFT.md Consent form — cần thêm phụ lục camera 🟡
8 docs/guides/HUONG_DAN_CVYK_OBSIDIAN.md Hướng dẫn — thiếu camera review flow 🟡
9 docs/guides/HUONG_DAN_ANTIGRAVITY_CXK.md Hướng dẫn Antigravity — thiếu camera workflow 🟡
10 safety/W1_D05_SafetyPolicy_v0.1.md Safety policy — thiếu camera safety rules 🟡
11 safety/README.md README safety — thiếu RSK-CAM tổng quan 🟢
12 knowledge-base/README.md README KB — thiếu liên kết camera thresholds 🟢
13 knowledge-base/MOC_TONG_QUAN.md MOC tổng quan — thiếu liên kết camera 🟢
14 docs/GLOSSARY.md Đã có 9 thuật ngữ camera, chỉ thiếu NCS2 mention 🟢
15 docs/presentations/kickoff/kickoff_outline.md Kickoff — thiếu NCS2 giới thiệu 🟢

Kế hoạch tuần (W1–W21) — KHÔNG cần sửa nội dung cũ

Các file kế hoạch tuần (W1→W21) đã hoàn chỉnh cho NCS1. Camera (C1–C4)
đã có task board riêng. KHÔNG cần chèn camera vào kế hoạch tuần cũ.
Chỉ cần đảm bảo W20/W21 có nhắc đến NCS2 trong phần báo cáo cuối.


Nhiệm vụ: 6 bước thực hiện

Bước 1: Audit chi tiết — Đọc từng file ❌

Đọc 15 file ❌ ở bảng trên. Với mỗi file, xác định:
- Dòng nào cần thêm NCS2?
- Dòng nào cần thêm camera?
- Format phù hợp (bảng, bullet, blockquote)?

Bước 2: Cập nhật AGENTS.md (ưu tiên cao nhất)

File AGENTS.md đã có NCS2 ở Section 3 (vai trò) nhưng CẦN BỔ SUNG:

2a. Section 1 (Tổng quan dự án):
Thêm dòng NCS2 vào bảng thông tin:

| **NCS2** | Đỗ Đoàn Anh Tuấn — Lớp 10A6, Trường PTTH Xuân Đỉnh |

2b. Section 4 (Cấu trúc thư mục):
Thêm movement-observation/ vào cây thư mục backend:

├── backend/
│   movement-observation/   ← Module camera (NCS2)
│   frontend/
│   voice/

2c. Section 5 (Quy trình review):
Thêm note: NCS2 cũng cần qua quy trình review CVYK cho nội dung
camera (ngưỡng TUG/5STS/Gait, ngôn ngữ kết quả).

2d. Section 7 (Files quan trọng):
Thêm 2 file mới vào bảng:

| CAMERA_MODULE_TASK_BOARD.md | Task board camera NCS2 | Khi làm camera |
| 12_DEEP_RESEARCH_CAMERA...md | Nghiên cứu khả thi camera | Khi cần bối cảnh camera |

2e. Section 8 (Những điều KHÔNG được làm):
Thêm vào 8.1 Nội dung y khoa:

- ❌ **Không dùng camera để chẩn đoán bệnh** — camera chỉ quan sát cử động
- ❌ **Không lưu video người dùng** — xử lý tại thiết bị, chỉ lưu chỉ số
- ✅ **Luôn cảnh báo** "Camera chỉ thấy cử động bên ngoài" khi trả kết quả

2f. Cập nhật phiên bản: v1.6 → v1.7, ngày 26/09/2026.

Bước 3: Cập nhật file CẤP 1 (🔴 — ảnh hưởng lớn)

3a. README.md:
- Thêm NCS2 vào phần giới thiệu đội ngũ
- Thêm "Module Camera Quan sát Cử động" vào danh sách tính năng
- Thêm link đến CAMERA_MODULE_TASK_BOARD.md
- Thêm note "v6.0" cho kiến trúc

3b. docs/INDEX.md:
- Thêm section "Module Camera" với links đến 3 file camera
- Thêm NCS2 vào bảng đội ngũ (nếu có)
- Thêm link GLOSSARY Nhóm 4

3c. docs/research/reports/03_TOM_TAT_DE_CUONG_NGHIEN_CUU.md:
- Thêm khối [CẬP NHẬT v6.0] về camera module
- Thêm NCS2 vào đội ngũ nghiên cứu
- Thêm mục tiêu phụ: "Nghiên cứu khả thi quan sát cử động bằng camera"

Bước 4: Cập nhật file CẤP 2 (🟡 — ảnh hưởng vừa)

4a. docs/research/00_MUC_LUC.md:
- Thêm entry cho file 12 (Deep Research Camera)
- Thêm entry cho CAMERA_MODULE_TASK_BOARD.md

4b. docs/project/LICH_GVHD.md:
- Thêm ghi chú: GVHD review NCS2 cùng phiên với NCS1
- Thêm milestone Camera , Camera Gate B

4c. docs/legal/W1_D04_ConsentForm_DRAFT.md:
- Thêm phụ lục đồng ý ghi hình camera (nếu pilot có NCT)
- Ghi rõ: video không lưu, chỉ tính chỉ số, quyền từ chối bất cứ lúc nào

4d. docs/guides/HUONG_DAN_CVYK_OBSIDIAN.md:
- Thêm mục "Review kết quả camera": CVYK cần ký ngưỡng TUG/5STS/Gait
- Thêm workflow: NCS2 submit → CVYK review ngưỡng → APPROVED

4e. docs/guides/HUONG_DAN_ANTIGRAVITY_CXK.md:
- Thêm mục "Workflow camera" cho
- Tham chiếu CAMERA_MODULE_TASK_BOARD.md

4f. safety/W1_D05_SafetyPolicy_v0.1.md:
- Thêm section "An toàn module camera" với ADR-005/006/007
- Thêm 3 quy tắc camera: không chẩn đoán, không lưu video, cảnh báo giới hạn

4g. docs/research/plans/W20/ và W21/:
- W20: Thêm task NCS2 tổng hợp kết quả camera vào báo cáo
- W21: Thêm NCS2 vào phần trình bày (slides, mock defense)

Bước 5: Cập nhật file CẤP 3 (🟢 — ảnh hưởng nhỏ)

5a. safety/README.md:
- Thêm tổng quan RSK-CAM (10 rủi ro camera)

5b. knowledge-base/README.md và MOC files:
- Thêm link đến camera thresholds
- Note: camera metrics KHÔNG phải y khoa

5c. docs/presentations/kickoff/kickoff_outline.md:
- Thêm slide NCS2 + camera module

Bước 6: Kiểm tra cuối cùng

  • Chạy python tools/check_glossary.py — 0 HIGH
  • Chạy python tools/check_structure.py — 0 HIGH
  • Đếm lại: NCS2 phải xuất hiện trong ≥20 file
  • Camera phải xuất hiện trong ≥20 file
  • Append diary docs/diary/2026-09-26.md

Ràng buộc BẮT BUỘC

  1. NCS2 = Đỗ Đoàn Anh Tuấn — lớp 10A6 PTTH Xuân Đỉnh.
  2. NCS1 = Võ Trần Gia Hiếu — không thay đổi vai trò.
  3. Camera chỉ "quan sát" — KHÔNG "chẩn đoán".
  4. Không sửa nội dung đã APPROVED bởi CVYK.
  5. Không sửa nội dung y khoa gốc (sources/, giáo trình).
  6. UTF-8 không BOM, relative paths, thuật ngữ theo GLOSSARY.
  7. Mỗi file chỉ thêm nội dung mới (annotation hoặc append), KHÔNG xoá nội dung cũ.
  8. Với file kế hoạch tuần (W1-W19): KHÔNG chèn camera — camera có task board riêng.

Đầu ra kiểm được

  • [ ] AGENTS.md v1.7 với 6 điểm bổ sung (2a→2f)
  • [ ] README.md có NCS2 + camera
  • [ ] INDEX.md có section camera
  • [ ] Đề cương (file 03) có [CẬP NHẬT v6.0] cho camera
  • [ ] Consent form có phụ lục camera
  • [ ] Safety policy có section camera
  • [ ] W20/W21 có NCS2
  • [ ] NCS2 xuất hiện trong ≥20 file
  • [ ] check_glossary.py = 0 HIGH
  • [ ] check_structure.py = 0 HIGH
  • [ ] Diary ghi nhận phiên

Tham chiếu cần đọc

File Lý do
AGENTS.md File chính cần sửa
docs/GLOSSARY.md 9 thuật ngữ camera đã có
docs/research/plans/CAMERA_MODULE_TASK_BOARD.md Task board NCS2
docs/research/reports/12_DEEP_RESEARCH_CAMERA...md Nguồn dữ liệu camera
docs/research/plans/10_KIEN_TRUC_VA_KE_HOACH...md Kiến trúc v6.0