# Gap analysis hồ sơ công trình - Đường từ nhà ông Nam đến cống chùa Hưng Khánh

## 1. Mục tiêu

- chốt nhanh hồ sơ đã có, hồ sơ thiếu và mức ảnh hưởng
- làm căn cứ cho next action trong workflow DSCons
- đồng bộ với manifest để phục vụ ingest, readiness và giao việc bổ sung hồ sơ
- tránh đánh giá sai tình trạng công trình khi mới chỉ có một phần hồ sơ

## 2. Phạm vi đánh giá

### Nguồn dùng để rà soát
- thư mục hồ sơ công trình đã khảo sát
- file danh mục hồ sơ tổng
- manifest công trình `docs/duong-ong-nam-hung-khanh-manifest.md`

### Trọng tâm đánh giá
- chuỗi pháp lý nền
- hồ sơ đấu thầu - hợp đồng gói 04
- hồ sơ thi công, nghiệm thu, thanh toán, quyết toán
- mức sẵn sàng để ingest và dùng cho workflow AI

## 3. Kết luận nhanh

### Hồ sơ đã có làm nền
- quyết định phê duyệt KHLCNT
- quyết định phê duyệt KQLCNT gói 04
- đơn nhận thầu gói 04
- biên bản thương thảo gói 04
- hợp đồng thi công gói 04
- bản vẽ PDF cơ bản
- file danh mục hồ sơ tổng

### Hồ sơ còn thiếu lớn
- quyết định phê duyệt nhiệm vụ và dự toán kinh phí
- quyết định phê duyệt BCKTKT
- bàn giao mặt bằng
- hồ sơ quản lý chất lượng
- nhật ký thi công
- biên bản nghiệm thu
- hoàn công
- hồ sơ thanh toán
- hồ sơ quyết toán
- thanh lý hợp đồng

### Nhận định vận hành
- công trình **đã có lõi pháp lý - đấu thầu - hợp đồng**
- công trình **chưa đủ bộ để kết luận readiness cho thanh toán hoặc quyết toán**
- DSCons nên coi đây là bộ pilot để chuẩn hóa workflow manifest → ingest → gap analysis → next action

## 4. Bảng gap analysis theo nhóm

| Nhóm hồ sơ | Hiện trạng | Mức độ thiếu | Tác động đến workflow |
| --- | --- | --- | --- |
| Pháp lý nền | thiếu một số quyết định gốc | Cao | làm yếu chuỗi căn cứ pháp lý |
| Đấu thầu gói 04 | có phần lõi | Trung bình | đủ để ingest đợt 1 |
| Hợp đồng gói 04 | có hợp đồng chính, thiếu phụ lục / bảo lãnh | Cao | tra cứu được nhưng chưa đủ để đối chiếu sâu |
| Thi công | thiếu nhiều | Rất cao | chưa thể nối từ hợp đồng sang thực hiện |
| Nghiệm thu | gần như chưa có | Rất cao | chặn readiness hoàn thành |
| Thanh toán | chưa thấy bộ hồ sơ | Rất cao | chưa thể chạy workflow thanh toán |
| Quyết toán | chưa thấy bộ hồ sơ | Rất cao | chưa thể chạy workflow quyết toán |
| Kiểm toán | chưa thấy hồ sơ | Trung bình | chưa phải ưu tiên trước mắt |

## 5. Phân tích chi tiết theo nhóm

### 5.1 Pháp lý nền

**Đã có**
- QĐ phê duyệt KHLCNT
- biểu kèm theo KHLCNT ở dạng file Word cần xác nhận
- QĐ phê duyệt KQLCNT gói 04

**Thiếu / chưa chắc**
- QĐ phê duyệt nhiệm vụ và dự toán kinh phí `1147/QĐ-UBND`
- QĐ phê duyệt BCKTKT `302/QĐ-UBND`
- bộ biểu hoặc tài liệu đi kèm giai đoạn chuẩn bị đầu tư

**Tác động**
- AI có thể trả lời được một phần về chuỗi lựa chọn nhà thầu
- nhưng chưa nên kết luận chuỗi pháp lý đã đủ vì thiếu quyết định nền

**Ưu tiên**
- cao

### 5.2 Đấu thầu và hợp đồng gói 04

