Bỏ qua để đến Nội dung

AzHome Quản Lý Công Trình Xây Dựng (az_construction_management)

Tài liệu này mô tả chi tiết kiến trúc của module az_construction_management dành cho Odoo 19 Community. Module này được thiết kế để quản lý toàn diện các quy trình tài chính và nhân sự đặc thù trong lĩnh vực thi công xây dựng.

1. Tổng quan Kiến trúc (High-Level Overview)

Module được xây dựng trên nền tảng Odoo 19 Community, mở rộng các phân hệ lõi (Project, Accounting, HR) thành 6 trụ cột quản lý cho doanh nghiệp xây dựng:

2. Chi tiết Từng phân hệ

2.1. Phân hệ Nhân công

2.2. Phân hệ Máy móc

2.3. Phân hệ Thầu phụ

2.4. Chủ Đầu Tư

2.5. Dự án & Ngân sách

Dashboard tài chính tập trung toàn bộ số liệu dự án theo thời gian thực. Truy cập qua menu Quản lý Công trình > Dự án, sau đó chọn dạng xem List hoặc Kanban.

Thời gian thực (Realtime)

Bật bằng bộ lọc 📊 Thời gian thực.

Bao gồm cả chi phí dự thảo chưa xác nhận — dành cho BGĐ theo dõi và ra quyết định tức thì. Số liệu sẽ khác với sổ kế toán.

Đã hạch toán (Accounting)

Bật bằng bộ lọc 📑 Đã hạch toán.

Chỉ lấy số liệu kế toán đã xác nhận (posted) — dành cho Kế toán lập báo cáo tài chính chính xác, đối chiếu sổ sách.

Tab Tổng quan — các chỉ số chính
  • Giá trị HĐ CĐT — tổng giá trị hợp đồng đã ký
  • Tạm ứng CĐT nhận — tổng tiền CĐT đã ứng trước
  • Doanh thu nghiệm thu — tổng đã nghiệm thu được duyệt
  • Chi phí tổng — tất cả loại chi phí gộp
  • Lợi nhuận gộp — xanh nếu lãi, đỏ nếu lỗ
  • Biên lợi nhuận % — lợi nhuận / doanh thu × 100
  • % Tiến độ thanh toán — CĐT đã thanh toán bao nhiêu % tổng phải thu
  • Còn lại phải thu — giá trị HĐ trừ đi đã ứng + đã NT
Tab Chi tiết — phân rã chi phí

Chuyển sang tab 🔍 Chi tiết chi phí để xem từng hạng mục:

  • Vật tư công trình (từ hóa đơn mua hàng)
  • Nhân công (từ bảng lương đã xác nhận)
  • Máy thi công (từ ca máy tháng)
  • Thầu phụ (từ nghiệm thu thầu phụ)
  • Phụ phí phát sinh
  • Tạm ứng CĐT chưa khấu trừ
10 Smart Buttons — drill-down nhanh

Trên form từng Dự án, nhấn các nút thống kê để mở danh sách chi tiết:

  • 📄 HĐ Chủ đầu tư
  • ☑ Nghiệm thu CĐT
  • 💵 Tạm ứng CĐT
  • 👥 Thầu phụ
  • 🛒 Hao phí Vật tư
  • ▣ CP Vật tư (hóa đơn)
  • 📦 Tồn kho hiện tại
  • 👤 Nhân công
  • 💳 Phụ phí
  • ⚙ Máy thi công

2.6. Cấu hình vận hành

Vào Cài đặt > AzHome để thiết lập các tham số vận hành. Cấu hình đúng giúp hệ thống tự động định khoản kế toán mà không cần nhập tay từng bút toán.

Tài khoản định khoản tự động

Odoo sẽ tự động lấy các tài khoản này khi tạo bút toán — không cần chọn tay từng lần.

