Tất cả những gì bạn cần để cài đặt, cấu hình và sử dụng OpenConstructionERP cho việc ước lượng chi phí xây dựng chuyên nghiệp.
Khởi động → Dự án mới → BoQ → Liên kết BIM → DWG → Lấy số liệu PDF → Ước lượng đầy đủ → Nhiệm vụ → Khám phá dữ liệu → Ước lượng AI → Danh mục đầu tư.
Phụ đề, chương và phát lại 1.5× được tích hợp trong trình phát ở trên. Bạn muốn xem trực tiếp trên YouTube? ▶ Mở trên YouTube · đăng ký kênh để nhận các video hướng dẫn mới.
Mỗi khối dưới đây là một đoạn GIF ngắn từ video hướng dẫn đầy đủ ở trên - cùng thứ tự như video, vì vậy bạn có thể nhảy đến bất kỳ quy trình nào quan trọng nhất. Bạn muốn một luồng liên tục? ▶ Xem video hướng dẫn 12 phút trên YouTube.
OpenConstructionERP là một nền tảng ước lượng chi phí xây dựng và quản lý dự án hoàn chỉnh, hoạt động hoàn toàn trên máy của bạn. Nó thay thế các bộ ước lượng thương mại đắt tiền bằng một giải pháp mở, tự lưu trữ. Nền tảng này bao phủ toàn bộ vòng đời xây dựng - từ các nghiên cứu khả thi ban đầu và khối lượng đến việc chuẩn bị BOQ chi tiết, đấu thầu, so sánh giá thầu, thực hiện dự án, quản lý chất lượng và kiểm soát tài chính. Tất cả dữ liệu của bạn sẽ ở trên máy chủ của bạn. Không phụ thuộc vào đám mây, không có đăng ký, không phí theo ghế.
Điểm nổi bật v18.5.0: hơn 190 mô-đun bao phủ toàn bộ vòng đời xây dựng: danh bạ liên hệ, công việc với Kanban, theo dõi RFI, tài chính (hóa đơn, ngân sách, EVM), mua sắm, an toàn, họp, kiểm tra chất lượng, NCR, submittals, thư tín, CDE (ISO 19650), transmittals, BIM Hub, sổ tài sản với xuất COBie, báo cáo & bảng KPI, markups (PDF↔DWG↔hub), trực quan hóa pivot & bộ chọn cột cho biểu đồ, dịch vụ email có thể cắm thêm, liên hệ đa người thuê, báo cáo theo lịch, Regional Packs và nhập/xuất đầy đủ.


