Prompt: Merge & Tái cấu trúc Kế hoạch theo Năm/Tháng/Ngày
Mục đích: Merge 2 hệ thống kế hoạch song song (W1–W23 cũ + KE_HOACH_CON_LAI/TUAN/R01–R90 mới) thành cấu trúc phân cấp theo Năm → Tháng → Ngày. Mỗi cấp folder có file tổng hợp tiến độ.
Soạn theo: vg-prompter v3.0 | Ngày tạo: 27/09/2026
Target: AI agent có quyền đọc toàn bộ workspace CXK, tạo/sửa/xoá/di chuyển file.
A. BỐI CẢNH & HIỆN TRẠNG
A1. Hai hệ thống kế hoạch đang song song
| Hệ thống | Vị trí | Số file | Dung lượng | Format |
|---|---|---|---|---|
| W cũ (W1–W23) | docs/research/plans/W{n}/ |
170 files | 0.6 MB | D{nn}_T{day}_{name}.md — kế hoạch theo tuần 21 tuần NCKH |
| R mới (R01–R90) | docs/research/plans/KE_HOACH_CON_LAI/TUAN/R{nn}/ |
630 ngày + 90 README + 90 stub | 6.8 MB | NGAY_YYYYMMDD.md — chi tiết theo ngày, có người làm, đầu vào, DoD |
A2. Phạm vi ngày
| Hệ thống | Bắt đầu | Kết thúc | Ghi chú |
|---|---|---|---|
| W cũ | ~21/09/2026 (W1) | ~15/02/2027 (W23) | Dùng format D01_T2 = Ngày 1, Thứ 2 |
| R mới | 28/09/2026 (R01) | 18/06/2028 (R90) | Dùng ngày cụ thể YYYYMMDD |
A3. Overlap
- W1 (21–27/09) TRƯỚC R01 (28/09) → không overlap về ngày.
- W2–W23 (28/09/2026 – 15/02/2027) CHỒNG R01–R20 (28/09/2026 – 14/02/2027).
- W cũ thiếu chi tiết (5–6KB/file, không có người cụ thể, không có giờ).
- R mới chi tiết hơn (7–12KB/file, có NCS1/NCS2, có giờ, có đầu vào/đầu ra).
A4. File hỗ trợ trong KE_HOACH_CON_LAI (root)
| File | Kích thước | Vai trò |
|---|---|---|
DANH_MUC_CONG_VIEC.md |
934 KB | Danh mục mã R001–R??? với đầy đủ đặc tả |
DU_LIEU_CONG_VIEC.json |
987 KB | Dữ liệu structured cho mọi công việc |
DU_LIEU_CONG_VIEC_AI.json |
785 KB | Phần việc AI |
KE_HOACH_AI_CHI_TIET.md |
333 KB | Kế hoạch chi tiết phần AI tự làm |
LICH_AI_VA_REVIEW.md |
264 KB | Lịch AI produce + NCS/CVYK review |
LICH_CHI_TIET.json |
734 KB | Lịch structured |
LICH_TONG_HOP.md |
15 KB | Bảng chọn tuần R01–R90 |
DOI_SOAT_HIEN_TRANG.md |
24 KB | So sánh đã làm vs chưa làm |
GIA_DINH_VA_DIEU_KIEN_LICH.md |
19 KB | Giả định về giờ, ràng buộc |
README.md |
5 KB | Hướng dẫn sử dụng |
THAM_CHIEU_ROADMAP_V7.md |
23 KB | Lịch sử đối chiếu |
VAI_TRO_VA_SAN_PHAM_BAN_GIAO.md |
30 KB | Phân công vai trò |
Review/ |
(subfolder) | Các file review |
B. CẤU TRÚC MỤC TIÊU
B1. Cấu trúc mới — Phân cấp Năm/Tháng/Ngày
docs/research/plans/
├── README.md # Tổng quan + link nhanh
├── ROADMAP.md # Roadmap tổng (giữ nguyên)
├── KIEN_TRUC_DU_AN.md # Kiến trúc (giữ nguyên)
├── PHAN_TICH_DU_AN.md # Phân tích (giữ nguyên)
├── DANH_MUC_CONG_VIEC.md # Moved from KE_HOACH_CON_LAI/
├── VAI_TRO_VA_SAN_PHAM_BAN_GIAO.md # Moved from KE_HOACH_CON_LAI/
│
├── 2026/
│ ├── README.md # Tổng hợp năm 2026: tiến độ, milestone
│ ├── 09/
│ │ ├── README.md # Tổng hợp tháng 09/2026
│ │ ├── 2026-09-21.md # Từ W1/D01 (nếu có nội dung)
│ │ ├── 2026-09-22.md # Từ W1/D02
│ │ ├── ...
│ │ ├── 2026-09-28.md # Merge: W1 + R01/NGAY_20260928
│ │ └── 2026-09-30.md
│ ├── 10/
│ │ ├── README.md # Tổng hợp tháng 10/2026
│ │ ├── 2026-10-01.md # Từ R01/NGAY_20261001
│ │ └── ...
│ ├── 11/
│ │ └── ...
│ └── 12/
│ └── ...
│
├── 2027/
│ ├── README.md
│ ├── 01/
│ │ └── ...
│ ├── ...
│ └── 12/
│ └── ...
│
├── 2028/
│ ├── README.md
│ ├── 01/ ... 06/
│ └── ...
│
├── _archive/ # Lưu trữ file cũ không merge được
│ ├── W_legacy/ # W1–W23 gốc (backup)
│ ├── KE_HOACH_CON_LAI_meta/ # File hỗ trợ gốc (JSON, review, etc.)
│ └── README.md
│
├── CAMERA_MODULE_TASK_BOARD.md # Camera tích hợp — nằm cùng plans/
├── DAC_TA_CAMERA.md
├── MA_TRAN_Y_KHOA_CAMERA.md
├── _PHUONG_AN_NANG_CAP_V6_CAMERA.md
├── LICH_SU_CAMERA/
├── _DANH_GIA_TONG_THE_KE_HOACH.md
└── _DANH_GIA_TONG_THE_KE_HOACH_V2.md
B2. Quy tắc tên file ngày
- Format:
YYYY-MM-DD.md(ví dụ:2026-09-28.md) - Giống format diary → dễ cross-reference
- Không dùng prefix
NGAY_(dư thừa khi đã nằm trong folder tháng)
B3. File README tổng hợp cho mỗi cấp
README.md cấp năm (2026/README.md):
# Kế hoạch năm 2026
> Tự động tổng hợp. Cập nhật lần cuối: [YYYY-MM-DD]
## Tổng quan
- **Tổng tháng hoạt động:** 4 (09–12)
- **Tổng ngày có kế hoạch:** XX
- **Milestone chính:** [Liệt kê từ ROADMAP]
## Theo tháng
| Tháng | Số ngày KH | Trọng tâm | Link |
|---|---|---|---|
| 09 | 10 | Khởi động, yêu cầu, phạm vi | <code>📄 09/</code> |
| 10 | 31 | Tri thức y khoa, schema, thử giới hạn | <code>📄 10/</code> |
| ... | ... | ... | ... |
README.md cấp tháng (2026/10/README.md):
# Tháng 10/2026
> Tự động tổng hợp. Cập nhật lần cuối: [YYYY-MM-DD]
## Trọng tâm tháng
- [Trích từ LICH_TONG_HOP hoặc ROADMAP — tuần nào rơi vào tháng này]
## Lịch ngày
| Ngày | Thứ | Người làm | Trọng tâm | Trạng thái |
|---|---|---|---|---|
| [01](../plans/2026/10/2026-10-01.html) | Th.5 | NCS1, NCS2 | Đối chiếu yêu cầu | 📋 KH |
| [02](../plans/2026/10/2026-10-02.html) | Th.6 | NCS1 | Schema v1 | 📋 KH |
| ... | ... | ... | ... | ... |
## Tiến độ
- ✅ Xong: X/Y task
- 🔄 Đang làm: Z task
- ⚠️ Blocker: ...
C. QUY TRÌNH THỰC HIỆN
C1. Phân tích & Lập mapping (KHÔNG sửa file)
- Parse W1–W23: Với mỗi file
D{nn}_T{day}_{name}.md, xác định ngày cụ thể dựa trên header (ví dụ: "Ngày 01 — Thứ Hai, 21/09/2026"). - Parse R01–R90: Với mỗi file
NGAY_YYYYMMDD.md, trích ngày từ tên file. - Detect overlap: Ngày nào có cả W file và R file → cần merge.
- Tạo bảng mapping hoàn chỉnh:
| Ngày | Nguồn W | Nguồn R | Hành động |
|---|---|---|---|
| 2026-09-21 | W1/D01_T2_khoi_dong.md | — | Move |
| 2026-09-28 | — | R01/NGAY_20260928.md | Move |
| 2026-10-05 | W2/D01_T2_xxx.md | R02/NGAY_20261005.md | Merge |
- Xuất bảng mapping ra file
_mapping_plan.mdđể NCS review trước khi thực hiện.
C2. Chiến lược merge khi overlap
Khi 1 ngày có cả file W và file R:
- Nếu R có nội dung chi tiết hơn (>5KB, có người, giờ, DoD) → dùng R làm base, append nội dung unique từ W vào cuối dưới section
## Từ kế hoạch ban đầu (W{n}). - Nếu W có nội dung unique (task ID, file tham chiếu mà R không có) → merge section đó vào R.
- Nếu W chỉ là phiên bản sơ bộ của R → dùng R, archive W.
- Mọi trường hợp: giữ cross-references từ cả 2 nguồn.
C3. Di chuyển file hỗ trợ
| File gốc | Đích | Lý do |
|---|---|---|
DANH_MUC_CONG_VIEC.md |
plans/DANH_MUC_CONG_VIEC.md |
File tra cứu chính, cần ở root plans/ |
VAI_TRO_VA_SAN_PHAM_BAN_GIAO.md |
plans/VAI_TRO_VA_SAN_PHAM_BAN_GIAO.md |
File tra cứu chính |
_archive/KE_HOACH_CON_LAI_meta/LICH_TONG_HOP.md |
Nội dung merge vào plans/README.md |
Thay bằng link sang cấp năm/tháng |
DOI_SOAT_HIEN_TRANG.md |
plans/DOI_SOAT_HIEN_TRANG.md |
Dùng ongoing |
KE_HOACH_CON_LAI/*.json |
plans/_archive/KE_HOACH_CON_LAI_meta/ |
Dữ liệu structured → archive |
_archive/KE_HOACH_CON_LAI_meta/KE_HOACH_AI_CHI_TIET.md |
plans/_archive/KE_HOACH_CON_LAI_meta/ |
Quá lớn (333KB), dùng ref |
_archive/KE_HOACH_CON_LAI_meta/LICH_AI_VA_REVIEW.md |
plans/_archive/KE_HOACH_CON_LAI_meta/ |
Quá lớn (264KB), dùng ref |
C4. File camera & đánh giá
Camera là module tích hợp trong sản phẩm chính (tùy chọn hỗ trợ đánh giá sâu hơn).
Giữ các file camera và đánh giá ngay tại root plans/ — không tách subfolder riêng:
- CAMERA_MODULE_TASK_BOARD.md, DAC_TA_CAMERA.md, MA_TRAN_Y_KHOA_CAMERA.md, _PHUONG_AN_NANG_CAP_V6_CAMERA.md, LICH_SU_CAMERA/
- _DANH_GIA_TONG_THE_KE_HOACH.md, _DANH_GIA_TONG_THE_KE_HOACH_V2.md
- 20260926_NANG_CAP_TONG_THE/
C6. Cập nhật cross-references
BẮT BUỘC: Sau khi di chuyển, quét toàn bộ workspace CXK:
1. Tìm mọi link trỏ đến file cũ (W{n}/D{nn}, KE_HOACH_CON_LAI/TUAN/R{nn}, etc.)
2. Cập nhật sang đường dẫn mới (2026/09/2026-09-28.md, etc.)
3. Kiểm tra broken links
C7. Sinh README tổng hợp
Sau khi di chuyển xong:
1. Mỗi folder tháng: Tự động sinh README.md dựa trên file ngày trong folder.
2. Mỗi folder năm: Tổng hợp từ các README tháng.
3. Root plans/README.md: Tổng hợp toàn bộ + link nhanh.
D. KIỂM TRA CHẤT LƯỢNG
D1. Trước khi thực hiện
- [ ] Bảng mapping đã xuất ra
_mapping_plan.md - [ ] NCS đã review mapping (hoặc AI tự xác nhận logic)
- [ ] Backup folder
plans/hiện tại (hoặc Git commit)
D2. Sau khi thực hiện
- [ ] Mọi file
NGAY_YYYYMMDD.mdđã nằm đúngYYYY/MM/YYYY-MM-DD.md - [ ] Mọi file
D{nn}_T{day}.mdtừ W cũ đã được merge hoặc archive - [ ] Folder
KE_HOACH_CON_LAI/đã dọn sạch (nội dung chuyển hết) - [ ] Folder
W1/–W23/đã dọn sạch hoặc archive - [ ] README tổng hợp đã sinh cho mọi cấp (năm, tháng)
- [ ]
python tools/check_structure.py— 0 HIGH - [ ] Scan broken links — 0 broken (trừ placeholder)
- [ ] Cập nhật
docs/INDEX.mdphản ánh cấu trúc mới - [ ] Cập nhật
ROADMAP.mdlink sang cấu trúc mới - [ ] Ghi diary
D3. Ước tính quy mô
| Hạng mục | Số lượng |
|---|---|
| File ngày cần di chuyển (R) | ~630 |
| File ngày cần merge (W overlap R) | ~100 (ước) |
| File ngày chỉ W (không có R) | ~7 (W1 trước 28/09) |
| Folder tháng cần tạo | ~22 (09/2026 – 06/2028) |
| Folder năm cần tạo | 3 (2026, 2027, 2028) |
| README cần sinh | ~25 (22 tháng + 3 năm) |
| Cross-references cần cập nhật | Ước ~200–500 |
E. ƯU TIÊN THỰC HIỆN
- Bước 1 — Script mapping: Parse W + R, xuất
_mapping_plan.md→ DỪNG chờ review. - Bước 2 — Di chuyển R (không overlap): Move file R vào cấu trúc mới (phần lớn = 630 file).
- Bước 3 — Merge W+R (overlap): Xử lý từng file overlap theo chiến lược C2.
- Bước 4 — Move W-only: Di chuyển file W không có R tương ứng.
- Bước 5 — Di chuyển file hỗ trợ: Theo bảng C3.
- Bước 6 — Gom camera + đánh giá: Theo C4 + C5.
- Bước 7 — Sinh README: Tự động tạo cho mọi cấp.
- Bước 8 — Cập nhật cross-references: Quét toàn bộ workspace.
- Bước 9 — Cleanup: Xoá folder rỗng, kiểm tra.
- Bước 10 — Cập nhật INDEX + diary.
F. GHI CHÚ
- KHÔNG xoá dữ liệu: Mọi file gốc phải được archive hoặc merge, không mất nội dung.
- JSON lớn (>700KB): Chuyển vào
_archive/, không để trong cấu trúc chính. - File >300KB: Archive, chỉ giữ link tham chiếu trong README.
- Tuân thủ encoding: UTF-8 không BOM cho mọi file mới.
- Tuân thủ naming:
YYYY-MM-DD.mdcho file ngày,README.mdcho tổng hợp.