Cấu hình Tài khoản gợi ý Khi nào được dùng
Chi phí nhân công 622 Khi xác nhận bảng lương tháng
Khấu trừ tạm ứng lương 141 / 334 Khi bảng lương khấu trừ khoản tạm ứng nhân viên
Chi phí thầu phụ 627 / 154 Khi xác nhận nghiệm thu thầu phụ
Giữ bảo hành thầu phụ 3311 Khi tạo bút toán trích giữ lại bảo hành
Giữ bảo hành CĐT 131 / 138 Khi phát hành hóa đơn nghiệm thu cho Chủ đầu tư
Chi phí ca máy 623 Khi xác nhận bảng tổng hợp ca máy tháng
Phải trả ca máy thuê 331 Khi ghi nhận phải trả cho đơn vị cho thuê máy
Phân bổ chi phí máy 154 / 623 Khi phân bổ chi phí máy vào giá thành công trình
Tham số kỹ thuật

Số giờ/ngày Mặc định: 8.0

Hệ số quy đổi ngày công sang giờ công trong bảng lương. Thay đổi khi công ty áp dụng chế độ ca đặc biệt (ca 6h, ca đêm, ca 10h...).

Ngưỡng quy đổi công Mặc định: 1.5

Khi nhập số giờ/ngày vào chấm công:
— Nếu số nhập ≤ 1.5 → hệ thống hiểu là Ngày công (ví dụ: 0.5 ngày = nửa ngày)
— Nếu số nhập > 1.5 → hệ thống hiểu là Giờ công (ví dụ: 8 giờ)

2.7. Phân hệ Tồn kho Dự án (Odoo 19)

3. Luồng dữ liệu Tài chính (Workflows)

3.1. Quy trình Nghiệm thu khối lượng

Đảm bảo tính minh bạch và tự động hóa trong việc thanh toán cho thầu phụ và thu tiền khách hàng.

3.2. Quy trình Thu mua Vật tư Linh hoạt (Flexible Procurement)

Số hóa toàn bộ quy trình cung ứng vật tư từ hiện trường đến tay nhà cung cấp, phân tách rõ ràng 3 vai trò.

Sơ đồ luồng tổng quát
📱 Kỹ sư tạo phiếu 🔔 QS nhận thông báo ✅ QS phê duyệt 🛒 Thu mua gom đơn + Tạo RFQ 📦 Đặt hàng NCC

3.3. Phân biệt Hoá đơn (Bill) & Biên lai (Receipt)

Khi tiến hành lập hồ sơ thanh toán từ Đơn mua hàng, hệ thống cung cấp 2 lựa chọn hạch toán kế toán có bản chất khác biệt:

3.4. Quy trình Import Dự toán (BOQ) Thông Minh

Cơ chế Import Dự toán được thiết kế đặc biệt giúp giải quyết triệt để bài toán điều chỉnh, cập nhật khối lượng thiết kế từ file Excel mà không làm hỏng cấu trúc dữ liệu hiện có.

5 Chế độ Tùy biến Nhập liệu
  1. Thêm nối tiếp: Chèn dữ liệu mới vào cuối BOQ.
  2. Ghi đè (Thay thế): Xóa hạng mục cũ được chọn và đè dữ liệu mới lên vị trí đó.
  3. Chèn TRƯỚC / SAU: Nhét khối lượng mới vào giữa Hạng mục được chọn.
  4. Xóa sạch làm mới: Xóa toàn bộ BOQ hiện có và bắt đầu lại từ đầu.
Đồng bộ Tài chính (Profitability)

Hệ thống áp dụng cấu trúc dữ liệu 4 tầng chặt chẽ:

  • Hợp đồng (Contract) ➔ Giai đoạn (Milestone) ➔ Nhiệm vụ cha (Task) ➔ Công tác chi tiết (Sub-task).
  • Khóa chặt 1:1: Thuật toán tự động bắt cặp (Matching) thông minh dựa trên tên và khối lượng, đảm bảo mọi dòng công tác đều liên kết với một dòng doanh thu hợp đồng (sale_line_id).
  • Giúp Báo cáo Lợi nhuận (P&L) hiển thị 100% chính xác.

3.5. Quy trình Vận hành Nhập kho Dự án (Quy trình kép 4 Bước)

Để Tồn kho vật tư và Dòng tiền Kế toán luôn được khớp nối chặt chẽ, đồng thời giảm thiểu 90% sai lệch số liệu, AzHome áp dụng quy trình kép sau đây:

