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

OpenConstructionERP: lập dự toán BOQ, bóc khối lượng CAD/BIM, tự host — hướng dẫn cài và dùng

11 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 khối lượng CAD/BIM, tự host — hướng dẫn cài và dùng

Tóm tắt nhanh

OpenConstructionERP là nền tảng ERP xây dựng mã nguồn mở (AGPL-3.0), gồm lập dự toán BOQ, bóc khối lượng từ PDF/CAD/BIM, tiến độ 4D, chi phí 5D và đấu thầu trong một ứng dụng tự host. README có ba cách cài: ứng dụng desktop, pip hoặc Docker. Cài bằng pip chỉ cần một dòng lệnh, nên người mới vẫn thử được.

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 các việc hay nằm rải rác ở nhiều phần mềm đắt tiền: lập bảng khối lượng và dự toán (BOQ), bóc khối lượng từ bản vẽ PDF, CAD, BIM, lập tiến độ, theo dõi chi phí và đấu thầu. 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 của riêng mình hoặc thay module có sẵn.

Repo này hợp với ai? Người làm dự toán, chủ thầu nhỏ, kỹ sư công trường, nhân viên văn phòng của công ty xây dựng. Lập trình viên mới cũng dùng được nếu muốn có một hệ thống thật để nghiên cứu. Bạn không phải biết lập trình mới thử được, vì README có bản ứng dụng desktop tải về là chạy.

Đ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á cho hơn 40 thị trường, trong đó có cơ sở dữ liệu riêng cho Việt Nam. Giao diện có 44 ngôn ngữ, gồm tiếng Việt. Hiện repo có khoảng 1.393 sao và 421 fork, giấy phép AGPL-3.0.

Ứng dụng

datadrivenconstruction/OpenConstructionERP

Phần mềm ERP xây dựng mã nguồn mở, tự host: lập BOQ, bóc khối lượng PDF/CAD/BIM, ước tính chi phí bằng AI, kèm hơn 120.000 đơn giá.

★ 1.4kTypeScriptAGPL-3.0
Xem repo trên GitHub

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

Dưới đây là các nhóm tính năng chính mà README mô tả. Mình giải thích theo lợi ích thực tế.

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

Kiểm tra BOQ tự động. Bộ quy tắc có sẵn báo các lỗi hay gặp như thiếu khối lượng, đơn giá bằng 0, hạng mục trùng. Nó cũng đối chiếu với chuẩn DIN 276, NRM và MasterFormat, rồi chấm điểm theo kiểu đèn giao thông. Với người làm dự toán, đây là lớp rà soát trước khi nộp hồ sơ.

Cơ sở dữ liệu đơn giá và danh mục tài nguyên. Có hơn 120.000 hạng mục trong 9 cơ sở dữ liệu: một bộ toàn cầu (CWICR) và tám bộ quốc gia (Trung Quốc, Thổ Nhĩ Kỳ, Brazil, Tây Ban Nha, Ý, Hy Lạp, Việt Nam, Indonesia). Tìm kiếm theo mô tả, mã hoặc phân loại. Có thêm tìm kiếm ngữ nghĩa bằng AI, nghĩa là tìm theo ý chứ không chỉ theo từ khoá. Danh mục tài nguyên có hơn 7.000 vật liệu, thiết bị, nhân công.

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

Ước tính 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 BOQ kèm điểm tin cậy. Bạn tự kết nối nhà cung cấp mô hình ngôn ngữ như Anthropic, OpenAI, Gemini, Mistral, Groq, DeepSeek.

Quản lý toàn dự án. Có bảng điều khiển danh mục nhiều dự án trên bản đồ, tổng tiền theo từng loại tiền tệ (không cộng gộp lẫn lộn), tài chính, hoá đơn, thanh toán và giá trị thu được (earned value). Hệ thống có hơn 190 module và 293 tình huống hướng dẫn từng bước (guided cases).

Tiêu chuẩn theo vùng. Có hơn 30 chuẩn như DIN 276, NRM 1/2, CSI MasterFormat, GAEB, GB/T 50500 và nhiều chuẩn khác.

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

