Bỏ qua tới nội dung
Ông T.vn

OpenConstructionERP: lập dự toán BOQ, bóc tách CAD/BIM miễn phí — hướng dẫn cài đặt và dùng

9 phút đọcCập nhật

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 →

OpenConstructionERP: lập dự toán BOQ, bóc tách CAD/BIM miễn phí — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

OpenConstructionERP là nền tảng quản lý dự án xây dựng mã nguồn mở (giấy phép AGPL-3.0), gồm lập dự toán BOQ, bóc tách khối lượng từ PDF/CAD/BIM, kế hoạch 4D/5D và đấu thầu. Bạn có thể tải bản desktop, cài bằng pip hoặc chạy bằng Docker, và dữ liệu nằm trên máy của bạn. Cài bản desktop khá dễ; cài bằng pip hoặc Docker cần quen terminal.

OpenConstructionERP là một nền tảng quản lý dự án xây dựng mã nguồn mở, tự cài trên máy hoặc máy chủ của bạn. Nó gom nhiều việc thường nằm rải rác ở nhiều phần mềm trả phí: lập bảng khối lượng và dự toán (BOQ), bóc tách 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.

Repo này hợp với người làm dự toán, quản lý công trình, chủ thầu nhỏ, và lập trình viên muốn dựng công cụ nội bộ cho ngành xây dựng. Người làm văn phòng không rành code cũng thử được, vì tác giả có bản desktop tải về chạy ngay, không cần Python hay Docker.

Điều đáng giá nhất: bạn có sẵn kho giá hơn 120.000 hạng mục, giao diện 44 ngôn ngữ (có tiếng Việt), và một cơ sở giá riêng cho Việt Nam. Hiện repo có khoảng 1.393 sao và 421 fork, vẫn được cập nhật trong vài tháng gần đây.

Ứng dụng

datadrivenconstruction/OpenConstructionERP

Nền tảng ERP xây dựng mã nguồn mở: lập BOQ, bóc tách PDF/CAD/BIM, gợi ý giá bằng AI, tự host trên máy bạn, có giao diện tiếng Việt.

★ 1.4kTypeScriptAGPL-3.0
Xem repo trên GitHub

I.OpenConstructionERP làm được gì

Theo README, đây là một workspace, nghĩa là nhiều công cụ trong cùng một nơi. Mình tóm lại những phần bạn dễ dùng nhất.

A.Lập BOQ (bảng khối lượng và dự toán)

Bộ soạn BOQ có cấu trúc phân cấp: phần, hạng mục, hạng mục con. Bạn bấm vào ô để sửa, dùng Tab để nhảy ô, Ctrl+Z để hoàn tác. Phần mềm tự tính khối lượng nhân đơn giá ra thành tiền, tổng từng phần và tổng cộng. Bạn cũng cài được chi phí chung, lợi nhuận, VAT, dự phòng theo từng dự án. Kết quả xuất ra Excel, CSV, PDF hoặc GAEB XML (X83).

B.Kho giá và danh mục tài nguyên

Có hơn 120.000 hạng mục giá, chia thành 9 cơ sở dữ liệu, phủ hơn 40 thị trường. Gồm một cơ sở toàn cầu (CWICR) và tám cơ sở quốc gia: Trung Quốc, Thổ Nhĩ Kỳ, Brazil, Tây Ban Nha, Ý, Hy Lạp, Việt Nam và Indonesia. Danh mục tài nguyên có hơn 7.000 vật liệu, thiết bị, nhân công. Tìm kiếm có cả kiểu ngữ nghĩa bằng AI: gõ "concrete wall" vẫn ra "reinforced partition C30/37".

C.Bóc tách PDF, CAD, BIM

Bạn thả bản vẽ PDF vào, AI trích khối lượng rồi đẩy thẳng vào BOQ. README nhắc các định dạng RVT, IFC, DWG. Có trình xem 3D BIM ngay trên trình duyệt và phát hiện va chạm giữa các mô hình, xuất BCF.

D.Dự toán bằng AI

Bạn đưa vào văn bản, ảnh, PDF hoặc bảng tính, hệ thống dựng ra BOQ kèm điểm tin cậy. Bạn tự nối với nhà cung cấp LLM mình chọn (README liệt kê Anthropic, OpenAI, Gemini, Mistral, Groq, DeepSeek).

E.Kiểm tra BOQ

Có sẵn quy tắc DIN 276, NRM, MasterFormat. Hệ thống chấm điểm BOQ theo đèn giao thông, bắt lỗi như thiếu khối lượng, đơn giá bằng 0, hạng mục trùng.