**Đã có**
- đơn nhận thầu
- biên bản thương thảo
- QĐ phê duyệt KQLCNT gói 04
- hợp đồng thi công gói 04

**Thiếu / chưa chắc**
- hồ sơ mời thầu / yêu cầu
- hồ sơ dự thầu
- phụ lục hợp đồng
- bảo lãnh thực hiện hợp đồng
- bảo lãnh tạm ứng
- văn bản điều chỉnh / gia hạn nếu có

**Tác động**
- đủ để ingest đợt 1 và tra cứu điều khoản chính
- chưa đủ để kiểm tra sâu các tình huống phát sinh, điều chỉnh, thanh toán, thanh lý

**Ưu tiên**
- cao

### 5.3 Thi công và quản lý chất lượng

**Đã có**
- bộ bản vẽ PDF cơ bản

**Thiếu**
- biên bản bàn giao mặt bằng
- hồ sơ quản lý chất lượng
- nhật ký thi công
- hồ sơ vật liệu đầu vào
- hồ sơ thí nghiệm / kiểm định

**Tác động**
- không có đủ ngữ cảnh để nối hợp đồng với hiện trường
- payment / settlement workflow sẽ thiếu căn cứ thực hiện
- readiness dễ bị đánh giá sai nếu chỉ nhìn hồ sơ pháp lý - hợp đồng

**Ưu tiên**
- rất cao

### 5.4 Nghiệm thu và hoàn công

**Thiếu**
- biên bản nghiệm thu công việc
- biên bản nghiệm thu giai đoạn
- biên bản nghiệm thu hoàn thành hạng mục
- hồ sơ hoàn công
- bản vẽ hoàn công
- biên bản nghiệm thu đưa vào sử dụng

**Tác động**
- đây là khoảng trống lớn nhất nếu muốn đi tiếp sang thanh toán và quyết toán
- chưa đủ để kết luận công trình hoàn thành theo hồ sơ

**Ưu tiên**
- rất cao

### 5.5 Thanh toán, quyết toán, thanh lý

**Thiếu**
- đề nghị tạm ứng
- hồ sơ thanh toán đợt / hoàn thành
- bảng xác nhận khối lượng
- bảng giá trị thanh toán
- hồ sơ quyết toán
- quyết định phê duyệt quyết toán
- biên bản thanh lý hợp đồng

**Tác động**
- không thể dùng AI để sinh checklist thanh toán / quyết toán có độ tin cậy cao
- chưa thể map sang readiness kết thúc công trình

**Ưu tiên**
- rất cao, nhưng phụ thuộc việc bù hồ sơ thi công - nghiệm thu trước

## 6. Hồ sơ đã có vs hồ sơ thiếu

### Hồ sơ đã có
| Nhóm | Tài liệu chính |
| --- | --- |
| Danh mục | file danh mục hồ sơ tổng |
| Pháp lý | QĐ phê duyệt KHLCNT |
| Pháp lý / đấu thầu | QĐ phê duyệt KQLCNT gói 04 |
| Đấu thầu | đơn nhận thầu, biên bản thương thảo |
| Hợp đồng | hợp đồng thi công gói 04 |
| Kỹ thuật | bản vẽ PDF cơ bản |

### Hồ sơ thiếu
| Nhóm | Tài liệu thiếu nổi bật |
| --- | --- |
| Pháp lý nền | QĐ nhiệm vụ, QĐ BCKTKT |
| Hợp đồng | phụ lục, bảo lãnh, điều chỉnh |
| Thi công | bàn giao mặt bằng, QLCL, NKTC |
| Nghiệm thu | nghiệm thu công việc, hoàn thành, hoàn công, đưa vào sử dụng |
| Thanh toán | đề nghị thanh toán, bảng khối lượng, bảng giá trị, chứng từ |
| Quyết toán | hồ sơ quyết toán, quyết định phê duyệt quyết toán, thanh lý |

## 7. Mức độ ưu tiên bổ sung

| Mức ưu tiên | Hạng mục |
| --- | --- |
| Rất cao | hồ sơ QLCL, nhật ký thi công, nghiệm thu, hoàn công, hồ sơ thanh toán, hồ sơ quyết toán |
| Cao | QĐ nhiệm vụ, QĐ BCKTKT, phụ lục hợp đồng, bàn giao mặt bằng |
| Trung bình | hồ sơ tư vấn, kiểm toán, chứng từ bổ sung, bảo lãnh nếu có |
| Thấp | các đầu mục chưa cần cho ingest đợt 1 và chưa tác động readiness trước mắt |