Hóa đơn khối lượng phân cấp với các phần, vị trí, tài nguyên, lắp ráp và đánh dấu tự động.
Cơ sở chi phí từ 9 nguồn quốc gia, phát hành thành 48 phiên bản thị trường theo tiền tệ và ngôn ngữ địa phương, với 36 cơ sở dữ liệu khu vực sẵn sàng nhập.
Tạo BOQ từ văn bản, ảnh, PDF, Excel hoặc mô hình CAD/BIM bằng cách sử dụng bất kỳ nhà cung cấp LLM nào.
Trích xuất số lượng từ RVT, IFC, DWG, DGN qua các bộ chuyển đổi DDC.
Lập lịch Gantt với CPM, Quản lý Giá trị Đã kiếm được, Đường cong S, mô phỏng Monte Carlo.
Tài chính, An toàn, Chất lượng, CDE, Trung tâm BIM, Mua sắm, RFI, Nhiệm vụ, Cuộc họp và nhiều hơn nữa. Chỉ kích hoạt những gì bạn cần.
Sau khi cài đặt OpenConstructionERP, hãy làm theo các bước này để thiết lập dự án đầu tiên của bạn và tạo ước lượng chi phí đầu tiên. Toàn bộ quá trình mất khoảng 10 phút.
Mở trình duyệt của bạn và điều hướng đến http://localhost:5173 (phát triển cục bộ) hoặc http://localhost:8080 (Docker). Bạn sẽ thấy trang đăng nhập với bảng "Truy cập Demo". Nhấp vào Quản trị viên để đăng nhập ngay lập tức bằng tài khoản demo, hoặc nhập thông tin đăng nhập của bạn nếu bạn đã đăng ký tài khoản mới.
Khi đăng nhập lần đầu, trình hướng dẫn sẽ hướng dẫn bạn qua việc thiết lập ban đầu:
Nhấp vào Dự án Mới trên Bảng điều khiển hoặc điều hướng đến Dự án. Điền vào:
Sau khi tạo dự án, bạn sẽ được chuyển hướng đến trang chi tiết dự án nơi bạn có thể bắt đầu thêm BOQ.
Từ trang dự án, nhấp vào Dự toán Mới. Đặt tên cho nó (ví dụ: "Dự toán Chi phí v1") và tùy chọn chọn một mẫu. Trình chỉnh sửa BOQ mở ra với một lưới trống sẵn sàng cho vị trí đầu tiên của bạn.
Trong trình chỉnh sửa BOQ, nhấp vào Thêm Vị trí hoặc nhấn Enter trên một hàng trống. Điền vào:
Cột Tổng tự động tính toán (Số lượng x Đơn giá). Bạn cũng có thể tìm kiếm cơ sở dữ liệu chi phí bằng cách nhấp vào biểu tượng cơ sở dữ liệu bên cạnh bất kỳ vị trí nào để tìm và áp dụng một mức giá từ hơn 120,000 mục CWICR.
OpenConstructionERP được thiết kế để dễ cài đặt bất kể nền tảng kỹ thuật của bạn. Chọn phương pháp phù hợp với thiết lập của bạn - tất cả các tùy chọn đều mất chưa đến 5 phút. Ứng dụng sử dụng PostgreSQL nhúng theo mặc định (không cần Docker, không cần máy chủ cơ sở dữ liệu riêng, không cần thiết lập), vì vậy mọi thứ hoạt động ngay lập tức. Cần Python 3.12+ cho pip và các đường dẫn một dòng.
pip install --upgrade openconstructionerp
openconstructionerpCài đặt backend + frontend React đã xây dựng sẵn trong một gói. Mở tại http://localhost:8080 với toàn bộ giao diện người dùng. PostgreSQL nhúng, không cần cấu hình. Nếu có gì đó trông sai, hãy chạy openconstructionerp doctor.
Trên Ubuntu 23.04+ (bao gồm Ubuntu 26) và Debian 12+, pip install trực tiếp vào Python hệ thống sẽ thất bại với error: externally-managed-environment (PEP 668). Sử dụng môi trường ảo thay vào đó:
# Ubuntu 26 - install Python 3.12 explicitly if needed
sudo apt install -y python3.12 python3.12-venv
# Create and activate a venv, then install
python3.12 -m venv ~/ocerp-venv
source ~/ocerp-venv/bin/activate
pip install --upgrade openconstructionerp
openconstructionerpNếu pip quay lại xây dựng từ nguồn, hãy cài đặt các tiêu đề: sudo apt install -y build-essential libpq-dev libjpeg-dev zlib1g-dev libgeos-dev. Hướng dẫn Linux đầy đủ với khắc phục sự cố: docs/INSTALL_LINUX.md.
# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/datadrivenconstruction/OpenConstructionERP/main/scripts/install.sh | bash
# Windows (PowerShell)
irm https://raw.githubusercontent.com/datadrivenconstruction/OpenConstructionERP/main/scripts/install.ps1 | iexChọn Docker nếu đã cài đặt, nếu không thì uv, nếu không thì pip. Chạy tại http://localhost:8080.
git clone https://github.com/datadrivenconstruction/OpenConstructionERP.git
cd OpenConstructionERP
make quickstartMở tại http://localhost:8080 (~2 phút cho lần xây dựng đầu tiên).
git clone https://github.com/datadrivenconstruction/OpenConstructionERP.git
cd OpenConstructionERP
# Backend (embedded PostgreSQL, zero config)
cd backend && pip install -r requirements.txt
uvicorn app.main:create_app --factory --reload --port 8000
# Frontend (new terminal)
cd frontend && npm install && npm run devBackend: http://localhost:8000 / Frontend: http://localhost:5173
| Tài khoản | Mật khẩu | Vai trò | |
|---|---|---|---|
| Admin | demo@openconstructionerp.com | DemoPass1234! | Quyền truy cập đầy đủ |
| Estimator | estimator@openconstructionerp.com | DemoPass1234! | Người ước lượng |
| Manager | manager@openconstructionerp.com | DemoPass1234! | Quản lý |
5 dự án demo (Berlin, London, New York, Paris, Dubai) với BOQ, lịch trình và mô hình chi phí hoàn chỉnh.
Trình chỉnh sửa Bill of Quantities là nơi bạn dành phần lớn thời gian. Nó cung cấp một giao diện chuyên nghiệp giống như bảng tính được hỗ trợ bởi AG Grid với các tính năng cụ thể cho xây dựng được tích hợp sẵn - các phần phân cấp, liên kết tài nguyên, công thức lắp ráp và tính toán markup tự động. Mọi thay đổi đều được theo dõi với hỗ trợ hoàn tác/làm lại đầy đủ. 42 quy tắc xác thực chạy tự động trong nền, phát hiện các lỗi như số lượng thiếu, giá bằng không, vị trí trùng lặp và vấn đề tuân thủ phân loại trước khi chúng trở thành vấn đề.
🎬 Xem trình chỉnh sửa BOQ hoạt động trên YouTube - chỉnh sửa theo kiểu bàn phím, hơn 120K mục đã định giá, điểm chất lượng trực tiếp.



Các phần tổ chức BOQ của bạn thành các nhóm hợp lý (ví dụ: "300 Cấu trúc", "400 HVAC"). Để tạo một phần:
Bạn có thể thu gọn/mở rộng các phần để tập trung vào các nghề cụ thể. Kéo các phần để sắp xếp lại toàn bộ cấu trúc BOQ.
Mỗi vị trí BOQ có thể có các tài nguyên liên kết phân tích tỷ lệ đơn vị thành các thành phần:
Để thêm tài nguyên: mở rộng hàng vị trí, nhấp "Thêm Tài nguyên", tìm kiếm trong danh mục, đặt hệ số số lượng (ví dụ: 120 kg thép thanh trên m3 bê tông). Tỷ lệ đơn vị của vị trí sẽ tự động cập nhật từ tổng của các tài nguyên của nó.
Markups được áp dụng sau tổng số ròng (tổng của tất cả các vị trí). Các markup phổ biến bao gồm:
Nhấp vào Thêm Chi Phí Thêm trong thanh công cụ. Bạn có thể thiết lập mặc định khu vực hoặc tùy chỉnh theo dự án. Chi phí thêm có thể là tỷ lệ phần trăm hoặc số tiền cố định, và chúng cộng dồn theo thứ tự (chi phí chung trước, sau đó là lợi nhuận trên số tiền bao gồm chi phí chung, sau đó là VAT trên tổng số).
Nhấn Ctrl+Shift+V hoặc nhấp vào biểu tượng khiên trong thanh công cụ để thực hiện xác thực. Hệ thống kiểm tra BOQ của bạn theo các bộ quy tắc đã chọn và hiển thị kết quả trực tiếp:
Trình chỉnh sửa BOQ hỗ trợ nhập từ nhiều nguồn:
| Phím tắt | Hành động |
|---|---|
Ctrl+K | Bảng lệnh |
Ctrl+N | Dự án mới |
Ctrl+Shift+V | Chạy xác thực |
Ctrl+Z / Y | Hoàn tác / Làm lại |
Truy cập cơ sở dữ liệu chi phí xây dựng mã nguồn mở lớn nhất thế giới: hơn 120.000 hạng mục chi phí ở hơn 40 khu vực. Cơ sở dữ liệu CWICR toàn cầu đóng góp hơn 55.000 hạng mục với mô tả bằng tối đa 9 ngôn ngữ, sắp xếp theo hạng mục thi công (đào đắp, bê tông, xây, thép, mái, mặt dựng, HVAC, điện, cấp thoát nước, hoàn thiện, cảnh quan). Mỗi hạng mục có đơn vị đo, đơn giá gốc cho khu vực chỉ định, mã phân loại (DIN 276, NRM, MasterFormat) và khi có thì kèm bảng tách vật liệu, nhân công, máy.