F.Những phần khác

Tài chính và giá trị đạt được (earned value), phân tích đa dự án, hợp tác thời gian thực, REST API đầy đủ, 190+ module kiểu cắm thêm như WordPress, và 293 tình huống hướng dẫn có sẵn.

II.Cần chuẩn bị gì

Tuỳ cách cài mà bạn cần khác nhau. README nêu ba đường:

  • Bản desktop: không cần Python, không cần Docker. Chọn hệ điều hành rồi chạy.
  • pip: cần Python và pip trên máy (README không nêu số phiên bản trong phần mình có).
  • Docker: cần cài Docker. Repo có các file docker-compose.yml, docker-compose.quickstart.yml, docker-compose.prod.yml.

Về AI: muốn dùng các tính năng AI, bạn cần tài khoản và khoá API của một nhà cung cấp LLM. Nếu chỉ lập BOQ thủ công thì không cần.

Phần mình đọc được không nói rõ cấu hình phần cứng tối thiểu hay hệ điều hành cụ thể cho bản desktop. Bạn xem trang tải để biết thêm.

Nếu dùng tính năng AI, khoá API của nhà cung cấp LLM là của riêng bạn và có thể phát sinh phí theo mức dùng. Đừng dán khoá vào file chia sẻ chung hay đẩy lên GitHub.

III.Cài đặt từng bước

Phần README mình có bị cắt trước mục Quick Start, nên mình chỉ ghi những lệnh chắc chắn có. Chi tiết còn lại bạn đọc ở mục Quick Start và Getting Started guide trong README.

  1. Chọn cách càiDesktop (dễ nhất), pip hoặc Docker
  2. Tải bản desktopVào trang tải, trang tự chọn đúng file cho máy bạn
  3. Hoặc cài bằng pipChạy một lệnh pip trong terminal
  4. Hoặc chạy bằng DockerTải repo về, dùng file docker-compose có sẵn
  5. Mở ứng dụngLàm theo Quick Start trong README để mở giao diện

A.Cách 1: Tải bản desktop (khuyên dùng cho người mới)

Vào trang openconstructionerp.com/download. Trang này tự chọn file phù hợp với 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. Không phải gõ lệnh nào.

B.Cách 2: Cài bằng pip

Mở terminal (trên Windows: PowerShell hoặc Command Prompt) rồi gõ:

Terminal
pip install openconstructionerp

Lệnh này tải gói về máy bằng pip. Nếu máy báo không tìm thấy pip, bạn cần cài Python trước. Phần README mình có chưa ghi lệnh khởi động sau khi cài, nên hãy xem mục Quick Start trong README hoặc trang tài liệu trên openconstructionerp.com/docs.

C.Cách 3: Chạy bằng Docker

Đầu tiên tải mã nguồn về và vào thư mục dự án:

Terminal
git clone https://github.com/datadrivenconstruction/OpenConstructionERP.git
cd OpenConstructionERP

Trong thư mục có docker-compose.quickstart.yml (bản chạy nhanh) và docker-compose.yml. Phần README mình có không chép lệnh khởi động Docker, nên bạn xem đúng lệnh ở mục Quick Start trong README. Repo cũng có file .env.example liệt kê các biến cấu hình như DATABASE_URL, REDIS_URL, S3_ENDPOINT, S3_BUCKET. Nếu chạy bản tự dựng, bạn sẽ cần copy file này ra và điền giá trị phù hợp. Người mới nên thử bản quickstart trước để khỏi đụng cấu hình.

IV.Kiểm tra đã chạy được chưa

Cách dễ nhất: mở được giao diện web hoặc cửa sổ ứng dụng. README nói bản cài mới đi kèm một bộ demo 70 dự án trải qua hơn 30 quốc gia, nên nếu bạn thấy bảng điều khiển danh mục (Portfolio Dashboard) với bản đồ và danh sách dự án là đã chạy.

Tiếp theo bạn mở thử mục BOQ và Cost Database. Nếu thấy bảng khối lượng và kho giá tìm được theo mã hay mô tả, thì cài xong.

README có mục Demo Accounts để đăng nhập thử. Phần này nằm ở chỗ README bị cắt, nên bạn xem trực tiếp trong README, mình không đoán tài khoản.

Bạn đổi ngôn ngữ sang Tiếng Việt từ bất kỳ màn hình nào, README nói mọi nhãn và báo cáo sẽ đổi theo.

V.Dùng vào việc thật

A.Chị chủ thầu nhỏ lập dự toán từ bản vẽ PDF

