# 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à nền tảng ERP xây dựng mã nguồn mở (AGPL-3.0), gồm BOQ, bóc khối lượng PDF/CAD/BIM, kế hoạch 4D/5D và cơ sở dữ liệu đơn giá hơn 120.000 hạng mục. Bạn có thể cài bằng ứng dụng desktop, lệnh pip hoặc Docker. Bản desktop không cần Python hay Docker nên dễ nhất cho người mới.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-05-02 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/openconstructionerp-bao-gia-boq-boc-khoi-luong-bim-ai

OpenConstructionERP là một phần mềm quản lý dự án xây dựng mã nguồn mở, chạy trên máy hoặc máy chủ của chính bạn. Nó gom nhiều việc vào một chỗ: 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. 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 mình hoặc thay module có sẵn.

Nếu bạn làm dự toán, quản lý công trình, hoặc đang cân nhắc phần mềm dự toán mà ngại phí thuê bao theo tháng, repo này đáng để thử. Người làm kinh doanh thầu xây dựng, nhân viên văn phòng của nhà thầu và lập trình viên muốn dựng công cụ nội bộ đều có thể dùng. Hiện repo có khoảng 1.388 sao và 419 fork, vẫn được cập nhật trong vài tháng gần đây.

Điểm đáng giá nhất là bạn không bắt đầu từ trang trắng. Bản cài có sẵn cơ sở dữ liệu hơn 120.000 hạng mục đơn giá, giao diện 44 ngôn ngữ (có tiếng Việt), 293 tình huống hướng dẫn từng bước và bộ dự án demo để bạn bấm thử ngay. Dữ liệu nằm trên máy bạn, không bị đẩy lên dịch vụ của bên thứ ba, trừ khi bạn chủ động nối AI với một nhà cung cấp mô hình ngôn ngữ.

```repo
- repo | datadrivenconstruction/OpenConstructionERP
- kind | Ứng dụng
- desc | Phần mềm ERP xây dựng mã nguồn mở, tự chạy trên máy bạn: lập BOQ, bóc khối lượng từ PDF/CAD/BIM, tra giá và ước tính bằng AI.
- stars | 1.4k
- lang | TypeScript
- license | AGPL-3.0
```

## OpenConstructionERP làm được gì

Dưới đây là những phần bạn sẽ dùng nhiều nhất, tóm theo lợi ích thực tế.

- **Soạn BOQ như bảng tính nhưng có cấu trúc.** Bảng có phần, hạng mục, hạng mục con, kéo thả để sắp xếp. Bấm vào ô là sửa, bấm Tab để sang ô kế, Ctrl+Z để hoàn tác. Khối lượng nhân đơn giá ra thành tiền, tự cộng tiểu kết từng phần và tổng cuối.
- **Gắn nhân công, vật liệu, máy thi công vào từng hạng mục.** Bạn có thể tạo “công thức giá” dùng lại cho nhiều dự án. Phần danh mục tài nguyên có hơn 7.000 vật tư, thiết bị, nhân công.
- **Phụ phí và thuế.** Chi phí chung, lợi nhuận, VAT, dự phòng đều cấu hình được theo dự án hoặc theo mặc định của từng khu vực.
- **Kiểm tra lỗi tự động.** Bộ quy tắc có sẵn phát hiện hạng mục thiếu khối lượng, đơn giá bằng 0, trùng lặp, và đối chiếu theo các chuẩn như DIN 276, NRM, MasterFormat. Kết quả hiện dạng đèn giao thông xanh, vàng, đỏ.
- **Xuất file.** Excel, CSV, báo cáo PDF và GAEB XML (X83).
- **Cơ sở dữ liệu đơn giá.** Hơn 120.000 hạng mục trong 9 bộ giá, phủ hơn 40 thị trường: bộ CWICR toàn cầu cộng 8 bộ quốc gia, trong đó có Việt Nam. 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, nên gõ “concrete wall” vẫn ra “reinforced partition C30/37”.
- **Bóc khối lượng từ PDF, CAD, BIM.** Thả bản vẽ vào, AI trích khối lượng rồi đẩy thẳng vào BOQ. Có trình xem BIM 3D trên trình duyệt và phát hiện va chạm giữa các mô hình (xuất được BCF). Cả phần này nhận các định dạng RVT, IFC, DWG.
- **Ước tính bằng AI.** Đưa vào đoạn văn, ảnh, PDF hoặc bảng tính, hệ thống dựng ra một BOQ kèm điểm tin cậy. README nói bạn nối được các nhà cung cấp như Anthropic, OpenAI, Gemini, Mistral, Groq, DeepSeek.
- **Quản lý tài chính.** Ngân sách, hóa đơn, thanh toán và giá trị thu được (earned value) đối chiếu với dự toán, kèm bảng phân tích nhiều dự án.
- **API đầy đủ (REST).** Dev có thể nối với hệ thống khác.

