Tuần: W2 | Sprint: S1
Task ID v5.0: 1.1
Phân loại: Hỗn hợp
Effort NCS: 3h | Effort CVYK: 0h | Effort AI: 2.4h
Mô tả
Thực hiện tạo toàn bộ cấu trúc thư mục mới theo tài liệu v5.0, và di chuyển (migrate) các file hiện tại từ thư mục Research/ và Knowledge/ sang cấu trúc mới, sau đó tạo redirect stubs.
File Input
t:/Shared drives/VAGA/Working/CXK/docs/research/plans/KIEN_TRUC_DU_AN.md- Các file trong
Research/vàKnowledge/
File Output
- Cấu trúc thư mục mới tại gốc dự án
- Các file đã di chuyển và đổi tên theo chuẩn
Definition of Done (DoD)
- [ ] Cấu trúc thư mục mới được tạo thành công.
- [ ] Tất cả file cũ được di chuyển về đúng vị trí mới.
- [ ] File redirect stubs (
_MOVED.md) được tạo đúng tại thư mục gốc.
Rủi ro & Xử lý
| Rủi ro | Xác suất | Xử lý |
|---|---|---|
| Gãy tham chiếu trong các file cũ | Thấp | Tạo _MOVED.md và AI update lại link nội bộ nếu cần. |
Mô tả chi tiết
Bối cảnh
Nằm ở đầu Tuần 2 (Sprint 1), đây là bước thực thi vật lý các thay đổi cấu trúc file đã được đề xuất trong bản thiết kế v5.0, đưa dự án vào quỹ đạo gọn gàng.
Các bước thực hiện
- Đọc bảng mapping cấu trúc cũ -> mới.
- Chạy script di chuyển file.
- Tạo file _MOVED.md.
Kết quả mong đợi
- Toàn bộ file cũ được chuyển thành công, không mất dấu vết.
Tiêu chuẩn Hoàn thành (Scoring Rubric)
| # | Tiêu chí | Chưa đạt (0đ) | Đạt (1đ) | Tốt (2đ) |
|---|---|---|---|---|
| 1 | Tính toàn vẹn | Mất file | Chuyển đủ | Chuyển đủ và đúng metadata |
| 2 | Redirect Stubs | Thiếu | Có _MOVED.md | Rõ ràng hướng dẫn tìm file mới |
| 3 | Naming convention | Sai chuẩn | Đúng đa số | 100% tuân thủ naming v5.0 |
| 4 | Automation | Làm tay 100% | Có xài script | Script sạch, có error handling |
| 5 | Verify kết quả | Không check | Check lướt | Verify bằng git status |
Ngưỡng pass: ≥7/10.
Phân công vai trò
| Vai trò | Hành động cụ thể | Thời lượng | Khi nào |
|---|---|---|---|
| NCS | Chạy script, kiểm tra git | 3.0h | T2 |
| AI | Viết Python script cho việc migration | 2.4h | T2 |
Đánh giá AI hỗ trợ
AI có thể làm gì?
| # | Việc AI làm | Tiết kiệm | Rủi ro |
|---|---|---|---|
| 1 | Viết mã tự động hóa file system | 2h | Script lỡ xoá nhầm file (cần backup) |
AI KHÔNG nên làm gì?
- Thực thi lệnh xoá file (
rm) mà không thông báo.
Phụ lục A: Sub-task AI
A.1 Script Migration
Input: Bảng mapping v5.0
Output: File python chạy an toàn
Prompt thực thi
## Nhiệm vụ
Viết script Python để di chuyển cấu trúc thư mục cũ sang mới
## Bối cảnh
- Dự án: Trợ lý AI Cơ Xương Khớp Tuổi Bạc (CXK)
- Kiến trúc: Context Loading (Markdown → Gemini 1M tokens, KHÔNG RAG)
- Tái cấu trúc thư mục dự án theo bảng mapping mới để đảm bảo tính gọn gàng và dễ bảo trì.
## Input
- File: `docs/architecture/folder_mapping.csv`
## Output
- File: `scripts/migration/migrate_folders.py`
- Format: Python
- Số lượng: 1 script
## Ràng buộc
1. An toàn y khoa: KHÔNG chẩn đoán, KHÔNG kê đơn, luôn có lời khuyên an toàn
2. Đảm bảo chất lượng định dạng và nội dung đầu ra theo yêu cầu kỹ thuật
3. Thuật ngữ: thẻ tri thức, cờ đỏ, bộ lọc an toàn, truy vết nguồn
4. Ngôn ngữ: Tiếng Việt, đơn giản, dễ hiểu
## Tiêu chí nghiệm thu
- [ ] Script không bị văng lỗi Permission
- [ ] Script chỉ di chuyển (move) hoặc copy, tạo thư mục đích nếu chưa có
- [ ] In ra console chi tiết từng file được chuyển và tạo file _MOVED.md ở thư mục cũ