VuQuangBao
a85b0ccac8
Also drop .github/ (GitHub-specific CI/CD workflows and ArgoCD operational scripts) from this mirror -- Gitea auto-picked up .github/workflows/*.yml as Actions and queued a run against secrets that don't exist here. Not meaningful outside the GitHub-hosted repo anyway.
32 lines
1.6 KiB
Markdown
32 lines
1.6 KiB
Markdown
# docs-legacy — lịch sử dự án
|
|
|
|
`docs/` là bộ tài liệu chuẩn. Thư mục này **chỉ còn giữ lịch sử**: những gì
|
|
không tái tạo được từ code.
|
|
|
|
| Mục | Là gì | Vì sao giữ |
|
|
|---|---|---|
|
|
| `adr/` | 11 Architecture Decision Record | Lịch sử quyết định. `apps/ai-service/routers/rag.py:436` tham chiếu trực tiếp `adr/0006` |
|
|
| `pdf-parsing-outlier-catalog.md` | Danh mục ca lỗi khi bóc PDF | **Code đang dùng**: `ingestion/cli.py`, `extract/glyph_order.py`, `extract/models.py` và một test đều trỏ tới file này |
|
|
|
|
Nhật ký phát triển chi tiết (`progress-log.md`, ~326 KB, đo lường/ngõ cụt/quyết định
|
|
theo từng phiên làm việc) không nằm trong bản mirror này — chỉ có trong repo gốc.
|
|
|
|
## Đã xoá 2026-08-24
|
|
|
|
Bộ `00-29`, `architecture.md`, các thư mục diataxis (`explanation/`, `how-to/`,
|
|
`reference/`, `runbooks/`, `tutorials/`) và các tài liệu kế hoạch/kiểm kê
|
|
(`DOCUMENTATION_PLAN.md`, `diataxis-audit.md`, `document-profile.md`,
|
|
`bao-cao-kiem-ke-...-2026-08-13.md`, `ke-hoach-showcase-...`,
|
|
`pipeline-tu-pdf-den-chatbot-production.md`).
|
|
|
|
Lý do: `docs/` đã thay thế chúng và được viết lại từ code, còn bộ này mô tả trạng
|
|
thái cũ nên đọc vào dễ hiểu sai. Đã kiểm không file nào trong số đó được code hay
|
|
`docs/` tham chiếu.
|
|
|
|
Cần đọc lại thì lấy từ lịch sử Git — chúng được track, không mất:
|
|
|
|
```bash
|
|
git log --oneline -- docs-legacy/00-project-overview.md
|
|
git show <sha>^:docs-legacy/00-project-overview.md
|
|
```
|