## Cần chuẩn bị gì

Tùy cách cài, bạn cần những thứ khác nhau. Tư liệu liệt kê ba đường:

- **Ứng dụng desktop miễn phí:** README ghi “không cần Python, không cần Docker, không cần cài gì thêm”. Bạn chọn đúng bản cho hệ điều hành rồi chạy. Đây là đường nhẹ nhất cho người mới.
- **pip:** cần máy đã có Python và công cụ pip. README phần tóm tắt mình có không ghi rõ phiên bản Python tối thiểu. Hãy xem phần Getting Started trong README hoặc trong tài liệu của dự án.
- **Docker:** cần cài Docker. Trong repo có sẵn các file docker-compose.yml, docker-compose.quickstart.yml, docker-compose.quickstart.image.yml và docker-compose.prod.yml.

Nếu muốn dùng tính năng AI, bạn cần một tài khoản và khóa API của nhà cung cấp mô hình mà bạn chọn. Tính năng AI không bắt buộc, phần BOQ và cơ sở dữ liệu giá vẫn dùng được khi không có khóa.

Về phần cứng và hệ điều hành, tư liệu mình có không nêu yêu cầu cụ thể. Trang tải về của dự án sẽ tự gợi ý bản phù hợp với máy bạn.

Trong file .env.example (dùng khi tự dựng máy chủ) có các biến 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. Người dùng bản desktop thường không phải đụng tới.

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

Mình tóm tắt trước, rồi đi vào chi tiết từng đường.

```steps
- Chọn cách cài | Desktop (dễ nhất), pip hoặc Docker
- Tải bản desktop | Vào trang tải về của dự án, chạy file đúng hệ điều hành
- Hoặc cài bằng pip | Một lệnh pip install trong terminal
- Hoặc dùng Docker | Tải mã nguồn về và dùng file docker-compose có sẵn
- Mở và thử với dự án demo | Dùng bộ demo có sẵn để làm quen
```

### Cách 1: ứng dụng desktop (khuyên dùng cho người mới)

Vào trang tải về của dự án (openconstructionerp.com/download). Trang này tự chọn file phù hợp với máy bạn. Tải về rồi chạy như một phần mềm bình thường. Không cần terminal, không cần lệnh nào.

Chỗ người mới hay vấp: nếu Windows hoặc macOS cảnh báo file lạ, hãy chắc chắn bạn tải từ đúng trang của dự án, đừng tải từ nguồn khác.

### Cách 2: cài bằng pip

Mở terminal (trên Windows: PowerShell hoặc Command Prompt) rồi chạy lệnh duy nhất mà README ghi:

```bash
pip install openconstructionerp
```

Lệnh này tải gói từ kho Python và cài vào máy. Nếu máy báo không có lệnh pip, nghĩa là bạn chưa cài Python, hãy cài Python trước.

Sau khi cài xong, lệnh khởi động ứng dụng không nằm trong phần README mình có. Bạn hãy mở mục Quick Start trong README của repo hoặc trang tài liệu (openconstructionerp.com/docs) để lấy đúng lệnh chạy, đừng đoán.

### Cách 3: Docker

Đầu tiên tải mã nguồn về máy:

```bash
git clone https://github.com/datadrivenconstruction/OpenConstructionERP.git
cd OpenConstructionERP
```