Chị làm thầu sửa nhà, nhận bản vẽ PDF từ khách. Thay vì ngồi đo tay và nhập Excel, chị tạo dự án, kéo thả bản vẽ vào mục PDF Takeoff, để AI trích khối lượng, rồi đẩy sang BOQ. Sau đó chị tìm đơn giá trong kho giá (có cơ sở Việt Nam), thêm chi phí chung, lợi nhuận, VAT, và xuất Excel gửi khách.

Kết quả: một bảng dự toán có đủ phần, hạng mục, thành tiền, tổng cộng, thay cho file Excel tự làm.

Dự toán là nơi sai một con số là mất cả lãi, nên công cụ phải bắt lỗi giúp mình.

Ông T

B.Nhân viên văn phòng kiểm tra BOQ trước khi nộp thầu

Bạn nhận một BOQ do đồng nghiệp lập và cần soát lại. Bạn nhập vào mục Validation. Hệ thống chạy các quy tắc có sẵn (DIN 276, NRM, MasterFormat) và trả báo cáo đèn giao thông, chỉ ra hạng mục thiếu khối lượng, đơn giá bằng 0, hoặc trùng lặp.

Kết quả: bạn có danh sách chỗ cần sửa và điểm chất lượng BOQ, không phải rà từng dòng bằng mắt.

C.Chủ đầu tư ước giá nhanh từ mô tả bằng chữ

Bạn có một mô tả công trình ngắn và muốn ước tính sơ bộ. Bạn nối OpenConstructionERP với một nhà cung cấp LLM, vào mục AI Estimate và đưa mô tả (văn bản, ảnh, PDF hoặc bảng tính đều được theo README). Hệ thống dựng BOQ kèm điểm tin cậy cho từng dòng.

Kết quả: một bản nháp BOQ trong vài giây. Hãy coi đây là bản nháp để soát lại, không phải con số chốt.

D.Lập trình viên dựng công cụ nội bộ

Bạn là dev cho một công ty xây dựng và muốn nối dữ liệu dự toán vào hệ thống khác. Repo có REST API đầy đủ, kiến trúc module cho phép thêm hoặc thay module, và backend dùng FastAPI. Bạn chạy bản Docker hoặc dựng từ mã nguồn rồi đọc tài liệu API và file DEVELOPING.md trong repo.

Kết quả: bạn kéo dữ liệu BOQ ra qua API hoặc viết thêm module riêng.

VI.Lỗi hay gặp và cách xử lý

A.Báo không tìm thấy lệnh pip

Máy chưa cài Python hoặc Python chưa nằm trong PATH. Cài Python trước, mở lại terminal rồi chạy lại. Nếu ngại, dùng bản desktop.

B.Docker chạy nhưng không vào được giao diện

Kiểm tra Docker đã chạy chưa và container có ở trạng thái đang chạy không. Cổng có thể bị chương trình khác chiếm. Xem lại hướng dẫn Quick Start và log của container để biết cổng đúng. Mình không đoán số cổng vì phần README mình có không nêu.

C.Chức năng AI không trả kết quả

Thường do chưa cấu hình nhà cung cấp LLM hoặc khoá API sai hoặc hết hạn mức. Kiểm tra lại khoá ở nhà cung cấp, và xem trang tài liệu để biết chỗ nhập khoá trong ứng dụng.

D.Giá hoặc khối lượng AI đề xuất không khớp thực tế

AI có thể nhận sai bản vẽ hoặc chọn nhầm hạng mục giá. Repo có điểm tin cậy và mục Validation để bạn soát. Hãy đối chiếu bản vẽ và đơn giá địa phương trước khi dùng. README cũng có mục AI Disclaimer về việc này.

E.Chạy bản tự dựng bị lỗi kết nối cơ sở dữ liệu

Nếu bạn dựng không qua bản quickstart, các biến như DATABASE_URL, DATABASE_SYNC_URL, REDIS_URL trong .env.example phải trỏ đúng tới dịch vụ đang chạy. Sai một biến là backend không lên được. Hãy so với file mẫu và thử bản quickstart trước.

VII.Có nên dùng không

Điểm mạnh: miễn phí, tự host nên dữ liệu ở lại máy bạn (README nói không gì rời khỏi mạng của bạn, ngoại trừ khi bạn chủ động dùng AI qua nhà cung cấp LLM bên ngoài). Phạm vi rộng: BOQ, bóc tách, BIM, kiểm tra, tài chính. Có tiếng Việt và cơ sở giá Việt Nam. Có bản desktop cho người không rành kỹ thuật.