| Khu vực | Tiền tệ | Tiêu chuẩn | Mục |
|---|---|---|---|
| Đức (DACH) | EUR | DIN 276 | 55,719 |
| Vương quốc Anh | GBP | NRM 1/2 | 55,719 |
| Hoa Kỳ | USD | MasterFormat | 55,719 |
| Pháp | EUR | DPGF | 55,719 |
| Nga | RUB | GESN | 55,719 |
| UAE | AED | Địa phương | 55,719 |
| Trung Quốc | CNY | GB/T | 55,719 |
| Ấn Độ | INR | CPWD | 55,719 |
Cơ sở dữ liệu chi phí được thiết kế cho hai quy trình chính:
Mỗi mục chi phí chứa:
Bật tìm kiếm ngữ nghĩa để tìm các mục chi phí theo nghĩa, không chỉ là các từ khóa chính xác. Khi bạn tìm kiếm "tường bê tông", hệ thống cũng tìm thấy các mục như "vách ngăn gia cố C30/37, 24cm với khuôn" - mặc dù các từ chính xác không xuất hiện. Điều này được hỗ trợ bởi các nhúng sentence-transformer chuyển đổi mô tả thành các vector số và tìm các kết quả gần nhất trong không gian đa chiều. Hai backend cơ sở dữ liệu vector được hỗ trợ: LanceDB (nhúng, chạy trong quá trình như SQLite, nhúng 384 chiều) và Qdrant (máy chủ sản xuất với các bản chụp 3072 chiều đã được xây dựng sẵn có thể tải xuống từ GitHub).
Trích xuất số lượng trực tiếp từ bản vẽ và mô hình dự án của bạn - không cần đếm thủ công. Tải lên các tệp RVT, IFC, DWG hoặc DGN và hệ thống sẽ trích xuất mọi yếu tố xây dựng với thể tích, diện tích và chiều dài. Đối với các bản vẽ PDF, mở chúng trực tiếp trong trình duyệt và sử dụng các công cụ đo lường đã được hiệu chỉnh để lấy khoảng cách, diện tích và số lượng yếu tố. Tất cả số lượng đã trích xuất có thể được chuyển đến một BOQ để định giá.
🎬 Xem các chương về liên kết hàng loạt BIM → BOQ, lấy số liệu lớp DWG và đo lường PDF trên YouTube.





| Định dạng | Phần mềm | Bộ chuyển đổi |
|---|---|---|
| .rvt / .rfa | BIM | DDC RvtExporter |
| .ifc | IFC (bất kỳ BIM nào) | DDC IfcExporter |
| .dwg / .dxf | CAD | DDC DwgExporter |
| .dgn | CAD | DDC DgnExporter |
Kết nối bất kỳ nhà cung cấp LLM nào để tạo ra ước lượng chi phí xây dựng từ mô tả văn bản đơn giản, hình ảnh tòa nhà, PDF quét, bảng tính Excel hoặc mô hình CAD/BIM. Hệ thống AI tạo ra các vị trí BOQ hoàn chỉnh với số lượng và giá cả theo thị trường. Sau khi tạo, bạn có thể đối chiếu từng mục với cơ sở dữ liệu chi phí CWICR để thay thế các mức giá ước lượng của AI bằng giá thị trường khu vực đã được xác minh. Các tính năng AI hoàn toàn là tùy chọn - nền tảng hoạt động hoàn toàn mà không cần chúng.
🎬 Xem "Dự toán AI từ một bức ảnh" trên YouTube - tải lên một bức ảnh xây dựng, nhận BOQ đã được xác định trong vài giây.


| Nhà cung cấp | Mô hình | Tính năng |
|---|---|---|
| Anthropic | Claude Sonnet / Opus | Văn bản, thị giác, tài liệu |
| OpenAI | GPT-4o | Văn bản, thị giác, tài liệu |
| Gemini Pro | Văn bản, thị giác | |
| Mistral / Groq / DeepSeek | Khác nhau | Văn bản |
Mô tả dự án của bạn bằng văn bản đơn giản và AI tạo ra 15-30 mục BOQ với số lượng và giá thị trường.
So sánh ước tính AI với cơ sở dữ liệu CWICR để thay thế các tỷ lệ ước lượng bằng giá thị trường thực.
Trò chuyện với AI về chi phí, vật liệu và giá cả bằng cách sử dụng cơ sở dữ liệu chi phí của bạn làm ngữ cảnh.

