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: 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
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,

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 + / 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)

  1. 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").
  2. Parse R01–R90: Với mỗi file NGAY_YYYYMMDD.md, trích ngày từ tên file.
  3. Detect overlap: Ngày nào có cả W file và R file → cần merge.
  4. 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 |
  1. 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:

  1. 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}).
  2. Nếu W có nội dung unique ( ID, file tham chiếu mà R không có) → merge section đó vào R.
  3. Nếu W chỉ là phiên bản sơ bộ của R → dùng R, archive W.
  4. 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 đúng YYYY/MM/YYYY-MM-DD.md
  • [ ] Mọi file D{nn}_T{day}.md từ 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.md phản ánh cấu trúc mới
  • [ ] Cập nhật ROADMAP.md link 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

  1. Bước 1 — Script mapping: Parse W + R, xuất _mapping_plan.md → DỪNG chờ review.
  2. 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).
  3. Bước 3 — Merge W+R (overlap): Xử lý từng file overlap theo chiến lược C2.
  4. Bước 4 — Move W-only: Di chuyển file W không có R tương ứng.
  5. Bước 5 — Di chuyển file hỗ trợ: Theo bảng C3.
  6. Bước 6 — Gom camera + đánh giá: Theo C4 + C5.
  7. Bước 7 — Sinh README: Tự động tạo cho mọi cấp.
  8. Bước 8 — Cập nhật cross-references: Quét toàn bộ workspace.
  9. Bước 9 — Cleanup: Xoá folder rỗng, kiểm tra.
  10. 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.md cho file ngày, README.md cho tổng hợp.