# Manifest hồ sơ mẫu Kênh xây Kiến Minh

## 1. Mục đích sử dụng

File này dùng để:

- chốt danh sách hồ sơ mẫu đã chọn cho công trình Kênh xây;
- làm đầu vào gắn metadata và sắp thứ tự ingest;
- đánh dấu file nên ưu tiên, file trùng và file cần xác minh;
- giữ một bộ tham chiếu ổn định cho chuẩn hóa hồ sơ công trình nhỏ.

Nguồn khảo sát: `HĐ-2026/Phòng KT xã Kiến Minh-2026/Kênh xây/`

## 2. Cách đọc manifest

### Nhãn chính

| Trường | Ý nghĩa ngắn |
|---|---|
| `document_group` | Nhóm hồ sơ chuẩn hóa |
| `document_type` | Loại tài liệu cụ thể |
| `package_label` | Gói công việc liên quan |
| `stage` | Giai đoạn sử dụng hồ sơ |
| `status` | `available` hoặc `needs_verification` |
| `is_ingest_candidate` | Có nên nạp ưu tiên vào retrieval không |
| `is_gold_reference` | Có giữ làm hồ sơ mẫu tham chiếu không |

### Quy ước nhanh

- `available`: tên file đủ rõ để phân loại.
- `needs_verification`: nên giữ nhưng cần kiểm tra sâu khi ingest.
- `is_ingest_candidate = false`: file trùng, file bìa, hoặc giá trị retrieval thấp.
- `is_gold_reference = true`: vẫn giữ trong bộ hồ sơ mẫu để đối chiếu workflow.

## 3. Tóm tắt inventory

| Chỉ số | Số lượng |
|---|---:|
| File khảo sát trong cây thư mục | 54 |
| File noise/hệ thống loại bỏ | 6 |
| Hồ sơ nghiệp vụ đưa vào manifest | 48 |
| Ưu tiên ingest | 40 |
| Giữ để audit, không ưu tiên ingest | 8 |

## 4. File noise đã loại khỏi manifest

Không đưa vào ingest/chuẩn hóa nghiệp vụ:

- `.DS_Store`
- file lock dạng `~$...`
- thành phần nội bộ của package `.pages`

Ví dụ đã loại:

- `HĐ-2026/Phòng KT xã Kiến Minh-2026/Kênh xây/.DS_Store`
- `HĐ-2026/Phòng KT xã Kiến Minh-2026/Kênh xây/Gói TCXD/~$ Đơn nhận thầu TCXD.doc`

## 5. Nhóm hồ sơ và anchor docs

### 5.1 Nhóm ưu tiên ingest trước

| Nhóm | Mục đích thực tế | Anchor docs |
|---|---|---|
| `project_overview` | Nhìn nhanh cấu trúc công trình, checklist hồ sơ | `0.DM hồ sơ - Kênh xây Kiến Minh_2026.xlsx` |
| `technical_design_estimate` | Căn cứ kỹ thuật, khối lượng, dự toán | `...TKTC_Ban Ve 2025.pdf`, `...Khoi Luong.xlsx`, `...Du toan sau tham dinh.xls` |
| `legal_approvals` | Căn cứ phê duyệt và lựa chọn nhà thầu | các file `QĐ ...pdf` trong `SỬA KÊNH XÂY/` |
| `construction_package` | Điều khoản gói thi công, pháp lý nhà thầu | `4. HD TCXD kenh xay.docx` |
| `execution_quality_payment` | Nhật ký, nghiệm thu, thanh toán, quyết toán | `nghiem thu khoi luong hoan thanh.docx`, `Quyết toán kx kien minh.xls` |
| `consulting_packages` | Thanh toán và biểu mẫu cho các gói tư vấn | các file `6a...docx`, `Phụ lục 03...xls`, `Mẫu 02A...xlsx` |

### 5.2 File nên xem là anchor docs