Dòng đầu sao chép toàn bộ repo về máy, dòng sau chuyển vào thư mục vừa tải. Trong thư mục này có các file docker-compose.yml, docker-compose.quickstart.yml và docker-compose.quickstart.image.yml. Tên file cho thấy có sẵn cấu hình chạy nhanh, nhưng README phần mình có không ghi lệnh cụ thể. Hãy xem mục Quick Start trong README hoặc file DEVELOPING.md để lấy lệnh chính xác.

```note
Nếu bạn tự dựng máy chủ, đừng để file .env chứa mật khẩu hay khóa truy cập (S3_SECRET_KEY, DATABASE_URL…) ở chỗ người khác đọc được, và không đưa chúng lên GitHub. Khóa API của nhà cung cấp AI có thể phát sinh chi phí theo mức bạn dùng, nên hãy đặt hạn mức bên phía nhà cung cấp.
```

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

Theo README, bản cài mới đi kèm bộ demo gồm 70 dự án trải khắp hơn 30 quốc gia. Vì vậy cách kiểm tra đơn giản nhất là mở ứng dụng và xem:

- Màn hình **Portfolio Dashboard** hiện bản đồ với các dự án.
- Mục **Projects** liệt kê dự án demo, mỗi thẻ có huy hiệu BIM, DWG, PDF.
- Mở một dự án, vào **BOQ Editor**, bạn thấy bảng khối lượng có tổng tiền và điểm chất lượng.
- Mục **Cost Database** tìm được hạng mục theo mã hoặc mô tả.

Thấy các màn hình này là bạn đã cài thành công. README còn khuyên xem video “Install and set up your first project” (khoảng 4 phút 41 giây) nếu muốn có hình ảnh để đối chiếu.

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

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

Bạn là chủ một đội thầu, cần báo giá phần thô cho căn nhà phố. Tạo dự án mới, vào BOQ Editor, chia thành các phần (móng, thân, hoàn thiện). Với mỗi hạng mục, bạn tìm đơn giá trong Cost Database (có bộ giá Việt Nam trong 8 bộ quốc gia), nhập khối lượng, và hệ thống tự nhân ra thành tiền. Sau đó đặt phụ phí: chi phí chung, lợi nhuận, VAT, dự phòng. Cuối cùng xuất Excel để gửi khách.

> Phần mềm dự toán đắt tiền thường chỉ là cái bảng tính có cấu trúc, và repo này cho bạn cái bảng đó miễn phí.
>
> — Ông T

### Nhân viên văn phòng nhận bản vẽ PDF từ kiến trúc sư

Bạn nhận một bản vẽ PDF và cần số liệu nhanh. Vào mục PDF Takeoff, thả bản vẽ vào, để AI trích khối lượng, rồi đẩy thẳng sang BOQ. Việc này cần khóa API của một nhà cung cấp AI, nên bạn hãy xem trong tài liệu chỗ khai báo khóa. Kết quả là một bảng khối lượng nháp để bạn kiểm tra lại, chứ đừng coi là số cuối.

### Ước tính sơ bộ từ mô tả hoặc ảnh

Khách chỉ gửi vài dòng mô tả công trình hoặc một tấm ảnh. Dùng mục AI Estimate, dán mô tả hoặc tải ảnh lên, hệ thống sinh BOQ có kèm điểm tin cậy cho từng dòng. Bạn rà các dòng điểm thấp trước. Cách này hợp để có con số sơ bộ trong buổi trao đổi đầu tiên.

### Dev hoặc BIM coordinator kiểm tra mô hình

Bạn đang gộp mô hình kiến trúc, kết cấu, cơ điện. Nạp các mô hình vào trình xem BIM, chạy Clash Detection để có ma trận va chạm giữa các mô hình, rồi xuất BCF gửi cho nhóm thiết kế. Nếu muốn tích hợp vào hệ thống nội bộ, README cho biết có REST API đầy đủ.

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