1
Tạo PO & Phân bổ

Tạo Đơn mua hàng (PO). Bắt buộc: Chọn Phân bổ tài khoản phân tích ứng với công trình trên các dòng vật tư.

2
Xác nhận Đơn

Bấm Xác nhận đơn hàng. Hệ thống tự động định tuyến và tạo 1 Phiếu nhập kho đang chờ tiếp nhận tại Kho riêng của dự án.

3
Thực Nhập (Thủ kho)

Bấm vào nút Nhận hàng (Receipt) trên PO. Bấm Xác nhận (Validate) để hoàn tất nhập kho vật lý khi hàng về bãi.

4
Lập Hóa Đơn (Kế toán)

Bấm nút Tạo hóa đơn trực tiếp từ PO để ghi nhận công nợ vào sổ cái kế toán. Hoàn thành chu trình chặt chẽ 100%!

KIỂM SOÁT HAO HỤT: BÁO CÁO SỬ DỤNG VẬT TƯ (Dành cho Kỹ sư)

Áp dụng khi: Kỹ sư hiện trường cần báo cáo chính xác lượng vật tư tiêu hao thực tế cho từng hạng mục thi công (BOQ) hàng ngày hoặc hàng tuần.

  • Trừ Tồn kho Vật lý: Hệ thống tự động sinh phiếu Xuất kho (từ Kho dự án ra Vị trí tiêu hao) làm giảm Tồn kho ngay lập tức, giúp Thủ kho/Kỹ sư biết chính xác công trình đang còn lại bao nhiêu vật tư thực tế.
  • Không sinh Chi phí Kế toán (Zero Cost): Tính năng này chỉ điều chỉnh Số lượng vật lý. Kế toán KHÔNG lo bị hạch toán trùng chi phí (vì toàn bộ chi phí vật tư đã được ghi nhận 100% ở quy trình Mua hàng - PO).
  • Đối chiếu Định mức: Nhờ trường thông tin Mục đích sử dụng, Ban quản lý biết chính xác số xi măng, sắt thép đã đổ vào cấu kiện nào (Móng hay Mái) để đối chiếu hao hụt.
🌟 HOẶC TUYỆT CHIÊU TINH GỌN: KIỂM KÊ CHỐT KỲ (Nếu không báo cáo hàng ngày)

Ưu điểm vượt trội: Giải phóng hoàn toàn cho Thủ kho khỏi gánh nặng thủ tục giấy tờ và thao tác "Xuất kho lẻ tẻ từng bao xi măng, cây sắt" hàng ngày. Thủ kho chỉ việc đếm số dư cuối cùng!

1. Thực tế bãi vật tư:

Thủ kho KHÔNG CẦN LÀM GÌ CẢ khi công nhân lấy vật tư sử dụng hàng ngày. Đến cuối tháng hoặc lúc xong việc, Thủ kho ra đếm xem thực tế còn dư bao nhiêu. Ví dụ: Đếm thấy chỉ còn 5 Tấn.

2. Phép thuật AzHome:

Vào ô Tồn kho hiện tại của Dự án > Bấm nút "Cập nhật số lượng" > Gõ thẳng con số 5 vào. Odoo lập tức tự tính toán (100 - 5 = 95) và tự sinh Phiếu Xuất kho tiêu hao 95 Tấn thẳng vào Chi phí Dự án A.

3. Luân chuyển vật tư dư:

Lúc này kho A báo chuẩn 5 Tấn. Để mang số này qua dự án B thi công tiếp, Kỹ sư chỉ cần làm một lệnh Chuyển kho nội bộ (Internal Transfer): Nguồn là Kho Dự án A > Đích là Kho Dự án B. Kho A về 0, Kho B nhận hàng!

Bảo chứng Kỹ thuật: Cấu trúc hệ thống do chúng ta phát triển đã cấp phát riêng biệt một Vị trí Kho vật lý độc lập cho mỗi công trình, do đó nghiệp vụ Kiểm kê và Chuyển kho nội bộ này hoạt động trơn tru và chuẩn xác 100%!

