Skip to content
cccskills
FreePublished on GitHub

oce-platform-overview

Guide to OpenConstructionERP: architecture, modules, API surface and quick start. Use when starting any OpenConstructionERP work, onboarding a user to the platform, or deciding which module/endpoint to use.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md3.0 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

OpenConstructionERP Platform Overview

What it is

OpenConstructionERP is a self-hosted, open-source (AGPL-3.0) construction ERP by DataDrivenConstruction: BOQ management, CAD/BIM takeoff (RVT/IFC/DWG/DGN), 4D scheduling, 5D cost modelling, tendering, field management and 180+ modules in one platform. It runs embedded PostgreSQL (no Docker required) with a FastAPI backend and a Vite/React frontend.

Homepage: https://openconstructionerp.com · Repo: https://github.com/datadrivenconstruction/OpenConstructionERP · Docs: https://openconstructionerp.com/docs

Module map (what to use when)

NeedModuleKey endpoints
Browse/load cost databasescostsGET /api/v1/costs/base-catalog, POST /api/v1/costs/load-cwicr/{db_id}, GET /api/v1/costs/?region=...&q=...
Resource catalogscatalogPOST /api/v1/catalog/import/{region}, GET /api/v1/catalog/...
Bill of quantitiesboqPOST /api/v1/boqs, GET /api/v1/boqs/{id}, validate/import GAEB
BIM elements / takeoffbimupload RVT/IFC/DWG/DGN, link elements to BOQ lines
Schedule (4D) / cost (5D)schedulingtasks, dependencies, cost model roll-ups
Issues & qualitypunch_list, validationpunch items, validation rule packs (DIN276/NRM/GAEB)
Site daily opsdaily_diary, hsediary entries, safety observations
Docs / tasks / risksdocuments, tasks, risksfile approvals, task board, risk register
Portfolio mapgeo_hubprojects on a 3D globe
Property developmentproperty_devlead → SPA → handover

Quick start (dev)

cd backend && python -m uvicorn app.main:create_app --factory --reload --port 8000
cd frontend && npm run dev   # http://localhost:5173

Auth: bootstrap admin (first registered user), JWT tokens, role-based permissions (viewer/editor/manager/admin). POST /auth/register, POST /auth/login.

Data contracts to respect

  • CWICR work-item parquets follow the 95-column master schema (rate_code, rate_original_name, rate_final_name, rate_unit, total_cost_per_position, classification collection/department/section/subsection/category, resource lines resource_*, flags is_material/is_machine/is_labor).
  • Region ids match ^[A-Z]{2,3}_[A-Z0-9]+$ (e.g. TR_NATIONAL, ZH_CHINA, BR_NATIONAL).
  • The importer is idempotent on (code, region) — re-loading returns already_loaded.

Best practices

  1. Load the base first (load-cwicr), then swap language (automatic via home_language_code), then reprice markets via the catalog path.
  2. Never invent prices: leave unpriced coefficient bases (VN, ID) as rate 0 and use the resource price sheet.
  3. Verify an import with GET /api/v1/costs/regions/stats/ and a sampled item's rate against the parquet's total_cost_per_position.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Create 4D construction simulations by linking BIM elements to project schedules. Generate time-based visualizations, sequence analysis, and construction phasing with Gantt integration.

The English summary is being prepared. Showing the original description.

datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction359Updated Oct 20, 2026

Analyze 5000+ IFC and Revit projects at scale for patterns, benchmarks, and insights. Big data analysis for construction.

The English summary is being prepared. Showing the original description.

datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction359Updated Oct 20, 2026

Check construction AI systems against the EU AI Act (Regulation 2024/1689): classify risk of estimation, scheduling, CV and agent tools, document transparency, keep human oversight. Use when deploying or auditing AI in construction.

The English summary is being prepared. Showing the original description.

datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction359Updated Oct 20, 2026

Orchestrate multiple AI agents for construction workflows: estimator, scheduler, document, QA and safety agents coordinated by a supervisor agent, with human checkpoints. Use when automating end-to-end project processes with agentic AI.

The English summary is being prepared. Showing the original description.

datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction359Updated Oct 20, 2026

Create Apache Airflow DAGs for construction data pipelines. Orchestrate ETL, validation, and reporting workflows.

The English summary is being prepared. Showing the original description.

datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction359Updated Oct 20, 2026

Automate as-built documentation and digital handover for construction. Compile project records, generate O&M manuals, create asset databases, and ensure complete project closeout.

The English summary is being prepared. Showing the original description.

datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction359Updated Oct 20, 2026

See all skills by datadrivenconstruction

Report a problem with this skill