Lập kế hoạch thời gian dự án xây dựng của bạn và theo dõi chi phí theo thời gian với các công cụ lập lịch và mô hình tài chính tích hợp.
Mô-đun lập lịch cung cấp biểu đồ Gantt chuyên nghiệp để quản lý thời gian xây dựng của bạn. Tạo các hoạt động, đặt thời gian, xác định sự phụ thuộc, và hệ thống tự động tính toán đường đi quan trọng cho thấy các hoạt động nào không được trì hoãn.
Mô hình chi phí kết nối dữ liệu BOQ của bạn với thời gian dự án, cung cấp cho bạn cái nhìn theo thời gian về chi phí xây dựng với các chỉ số Quản lý Giá trị Đã kiếm được.
Quản lý quy trình mua sắm hoàn chỉnh từ việc tạo gói đấu thầu đến so sánh các đề xuất và trao hợp đồng cho các nhà thầu phụ.
Đi tới Mua sắm, chọn một dự án và nhấp vào "Tạo Gói". Chỉ định tên gói, mô tả phạm vi, thời hạn nộp hồ sơ và chọn các vị trí BOQ để bao gồm. Bạn có thể tạo nhiều gói cho mỗi dự án (ví dụ: công việc kết cấu, MEP, hoàn thiện).
Thêm đấu thầu từ các nhà thầu phụ với tên công ty, thông tin liên hệ và giá đã báo cho mỗi vị trí BOQ. Hệ thống hỗ trợ nhiều đấu thầu cho mỗi gói để so sánh cạnh tranh.
Gương giá hiển thị tất cả các đấu thầu trong bảng so sánh với tỷ lệ đơn vị và tổng số cho mỗi vị trí. Các chỉ báo trực quan làm nổi bật các đấu thầu thấp nhất và cao nhất. Xuất so sánh dưới dạng CSV để các bên liên quan xem xét.
Đánh dấu đấu thầu thắng cuộc bằng nút Trao hợp đồng và thêm ghi chú lý do. Trạng thái gói theo dõi qua: Dự thảo, Đã phát hành, Đang thu thập, Đánh giá, Đã trao, Đã đóng.
Xác định, đánh giá và quản lý rủi ro dự án bằng cách sử dụng ma trận xác suất-tác động. Định lượng mức độ rủi ro và lập kế hoạch chiến lược giảm thiểu cho từng rủi ro đã xác định.
Ma trận hiển thị tất cả các rủi ro trên lưới xác suất (0.1-0.9) so với tác động (thấp/trung bình/cao/quan trọng) với mã màu. Mỗi rủi ro hiển thị điểm số mức độ rủi ro đã tính toán (xác suất nhân với chi phí tác động).
Đối với mỗi rủi ro, tài liệu: mã duy nhất (R-001), tiêu đề, danh mục (kỹ thuật, tài chính, lịch trình, quy định, môi trường, an toàn), chiến lược giảm thiểu, kế hoạch dự phòng, chủ sở hữu rủi ro, tác động chi phí, và tác động lịch trình theo ngày. Theo dõi trạng thái qua: Đã xác định, Đã đánh giá, Đang giảm thiểu, Đã đóng, hoặc Đã xảy ra.
Theo dõi các thay đổi phạm vi và tác động của chúng đến chi phí và lịch trình dự án. Đơn thay đổi cung cấp một dấu vết kiểm toán cho tất cả các sửa đổi được thực hiện sau ước tính ban đầu.
Tạo một đơn thay đổi với mã (CO-001), tiêu đề, và danh mục lý do (yêu cầu của khách hàng, thay đổi thiết kế, điều kiện không lường trước, quy định). Thêm các mục dòng chỉ định các vị trí BOQ bị ảnh hưởng với số lượng/tỷ lệ ban đầu và mới. Hệ thống tự động tính toán sự thay đổi chi phí. Trạng thái di chuyển qua: Bản nháp, Đã gửi, Đang xem xét, Được phê duyệt/Bị từ chối.

Chạy các kiểm tra chất lượng tự động trên các BOQ của bạn để phát hiện lỗi trước khi chúng trở thành vấn đề. Công cụ xác thực áp dụng 42 quy tắc có thể cấu hình đối với dữ liệu ước tính của bạn.
Mỗi lần xác thực tạo ra một điểm số chất lượng (0-100%) với các phát hiện mã màu: Lỗi (đỏ, phải sửa), Cảnh báo (vàng, nên xem xét), Thông tin (xanh, gợi ý). Nhấp vào bất kỳ phát hiện nào để điều hướng trực tiếp đến vị trí BOQ bị ảnh hưởng.



Tạo tài liệu chuyên nghiệp từ dữ liệu dự án của bạn cho các bên liên quan, khách hàng, và tuân thủ quy định.

Tập trung tất cả tài liệu dự án. Tải lên bản vẽ, hợp đồng, đặc điểm kỹ thuật, và ảnh với phân loại tự động và tìm kiếm.


Xem hiệu suất ngân sách đa dự án. Bảng điều khiển tổng hợp dữ liệu tài chính trên tất cả các dự án để xác định xu hướng, biến động, và ngân sách có nguy cơ.
Quản lý tất cả các bên liên quan trong dự án trong một danh bạ tập trung. Theo dõi khách hàng, nhà thầu phụ, nhà cung cấp, kiến trúc sư và tư vấn viên với đầy đủ thông tin liên hệ, mối quan hệ công ty và phân loại theo vai trò. Liên kết các liên hệ với dự án, thầu, đơn đặt hàng và thư từ để đảm bảo tính truy xuất đầy đủ.
| Phương thức | Điểm cuối | Mô tả |
|---|---|---|
| GET | /api/v1/contacts/ | Danh sách tất cả các liên hệ |
| POST | /api/v1/contacts/ | Tạo liên hệ |
| GET | /api/v1/contacts/{id} | Lấy thông tin chi tiết liên hệ |
| PUT | /api/v1/contacts/{id} | Cập nhật liên hệ |
| POST | /api/v1/contacts/import | Nhập khẩu hàng loạt liên hệ |
Tổ chức công việc dự án với phân loại nhiệm vụ 5 loại và bảng Kanban trực quan. Nhiệm vụ có thể được giao cho các thành viên trong nhóm, liên kết với các vị trí BOQ cụ thể, tài liệu hoặc RFIs, và được theo dõi qua các giai đoạn quy trình tùy chỉnh. Mỗi loại nhiệm vụ có mã màu riêng và các trường mặc định.

