> ## Documentation Index
> Fetch the complete documentation index at: https://huongdan.luklak.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Chức năng Quản lý Thi công
**Mục đích:** Tài liệu này mô tả logic vận hành **nội bộ** của `📋 Chức năng` Quản lý Thi công. Nội dung bao gồm quy trình thi công tại công trường — từ lập kế hoạch, phân bổ nguồn lực, theo dõi tiến độ hàng ngày đến nghiệm thu chính thức các hạng mục hoàn thành.
## Tại sao điều này quan trọng
`📋 Chức năng` này mang lại cấu trúc và khả năng theo dõi thời gian thực cho những phức tạp của thi công tại công trường. Về mặt vận hành, nó tập trung vào việc theo dõi tiến độ hàng ngày, quản lý phân bổ nguồn lực, và đảm bảo kiểm soát chất lượng thông qua quy trình nghiệm thu chính thức. Về mặt chiến lược, quản lý dự án có cái nhìn rõ ràng về tiến độ thực tế so với kế hoạch tổng thể, cho phép xử lý sự cố chủ động và đảm bảo tuân thủ ngân sách cũng như tiêu chuẩn chất lượng. Đối với giám sát công trường và đội thi công, hệ thống số hóa báo cáo hàng ngày, làm rõ trách nhiệm từng đầu việc, và tinh gọn quy trình yêu cầu vật tư cùng nghiệm thu công trình.
## Bức tranh tổng thể
Về mặt kiến trúc, `📋 Chức năng` này là động cơ thực thi của vòng đời dự án, tiếp nhận đầu vào từ `🧊 Dự án` và `🧊 Bản vẽ Thiết kế` ở tầng cao hơn. Hệ thống xoay quanh Object `🧊 Hạng mục Thi công` — đại diện cho một giai đoạn công việc lớn (ví dụ: Điện, Nước). Object trung tâm này được hỗ trợ bởi Object con `🧊︎ Đầu việc Thi công` để quản lý công việc chi tiết. Tất cả các quy trình chính khác, bao gồm `🧊 Nhật ký Thi công`, `🧊 Yêu cầu Vật tư`, và `🧊 Biên bản Nghiệm thu`, đều liên kết trực tiếp với một `🧊 Hạng mục Thi công` — biến nó thành trung tâm vận hành cho mọi hoạt động tại công trường.
***
## LOẠI OBJECT & QUY TRÌNH LÀM VIỆC
### 1. 🧊 Hạng mục Thi công (Object Chuẩn)
* **Mô tả quy trình**: Quản lý một gói công việc thi công lớn cho một dự án cụ thể, từ giai đoạn chuẩn bị đến nghiệm thu hoàn thành. Theo dõi ngân sách và tiến độ theo từng hạng mục.
* **Ví dụ**: "Lắp đặt Điện cho DA-101". "Xây gạch Căn hộ cho DA-101".
**Quy trình Hạng mục Thi công**
```
PREPARATION → IN PROGRESS ↔ PAUSED → AWAITING ACCEPTANCE → COMPLETED
```
*`Một hạng mục đang IN PROGRESS có thể chuyển sang trạng thái PAUSED.`*
| Trạng thái | Logic nghiệp vụ | Cài đặt nâng cao |
| :------------------------- | :---------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------ |
| **1. PREPARATION** | Lập kế hoạch, phân công nguồn lực và chuẩn bị vật tư cho giai đoạn thi công này. | - |
| **2. IN PROGRESS** | Đội thi công đang tích cực thực hiện các đầu việc trong hạng mục này. | **Tự động hóa**: Ngày bắt đầu thực tế được tự động ghi nhận khi chuyển sang trạng thái này. |
| **3. PAUSED** | Công việc trong hạng mục này đã tạm dừng. | **Màn hình nhập liệu**: Lý do tạm dừng. |
| **4. AWAITING ACCEPTANCE** | Tất cả đầu việc đã hoàn thành, công trình sẵn sàng cho kiểm tra và nghiệm thu chính thức. | **Tự động hóa**: Tạo mới một `🧊 Biên bản Nghiệm thu` và thông báo cho Giám đốc Dự án. |
| **5. COMPLETED** | Công trình đã được nghiệm thu chính thức và coi như hoàn thành. | **Điều kiện**: Chỉ có thể chuyển sang trạng thái này sau khi `🧊 Biên bản Nghiệm thu` liên quan ở trạng thái `COMPLETED`. |
| Nhóm | Tên trường (Kiểu dữ liệu) | Ghi chú |
| :---------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------- |
| **Thông tin Hạng mục** *(3 Trường)* | Tên hạng mục (Text), Dự án liên quan (Object Reference), Giám sát (User) | Thông tin nhận diện cốt lõi của hạng mục thi công. |
| **Lịch trình** *(5 Trường)* | Ngày bắt đầu dự kiến (Date), Ngày kết thúc dự kiến (Date), Ngày bắt đầu thực tế (Date), Ngày kết thúc thực tế (Date), Tiến độ % (Rollup) | Theo dõi lịch trình kế hoạch so với thực tế và tiến độ tổng hợp từ đầu việc con. |
| **Tổng: 8 Trường** | | |
***
### 2. 🧊︎ Đầu việc Thi công (Object Con)
* **Mô tả quy trình**: Một đầu việc cụ thể, có thể thực hiện được, thuộc một `🧊 Hạng mục Thi công`. Mỗi đầu việc được giao cho nhân sự cụ thể tại công trường.
* **Object cha**: `🧊 Hạng mục Thi công`
* **Ví dụ**: "Lắp đặt tủ điện tổng". "Trát tường phòng ngủ chính".
**Quy trình Đầu việc Thi công**
```
TO DO → DOING → DONE
```
| Trạng thái | Logic nghiệp vụ | Cài đặt nâng cao |
| :----------- | :--------------------------------------- | :-------------------------------------------------------------------------------------- |
| **1. TO DO** | Đầu việc đã được tạo nhưng chưa bắt đầu. | - |
| **2. DOING** | Đầu việc đang được thực hiện. | - |
| **3. DONE** | Đầu việc đã hoàn thành. | **Tự động hóa**: Tỷ lệ hoàn thành của `🧊 Hạng mục Thi công` cha được tự động cập nhật. |
| Nhóm | Tên trường (Kiểu dữ liệu) | Ghi chú |
| :---------------------------------- | :--------------------------------------------------------------------------------------- | :---------------------------------------------------------- |
| **Thông tin Đầu việc** *(4 Trường)* | Tên đầu việc (Text), Người thực hiện (User), Ngày đến hạn (Date), Mức ưu tiên (Dropdown) | Thông tin chi tiết và phân công cho từng đầu việc thi công. |
| **Tổng: 4 Trường** | | |
***
### 3. 🧊 Nhật ký Thi công (Object Chuẩn)
* **Mô tả quy trình**: Báo cáo tiến độ hàng ngày tại công trường, ghi nhận tiến độ, sự cố và các hoạt động cho một `🧊 Hạng mục Thi công` cụ thể.
* **Ví dụ**: "Nhật ký Lắp đặt Điện — 20/08/2025".
**Quy trình Nhật ký Thi công**
```
DRAFT → SUBMITTED
```
| Trạng thái | Logic nghiệp vụ | Cài đặt nâng cao |
| :--------------- | :---------------------------------------------- | :-------------------------------------------------------------------------------- |
| **1. DRAFT** | Giám sát công trường đang soạn bản ghi nhật ký. | - |
| **2. SUBMITTED** | Nhật ký đã được hoàn thiện và gửi đi. | **Tự động hóa**: Thông báo cho Giám đốc Dự án rằng nhật ký hàng ngày đã sẵn sàng. |
| Nhóm | Tên trường (Kiểu dữ liệu) | Ghi chú |
| :--------------------------------- | :------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------- |
| **Thông tin Nhật ký** *(5 Trường)* | Ngày ghi nhật ký (Date), Giám sát (User), Cập nhật tiến độ (Paragraph), Sự cố phát sinh (Paragraph), Hình ảnh (Attachment) | Ghi nhận đầy đủ tình hình công trường trong ngày: tiến độ, sự cố và minh chứng hình ảnh. |
| **Tổng: 5 Trường** | | |
***
### 4. 🧊 Yêu cầu Vật tư (Object Chuẩn)
* **Mô tả quy trình**: Quản lý vòng đời yêu cầu và duyệt vật tư cần thiết cho một `🧊 Hạng mục Thi công`, từ lúc tạo yêu cầu đến khi vật tư được giao.
* **Ví dụ**: "Yêu cầu 50m ống luồn dây điện".
**Quy trình Yêu cầu Vật tư**
```
NEW → PENDING APPROVAL → APPROVED → DELIVERED
↓
REJECTED
```
| Trạng thái | Logic nghiệp vụ | Cài đặt nâng cao |
| :---------------------- | :--------------------------------------------------- | :------------------------------------------------------------------ |
| **1. NEW** | Giám sát công trường vừa tạo một yêu cầu vật tư mới. | - |
| **2. PENDING APPROVAL** | Yêu cầu đang chờ Giám đốc Dự án phê duyệt. | **Tự động hóa**: Thông báo cho Giám đốc Dự án về yêu cầu chờ duyệt. |
| **3. APPROVED** | Yêu cầu đã được phê duyệt để mua sắm. | **Phân quyền**: Chỉ đọc sau khi phê duyệt. |
| **4. DELIVERED** | Vật tư đã được giao đến công trường. | - |
| **5. REJECTED** | Yêu cầu đã bị từ chối. | **Màn hình nhập liệu**: Lý do từ chối. |
| Nhóm | Tên trường (Kiểu dữ liệu) | Ghi chú |
| :--------------------------------- | :---------------------------------------------------------------------------------------------------- | :----------------------------------------------------------- |
| **Thông tin Yêu cầu** *(5 Trường)* | Tên vật tư (Text), Số lượng (Number), Đơn vị (Text), Nhà cung cấp (Text), Chi phí ước tính (Currency) | Thông tin chi tiết về vật tư cần mua sắm và dự toán chi phí. |
| **Tổng: 5 Trường** | | |
***
### 5. 🧊 Biên bản Nghiệm thu (Object Chuẩn)
* **Mô tả quy trình**: Bản ghi chính thức để ghi nhận quá trình kiểm tra và nghiệm thu một `🧊 Hạng mục Thi công` đã hoàn thành.
* **Ví dụ**: "Biên bản Nghiệm thu Hạng mục Điện DA-101".
**Quy trình Biên bản Nghiệm thu**
```
DRAFT → AWAITING SIGNATURE → COMPLETED
```
| Trạng thái | Logic nghiệp vụ | Cài đặt nâng cao |
| :------------------------ | :---------------------------------------------------------------- | :-------------------------------------------------------------------------------- |
| **1. DRAFT** | Biên bản nghiệm thu đang được chuẩn bị với các chi tiết kiểm tra. | **Màn hình nhập liệu**: Ngày kiểm tra, thành phần tham gia, kết quả và ghi chú. |
| **2. AWAITING SIGNATURE** | Biên bản đã hoàn chỉnh và đã gửi để ký số. | - |
| **3. COMPLETED** | Biên bản đã được tất cả các bên ký và hoàn tất. | **Tự động hóa**: Cập nhật trạng thái `🧊 Hạng mục Thi công` cha sang `COMPLETED`. |
| Nhóm | Tên trường (Kiểu dữ liệu) | Ghi chú |
| :---------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------ |
| **Thông tin Biên bản** *(6 Trường)* | Mã biên bản (Text), Hạng mục liên quan (Object Reference), Ngày kiểm tra (Date), Kết quả (Dropdown), Thành phần tham gia (Text), Chữ ký số (Attachment) | Ghi nhận đầy đủ thông tin nghiệm thu chính thức và chữ ký xác nhận của các bên. |
| **Tổng: 6 Trường** | | |
***
## MỐI QUAN HỆ GIỮA CÁC OBJECT
| Loại quan hệ | Kết nối | Mô tả |
| :------------- | :------------------------------------------------ | :--------------------------------------------------------------------------- |
| **Cha-Con** | `🧊 Hạng mục Thi công` → `🧊︎ Đầu việc Thi công` | Mỗi hạng mục được chia nhỏ thành các đầu việc cụ thể cho đội thi công. |
| **Tham chiếu** | `🧊 Nhật ký Thi công` → `🧊 Hạng mục Thi công` | Nhật ký hàng ngày được ghi nhận cho một hạng mục thi công đang hoạt động. |
| **Tham chiếu** | `🧊 Yêu cầu Vật tư` → `🧊 Hạng mục Thi công` | Vật tư được yêu cầu cho một hạng mục thi công cụ thể. |
| **Tham chiếu** | `🧊 Biên bản Nghiệm thu` → `🧊 Hạng mục Thi công` | Biên bản nghiệm thu chính thức được tạo để xác nhận hoàn thành một hạng mục. |
***
## TỰ ĐỘNG HÓA
Bảng dưới đây mô tả các quy tắc tự động hóa chạy hoàn toàn trong `⏹️ Thi công` Space để quản lý tiến độ, nhắc nhở và kiểm soát chất lượng.
| ID | Tên quy tắc | Điều kiện kích hoạt | Hành động | Mô tả |
| :-------- | :---------------------------- | :----------------------------------------------------------------------- | :------------------------------------ | :------------------------------------------------------------------------------------------------------------------------- |
| **IN-01** | Nhắc nhở báo cáo hàng ngày | **Theo lịch**: Mỗi ngày lúc 16:00 | **Thông báo**: Giám sát công trường | Gửi thông báo đến tất cả `Giám sát công trường` nhắc nộp `🧊 Nhật ký Thi công` trong ngày. |
| **IN-02** | Ghi nhận ngày bắt đầu thực tế | **Chuyển trạng thái**: `🧊 Hạng mục Thi công` sang `IN PROGRESS` | **Cập nhật**: `🧊 Hạng mục Thi công` | Tự động ghi nhận ngày hiện tại vào trường `Ngày bắt đầu thực tế` khi hạng mục chuyển sang trạng thái `IN PROGRESS`. |
| **IN-03** | Cập nhật tiến độ hạng mục | **Chuyển trạng thái**: `🧊︎ Đầu việc Thi công` sang `DONE` | **Cập nhật**: `🧊 Hạng mục Thi công` | Tự động tính lại và cập nhật trường `Tiến độ %` trên `🧊 Hạng mục Thi công` cha dựa trên tỷ lệ đầu việc đã hoàn thành. |
| **IN-04** | Tạo Biên bản Nghiệm thu | **Chuyển trạng thái**: `🧊 Hạng mục Thi công` sang `AWAITING ACCEPTANCE` | **Tạo mới**: `🧊 Biên bản Nghiệm thu` | Tự động tạo một `🧊 Biên bản Nghiệm thu` mới liên kết với hạng mục và thông báo cho Giám đốc Dự án. |
| **IN-05** | Cảnh báo đầu việc quá hạn | **Theo lịch**: Mỗi ngày | **Thông báo**: Giám đốc Dự án | Kiểm tra các `🧊︎ Đầu việc Thi công` đã quá `Ngày đến hạn` nhưng chưa ở trạng thái `DONE` và thông báo cho Giám đốc Dự án. |
Bảng dưới đây mô tả các quy tắc tự động hóa kết nối `⏹️ Thi công` Space với các Space khác trong hệ thống, đảm bảo dòng chảy dữ liệu liền mạch.
| ID | Tên quy tắc | Điều kiện kích hoạt | Hành động | Mô tả |
| :-------- | :------------------------------------------ | :--------------------------------------------------------------- | :-------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------- |
| **CF-01** | Thông báo kết quả nghiệm thu | **Chuyển trạng thái**: `🧊 Biên bản Nghiệm thu` sang `COMPLETED` | **Thông báo**: Giám sát công trường, Giám đốc Dự án | Gửi thông báo đến Giám sát công trường và Giám đốc Dự án kèm kết quả kiểm tra nghiệm thu. |
| **CF-02** | Cập nhật trạng thái hạng mục sau nghiệm thu | **Chuyển trạng thái**: `🧊 Biên bản Nghiệm thu` sang `COMPLETED` | **Cập nhật**: `🧊 Hạng mục Thi công` | Tự động chuyển trạng thái `🧊 Hạng mục Thi công` liên quan sang `COMPLETED` sau khi biên bản nghiệm thu hoàn tất. |
| **CF-03** | Đồng bộ tiến độ lên Dự án | **Cập nhật**: Trường `Tiến độ %` của `🧊 Hạng mục Thi công` | **Cập nhật**: `Quản lý Dự án/🧊 Dự án` | Tự động tổng hợp tiến độ từ các hạng mục thi công lên Object `🧊 Dự án` trong `⏹️ Quản lý Dự án` Space, cung cấp cái nhìn tổng thể tiến độ thực tế. |
Bảng dưới đây mô tả các quy tắc tích hợp hệ thống bên ngoài, nếu có, với `⏹️ Thi công` Space.
| ID | Tên quy tắc | Điều kiện kích hoạt | Hành động | Mô tả |
| :-------- | :--------------------------- | :--------------------------------------------------------------- | :---------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------- |
| **CS-01** | Gửi thông báo qua Zalo/Email | **Chuyển trạng thái**: `🧊 Biên bản Nghiệm thu` sang `COMPLETED` | **Webhook**: Hệ thống thông báo bên ngoài | Gửi thông báo kết quả nghiệm thu cho khách hàng qua kênh liên lạc bên ngoài (Zalo OA hoặc Email) để đảm bảo khách hàng nắm được tiến độ dự án. |
***
## WORKVIEW, DASHBOARD, BỘ LỌC & NHẮC NHỞ
| Workview | Mô tả | Cấu hình dữ liệu |
| :------------------------------- | :-------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------ |
| 1. **Gantt Chart Hạng mục** | Hiển thị dạng timeline tất cả `🧊 Hạng mục Thi công` của một dự án, so sánh thời gian dự kiến và thực tế. | Tất cả `🧊 Hạng mục Thi công`, lọc theo dự án, hiển thị ngày bắt đầu/kết thúc dự kiến và thực tế. |
| 2. **Kanban Đầu việc hàng ngày** | Hiển thị dạng bảng tất cả `🧊︎ Đầu việc Thi công` trong ngày, sắp xếp theo cột trạng thái (`TO DO`, `DOING`, `DONE`). | Tất cả `🧊︎ Đầu việc Thi công`, nhóm theo trạng thái, lọc theo ngày đến hạn = hôm nay. |
| Widget | Dữ liệu | Mô tả |
| :--------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------- |
| 1. **Tiến độ tổng thể Dự án** | Biểu đồ tổng hợp tỷ lệ hoàn thành từ tất cả `🧊 Hạng mục Thi công` để hiển thị tiến độ vật lý thực tế của dự án theo thời gian thực. | Cung cấp cái nhìn tổng quan tiến độ thi công cho Giám đốc Dự án và Ban lãnh đạo. |
| 2. **Khối lượng công việc theo nhân sự** | Biểu đồ hiển thị số lượng đầu việc đang hoạt động được giao cho từng thành viên `Đội Thi công`. | Giúp cân đối phân bổ nguồn lực và phát hiện tình trạng quá tải sớm. |
| Bộ lọc | Tiêu chí | Nhắc nhở |
| :------------------------------ | :---------------------------------------------- | :------------------------------------------------------------------------------ |
| 1. **Hạng mục chờ Nghiệm thu** | Trạng thái = `AWAITING ACCEPTANCE`. | Hàng ngày lúc 9:00 sáng gửi đến vai trò Giám đốc Dự án. |
| 2. **Yêu cầu Vật tư chờ duyệt** | Trạng thái = `PENDING APPROVAL`. | Hàng ngày lúc 9:00 sáng gửi đến vai trò Giám đốc Dự án. |
| 3. **Đầu việc quá hạn** | Trạng thái ≠ `DONE` VÀ Ngày đến hạn \< Hôm nay. | Hàng ngày lúc 8:00 sáng gửi đến vai trò Giám đốc Dự án và Giám sát công trường. |
***
## VAI TRÒ, PHÂN QUYỀN & THÔNG BÁO
| Vai trò | Mô tả |
| :----------------------- | :----------------------------------------------------------------------------------------------------- |
| **Giám đốc Dự án** | Chịu trách nhiệm tổng thể cho dự án, phê duyệt yêu cầu vật tư và xem xét biên bản nghiệm thu. |
| **Giám sát công trường** | Quản lý đội thi công tại hiện trường, phân công đầu việc, nộp nhật ký hàng ngày và tạo yêu cầu vật tư. |
| **Đội Thi công** | Thực hiện các `🧊︎ Đầu việc Thi công` được giao và cập nhật trạng thái tiến độ. |
`📋 Chức năng` này sử dụng **Sơ đồ Toàn cục 3: Phân quyền Vừa phải**.
* **`Xem/Cập nhật 🧊 Object`**: Chỉ người dùng được gán trực tiếp vào Object (ví dụ: Giám sát của Hạng mục, Người thực hiện của Đầu việc) mới có thể xem và cập nhật.
`📋 Chức năng` này sử dụng **Sơ đồ Toàn cục 2: Thông báo Tất cả Bên liên quan**.
* Tất cả thông báo chỉ gửi đến người dùng liên quan trực tiếp đến Object (ví dụ: Giám đốc Dự án cho phê duyệt, Giám sát công trường cho nhắc nhở hàng ngày).
***
## Tiếp theo?
* [**Chức năng Quản lý Dự án**](/03-build/case-study-laika/chuc-nang/du-an): Tìm hiểu chức năng cấp cao hơn — nơi tạo kế hoạch tổng thể và ngân sách mà Chức năng Thi công thực thi.
* [**Chức năng Quản lý Thiết kế**](/03-build/case-study-laika/chuc-nang/thiet-ke): Xem cách bản vẽ kỹ thuật mà đội thi công sử dụng được tạo và phê duyệt.