Tư liệu README mà mình đọc được nói về ba cách cài: ứng dụng desktop, pip và Docker. Mỗi cách cần thứ khác nhau.

  • Ứng dụng desktop: README ghi rõ là không cần Python, không cần Docker, không phải cài đặt gì thêm. Bạn chọn bản đúng hệ điều hành rồi chạy.
  • Cài bằng pip: cần Python và pip trên máy. README phần mình có không nêu phiên bản Python cụ thể, nên bạn xem mục Getting Started hoặc Quick Start trong repo để biết yêu cầu chính xác.
  • Cài bằng Docker: cần Docker. Repo có sẵn các file docker-compose.yml, docker-compose.quickstart.yml, docker-compose.quickstart.image.yml và docker-compose.prod.yml.
  • Tuỳ chọn: muốn dùng tính năng AI thì bạn cần tài khoản và API key của một nhà cung cấp mô hình ngôn ngữ mà bạn chọn. File .env.example của repo liệt kê các biến cấu hình như APP_ENV, DATABASE_URL, REDIS_URL, S3_ENDPOINT. Đây là tên biến dành cho bản triển khai đầy đủ.

Tư liệu chưa nói về yêu cầu phần cứng như RAM hay GPU, nên mình không đoán.

Nếu dùng AI, bạn sẽ điền API key của nhà cung cấp mô hình vào hệ thống. Key là bí mật, đừng gửi cho người khác hay đưa lên nơi công khai. Gọi AI có thể tốn phí theo gói của nhà cung cấp, bạn nên kiểm tra mức phí trước khi cho cả đội dùng.

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

Với người mới, đường dễ nhất là bản desktop. Nếu quen terminal, bạn dùng pip. Docker dành cho ai muốn chạy như một dịch vụ.

  1. Chọn cách càiDesktop, pip hoặc Docker, tuỳ bạn quen công cụ nào
  2. Tải bản desktop hoặc chạy pipDesktop tải về chạy ngay, pip chỉ một dòng lệnh
  3. Khởi động ứng dụngLàm theo mục Quick Start trong README
  4. Mở giao diện và đăng nhậpDùng tài khoản demo nếu README có ghi
  5. Chọn ngôn ngữĐổi sang tiếng Việt từ bất kỳ màn hình nào

A.Cách 1: Tải ứng dụng desktop (dễ nhất)

README có mục "Download the free desktop app". Không cần Python hay Docker. Bạn vào trang tải về của dự án, trang này tự chọn đúng file cho hệ điều hành của bạn, rồi chạy file đó như mọi phần mềm khác.

Trang chủ dự án là openconstructionerp.com, mục tải về nằm ở đường dẫn /download trên trang này. Chỗ người mới hay vấp là chọn nhầm file. Nếu không chắc, cứ để trang tự chọn giúp.

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

Mở terminal (trên Windows là PowerShell hoặc Command Prompt, trên macOS và Linux là Terminal). Gõ lệnh sau. Lệnh này có đúng trong README:

Terminal
pip install openconstructionerp

Lệnh này tải gói về và cài vào Python trên máy bạn. Nếu terminal báo không tìm thấy pip, nghĩa là Python chưa được cài hoặc chưa nằm trong PATH. Bạn cài Python trước rồi mở lại terminal.

Sau khi cài xong, cách khởi động ứng dụng nằm ở mục Quick Start của README, phần mình có không ghi lệnh đó. Bạn mở file README.md trong repo, tìm mục Quick Start và làm đúng theo đó. Mình không muốn đoán tên lệnh khởi động vì gõ sai sẽ mất thời gian của bạn.

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

README nói Docker là một trong ba cách cài. Trước hết bạn lấy mã nguồn về máy:

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

Dòng đầu tải toàn bộ repo. Dòng sau đưa terminal vào thư mục vừa tải. Trong thư mục có sẵn docker-compose.quickstart.yml, nghĩa là có cấu hình chạy nhanh. Lệnh Docker chính xác nằm trong mục Quick Start của README và trong thư mục docs/, bạn chép đúng từ đó. Với Docker, bạn nên mở terminal ngay trong thư mục repo thì Docker mới thấy file cấu hình.

D.Điền cấu hình (nếu cần)

Repo có file .env.example. Đây là mẫu cấu hình, chứa tên các biến như APP_ENV, LOG_LEVEL, DATABASE_URL, REDIS_URL. Nếu bạn triển khai đầy đủ, thường bạn sẽ sao chép file mẫu thành file cấu hình thật rồi điền giá trị. Cách làm cụ thể xem DEVELOPING.md hoặc tài liệu trong docs/. Với bản desktop, bạn không phải làm bước này.

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

README mô tả rằng bản cài mới đi kèm một bộ demo gồm 70 dự án trải trên hơn 30 quốc gia. Vì vậy dấu hiệu rõ nhất là bạn mở được giao diện, thấy bảng điều khiển danh mục dự án với bản đồ và danh sách dự án có sẵn.