| Phương thức | Điểm cuối | Mô tả |
|---|---|---|
| GET | /api/v1/tasks/ | Danh sách nhiệm vụ (có thể lọc theo dự án, người được giao, trạng thái) |
| POST | /api/v1/tasks/ | Tạo nhiệm vụ |
| PATCH | /api/v1/tasks/{id} | Cập nhật nhiệm vụ (trạng thái, người được giao, ưu tiên) |
| GET | /api/v1/tasks/board/{project_id} | Lấy dữ liệu bảng Kanban |
Theo dõi các yêu cầu thông tin chính thức giữa các bên trong dự án với phân công ball-in-court. RFIs đi qua một vòng đời có cấu trúc từ bản nháp đến đóng, đảm bảo mọi câu hỏi đều nhận được câu trả lời được tài liệu hóa. Theo dõi ball-in-court cho thấy ai hiện đang sở hữu hành động vào bất kỳ thời điểm nào.
| Phương thức | Điểm cuối | Mô tả |
|---|---|---|
| GET | /api/v1/rfis/ | Danh sách RFIs |
| POST | /api/v1/rfis/ | Tạo RFI |
| POST | /api/v1/rfis/{id}/respond | Gửi phản hồi |
| PATCH | /api/v1/rfis/{id}/status | Cập nhật trạng thái / ball-in-court |
Quản lý tài chính dự án toàn diện bao gồm hóa đơn, ngân sách, thanh toán và Quản lý Giá trị thu được (EVM). Theo dõi chi phí dự kiến so với thực tế, tạo ứng dụng thanh toán và giám sát tình trạng ngân sách với phân tích biến động theo thời gian thực. Tích hợp với dữ liệu BOQ để tự động tạo cơ sở chi phí.
| Phương thức | Điểm cuối | Mô tả |
|---|---|---|
| GET | /api/v1/finance/invoices/ | Danh sách hóa đơn |
| POST | /api/v1/finance/invoices/ | Tạo hóa đơn |
| GET | /api/v1/finance/budgets/ | Danh sách ngân sách |
| POST | /api/v1/finance/budgets/import | Nhập ngân sách từ Excel |
| GET | /api/v1/finance/evm/{project_id} | Lấy chỉ số EVM |
| GET | /api/v1/finance/payments/ | Danh sách thanh toán |
Quản lý đơn đặt hàng và biên nhận hàng hóa cho vật liệu và dịch vụ xây dựng. Tạo đơn đặt hàng liên kết với các vị trí trong BOQ, theo dõi tình trạng giao hàng và ghi nhận biên nhận hàng hóa với xác minh số lượng. Tích hợp với mô-đun Danh bạ để quản lý nhà cung cấp.
| Phương thức | Điểm cuối | Mô tả |
|---|---|---|
| GET | /api/v1/procurement/orders/ | Danh sách đơn đặt hàng |
| POST | /api/v1/procurement/orders/ | Tạo đơn đặt hàng |
| POST | /api/v1/procurement/orders/{id}/receive | Ghi nhận biên nhận hàng hóa |
| GET | /api/v1/procurement/receipts/ | Danh sách biên nhận hàng hóa |
Ghi nhận các sự cố an toàn, sự cố gần xảy ra và quan sát hành vi với hệ thống chấm điểm rủi ro. Theo dõi các chỉ số hiệu suất an toàn trên các dự án, xác định xu hướng và đảm bảo tuân thủ các quy định về sức khỏe và an toàn nghề nghiệp.
| Phương thức | Điểm cuối | Mô tả |
|---|---|---|
| GET | /api/v1/safety/incidents/ | Danh sách sự cố |
| POST | /api/v1/safety/incidents/ | Báo cáo sự cố |
| GET | /api/v1/safety/observations/ | Danh sách quan sát |
| POST | /api/v1/safety/observations/ | Ghi nhận quan sát |
| GET | /api/v1/safety/dashboard/{project_id} | Lấy KPI an toàn |
Quản lý biên bản cuộc họp với các chương trình nghị sự có cấu trúc và các mục hành động được theo dõi. Tạo chuỗi cuộc họp định kỳ (ví dụ: cuộc họp tại công trường hàng tuần), ghi lại người tham dự, ghi lại các điểm thảo luận và tự động tạo các mục hành động tích hợp với mô-đun Nhiệm vụ.
| Phương thức | Điểm cuối | Mô tả |
|---|---|---|
| GET | /api/v1/meetings/ | Danh sách cuộc họp |
| POST | /api/v1/meetings/ | Tạo cuộc họp |
| GET | /api/v1/meetings/{id}/minutes | Lấy biên bản cuộc họp |
| POST | /api/v1/meetings/{id}/actions | Thêm mục hành động |
Tiến hành kiểm tra chất lượng bằng cách sử dụng danh sách kiểm tra có thể cấu hình. Định nghĩa mẫu kiểm tra theo nghề hoặc loại hoạt động, điền chúng tại chỗ, đính kèm ảnh và theo dõi việc giải quyết các thiếu sót. Kết quả kiểm tra sẽ được đưa vào điểm chất lượng dự án và quy trình NCR.
| Phương thức | Điểm cuối | Mô tả |
|---|---|---|
| GET | /api/v1/inspections/ | Danh sách kiểm tra |
| POST | /api/v1/inspections/ | Tạo kiểm tra từ mẫu |
| GET | /api/v1/inspections/templates/ | Danh sách mẫu danh sách kiểm tra |
| PATCH | /api/v1/inspections/{id}/items | Cập nhật kết quả mục danh sách kiểm tra |
Tài liệu và theo dõi các sự không phù hợp về chất lượng khi công việc không đáp ứng được các thông số kỹ thuật. NCR tuân theo một vòng đời chính thức từ việc xác định đến phân tích nguyên nhân gốc rễ và xác minh hành động khắc phục, đảm bảo tất cả các sai lệch về chất lượng được giải quyết và tài liệu đúng cách.
| Phương thức | Điểm cuối | Mô tả |
|---|---|---|
| GET | /api/v1/ncr/ | Danh sách NCR |
| POST | /api/v1/ncr/ | Tạo NCR |
| PATCH | /api/v1/ncr/{id}/status | Cập nhật trạng thái NCR |
| POST | /api/v1/ncr/{id}/actions | Thêm hành động khắc phục |
Quản lý quy trình xem xét tài liệu gửi cho vật liệu xây dựng, bản vẽ cửa hàng và dữ liệu sản phẩm. Theo dõi quy trình xem xét nhiều giai đoạn, nơi tài liệu gửi phải qua nhiều người xem trước khi được phê duyệt cuối cùng. Duy trì một hồ sơ kiểm toán đầy đủ của tất cả các chu kỳ xem xét và lịch sử sửa đổi.
| Phương thức | Điểm cuối | Mô tả |
|---|---|---|
| GET | /api/v1/submittals/ | Danh sách tài liệu gửi |
| POST | /api/v1/submittals/ | Tạo tài liệu gửi |
| POST | /api/v1/submittals/{id}/review | Gửi quyết định xem xét |
| POST | /api/v1/submittals/{id}/revise | Tải lên phiên bản mới |
Duy trì một sổ đăng ký giao tiếp chính thức cho tất cả thư tín dự án. Theo dõi các bức thư, email, thông báo và hướng dẫn giữa các bên dự án với các số tham chiếu duy nhất, theo dõi phản hồi và tìm kiếm toàn văn. Đảm bảo rằng các giao tiếp hợp đồng được tài liệu và có thể truy nguyên đúng cách.
| Phương thức | Điểm cuối | Mô tả |
|---|---|---|
| GET | /api/v1/correspondence/ | Danh sách thư tín |
| POST | /api/v1/correspondence/ | Tạo mục thư tín |
| GET | /api/v1/correspondence/{id} | Lấy chi tiết với các tệp đính kèm |
| GET | /api/v1/correspondence/{id}/thread | Lấy chuỗi thư tín liên kết |
Một Môi Trường Dữ Liệu Chung phù hợp với quy trình ISO 19650 để quản lý thông tin dự án với các chuyển trạng thái được kiểm soát. Tài liệu di chuyển qua các trạng thái Đang Thực Hiện (WIP), Chia Sẻ, Đã Xuất Bản và Lưu Trữ với các cổng phê duyệt. Đảm bảo quản lý thông tin tuân theo các tiêu chuẩn BIM cho việc giao hàng hợp tác.
| Phương thức | Điểm cuối | Mô tả |
|---|---|---|
| GET | /api/v1/cde/documents/ | Danh sách tài liệu CDE (có thể lọc theo trạng thái, tính phù hợp) |
| POST | /api/v1/cde/documents/ | Tải tài liệu lên CDE |
| PATCH | /api/v1/cde/documents/{id}/status | Chuyển trạng thái tài liệu |
| GET | /api/v1/cde/documents/{id}/history | Lấy lịch sử sửa đổi |
Phân phối chính thức tài liệu cho các bên bên ngoài với việc theo dõi giao hàng và xác nhận. Tạo các gói chuyển phát chứa nhiều tài liệu, chỉ định người nhận và theo dõi xem mỗi người nhận đã nhận và xác nhận tài liệu hay chưa. Cung cấp một hồ sơ hợp đồng về việc trao đổi thông tin.
| Phương thức | Điểm cuối | Mô tả |
|---|---|---|
| GET | /api/v1/transmittals/ | Danh sách chuyển phát |
| POST | /api/v1/transmittals/ | Tạo chuyển phát |
| POST | /api/v1/transmittals/{id}/send | Gửi chuyển phát đến người nhận |
| PATCH | /api/v1/transmittals/{id}/acknowledge | Ghi nhận xác nhận của người nhận |
Trung tâm chính cho quản lý mô hình BIM với quyền truy cập dữ liệu theo cấp độ phần tử và liên kết trực tiếp với BOQ. Tải lên các mô hình IFC/RVT, duyệt các phần tử xây dựng với các thuộc tính và số lượng của chúng, và liên kết các phần tử với các vị trí BOQ để tích hợp chi phí 5D. Cung cấp cầu nối giữa dữ liệu thiết kế và ước lượng chi phí.
🎬 Demo liên kết hàng loạt BIM trên YouTube - 100 tường BIM → một dòng BOQ với diện tích, thể tích và chiều dài tổng hợp.
| Phương thức | Điểm cuối | Mô tả |
|---|---|---|
| GET | /api/v1/bim/models/ | Danh sách mô hình BIM |
| POST | /api/v1/bim/models/ | Tải mô hình BIM lên |
| GET | /api/v1/bim/models/{id}/elements | Danh sách các phần tử mô hình |
| POST | /api/v1/bim/elements/{id}/link-boq | Liên kết phần tử với vị trí BOQ |
Công cụ báo cáo toàn diện với bảng điều khiển KPI, mẫu báo cáo tùy chỉnh và tạo báo cáo theo lịch. Tập hợp dữ liệu từ các dự án để có cái nhìn tổng thể về danh mục. Tạo mẫu báo cáo tùy chỉnh kết hợp dữ liệu từ bất kỳ mô-đun nào (BOQ, Tài Chính, Lịch Trình, An Toàn, Chất Lượng).
| Phương thức | Điểm cuối | Mô tả |
|---|---|---|
| GET | /api/v1/reporting/kpi/{project_id} | Lấy KPI dự án |
| GET | /api/v1/reporting/templates/ | Danh sách mẫu báo cáo |
| POST | /api/v1/reporting/generate | Tạo báo cáo từ mẫu |
| GET | /api/v1/reporting/portfolio/ | Lấy dữ liệu bảng điều khiển danh mục |
Hệ thống thông báo trong ứng dụng giúp người dùng được thông báo về các sự kiện liên quan đến họ. Thông báo được kích hoạt bởi các hành động trên tất cả các mô-đun - phân công nhiệm vụ, phản hồi RFI, xem xét tài liệu, yêu cầu phê duyệt, các mục quá hạn, và nhiều hơn nữa. Người dùng kiểm soát sở thích thông báo của họ theo từng danh mục.
| Phương thức | Điểm cuối | Mô tả |
|---|---|---|
| GET | /api/v1/notifications/ | Danh sách thông báo (chưa đọc trước) |
| PATCH | /api/v1/notifications/{id}/read | Đánh dấu thông báo là đã đọc |
| POST | /api/v1/notifications/read-all | Đánh dấu tất cả là đã đọc |
| GET | /api/v1/notifications/preferences | Lấy sở thích thông báo |
Biểu đồ Gantt dựa trên SVG thuần cho việc trực quan hóa lịch trình xây dựng. Hiển thị các mốc thời gian, sự phụ thuộc, các cột mốc, và đường đi quan trọng trực tiếp trong trình duyệt mà không cần thư viện bên ngoài. Hỗ trợ phóng to từ chế độ xem theo ngày đến chế độ xem theo năm và xuất sang PDF/PNG cho báo cáo.
| Phương thức | Điểm cuối | Mô tả |
|---|---|---|
| GET | /api/v1/schedule/gantt/{project_id} | Lấy dữ liệu biểu đồ Gantt (các hoạt động, sự phụ thuộc) |
| PATCH | /api/v1/schedule/activities/{id} | Cập nhật ngày/thời gian tiến độ hoạt động |
| POST | /api/v1/schedule/dependencies/ | Tạo sự phụ thuộc |
Cấu hình múi giờ, tiền tệ, định dạng số, và sở thích định dạng ngày theo từng người dùng và từng dự án. Cài đặt khu vực được phân cấp từ mặc định hệ thống đến ghi đè cấp dự án đến sở thích cấp người dùng, đảm bảo mỗi thành viên trong nhóm thấy dữ liệu được định dạng theo địa phương của họ.
| Phương thức | Điểm cuối | Mô tả |
|---|---|---|
| GET | /api/v1/settings/regional/ | Lấy cài đặt khu vực hiện tại |
| PUT | /api/v1/settings/regional/ | Cập nhật cài đặt khu vực |
| GET | /api/v1/settings/regional/timezones | Danh sách các múi giờ có sẵn |
| GET | /api/v1/settings/regional/currencies | Danh sách các loại tiền tệ được hỗ trợ |
Kích hoạt hoặc vô hiệu hóa các mô-đun nền tảng để tùy chỉnh OpenConstructionERP cho quy trình làm việc của bạn. Mỗi mô-đun có thể được bật hoặc tắt độc lập mà không ảnh hưởng đến các mô-đun khác. Các mô-đun bị vô hiệu hóa sẽ bị ẩn khỏi giao diện người dùng, các điểm cuối API của chúng trả về 404, và các bảng cơ sở dữ liệu của chúng vẫn nguyên vẹn để có thể kích hoạt lại.
| Phương thức | Điểm cuối | Mô tả |
|---|---|---|
| GET | /api/v1/modules/ | Danh sách tất cả các mô-đun với trạng thái |
| PATCH | /api/v1/modules/{name}/toggle | Bật hoặc tắt một mô-đun |
| GET | /api/v1/modules/{name}/dependencies | Kiểm tra các phụ thuộc của mô-đun |
Các gói khu vực được cấu hình sẵn thiết lập tiêu chuẩn phân loại, quy tắc thuế, mặc định cơ sở dữ liệu chi phí, mẫu báo cáo và quy tắc tuân thủ quy định cho các thị trường cụ thể. Cài đặt một gói khu vực để ngay lập tức cấu hình nền tảng cho quốc gia hoặc khu vực của bạn.
| Gói | Khu vực | Tiêu chuẩn | Tiền tệ |
|---|---|---|---|
| US | Hoa Kỳ | MasterFormat, UniFormat, CSI | USD |
| DACH | Đức, Áo, Thụy Sĩ | DIN 276, GAEB, VOB, HOAI | EUR/CHF |
| UK | Vương quốc Anh | NRM 1/2, RICS, JCT | GBP |
| Russia | Nga, CIS | GESN, FER, TER, SNIP | RUB |
| Trung Đông | UAE, Ả Rập Saudi, Qatar | RICS, CESMM, FIDIC | AED/SAR/QAR |
| Asia-Pacific | Trung Quốc, Nhật Bản, Úc | GB/T, AS 4000, JASS | CNY/AUD/JPY |
| India | Ấn Độ | CPWD, IS standards, DSR | INR |
| LatAm | Brazil, Mexico, Colombia | SINAPI, CMIC, local norms | BRL/MXN/COP |
| Phương thức | Điểm cuối | Mô tả |
|---|---|---|
| GET | /api/v1/regional-packs/ | Danh sách các gói khu vực có sẵn |
| POST | /api/v1/regional-packs/{name}/install | Cài đặt gói khu vực |
| GET | /api/v1/regional-packs/{name}/details | Lấy nội dung và cấu hình gói |
Khả năng nhập và xuất dữ liệu toàn diện trên tất cả các mô-đun. Nhập danh bạ, ngân sách, BOQ và cơ sở dữ liệu chi phí từ các tệp Excel và CSV với ánh xạ cột thông minh. Xuất dữ liệu dự án sang Excel, PDF và CSV với các mẫu tùy chỉnh. Tất cả các xuất khẩu đều giữ nguyên định dạng và bao gồm tiêu đề siêu dữ liệu.
| Phương thức | Điểm cuối | Mô tả |
|---|---|---|
| POST | /api/v1/import/contacts | Nhập danh bạ từ tệp |
| POST | /api/v1/import/budget | Nhập ngân sách từ Excel |
| POST | /api/v1/export/boq/{id} | Xuất BOQ (định dạng: excel, pdf, gaeb, csv) |
| POST | /api/v1/export/report | Tạo và xuất báo cáo |



