# 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
```