4. Bảo mật & Phân quyền (Security Matrix)

Cơ cấu phân quyền được thiết kế đặc thù và tối ưu cho mô hình Ban Quản lý Dự án (PMB) ngành Xây Dựng tại Việt Nam. Hệ thống chia làm 4 layer độc lập, ứng dụng Record Rules nghiêm ngặt để phân tách trách nhiệm (Segregation of Duties):

5. Kế hoạch Kinh doanh & Kế toán liền mạch (Odoo 19)

Phiên bản: 1.0 | Ngày soạn: 27/04/2026

I. TỔNG QUAN HỆ THỐNG

Hệ thống quản trị AZHome Quản Lý Công Trình Xây Dựng được thiết kế dựa trên triết lý "Số liệu đi trước, Kế toán đi sau". Mục tiêu cốt lõi là cung cấp cho Ban Giám đốc cái nhìn tức thời (Real-time) về dòng tiền và tình hình kinh doanh mà không bị phụ thuộc vào độ trễ của khâu đối soát kế toán truyền thống.

II. TỰ ĐỘNG HÓA DỰ ÁN TỪ HỢP ĐỒNG (SALES)

Quy trình liền mạch bắt đầu từ khâu Bán hàng (Sales) đến khâu Thi công (Project Management).

1. Khởi tạo Dự án Tự động

Khi một Hợp đồng CĐT (Sale Order) được xác nhận, hệ thống sẽ tự động tạo một Dự án (Project) tương ứng. Mọi thông tin khách hàng, tham chiếu hợp đồng sẽ được chuyển sang Dự án để đảm bảo tính nhất quán.

2. Cơ chế tự gán Phân khúc (Category)

Để giảm thiểu sai sót và thao tác tay, hệ thống áp dụng logic "Bắt bài dữ liệu":

  • Tự động gán: Nếu Hợp đồng chỉ chứa các sản phẩm thuộc duy nhất 1 Danh mục, hệ thống sẽ tự động điền giá trị vào ô Phân khúc của Dự án.
  • Phễu lọc thông minh: Nếu Hợp đồng có nhiều danh mục, ô Phân khúc sẽ để trống và danh sách chọn sẽ tự lọc chỉ hiển thị các danh mục có trong hợp đồng.

Lưu ý: Hệ thống sử dụng cơ chế "Quét ngược" Database để bắt ID hợp đồng ngay cả khi Odoo tạo dự án ngầm.

III. HƯỚNG DẪN CẤU HÌNH & VẬN HÀNH KẾ TOÁN

Tùy theo quy mô và yêu cầu kiểm soát, AzHome có thể lựa chọn một trong ba phương pháp vận hành sau đây.

PHƯƠNG PHÁP 1: QUY TRÌNH RÚT GỌN (DÀNH CHO DỰ ÁN NHỎ / SME)

Mục đích: Bỏ qua khâu đối chiếu "Đang thanh toán", giúp tiền vào sổ ngay lập tức.

Cấu hình Sổ nhật ký: Vào Cấu hình > Sổ nhật ký. Tại tab Phiếu thu/chi: Ô "Tài khoản biên lai/chi chưa thanh toán", chọn đích danh tài khoản chính (1110 hoặc 1120).

Vận hành: Lập Phiếu thu/chi > Bấm Xác nhận > Trạng thái nhảy thẳng sang "Đã thanh toán" (Paid).

PHƯƠNG PHÁP 2: KIỂM QUỸ TIỀM MẶT CHUẨN (SỔ GHI TIỀN)

Mục đích: Đối soát chặt chẽ tiền mặt tại quỹ vào cuối ngày.

  • Vào Bảng điều khiển Kế toán > Thẻ Tiền mặt.
  • Bấm Giao dịch > Mới để nhập phát sinh thực tế.
  • Nhập Số dư đầu kỳ và Số dư cuối kỳ (dựa trên kiểm đếm thực tế két sắt).
  • Bấm Đối chiếu (Reconcile) để khớp thực tế với Phiếu thanh toán.
PHƯƠNG PHÁP 3: ĐỐI SOÁT NGÂN HÀNG (DÀNH CHO DOANH NGHIỆP LỚN)