- `HĐ-2026/Phòng KT xã Kiến Minh-2026/Kênh xây/SỬA KÊNH XÂY/0.DM hồ sơ - Kênh xây Kiến Minh_2026.xlsx`
- `HĐ-2026/Phòng KT xã Kiến Minh-2026/Kênh xây/Kenh Xay Kien Minh_TKTC_Khoi Luong.xlsx`
- `HĐ-2026/Phòng KT xã Kiến Minh-2026/Kênh xây/Kenh Xay Kien Minh_TKTC_Du toan sau tham dinh.xls`
- `HĐ-2026/Phòng KT xã Kiến Minh-2026/Kênh xây/Kenh Xay Kien Minh_TKTC_Ban Ve 2025.pdf`
- `HĐ-2026/Phòng KT xã Kiến Minh-2026/Kênh xây/Gói TCXD/4. HD TCXD kenh xay.docx`
- `HĐ-2026/Phòng KT xã Kiến Minh-2026/Kênh xây/Gói TCXD/thanh toan lan 1 kx/nghiem thu khoi luong hoan thanh.docx`

## 6. Checklist làm việc với manifest

### Trước khi ingest

- [ ] Loại noise: `.DS_Store`, `~$`, asset nội bộ `.pages`.
- [ ] Giữ nguyên `relative_path` gốc để audit.
- [ ] Gắn đủ `document_group`, `document_type`, `stage`, `package_label`.
- [ ] Đánh dấu file trùng để tránh nạp lặp.
- [ ] Tách file cần xác minh ra hàng đợi review.

### Trong khi ingest

- [ ] Nạp trước các anchor docs.
- [ ] Nạp sau các file thanh toán, nghiệm thu, quyết toán.
- [ ] Chưa dùng file bìa làm nguồn trả lời chính.
- [ ] Với file tên mơ hồ, chỉ dùng khi có metadata xác nhận thêm.

### Sau khi ingest

- [ ] Kiểm tra retrieval có tách đúng theo nhóm hồ sơ không.
- [ ] Kiểm tra trùng giữa bản gốc và bản copy.
- [ ] Kiểm tra file `needs_verification` đã được xác nhận chưa.

## 7. Điểm cần chú ý để tránh trùng

| Cặp hồ sơ | Cách xử lý |
|---|---|
| Dự toán ở thư mục gốc và bản copy trong `SỬA KÊNH XÂY/` | Giữ bản gốc làm nguồn ingest chính |
| `Mẫu 02A - TCXD` ở `Gói TCXD/` và bản lặp trong thư mục tư vấn | Chỉ ingest 1 bản chính, giữ bản còn lại để audit |
| `PHAP LY.docx` ở `Gói TCXD/` và bản trong `IN - KENH XAY KM/` | Ưu tiên bản cấp trên, bản trong bộ in đánh dấu trùng |

## 8. File cần xác minh sâu

Các file dưới đây nên giữ trong manifest nhưng cần review bổ sung trước khi dùng làm căn cứ mạnh:

- `Gói TCXD/IN - KENH XAY KM/2. 5A.docx`
- `Gói TCXD/IN - KENH XAY KM/4. 4A.docx`
- `Gói TCXD/thanh toan lan 1 kx/7. 8A thi công - theo trọn gói.docx`
- `Gói TCXD/BGHĐ - kenh xay.xls`

Lý do:

- tên file mơ hồ;
- khó xác định chính xác loại biểu mẫu chỉ từ tên;
- dễ bị dùng sai vai trò nếu không kiểm tra nội dung.

## 9. Cách dùng file này trong workflow DSCons

- dùng như manifest chuẩn để map file thực tế sang taxonomy;
- dùng để lập hàng đợi ingest theo mức ưu tiên;
- dùng làm chuẩn so sánh khi đối chiếu công trình mới;
- dùng làm đầu vào cho gap analysis và missing-doc detection;
- dùng để huấn luyện agent không nhầm file bìa, file trùng và file mơ hồ.

## 10. File liên quan

- JSON máy đọc được: `docs/kenh-xay-document-manifest.json`
- Khảo sát cấu trúc mẫu: `docs/kenh-xay-template-survey.md`
- Blueprint huấn luyện mẫu: `docs/kenh-xay-training-template-blueprint.md`