- **Gõ pip mà máy báo không tìm thấy lệnh.** Máy chưa cài Python, hoặc Python chưa được thêm vào PATH. Cài Python rồi mở lại terminal. Nếu ngại terminal, dùng bản desktop.
- **Không biết gõ lệnh nào để chạy sau khi cài pip.** Phần README mình có không ghi lệnh khởi động. Đọc mục Quick Start trong README gốc hoặc trang tài liệu của dự án rồi làm theo đúng.
- **Docker không chạy hoặc báo lỗi cổng.** Kiểm tra Docker Desktop đã bật chưa. Nếu cổng đang bị chương trình khác dùng, hãy tắt chương trình đó hoặc xem cấu hình cổng trong file docker-compose.
- **Tính năng AI không trả kết quả.** Thường do chưa khai báo khóa API của nhà cung cấp, hoặc khóa hết hạn mức. Kiểm tra lại khóa và số dư tài khoản bên nhà cung cấp.
- **Số liệu từ AI không khớp thực tế.** README có mục tuyên bố về AI (AI Disclaimer). Hãy xem kết quả AI là bản nháp, rà soát bằng tay và dùng bộ kiểm tra (Validation) trước khi gửi báo giá.

## Có nên dùng không

**Điểm mạnh:** miễn phí theo giấy phép AGPL-3.0, không phí theo người dùng, tự lưu dữ liệu trên máy mình. Có sẵn kho đơn giá lớn, giao diện tiếng Việt, nhiều video hướng dẫn và dự án demo để học nhanh. Bản desktop cài rất dễ.

**Giới hạn:** đây là hệ thống lớn (hơn 190 module), nên mất thời gian làm quen. Đơn giá có sẵn là dữ liệu tham khảo, bạn vẫn phải đối chiếu với giá thị trường và định mức nơi bạn làm. Tính năng AI cần khóa API và có thể tốn phí. Giấy phép AGPL-3.0 có điều kiện khi bạn sửa và cung cấp phần mềm cho người khác dùng qua mạng, nên nếu định đóng gói thành sản phẩm thương mại, hãy đọc kỹ giấy phép. Tư liệu mình có chưa nói gì về yêu cầu phần cứng hay tiêu chuẩn Việt Nam cụ thể, bạn nên tự thử bằng dữ liệu của mình.

**Khi nào chọn cách khác:** nếu bạn chỉ cần một bảng báo giá đơn giản vài dòng, Excel là đủ. Nếu công ty bạn đã có hệ thống ERP và quy trình cố định, hãy cân nhắc kỹ trước khi chuyển.

## 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, README ghi là không thuê bao, không phí theo người dùng. Ứng dụng desktop cũng được giới thiệu là miễn phí. Chi phí duy nhất có thể phát sinh là khóa API của nhà cung cấp AI nếu bạn dùng tính năng AI.

### Có cần cài Python hay Docker không?

Không bắt buộc. Bản desktop không cần Python, không cần Docker. Nếu muốn cài qua terminal thì có hai lựa chọn là pip (cần Python) hoặc Docker.

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

README nói phần mềm tự chạy trên máy hoặc máy chủ của bạn và dữ liệu không rời khỏi mạng của bạn. Riêng khi bạn bật AI và nối với một nhà cung cấp bên ngoài, nội dung gửi cho AI sẽ đi theo nhà cung cấp đó, nên bạn cần cân nhắc.

### Giao diện có tiếng Việt không?

Có. README liệt kê giao diện đầy đủ 44 ngôn ngữ, trong đó có Tiếng Việt. Bộ đơn giá cũng có một bộ quốc gia cho Việt Nam trong 8 bộ quốc gia.

### Dùng AI ước tính cần gì?

Cần nối với một nhà cung cấp mô hình ngôn ngữ như Anthropic, OpenAI, Gemini, Mistral, Groq hoặc DeepSeek theo README. Chỗ khai báo khóa cụ thể chưa có trong tư liệu mình có, bạn xem trong tài liệu của dự án.

### Khác gì phần mềm dự toán thương mại?

README so sánh rằng phần mềm thương mại thường thuê bao theo tháng và đóng kín mã nguồn, còn repo này miễn phí, tự lưu trữ được, kèm cơ sở dữ liệu giá. Bảng so sánh đó do tác giả viết và ghi rõ chỉ mang tính tham khảo theo nhóm phần mềm, nên bạn nên tự thử bằng dữ liệu của mình.

### Có cần GPU hay 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 nên xem trang tài liệu của dự án, đặc biệt nếu định mở mô hình BIM lớn.