## 8. Next action theo workflow DSCons

### Bước 1 - Chốt ingest đợt 1
- ingest các tài liệu đã có thật:
  - QĐ phê duyệt KHLCNT
  - QĐ phê duyệt KQLCNT gói 04
  - biên bản thương thảo
  - hợp đồng chính
  - bản vẽ PDF cơ bản
- gắn metadata tối thiểu:
  - `project_code`
  - `package_code`
  - `contract_code`
  - `document_type`
  - `source_file`
  - `issue_date`
  - `decision_no` nếu có

### Bước 2 - Bù pháp lý nền
- xin bản ký hoặc scan cho:
  - `1147/QĐ-UBND`
  - `302/QĐ-UBND`
- xác nhận biểu kèm theo nào là bản hiệu lực

### Bước 3 - Mở hồ sơ thi công - nghiệm thu
- gom bàn giao mặt bằng
- gom hồ sơ QLCL
- gom nhật ký thi công
- gom nghiệm thu và hoàn công

### Bước 4 - Chỉ khi đủ căn cứ mới đi tiếp
- lập checklist thanh toán
- lập checklist quyết toán
- đánh giá readiness hoàn thành công trình

## 9. Cách dùng tài liệu này trong workflow

- dùng cùng manifest để trả lời câu hỏi:
  - công trình đang có gì
  - còn thiếu gì
  - thiếu gì trước mắt phải xử lý
- ingest vào Qdrant như knowledge nội bộ để retrieval giải thích được lý do thiếu hồ sơ
- không dùng tài liệu này như bằng chứng pháp lý cuối cùng
- khi có hồ sơ bổ sung, phải cập nhật lại cả:
  - manifest
  - gap analysis
  - kế hoạch ingest nếu thứ tự ưu tiên thay đổi

## 10. Rủi ro chính

| Rủi ro | Tác động | Cách kiểm soát |
| --- | --- | --- |
| Nhìn thấy vài hồ sơ lõi rồi kết luận công trình gần đủ bộ | readiness sai, giao việc sai | luôn đọc theo nhóm hồ sơ, không đọc rời từng file |
| Dùng bản Word chưa ký như nguồn mạnh | trả lời pháp lý thiếu chắc chắn | gắn cờ bản Word / bản ký rõ ràng |
| Thiếu hồ sơ thi công nhưng vẫn làm checklist thanh toán | checklist thiếu căn cứ | chỉ mở workflow thanh toán sau khi bù hồ sơ nền |
| Không cập nhật lại manifest sau khi có file mới | retrieval và next action bị lệch | cập nhật manifest và gap analysis cùng đợt |
| Ingest tài liệu thiếu trang hoặc scan mờ | AI hiểu sai nội dung | kiểm tra chất lượng file trước ingest |

## 11. Đề xuất cho DSCons

### Deliverable thực dụng trước mắt
- một bộ knowledge pilot cho công trình này gồm:
  - manifest
  - gap analysis
  - nhóm pháp lý - hợp đồng đã có thật

### Điều kiện chấp nhận tối thiểu
- truy hồi trả lời được 4 câu hỏi:
  - công trình hiện có hồ sơ nào
  - còn thiếu hồ sơ nào
  - hồ sơ nào đủ mạnh để tra cứu
  - bước tiếp theo nên bổ sung nhóm nào trước

### Chưa nên làm ở giai đoạn này
- chưa coi công trình là đủ điều kiện thanh toán hoặc quyết toán
- chưa tự động sinh hồ sơ thanh toán khi thiếu nền nghiệm thu
- chưa mở workflow kiểm toán sâu khi chưa có bộ hồ sơ kết thúc

## 12. Kết luận ngắn

Công trình này phù hợp làm pilot cho DSCons vì:
- đã có một phần hồ sơ thật để ingest ngay
- có khoảng trống hồ sơ rõ ràng để kiểm chứng workflow manifest và gap analysis
- cho thấy rất rõ nguyên tắc của hệ thống: **knowledge chỉ có giá trị khi bám đúng hồ sơ thật, trạng thái thật và next action thật**