Giới hạn: phạm vi lớn nên cần thời gian làm quen. Việc cài bằng pip hoặc Docker đòi hỏi quen terminal. Về độ phủ giá Việt Nam, mình chưa có thông tin chi tiết về mức cập nhật, bạn nên đối chiếu với đơn giá và định mức bạn đang dùng. Giấy phép AGPL-3.0 có điều kiện khi bạn sửa mã và cung cấp dịch vụ cho người khác qua mạng, nên công ty định tích hợp hay bán lại cần đọc kỹ file LICENSE.

Khi nên chọn cách khác: nếu bạn chỉ cần một bảng Excel đơn giản cho vài việc nhỏ, bộ công cụ này có thể quá nặng. Nếu doanh nghiệp cần hỗ trợ có hợp đồng, bạn cần xem kênh hỗ trợ của dự án (có file SUPPORT.md) và cân nhắc kỹ.

Lời khuyên của mình: thử bản desktop với dự án demo trước, làm một BOQ nhỏ, rồi hãy quyết định có triển khai sâu hơn không.

4.9/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

Câu hỏi thường gặp

OpenConstructionERP có miễn phí không?

Có. Dự án dùng giấy phép AGPL-3.0 và README nói không có phí thuê bao hay phí theo người dùng. Nếu bạn dùng tính năng AI, chi phí API của nhà cung cấp LLM là phần riêng, do bạn tự trả.

Có cần GPU hay máy cấu hình mạnh không?

Phần README mình có chưa nêu yêu cầu phần cứng. Tính năng AI chạy qua nhà cung cấp LLM bạn nối vào, nên không thấy README nhắc cần GPU. Muốn chắc về cấu hình, bạn xem trang tài liệu của dự án.

Chạy được trên Windows không?

README có bản desktop cho người dùng chọn hệ điều hành rồi chạy. Phần mình có không liệt kê chi tiết hệ điều hành nào được hỗ trợ, nên bạn xem trang tải để biết bản dành cho máy mình.

Dữ liệu của tôi có an toàn không?

README nói đây là bản tự host, mọi thứ chạy trên máy hoặc máy chủ của bạn và không rời mạng của bạn. Nếu bạn bật AI qua nhà cung cấp LLM bên ngoài, nội dung gửi đi sẽ theo chính sách của nhà cung cấp đó. Repo cũng có file SECURITY.md.

Có giao diện tiếng Việt và 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 nằm trong tám cơ sở giá quốc gia. Mức độ đầy đủ và cập nhật của dữ liệu giá Việt Nam thì chưa có thông tin chi tiết.

Cài bằng cách nào dễ nhất?

Dễ nhất là tải bản desktop, không cần Python hay Docker. Nếu quen terminal, bạn có thể dùng lệnh pip install openconstructionerp hoặc chạy bằng Docker theo mục Quick Start trong README.

Khác gì phần mềm dự toán trả phí?

README so sánh với các nhóm phần mềm BIM, bóc tách CAD, dự toán truyền thống và đánh dấu PDF. Điểm khác chính là mã nguồn mở, tự host, có kho giá kèm sẵn và có AI. Đây là so sánh do chính tác giả viết theo khả năng chung của từng nhóm, nên bạn nên tự thử trước khi so.

Chuyển nhanh tới mục

  1. I.OpenConstructionERP làm được gì
    1. A.Lập BOQ (bảng khối lượng và dự toán)
    2. B.Kho giá và danh mục tài nguyên
    3. C.Bóc tách PDF, CAD, BIM
    4. D.Dự toán bằng AI
    5. E.Kiểm tra BOQ
    6. F.Những phần khác
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Cách 1: Tải bản desktop (khuyên dùng cho người mới)
    2. B.Cách 2: Cài bằng pip
    3. C.Cách 3: Chạy bằng Docker
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chị chủ thầu nhỏ lập dự toán từ bản vẽ PDF
    2. B.Nhân viên văn phòng kiểm tra BOQ trước khi nộp thầu
    3. C.Chủ đầu tư ước giá nhanh từ mô tả bằng chữ
    4. D.Lập trình viên dựng công cụ nội bộ
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Báo không tìm thấy lệnh pip
    2. B.Docker chạy nhưng không vào được giao diện
    3. C.Chức năng AI không trả kết quả
    4. D.Giá hoặc khối lượng AI đề xuất không khớp thực tế
    5. E.Chạy bản tự dựng bị lỗi kết nối cơ sở dữ liệu
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.