Bạn thử thêm ba việc nhỏ:

  1. Mở một dự án demo và vào trình soạn BOQ. Bạn sẽ thấy các phần, hạng mục, tổng tiền.
  2. Vào mục cơ sở dữ liệu đơn giá và tìm một từ khoá như "bê tông". Có kết quả nghĩa là dữ liệu đã nạp.
  3. Đổi ngôn ngữ giao diện sang tiếng Việt từ menu ngôn ngữ.

README cũng nhắc tới mục Demo Accounts (tài khoản demo). Thông tin đăng nhập cụ thể nằm ở mục đó trong README, bạn xem để đăng nhập.

Nếu bạn muốn xem trước khi cài, dự án có video hướng dẫn cài đặt và dựng dự án đầu tiên dài khoảng 4 phút, và bản giới thiệu toàn bộ sản phẩm dài khoảng 12 phút.

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

Các tình huống dưới đây bám theo tính năng README mô tả. Mình mô tả các bước chung, còn tên menu có thể hơi khác tuỳ phiên bản.

A.Chủ thầu nhỏ lập dự toán nhà dân

Bạn nhận một công trình nhà ở và cần báo giá. Tạo dự án mới, chọn cơ sở dữ liệu đơn giá của thị trường phù hợp (README có bộ riêng cho Việt Nam). Trong BOQ, thêm từng phần như móng, thân, hoàn thiện. Tìm hạng mục trong cơ sở dữ liệu, điền khối lượng, hệ thống tự nhân ra thành tiền. Sau đó đặt chi phí chung, lợi nhuận, VAT, dự phòng ở phần markup. Cuối cùng xuất ra Excel để gửi khách.

Kết quả là một bảng dự toán có cấu trúc rõ ràng, tổng tiền khớp và bạn tự chủ dữ liệu của mình.

Phần mềm dự toán tốt nhất là cái bạn thật sự mở ra dùng mỗi ngày, và dữ liệu nằm trong máy của bạn.

Ông T

B.Nhân viên dự toán bóc khối lượng từ bản vẽ PDF

Bạn có bản vẽ PDF và không muốn ngồi đo từng chi tiết bằng tay. Dùng chức năng PDF Takeoff: thả bản vẽ vào, để AI trích khối lượng, kiểm tra lại số liệu rồi đẩy vào BOQ. README nói rõ luồng này là "thả bản vẽ, để AI trích, đẩy thẳng vào BOQ".

Kết quả là bạn tiết kiệm thời gian nhập liệu, nhưng vẫn phải rà soát số, vì AI có thể đọc sai bản vẽ.

C.Kỹ sư BIM kiểm tra va chạm giữa các mô hình

Bạn nhận mô hình từ nhiều bộ môn (kiến trúc, kết cấu, cơ điện). Đưa các file IFC hoặc RVT vào trình xem BIM 3D, chạy phát hiện va chạm để xem ma trận va chạm, rồi xuất BCF gửi cho đội thiết kế. Việc chuyển đổi mô hình dùng DDC Converters theo README.

Kết quả là bạn thấy các chỗ đường ống đâm vào dầm ngay từ khi chưa thi công.

D.Lập trình viên mới nghiên cứu một ERP thật

Bạn muốn học cách một hệ thống lớn được tổ chức. Repo có thư mục backend/ và frontend/, dùng TypeScript và FastAPI (theo chủ đề repo), cùng DEVELOPING.md và CONTRIBUTING.md. Bạn clone về, đọc DEVELOPING.md để chạy bản phát triển, rồi thử viết một module nhỏ. Tác giả khuyến khích tự thêm hoặc thay module.

Kết quả là bạn có một dự án thực tế để thực hành, thay vì ví dụ đồ chơi.

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

Báo không tìm thấy lệnh pip. Python chưa cài hoặc chưa vào PATH. Cài Python từ trang chính thức, đóng terminal rồi mở lại. Với người mới, bản desktop tránh được lỗi này.

Cài xong nhưng không biết khởi động thế nào. Phần lệnh khởi động không nằm trong đoạn README mình có. Bạn mở mục Quick Start hoặc Getting Started trong repo, hoặc trang tài liệu của dự án, và làm đúng theo đó. Đừng tự gõ lệnh đoán mò.

Docker báo không tìm thấy file cấu hình. Thường do bạn đang đứng sai thư mục. Hãy chắc là terminal đang ở thư mục OpenConstructionERP vừa clone, nơi có các file docker-compose.

Cổng đã bị phần mềm khác chiếm hoặc dịch vụ không lên. Đây là lỗi thường gặp với ứng dụng web chạy cục bộ. Tắt phần mềm đang dùng cổng đó, hoặc xem lại cấu hình trong .env.example và tài liệu triển khai. Đọc log trong terminal để biết lỗi nằm ở đâu.