Mục đích: Khớp 100% số liệu Odoo với sao kê Ngân hàng thực tế.

  • Bán tự động: Xuất file sao kê từ Internet Banking và tải lên Odoo qua chức năng "Nhập sao kê".
  • Tự động hóa 100% (API): Sử dụng các dịch vụ trung gian (Casso, SePay...) để đồng bộ biến động số dư theo thời gian thực. Odoo tự động "Matching" dựa trên nội dung chuyển khoản.

IV. HƯỚNG DẪN TẠO VÀ VẬN HÀNH KẾ HOẠCH KINH DOANH

Kế hoạch Kinh doanh là tài liệu trung tâm để theo dõi mục tiêu doanh thu, chi phí và dòng tiền theo từng năm. Toàn bộ số liệu thực tế được đồng bộ tự động từ kế toán.

Bước 1 — Tạo Kế hoạch mới
  1. Vào menu Kế hoạch Kinh doanh > nhấn Tạo (nút New).
  2. Chọn Năm kế hoạch (ví dụ: 2026).
  3. Nhập Vốn lưu động đầu kỳ — số tiền mặt/tiền gửi sẵn có đầu năm.
  4. Nhập Ngưỡng an toàn tối thiểu — mức quỹ tối thiểu cần duy trì để hệ thống cảnh báo khi dòng tiền xuống dưới ngưỡng.
  5. Nhấn Lưu — kế hoạch ở trạng thái Dự thảo.
Bước 2 — Nhập dòng Doanh thu & Chi phí kế hoạch

Tại tab Doanh thu Kế hoạch:

  • Thêm từng dòng doanh thu: chọn Nhóm (Xây dựng, Thiết kế, Tư vấn…) và nhập Số tiền kế hoạch theo tháng.

Tại tab Chi phí Kế hoạch:

  • Thêm từng dòng chi phí: chọn Nhóm chi phí (Nhân công, Vật tư hóa đơn, Hao phí VT theo PO, Thầu phụ, Máy thi công, Phụ phí công trường, Văn phòng) và nhập Số tiền kế hoạch.
Bước 3 — Thiết lập Dòng tiền theo tháng

Tại tab Dòng tiền, hệ thống hiển thị 12 dòng tương ứng 12 tháng. Với mỗi tháng:

Thu kế hoạch (inflow): Nhập số tiền dự kiến thu về trong tháng (từ nghiệm thu, tạm ứng CĐT…).
Chi kế hoạch (outflow): Nhập số tiền dự kiến chi ra trong tháng (lương, vật tư, thầu phụ…).
Số dư cuối tháng được tính tự động: Số dư đầu tháng + Thu − Chi. Ô hiển thị đỏ khi xuống dưới ngưỡng an toàn.
Bước 4 — Khởi động Kế hoạch

Sau khi hoàn thiện dữ liệu dự thảo, nhấn nút Thực hiện để chuyển trạng thái sang Đang thực hiện.

  • Chatter tự động ghi nhận ngày khởi động cùng mục tiêu Doanh thu & Chi phí kế hoạch.
  • Từ lúc này, Cron job tự động đồng bộ số liệu thực tế mỗi đêm từ kế toán.
  • Nếu cần chỉnh sửa, nhấn Về Dự thảo để mở lại.
Bước 5 — Đồng bộ số liệu & Xuất báo cáo

Cập nhật Số liệu — đồng bộ tức thì không cần chờ Cron:

  • Nhấn nút Cập nhật Số liệu trên form — hệ thống kéo toàn bộ số liệu thực tế từ kế toán và ghi vào cột Thực tế.
  • Chatter ghi nhận % thực hiện Doanh thu, Chi phí và Lợi nhuận gộp tại thời điểm đồng bộ.

Xuất Excel — báo cáo đa tầng:

  • Nhấn nút Xuất Excel — file Bao_cao_Ke_hoach_[Năm].xlsx gồm 3 sheet: Doanh thu, Chi phí, Dòng tiền được tải về ngay.
  • Chatter ghi nhận tên file và số dòng đã xuất.
Bước 6 — Chốt Kế hoạch