| Biến | Mặc định | Mô tả |
|---|---|---|
DATABASE_URL | (chưa đặt = PostgreSQL tích hợp) | Cơ sở dữ liệu (mặc định là PostgreSQL tích hợp; đặt giá trị để dùng PostgreSQL bên ngoài). Để trống để dùng PostgreSQL tích hợp, hoặc đặt thành một cơ sở dữ liệu bên ngoài, ví dụ postgresql+asyncpg://oe:oe@localhost:5432/openestimate. |
JWT_SECRET | dev-key | Mật khẩu JWT (thay đổi trong môi trường sản xuất!) |
SEED_DEMO | true | Tạo tài khoản demo |
VECTOR_BACKEND | lancedb | Backend tìm kiếm vector |
OpenConstructionERP cung cấp một API REST toàn diện hỗ trợ frontend và có thể được sử dụng cho tích hợp, tự động hóa, và quy trình làm việc tùy chỉnh. Mọi hành động có sẵn trong giao diện người dùng - tạo dự án, chỉnh sửa BOQs, chạy ước lượng AI, tìm kiếm chi phí - đều có sẵn dưới dạng điểm cuối API. Tài liệu Swagger tương tác với các nút thử nghiệm có sẵn tại /api/docs khi chạy backend.
| Phương thức | Điểm cuối | Mô tả |
|---|---|---|
| POST | /api/v1/users/auth/login | Đăng nhập |
| GET | /api/v1/projects/ | Danh sách dự án |
| GET | /api/v1/boq/boqs/?project_id=... | Danh sách BOQ |
| GET | /api/v1/costs/?q=concrete | Tìm kiếm chi phí |
| POST | /api/v1/ai/quick-estimate | Ước lượng AI |
| POST | /api/v1/takeoff/cad-extract | Trích xuất CAD |
| GET | /api/health | Kiểm tra sức khỏe |
| Module | Tiền tố | Mô tả |
|---|---|---|
| Contacts | /api/v1/contacts/ | Danh bạ liên hệ CRUD, nhập khẩu |
| Tasks | /api/v1/tasks/ | Quản lý tác vụ, bảng Kanban |
| RFI | /api/v1/rfis/ | Yêu cầu thông tin |
| Finance | /api/v1/finance/ | Hóa đơn, ngân sách, thanh toán, EVM |
| Procurement | /api/v1/procurement/ | Đơn đặt hàng, biên nhận hàng hóa |
| Safety | /api/v1/safety/ | Sự cố, quan sát, đánh giá rủi ro |
| Meetings | /api/v1/meetings/ | Biên bản, chương trình nghị sự, mục hành động |
| Inspections | /api/v1/inspections/ | Kiểm tra chất lượng, danh sách kiểm tra |
| NCR | /api/v1/ncr/ | Báo cáo không phù hợp |
| Submittals | /api/v1/submittals/ | Xem xét nộp đa giai đoạn |
| Correspondence | /api/v1/correspondence/ | Sổ đăng ký giao tiếp |
| CDE | /api/v1/cde/ | Môi trường tài liệu ISO 19650 |
| Transmittals | /api/v1/transmittals/ | Phân phối tài liệu |
| BIM Hub | /api/v1/bim/ | Mô hình BIM, phần tử, liên kết BOQ |
| Reporting | /api/v1/reporting/ | Bảng điều khiển KPI, mẫu báo cáo |
| Notifications | /api/v1/notifications/ | Hệ thống thông báo trong ứng dụng |
| Comments | /api/v1/comments/ | Bình luận theo chuỗi trên bất kỳ thực thể nào |
| Gantt | /api/v1/schedule/gantt/ | Hình ảnh hóa lịch trình SVG |
| Regional | /api/v1/settings/regional/ | Tùy chọn múi giờ, tiền tệ, định dạng |
| Modules | /api/v1/modules/ | Bật/tắt các mô-đun |
| Regional Packs | /api/v1/regional-packs/ | Cài đặt cấu hình khu vực |
| Import/Export | /api/v1/import/ / /api/v1/export/ | Nhập và xuất dữ liệu hàng loạt |
Xem từng phần mô-đun ở trên để biết tài liệu điểm cuối chi tiết với các tham số và mô tả.
Phân tích dự án dựa trên AI đánh giá dự án của bạn trên 9 lĩnh vực trọng số và tạo ra điểm hoàn thành từ 0 đến 100 (điểm A đến F).
API: GET /api/v1/project_intelligence/score/?project_id=X - trả về điểm tổng thể, điểm miền, khoảng trống quan trọng và thành tựu.
Quản lý thành viên trong nhóm, vai trò và kiểm soát truy cập theo mô-đun.
Quản trị viên có thể cấu hình mức độ hiển thị và quyền truy cập mô-đun theo từng người dùng (Không, Xem, Chỉnh sửa, Toàn bộ) qua trang /users. Có thể gán tên vai trò tùy chỉnh (ví dụ: "Kỹ sư công trường", "Quản lý chi phí").
Đánh dấu kho lưu trữ để giúp người khác khám phá dự án.
Đăng ký để xem các hướng dẫn và bài học về phát hành. Bắt đầu với hướng dẫn sản phẩm 12 phút.
Mở một vấn đề trên GitHub.
Tham gia cộng đồng Telegram để đặt câu hỏi.
Liên hệ với chúng tôi để được hỗ trợ triển khai và đào tạo.
Giấy phép: AGPL-3.0. Giấy phép thương mại: info@datadrivenconstruction.io
OpenConstructionERP
Được xây dựng bởi đội ngũ DataDrivenConstruction
2026 Xây dựng Dữ liệu Được điều khiển. AGPL-3.0
Bình luận
Hệ thống bình luận theo chuỗi có thể được đính kèm vào bất kỳ thực thể nào trong nền tảng - vị trí BOQ, nhiệm vụ, RFI, tài liệu, kiểm tra, và nhiều hơn nữa. Hỗ trợ @đề cập để thông báo cho các thành viên trong nhóm, đính kèm tệp, và theo dõi giải quyết cho các cuộc thảo luận hướng đến hành động.
Các Tính Năng Chính
API Endpoints
/api/v1/comments/?entity_type=task&entity_id=.../api/v1/comments//api/v1/comments/{id}/reply/api/v1/comments/{id}/resolve