Nhật ký — 27/09/2026
Phiên [16:30] — Merge & Tái cấu trúc Kế hoạch Năm/Tháng/Ngày
Công việc đã thực hiện
✅ Viết prompt merge 2 hệ thống kế hoạch (W cũ + R mới) → docs/research/prompts/20260927_1632_PROMPT_MERGE_KE_HOACH_THEO_NAM_THANG_NGAY.md
✅ Script mapping: Parse W1-W23 (48 ngày + 122 file khác) + R01-R90 (630 ngày) → 636 ngày duy nhất, 18 overlap
✅ Thực hiện restructure:
- 612 file R di chuyển vào YYYY/MM/YYYY-MM-DD.md
- 18 file overlap merge (R làm base, append W unique)
- 6 file W-only di chuyển
- 23 folder W1-W23 archive → _archive/W_legacy/
- 7 file meta archive → _archive/KE_HOACH_CON_LAI_meta/
- 25 README tổng hợp sinh tự động (22 tháng + 3 năm)
- Xoá folder KE_HOACH_CON_LAI/ sau khi chuyển hết
✅ Fix cross-references: 5906 links sửa (207 + 5071 + 628), còn 78 broken (99.3% clean)
✅ Cập nhật docs/INDEX.md Section 5 phản ánh cấu trúc mới
✅ Cập nhật tools/check_structure.py — thêm _archive vào excluded dirs → 0 HIGH
✅ Camera files giữ ở root plans/ (không tách subfolder — module tích hợp)
File đã tạo/sửa
docs/research/prompts/20260927_1632_PROMPT_MERGE_KE_HOACH_THEO_NAM_THANG_NGAY.md(mới)docs/research/plans/2026/— 4 tháng, 101 ngày (mới)docs/research/plans/2027/— 12 tháng, 365 ngày (mới)docs/research/plans/2028/— 6 tháng, 170 ngày (mới)docs/research/plans/_archive/— W legacy + KE_HOACH_CON_LAI meta (mới)docs/INDEX.md(sửa — Section 5 cập nhật)tools/check_structure.py(sửa — thêm_archiveexclusion)- ~640 file .md trong plans/ (sửa cross-references)
Quyết định quan trọng
- Camera module KHÔNG tách subfolder riêng — nằm ở root
plans/vì là module tích hợp - Folder
KE_HOACH_CON_LAI/xoá hoàn toàn sau khi backup đầy đủ vào_archive/ - Format file ngày:
YYYY-MM-DD.md(thống nhất với diary)
Phiên [21:10] — Nâng cấp Website HTML theo Kế hoạch Năm/Tháng/Ngày & Tối ưu Link Audit (0 Broken Links)
Công việc đã thực hiện
✅ Nâng cấp tools/build_docs_site.py:
- Hỗ trợ phân loại taxonomy cho hệ thống kế hoạch Năm/Tháng/Ngày: research/plans/(\d{4})/(\d{2}), research/plans/(\d{4}), research/plans/_archive/.
- Nâng cấp build_smart_link_replacer: ánh xạ liên kết ngày YYYY-MM-DD, folder KE_HOACH_CON_LAI cũ sang _archive/KE_HOACH_CON_LAI_meta/, folder W1-W23 cũ sang _archive/W_legacy/, và định dạng tham chiếu code (.py, .sql) thành thẻ code không sinh link 404 hỏng.
- Tự động đăng ký trước toàn bộ các Hubs (subdirs) vào danh bạ đích (all_dest_set và external_alias_map) giúp các link trỏ đến folder phân cấp resolve chuẩn xác.
- Sửa lỗi liên kết footer cứng trỏ vào guides/TROUBLESHOOTING_W5_W6.html (chuyển sang guides/HUONG_DAN_ANTIGRAVITY_CXK.html), xoá sạch hơn 2.000 cảnh báo broken link do footer lặp lại trên toàn site.
- Bổ sung hàm clean_orphaned_files(): quét và dọn dẹp triệt để 1.176 file HTML mồ côi tồn đọng từ cấu trúc kế hoạch cũ.
✅ Biên dịch toàn bộ tài liệu dự án:
- Xuất thành công 2.010 trang tài liệu HTML + 150 trang Subfolder Hubs tra cứu phân cấp.
- Tự động kiểm thử liên kết (Link Audit): kiểm tra 85.901 lượt liên kết nội bộ, xác nhận 0 broken links (100% hợp lệ).
✅ Rà soát và chuẩn hoá thuật ngữ:
- Sửa các lỗi HIGH thuật ngữ trong docs/research/prompts/20260925_1939_PROMPT_DEEP_RESEARCH_DOCS_CONFLICT.md và docs/research/prompts/20260926_0036_PROMPT_NANG_CAP_DE_CUONG_03.md.
- Xác nhận 0 vi phạm HIGH cấu trúc (check_structure.py) và 0 vi phạm HIGH thuật ngữ (check_glossary.py).
File đã tạo/sửa
tools/build_docs_site.py(sửa — bổ sung taxonomy plans mới, link replacer thông minh, clean orphaned files, fix link footer)docs/research/prompts/20260925_1939_PROMPT_DEEP_RESEARCH_DOCS_CONFLICT.md(sửa — chuẩn hoá thuật ngữ)docs/research/prompts/20260926_0036_PROMPT_NANG_CAP_DE_CUONG_03.md(sửa — chuẩn hoá thuật ngữ)html/— cập nhật toàn bộ 2.010 trang HTML và 150 trang Hubs mới nhất
Quyết định quan trọng
- Xoá hoàn toàn các file HTML mồ côi khi tái cấu trúc tài liệu để đảm bảo
search_index.jsonkhông trỏ vào trang ảo và tránh broken links ngầm. - Định dạng các tham chiếu file mã nguồn (
.py,.sql) thành code blocks trong văn bản thay vì cố gắng sinh link HTML rỗng khi chưa có trang HTML tương ứng.
✍️ BẢN VIẾT TAY — Phụ lục 3
1. Mục tiêu hôm nay
- Tái cấu trúc và hợp nhất toàn bộ hệ thống kế hoạch dự án thành cấu trúc phân cấp Năm/Tháng/Ngày (
2026/,2027/,2028/,_archive/). - Sửa toàn bộ liên kết chéo (cross-references) trong các tài liệu kế hoạch.
- Nâng cấp bộ sinh website
tools/build_docs_site.pytương thích hoàn toàn với cấu trúc mới, dọn dẹp file HTML mồ côi, đạt 0 broken links và 0 vi phạm quy tắc.
2. Dụng cụ / Thiết bị
- Hệ thống công cụ Python:
tools/build_docs_site.py,tools/check_structure.py,tools/check_glossary.py. - Môi trường PowerShell trên Windows Server, Antigravity AI Agent.
- Bộ font và theme MD3, Chart.js, Mermaid.js, SVG Icons cho website tài liệu.
3. Tiến trình / Hiện tượng quan sát
- Sáng & Chiều: Hợp nhất thành công 636 ngày kế hoạch duy nhất (09/2026 đến 06/2028), lưu trữ cấu trúc W cũ vào
_archive/. Sửa hơn 5.900 liên kết chéo. - Tối: Biên dịch website tài liệu HTML. Ban đầu phát hiện 4.509 cảnh báo liên kết, trong đó có hơn 2.000 liên kết hỏng từ footer chung trỏ vào file không tồn tại.
- Xử lý link replacer thông minh, sửa link footer và bổ sung tính năng dọn dẹp 1.176 file HTML mồ côi.
- Kết quả Link Audit trên toàn site chuyển từ 4.509 lỗi về 0 broken links trên tổng số 85.901 liên kết được quét.
4. Dữ liệu thô / Kết quả
- 636 file kế hoạch ngày phân bổ theo 3 năm và 22 thư mục tháng.
- 2.010 trang HTML tài liệu và 150 trang Hubs danh mục được biên dịch hoàn chỉnh.
- Kiểm thử liên kết: 85.901 links checked, 0 broken links (tỷ lệ hợp lệ 100%).
- Kiểm tra cấu trúc (
check_structure.py): 0 vi phạm HIGH. - Kiểm tra thuật ngữ (
check_glossary.py): 0 vi phạm HIGH.
5. Lỗi sai / Rủi ro / Bài học
- Lỗi sai: File footer template dùng đường dẫn tĩnh trỏ vào file tài liệu cũ không tồn tại, khiến lỗi bị nhân bản trên từng trang HTML được sinh ra.
- Bài học: Khi tái cấu trúc thư mục quy mô lớn, việc dọn dẹp các tệp HTML mồ côi (
clean_orphaned_files) là bắt buộc để tránh tạo liên kết chết và sai lệch chỉ mục tìm kiếm. - Rủi ro đã phòng ngừa: Các tham chiếu file code
.py/.sqlđược bọc dạng code inline, tránh sinh link web hỏng dẫn đến 404.
6. Kế hoạch tiếp theo
- Triển khai nội dung chi tiết cho các thẻ tri thức (Knowledge Cards) còn ở trạng thái DRAFT.
- Bắt đầu triển khai các tác vụ kiểm thử và nghiên cứu module camera quan sát cử động theo kế hoạch tuần tiếp theo.