Cuối kỳ hoặc khi kế hoạch hoàn thành, nhấn Chốt Kế hoạch để chuyển sang trạng thái Đã chốt.

  • Kế hoạch bị khóa — không thể chỉnh sửa thêm.
  • Chatter ghi lại tổng kết: Doanh thu thực tế, Chi phí, Lợi nhuận gộp và Biên lãi (%) để lưu hồ sơ.
  • Cron job tự động dừng đồng bộ cho kế hoạch đã chốt.

6. Tích hợp Telegram Chatter & Báo cáo Hiện trường

Phân hệ cung cấp khả năng tích hợp sâu sắc giữa Odoo Chatter và ứng dụng Telegram, giúp tự động hóa quá trình thông tin liên lạc và thu thập chứng từ hiện trường.

7. Hệ thống Bộ lọc Tìm kiếm (Search Panels)

Toàn bộ danh sách trong hệ thống đều có thanh tìm kiếm phía trên và Search Panel bên trái màn hình. Dưới đây là 5 kịch bản sử dụng phổ biến nhất.

Kịch bản 1 — Chuyển chế độ xem Dashboard

Áp dụng cho: Dashboard Dự án và Dashboard HĐ CĐT.

  • 📊 Thời gian thực — BGĐ xem tổng quan ngay cả khi kế toán chưa xác nhận
  • 📑 Đã hạch toán — Kế toán lấy số liệu đã vào sổ để lập báo cáo
  • 📝 Dự thảo — Xem riêng các chi phí đang chờ duyệt

Cách bật: Nhấn vào thanh tìm kiếm > chọn bộ lọc tương ứng trong danh sách.

Kịch bản 2 — Chuyển Tab Tổng quan / Chi tiết

Áp dụng cho: Dashboard Dự án và Dashboard HĐ CĐT.

  • 📊 Tổng quan — hiển thị cột Doanh thu, Chi phí, Lợi nhuận, Biên LN
  • 🔍 Chi tiết chi phí — phân rã thành: Vật tư, Nhân công, Máy thi công, Thầu phụ, Phụ phí

Cách bật: Tìm kiếm > chọn "Tổng quan" hoặc "Chi tiết chi phí" trong danh sách bộ lọc.

Kịch bản 3 — Lọc theo Công trình cụ thể

Áp dụng cho: Thầu phụ, Nghiệm thu TP, Tạm ứng TP.

Search Panel bên trái có mục Công trình — hiển thị danh sách hợp đồng CĐT kèm số lượng records. Nhấn vào tên công trình để lọc toàn bộ records thuộc công trình đó.

Ví dụ: Tại màn Thầu phụ, click "CTXD Căn hộ Hoàng Anh (3)" → chỉ thấy 3 hợp đồng thầu phụ của công trình này.
Kịch bản 4 — Lọc theo Trạng thái

Áp dụng cho: HĐ CĐT, Bảng lương, Dashboard Dự án.

Search Panel hiển thị từng trạng thái kèm số lượng records trong ngoặc — giúp biết ngay có bao nhiêu records ở mỗi bước.

  • HĐ CĐT: Dự thảo Đang thực hiện Hoàn thành Hủy
  • Bảng lương: Dự thảo Đã xác nhận Đã thanh toán
Kịch bản 5 — Nhóm dữ liệu BOQ theo cấu trúc phân cấp

Áp dụng cho: Dòng BOQ (HĐ CĐT > Tab Dự toán). Dùng khi cần đọc và phân tích dự toán nhiều dòng.

Group by Hạng mục
Nhóm theo az_excel_category — ví dụ: Phần thô, Phần hoàn thiện, MEP
Group by Nhóm công tác
Nhóm theo az_excel_group — ví dụ: Bê tông, Cốt thép, Xây gạch
Group by Mốc thời gian
Nhóm theo az_excel_milestone — ví dụ: Tháng 1, Giai đoạn 1

Cách dùng: Trong màn BOQ, nhấn vào thanh tìm kiếm > chọn Group by > chọn tiêu chí nhóm. Có thể kết hợp nhiều tiêu chí nhóm lồng nhau.