Tính năng AI không chạy. Rất có thể bạn chưa nhập API key hoặc key hết hạn mức. Kiểm tra lại key của nhà cung cấp, và nhớ rằng gọi AI có thể tốn phí. Bạn vẫn dùng được BOQ và cơ sở dữ liệu đơn giá mà không cần AI.

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

Điểm mạnh. Miễn phí, không phí theo người dùng, bạn giữ dữ liệu trên máy mình. Phạm vi rất rộng: BOQ, bóc khối lượng, BIM, tiến độ, tài chính. Có dữ liệu đơn giá sẵn, trong đó có bộ cho Việt Nam, và giao diện tiếng Việt. Dự án còn được cập nhật trong vài tháng gần đây, có nhiều video và tài liệu.

Giới hạn. Hệ thống lớn với hơn 190 module nên cần thời gian làm quen. Chất lượng AI phụ thuộc vào bản vẽ và mô hình bạn chọn, nên số liệu luôn cần người kiểm tra. Đơn giá có sẵn là dữ liệu tham khảo, bạn cần đối chiếu với định mức và giá thị trường thực tế của mình trước khi chốt báo giá. Giấy phép AGPL-3.0 yêu cầu nghiêm túc nếu bạn sửa mã và cung cấp dịch vụ cho người khác, nên nếu định đưa vào sản phẩm thương mại, hãy đọc kỹ file LICENSE. Bảng so sánh với phần mềm trả phí trong README là do tác giả tự đưa ra và chỉ mang tính tham khảo.

Khi nào nên chọn cách khác. Nếu bạn chỉ cần một bảng tính dự toán đơn giản, Excel là đủ. Nếu công ty bắt buộc dùng một phần mềm có hợp đồng hỗ trợ và chịu trách nhiệm, hãy chọn giải pháp thương mại. Còn nếu bạn muốn thử một nền tảng xây dựng mở, tự chủ dữ liệu, thì đây là cái đáng cài thử trước.

4.6/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ó. README ghi giấy phép AGPL-3.0, không thu phí theo tháng hay theo người dùng. Bạn nên đọc kỹ giấy phép nếu định sửa mã và cung cấp dịch vụ cho người khác.

Có chạy được trên Windows không?

README có bản ứng dụng desktop miễn phí để bạn chọn theo hệ điều hành, không cần Python hay Docker. Danh sách hệ điều hành cụ thể nằm trên trang tải về của dự án, tư liệu mình có chưa liệt kê chi tiết.

Cài đặt bằng cách nào, có khó không?

Có ba cách: ứng dụng desktop, pip và Docker. Cách pip chỉ cần lệnh pip install openconstructionerp. Cách desktop dễ nhất với người không rành kỹ thuật.

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

README nói đây là phần mềm tự host, mọi thứ chạy trên máy bạn và không rời khỏi mạng của bạn. Nếu bật tính năng AI thì dữ liệu gửi đến nhà cung cấp mô hình mà bạn chọn, nên bạn cần xem chính sách của họ.

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. Bạn xem tài liệu cài đặt trong repo hoặc trên trang chủ dự án để biết cấu hình khuyến nghị.

Có đơn giá và giao diện tiếng Việt không?

Có. Giao diện hỗ trợ 44 ngôn ngữ trong đó có tiếng Việt. Trong 9 cơ sở dữ liệu đơn giá có một bộ dành cho Việt Nam. Bạn vẫn nên đối chiếu với giá thị trường và định mức thực tế.

Muốn dùng AI thì cần gì?

README nói bạn kết nối nhà cung cấp mô hình ngôn ngữ như Anthropic, OpenAI, Gemini, Mistral, Groq hoặc DeepSeek. Bạn cần tài khoản và API key của nhà cung cấp đó, và có thể phát sinh phí.

Chuyển nhanh tới mục

  1. I.OpenConstructionERP làm được gì
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Cách 1: Tải ứng dụng desktop (dễ nhất)
    2. B.Cách 2: Cài bằng pip
    3. C.Cách 3: Chạy bằng Docker
    4. D.Điền cấu hình (nếu cần)
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ thầu nhỏ lập dự toán nhà dân
    2. B.Nhân viên dự toán bóc khối lượng từ bản vẽ PDF
    3. C.Kỹ sư BIM kiểm tra va chạm giữa các mô hình
    4. D.Lập trình viên mới nghiên cứu một ERP thật
  6. VI.Lỗi hay gặp và cách xử lý
  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ỏ.