Kế hoạch Tái cấu trúc docs/ — Dry Run
Ngày: 26/09/2026 | Trạng thái: DRY-RUN (chưa thực hiện)
Ảnh hưởng: ~30 file .md cần đổi tên/di chuyển, ~15 file cần sửa cross-references
1. Nguyên tắc đổi tên
| Quy tắc | Ví dụ |
|---|---|
Xóa prefix số cũ (01_, 02_...) |
02_BAO_CAO... → BAO_CAO... |
| snake_case VIẾT HOA không dấu | Phụ lục 8_ Hướng dẫn... → PHU_LUC_8_HUONG_DAN_AI_TAO_SINH.md |
| Tên phản ánh nội dung, không phải thứ tự | 09_PROMPT_DEEP_RESEARCH_KIEN_TRUC_PROJECT.md → giữ nguyên (đã rõ nghĩa) |
| File mới tạo (10_ANALYSIS, 10_ROADMAP) → giữ nguyên | Vừa tạo, tên đã chuẩn |
2. Bảng Ánh xạ Đổi tên & Di chuyển
2.1 docs/research/requirements/
| File hiện tại | Tên mới | Hành động |
|---|---|---|
01_YEU_CAU_GOC_VA_LICH_SU_NGHIEN_CUU.md |
YEU_CAU_GOC.md |
Đổi tên |
Phu luc 6_ Báo cáo kết quả...docx.md |
PHU_LUC_6_MAU_BAO_CAO_KET_QUA.md |
Đổi tên |
Phụ lục 3_Hướng dẫn ghi nhật ký.docx.md |
PHU_LUC_3_HUONG_DAN_GHI_NHAT_KY.md |
Đổi tên |
Phụ lục 8_ Hướng dẫn sử dụng AI tạo sinh.docx.md |
PHU_LUC_8_HUONG_DAN_AI_TAO_SINH.md |
Đổi tên |
2.2 docs/research/reports/
| File hiện tại | Tên mới | Hành động |
|---|---|---|
02_BAO_CAO_NGHIEN_CUU_TONG_THE.md |
BAO_CAO_NGHIEN_CUU_TONG_THE.md |
Đổi tên |
03_TOM_TAT_DE_CUONG_NGHIEN_CUU.md |
DE_CUONG_NGHIEN_CUU.md |
Đổi tên |
08_TOAN_BO_NOI_DUNG_NGHIEN_CUU.md |
TONG_HOP_NGHIEN_CUU_ARCHIVE.md |
Đổi tên (rõ là archive) |
11_OBSIDIAN_VS_RAG_DEEP_RESEARCH.md |
DEEP_RESEARCH_OBSIDIAN_VS_RAG.md |
Đổi tên |
12_DEEP_RESEARCH_CAMERA_QUAN_SAT_CU_DONG.md |
DEEP_RESEARCH_CAMERA.md |
Đổi tên |
14_CHIEN_LUOC_BAO_VE_AI_PL8.md |
CHIEN_LUOC_BAO_VE_PL8.md |
Đổi tên |
2.3 docs/research/plans/
| File hiện tại | Tên mới | Hành động |
|---|---|---|
10_KIEN_TRUC_VA_KE_HOACH_TRIEN_KHAI.md |
KIEN_TRUC_DU_AN.md |
Đổi tên |
10_ROADMAP.md |
ROADMAP.md |
Đổi tên |
10_ANALYSIS.md |
PHAN_TICH_DU_AN.md |
Đổi tên |
CAMERA_MODULE_TASK_BOARD.md |
Giữ nguyên | — |
_DANH_GIA_TONG_THE_KE_HOACH.md |
Giữ nguyên | Đã có _ prefix = internal |
_DANH_GIA_TONG_THE_KE_HOACH_V2.md |
Giữ nguyên | Đã có _ prefix |
_PHUONG_AN_NANG_CAP_V6_CAMERA.md |
Giữ nguyên | Đã có _ prefix |
task_list.txt |
Giữ nguyên | — |
| W1–W21 folders | Giữ nguyên | — |
2.4 docs/research/references/
| File hiện tại | Tên mới | Hành động |
|---|---|---|
07_NGUON_THAM_KHAO_VA_GHI_CHU_XUAT.md |
NGUON_THAM_KHAO.md |
Đổi tên |
2.5 docs/research/prompts/ — 14 files
| File hiện tại | Tên mới | Hành động |
|---|---|---|
Tất cả 14 file 09_PROMPT_... → 20_PROMPT_... |
Xóa prefix số, giữ PROMPT_ |
Đổi tên hàng loạt |
Ví dụ:
09_PROMPT_DEEP_RESEARCH_KIEN_TRUC_PROJECT.md→PROMPT_DEEP_RESEARCH_KIEN_TRUC_PROJECT.mdPrompts là file tham khảo, ít ai link đến. Rủi ro thấp.
2.6 Di chuyển file giữa thư mục
| File | Vị trí hiện tại | Vị trí mới | Lý do |
|---|---|---|---|
OUTLINE_BAO_CAO_15_TRANG.md |
docs/reports/final/ |
docs/research/reports/ |
Đây là outline nghiên cứu, không phải report cuối |
W1_D06_VoiceUX_Notes.md |
docs/design/ |
docs/research/plans/W1/ |
Thuộc deliverable W1 |
2.7 Thư mục gộp/xóa
| Thư mục | Trạng thái | Hành động |
|---|---|---|
docs/architecture/ |
Trống | Xóa (nội dung kiến trúc đã ở research/plans/) |
docs/gates/ |
Trống | Xóa (gate tracking đã ở research/plans/) |
docs/reports/final/ |
1 file → di chuyển | Xóa sau khi di chuyển OUTLINE |
docs/reports/weekly/ |
Kiểm tra | Giữ nếu có nội dung |
3. Cross-references cần cập nhật
| File chứa link | Số links cần sửa | Ghi chú |
|---|---|---|
docs/INDEX.md |
~15 | File bản đồ dự án — nhiều link nhất |
docs/research/00_MUC_LUC.md |
~13 | Mục lục nghiên cứu |
AGENTS.md |
~5 | Link đến file 10, glossary |
README.md |
~5 | Link đến reports, plans |
docs/research/plans/KIEN_TRUC_DU_AN.md |
~12 | File kiến trúc — nhiều internal links |
docs/research/plans/ROADMAP.md |
~8 | Roadmap links |
docs/research/plans/PHAN_TICH_DU_AN.md |
~5 | Analysis links |
docs/research/reports/TONG_HOP_NGHIEN_CUU_ARCHIVE.md |
~10 | Archive — section markers |
docs/diary/2026-09-23.md → 2026-09-25.md |
~4 mỗi file | Diary entries |
docs/project/project_charter.md |
~1 | Link đến camera report |
docs/guides/HUONG_DAN_ANTIGRAVITY_CXK.md |
~4 | Link đến plans |
docs/research/plans/CAMERA_MODULE_TASK_BOARD.md |
~1 | Link đến camera report |
4. Thứ tự thực hiện (nếu duyệt)
- Bước 1: Đổi tên tất cả file (dùng
git mvhoặcMove-Item) - Bước 2: Di chuyển OUTLINE và VoiceUX
- Bước 3: Xóa thư mục trống
- Bước 4: Cập nhật cross-references (script Python quét + replace)
- Bước 5: Chạy
check_structure.py+check_glossary.py - Bước 6: Cập nhật
00_MUC_LUC.md,INDEX.md,README.md - Bước 7: Ghi diary
5. Rủi ro
| Rủi ro | Mức | Giảm thiểu |
|---|---|---|
| Gãy cross-reference | Cao | Script Python quét toàn bộ .md files |
| Mất file trên shared drive | Trung bình | Dùng copy → verify → delete (không dùng move) |
| AGENTS.md link sai | Cao | Kiểm tra thủ công sau |
| Obsidian graph bị vỡ | Thấp | Obsidian tự rebuild graph |
Ước lượng: ~15–20 phút thực thi + 5 phút kiểm tra.
Bấm Proceed để thực hiện.