OpenConstructionERP: lập dự toán, bóc khối lượng, quản lý công trình — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về datadrivenconstruction/OpenConstructionERP — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: OpenConstructionERP: lập dự toán BOQ, bóc khối lượng CAD/BIM bằng AI — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
OpenConstructionERP là nền tảng ERP mã nguồn mở cho ngành xây dựng, gồm lập bảng khối lượng (BOQ), bóc khối lượng từ bản vẽ PDF/CAD/BIM, lập tiến độ 4D, mô hình chi phí 5D và đấu thầu. Bạn tự cài trên máy hoặc máy chủ của mình, dữ liệu không rời khỏi mạng nội bộ. Cách dễ nhất là tải app desktop; nếu quen dòng lệnh thì cài bằng pip hoặc Docker.
OpenConstructionERP là một nền tảng quản lý dự án xây dựng mã nguồn mở, chạy trên máy của chính bạn. Nó gom lập dự toán (BOQ), bóc khối lượng từ bản vẽ PDF, CAD, BIM, tiến độ, chi phí và đấu thầu vào một chỗ. Tác giả ví nó như "WordPress cho công ty xây dựng": bạn chọn module cần dùng, thêm module riêng hoặc thay module có sẵn.
Nếu bạn là kỹ sư dự toán, chủ thầu nhỏ, nhân viên văn phòng công ty xây dựng, hoặc lập trình viên đang làm phần mềm cho ngành này, repo đáng để thử. Phần mềm dự toán thương mại thường tính phí theo người dùng và hay bị khóa theo vùng. Ở đây giấy phép là AGPL-3.0, không phí thuê bao, và giao diện có cả tiếng Việt.
Điểm đáng giá nhất là bộ dữ liệu đi kèm. Repo có hơn 120.000 hạng mục đơn giá, trong đó có một bộ cơ sở giá riêng cho Việt Nam. Ngoài ra còn 190+ module và 293 "ca hướng dẫn" để bạn học bằng dự án mẫu. Repo hiện có khoảng 1.393 sao và 421 fork, và vẫn được cập nhật trong 3 tháng gần đây.
datadrivenconstruction/OpenConstructionERP
ERP mã nguồn mở cho xây dựng: lập BOQ, bóc khối lượng từ PDF/CAD/BIM, ghép đơn giá bằng AI, tự chạy trên máy bạn, có giao diện tiếng Việt.
I.OpenConstructionERP làm được gì
Dưới đây là những nhóm tính năng chính, kèm lợi ích thực tế.
A.Lập BOQ ngay trên giao diện giống bảng tính
BOQ có cấu trúc phân cấp: phần, hạng mục, hạng mục con, kéo thả để sắp xếp. Bạn bấm vào ô để sửa, bấm Tab để sang ô kế, Ctrl+Z để hoàn tác. Số lượng nhân đơn giá ra thành tiền, cộng dồn từng phần, rồi cộng các khoản phụ như chi phí chung, lợi nhuận, VAT, dự phòng. Bạn đỡ phải dựng công thức Excel rồi lo vỡ công thức.
BOQ xuất được ra Excel, CSV, báo cáo PDF hoặc GAEB XML (X83). Nếu đang làm việc với đối tác nước ngoài, bạn có sẵn định dạng họ hay dùng.
B.Cơ sở dữ liệu đơn giá và danh mục tài nguyên
Có hơn 120.000 hạng mục đơn giá trong 9 cơ sở dữ liệu, phủ 40+ thị trường. Gồm một cơ sở toàn cầu CWICR và 8 cơ sở quốc gia: Trung Quốc, Thổ Nhĩ Kỳ, Brazil, Tây Ban Nha, Ý, Hy Lạp, Việt Nam và Indonesia. Bạn có thể tìm theo mô tả, mã hoặc phân loại. Tìm kiếm ngữ nghĩa bằng AI hiểu nghĩa chứ không chỉ khớp từ khóa. Ví dụ gõ "concrete wall" vẫn ra "reinforced partition C30/37".
Danh mục tài nguyên có hơn 7.000 mục vật liệu, thiết bị, nhân công, và bạn có thể dựng định mức tổ hợp (assembly) dùng lại nhiều lần.
C.Bóc khối lượng từ PDF, CAD, BIM và ước tính bằng AI
Bạn thả bản vẽ PDF vào, AI trích khối lượng, rồi đẩy thẳng vào BOQ. Với CAD/BIM, repo hỗ trợ RVT, IFC, DWG (tổng cộng 6 định dạng CAD). Bản dựng 3D xem được ngay trong trình duyệt, kèm kiểm tra va chạm giữa các mô hình và xuất BCF.
Tính năng "AI Estimate" biến văn bản, ảnh, PDF hoặc bảng tính thành BOQ nháp kèm điểm tin cậy. Bạn kết nối nhà cung cấp LLM mình chọn (README nêu Anthropic, OpenAI, Gemini, Mistral, Groq, DeepSeek). Phần AI cần khóa API của nhà cung cấp, nên có thể phát sinh chi phí bên họ.
D.Kiểm tra chất lượng BOQ và theo dõi tài chính
Công cụ kiểm tra có sẵn quy tắc DIN 276, NRM, MasterFormat. Nó chấm điểm BOQ theo kiểu đèn giao thông và bắt lỗi như thiếu khối lượng, đơn giá bằng 0, hạng mục trùng. Ở phía quản lý, bạn có ngân sách, hóa đơn, thanh toán, giá trị thu được (earned value) và bảng điều khiển nhiều dự án. Tổng tiền được nhóm theo từng loại tiền tệ, không cộng lẫn.
E.Đa ngôn ngữ và dữ liệu mở
Giao diện có 44 ngôn ngữ, trong đó có tiếng Việt. Dữ liệu xuất được ra GAEB, XLSX, JSON, và có REST API đầy đủ nếu bạn muốn nối với hệ thống khác.
II.Cần chuẩn bị gì
Tư liệu mình có nêu ba cách cài, và mỗi cách cần chuẩn bị khác nhau:
- App desktop: README nói không cần Python, không cần Docker, tải về rồi chạy. Đây là đường dễ nhất cho người mới.
- pip: cần có Python trên máy để chạy được
pip install. README trong phần bạn đọc không ghi phiên bản Python cụ thể, nên bạn xem thêm hướng dẫn Getting Started trong repo. - Docker: cần Docker. Repo có sẵn các file
docker-compose.yml,docker-compose.quickstart.yml,docker-compose.quickstart.image.ymlvàdocker-compose.prod.yml.
Nếu muốn dùng AI, bạn cần một khóa API của nhà cung cấp LLM bạn chọn. Tư liệu chưa nêu yêu cầu về phần cứng hay GPU. Phần ghi chú hệ điều hành chi tiết cũng nằm trong hướng dẫn của repo, mình không đoán thay.
File .env.example có các biến cấu hình như APP_ENV, APP_DEBUG, LOG_LEVEL, ALLOWED_ORIGINS, DATABASE_URL, DATABASE_SYNC_URL, REDIS_URL, S3_ENDPOINT, S3_ACCESS_KEY, S3_SECRET_KEY, S3_BUCKET. Bạn chỉ cần quan tâm đến chúng khi tự dựng máy chủ, còn app desktop thì không.
Khóa API (nếu bạn bật AI) và các biến như S3_SECRET_KEY là thông tin bí mật. Đừng dán lên nhóm chat, đừng đưa vào file bạn đẩy lên GitHub. Tính năng AI gọi sang nhà cung cấp bên ngoài và có thể tốn phí theo mức dùng, nên hãy kiểm tra bảng giá của họ trước.
III.Cài đặt từng bước
- Chọn cách càiDesktop (dễ nhất), pip, hoặc Docker
- Tải app desktopVào trang tải về, chọn đúng hệ điều hành rồi chạy
- Hoặc cài bằng pipChạy một lệnh pip trong terminal
- Hoặc dùng DockerLấy mã nguồn và dùng file docker-compose có sẵn
- Mở ứng dụng và vào thửDùng dự án demo có sẵn để làm quen
A.Chọn cách cài phù hợp
Nếu bạn không rành dòng lệnh, chọn app desktop. Nếu bạn là dev và muốn nhúng vào hạ tầng của mình, chọn pip hoặc Docker. README còn có phần "Getting Started guide" mô tả cả ba cách kèm điều kiện cần có. Đó là chỗ nên đọc nếu bạn kẹt.
B.Cách 1: App desktop (không cần Python, Docker)
Vào trang openconstructionerp.com/download. Trang này tự chọn đúng file cho hệ điều hành của bạn. Tải về rồi chạy như một phần mềm bình thường. Đây là cách ít vấp nhất, phù hợp với nhân viên văn phòng và chủ thầu.
C.Cách 2: Cài bằng pip
Mở terminal (trên Windows là PowerShell hoặc Command Prompt) rồi chạy lệnh có trong README:
pip install openconstructionerpLệnh này tải gói về máy bạn. Chỗ người mới hay vấp: nếu máy báo "pip is not recognized" thì Python chưa được cài hoặc chưa thêm vào PATH. README phần mình có chưa ghi lệnh khởi động sau khi cài, nên bạn xem mục Quick Start hoặc Getting Started guide trong repo để lấy đúng lệnh chạy.
D.Cách 3: Docker
Lấy mã nguồn về máy:
git clone https://github.com/datadrivenconstruction/OpenConstructionERP.git
cd OpenConstructionERPTrong thư mục có các file compose, trong đó docker-compose.quickstart.yml là bản khởi động nhanh. Mình không bịa lệnh chạy cụ thể ở đây, vì đoạn README mình có không chứa lệnh Docker. Bạn hãy mở mục Quick Start trong README hoặc file DEVELOPING.md để chép đúng lệnh. Nếu bạn định chạy cho cả công ty, docker-compose.prod.yml và thư mục deploy/ là nơi nên xem.
E.Bước cuối: mở ứng dụng và vào thử
README cho biết bản cài mới có sẵn bộ demo 70 dự án trải rộng 30+ quốc gia. Mục "Demo Accounts" trong README sẽ nói cách đăng nhập, nên bạn xem ở đó thay vì đoán tài khoản.
IV.Kiểm tra đã chạy được chưa
Theo README, bạn sẽ thấy ứng dụng chạy với bộ demo 70 dự án. Bạn kiểm tra như sau:
- Mở được giao diện ứng dụng (app desktop hoặc trang web cục bộ, tùy cách cài).
- Thấy bảng điều khiển tổng quan với bản đồ các dự án.
- Vào được một dự án mẫu và mở được trình sửa BOQ có tổng tiền hiển thị.
- Đổi được ngôn ngữ sang tiếng Việt từ màn hình bất kỳ.
Nếu những việc trên làm được thì bạn cài xong. Nếu chưa, xem mục lỗi bên dưới. README còn có video 4 phút 41 giây hướng dẫn cài đặt và lập dự án đầu tiên, rất hợp để đối chiếu màn hình.
V.Dùng vào việc thật
A.Kỹ sư dự toán lập BOQ cho công trình nhà ở
Bạn đang lập dự toán một căn nhà phố. Tạo dự án mới, chọn cơ sở giá Việt Nam trong cơ sở dữ liệu đơn giá, rồi thêm từng phần: móng, thân, hoàn thiện. Ở mỗi hạng mục, bạn tìm đơn giá bằng ô tìm kiếm, nhập khối lượng, và cấu hình chi phí chung, lợi nhuận, VAT, dự phòng. Kết quả là một BOQ có tổng từng phần và tổng cộng, bạn xuất ra Excel hoặc PDF để gửi chủ đầu tư.
Phần mềm dự toán không cần đắt, chỉ cần dữ liệu của bạn nằm trong tay bạn.
Ông T
B.Nhân viên văn phòng bóc khối lượng từ bản vẽ PDF
Bạn nhận một bộ bản vẽ PDF và phải lên khối lượng nhanh. Dùng tính năng PDF Takeoff: thả bản vẽ vào, để AI trích khối lượng, rồi đẩy thẳng sang BOQ. Bạn vẫn phải kiểm tra lại các con số AI đọc, nhất là với bản vẽ mờ hoặc nhiều ghi chú. Mỗi kết quả có điểm tin cậy để bạn biết chỗ nào cần soát kỹ. Nhờ vậy bạn bớt được công gõ lại từng dòng.
C.Chủ thầu ước tính nhanh từ một mô tả ngắn
Khách hỏi báo giá sơ bộ khi bạn chưa có bản vẽ. Trong AI Estimate, bạn gõ mô tả bằng văn bản, hoặc đưa ảnh, PDF, bảng tính. Phần mềm dựng một BOQ nháp kèm điểm tin cậy. Bạn dùng nó làm khung, chỉnh lại đơn giá và khối lượng cho đúng thực tế, rồi chạy công cụ kiểm tra để bắt lỗi thiếu khối lượng hay đơn giá bằng 0 trước khi gửi giá. Phần này cần khóa API của một nhà cung cấp LLM.
D.Lập trình viên xây hệ thống riêng trên nền có sẵn
Bạn làm phần mềm cho một công ty xây dựng và không muốn viết lại từ đầu. Repo có REST API đầy đủ và kiến trúc module, nên bạn có thể thêm module riêng hoặc thay module có sẵn. Backend viết trên FastAPI, frontend bằng TypeScript. Bạn đọc DEVELOPING.md, MODULES.md và thư mục modules/ để biết cách mở rộng.
VI.Lỗi hay gặp và cách xử lý
A."pip is not recognized" hoặc không tìm thấy lệnh
Python chưa cài hoặc chưa nằm trong PATH. Cài Python, mở terminal mới rồi chạy lại. Nếu ngại dòng lệnh, chuyển sang app desktop.
B.Docker báo lỗi khi khởi động
Thường do Docker chưa mở, hoặc cổng đang bị chương trình khác dùng. Hãy bật Docker Desktop trước, đọc kỹ thông báo lỗi, rồi đối chiếu với hướng dẫn Quick Start trong README. Nếu bạn tự dựng, kiểm tra các biến như DATABASE_URL và REDIS_URL trong .env đã đúng chưa.
C.Tính năng AI không phản hồi
Khả năng cao là bạn chưa nhập khóa API của nhà cung cấp LLM, hoặc khóa hết hạn mức. Kiểm tra lại cài đặt kết nối AI và số dư tài khoản bên nhà cung cấp. Đừng chia sẻ khóa khi nhờ người khác hỗ trợ.
D.Số liệu AI bóc ra không khớp bản vẽ
AI có thể đọc nhầm. README cũng có phần "AI Disclaimer". Hãy đối chiếu với bản vẽ, nhất là các hạng mục tiền lớn, và dùng công cụ kiểm tra BOQ trước khi gửi giá.
E.Mở file CAD/BIM không được
Hãy kiểm tra định dạng có nằm trong danh sách hỗ trợ (RVT, IFC, DWG và các định dạng CAD khác) và file có bị hỏng không. Nếu vẫn lỗi, tìm trong mục Issues của repo hoặc hỏi ở cộng đồng Telegram của dự án.
VII.Có nên dùng không
Điểm mạnh. Miễn phí theo giấy phép AGPL-3.0, tự chạy trên máy của bạn nên dữ liệu không phải gửi lên dịch vụ của bên thứ ba. Có giao diện tiếng Việt và cơ sở giá riêng cho Việt Nam. Phạm vi rộng: dự toán, bóc khối lượng, BIM, tiến độ, tài chính và API trong một chỗ. Dự án còn được cập nhật, có video hướng dẫn và cộng đồng.
Giới hạn. Nền tảng rất lớn (190+ module), nên người mới sẽ cần thời gian làm quen. Tính năng AI cần khóa API và có thể tốn phí. Đơn giá và định mức trong bộ dữ liệu là tham khảo; bạn cần đối chiếu với định mức, đơn giá và quy định hiện hành mà dự án của bạn phải tuân theo. Về giấy phép, AGPL-3.0 có ràng buộc khi bạn chỉnh sửa rồi cung cấp dịch vụ cho người khác, nên nếu định thương mại hóa, hãy đọc kỹ file LICENSE. Những so sánh về giá và tính năng với phần mềm thương mại trong README là ước tính của tác giả, bạn nên tự kiểm chứng.
Khi nào chọn cách khác. Nếu bạn chỉ cần một bảng tính dự toán nhỏ cho vài hạng mục, Excel vẫn gọn hơn. Nếu công ty bạn bắt buộc dùng phần mềm có hợp đồng hỗ trợ và cam kết dịch vụ, bạn nên cân nhắc giải pháp thương mại. Còn nếu bạn muốn một công cụ mở, tự chủ dữ liệu và sẵn sàng bỏ thời gian học, OpenConstructionERP rất đáng thử, và cứ bắt đầu bằng app desktop cùng dự án demo.
Câu hỏi thường gặp
OpenConstructionERP có miễn phí không?
Có. Repo dùng giấy phép AGPL-3.0, và README nhấn mạnh không có phí thuê bao hay phí theo người dùng. Tuy nhiên nếu bạn bật tính năng AI bằng khóa API của nhà cung cấp LLM, chi phí đó do nhà cung cấp tính, không phải của dự án.
Cài có khó không, có cần biết lập trình không?
Không bắt buộc. README có app desktop để tải về và chạy, không cần Python hay Docker. Nếu quen dòng lệnh, bạn cài bằng pip hoặc Docker. Lệnh pip trong README là pip install openconstructionerp.
Dữ liệu của tôi có an toàn không?
README nói đây là bản tự lưu trữ (self-hosted), mọi thứ chạy trên máy bạn và không rời khỏi mạng của bạn. Riêng tính năng AI sẽ gọi tới nhà cung cấp LLM mà bạn chọn, nên bạn cần cân nhắc dữ liệu nào đưa vào. Repo cũng có file SECURITY.md để bạn xem thêm.
Có dùng được bằng tiếng Việt và có đơn giá Việt Nam không?
Có. README liệt kê tiếng Việt trong 44 ngôn ngữ giao diện, và Việt Nam là một trong 8 cơ sở giá quốc gia. Bạn vẫn nên đối chiếu đơn giá với quy định hiện hành của dự án.
Có cần GPU hoặc máy cấu hình mạnh không?
Tư liệu mình có chưa nêu yêu cầu phần cứng hay GPU. Phần AI chạy qua nhà cung cấp LLM bạn kết nối. Bạn nên xem Getting Started guide trong repo để biết yêu cầu cụ thể.
Chạy được trên Windows không?
App desktop cho phép bạn chọn hệ điều hành rồi tải về, và trang tải sẽ tự chọn file phù hợp. Danh sách hệ điều hành cụ thể không nằm trong đoạn README mình đọc, nên bạn kiểm tra ở trang tải.
Khác gì phần mềm dự toán thương mại?
README so sánh rằng OpenConstructionERP miễn phí, tự lưu trữ, có cơ sở giá kèm theo và hỗ trợ AI, trong khi nhiều phần mềm thương mại tính phí theo người dùng. Đó là so sánh của tác giả, mang tính tham khảo. Bạn nên tự thử với dự án của mình trước khi quyết định.


