How hardlaz/openconstructionerp works
OpenConstructionERP is a modular construction-project workspace spanning estimating, BIM takeoff, scheduling/cost control, tendering, coordination, and reporting. A visible match-elements workflow lets an estimator run and adjust seven stages; its backend orchestrates matching against BIM and cost data. The graph also includes documented major product areas and a platform layer. Some capability nodes are supported by the README and tree but their implementation was not sampled, so their internal links are omitted; edges cite only shown source references or README statements.
Main entry points: match_elements/service.py Match service · pipeline.py Match stages · models.py Match records · boq/service.py Bill of quantities
Components 31
Estimating and BIM
- Match workflow
frontend/src/features/match-elements/MatchPipeline.tsx - Match API
frontend/src/features/match-elements/api.ts - Match stages
backend/app/modules/match_elements/pipeline.py - Match service
backend/app/modules/match_elements/service.py - Match records
backend/app/modules/match_elements/models.py - Match configuration
backend/app/core/match_service/config.py - Match envelope
backend/app/core/match_service/envelope.py - Vector ranker
backend/app/core/match_service/ranker_qdrant.py - Bill of quantities
backend/app/modules/boq/service.py - BIM hub
backend/app/modules/bim_hub/service.py - BIM records
backend/app/modules/bim_hub/models.py - Cost catalog
backend/app/modules/catalog/service.py
Project delivery
- Schedule and CPM
backend/app/modules/schedule_advanced/cpm.py - Schedule risk
backend/app/modules/schedule_advanced/schedule_risk_engine.py - Resource planning
backend/app/modules/resources/resource_engine.py - Tender management
backend/app/modules/bid_management/service.py - Requirements and quality
backend/app/modules/bim_requirements/service.py - Property development
backend/app/modules/property_dev/tax_engine.py
Coordination and insight
- Clash coordination
backend/app/modules/clash/service.py - Geo hub
backend/app/modules/geo_hub/tile_pipeline.py - BI dashboards
backend/app/modules/bi_dashboards/service.py
Platform services
- Application config
backend/app/config.py - Database
backend/app/database.py - Blob storage
backend/app/core/storage.py - Localization
backend/app/core/i18n.py - User repository
backend/app/modules/users/repository.py - Project records
backend/app/modules/projects/models.py
Pipeline automation
- Pipeline builder
frontend/src/features/pipelines/canvas/PipelineNode.tsx - Canvas state
frontend/src/features/pipelines/usePipelineStore.ts - Pipeline API
frontend/src/features/pipelines/api.ts
Other components
- Estimator
Connections 33
- Estimator → Match workflow: runs and adjusts
README.md - Match workflow → Match API: requests stages
frontend/src/features/match-elements/MatchPipeline.tsx - Match API → Match stages: calls stages
- Match stages → Match service: runs matching
backend/app/modules/match_elements/pipeline.py - Match stages → Match records: reads and writes
backend/app/modules/match_elements/pipeline.py - Match service → Match records: reads and writes
backend/app/modules/match_elements/service.py - Match service → Match configuration: uses settings
backend/app/modules/match_elements/service.py - Match service → Match envelope: uses envelope
backend/app/modules/match_elements/service.py - Match service → Vector ranker: ranks candidates
backend/app/modules/match_elements/service.py - Match stages → BIM records: reads models
backend/app/modules/match_elements/pipeline.py - Match service → Bill of quantities: matches quantities
backend/app/modules/match_elements/service.py - Bill of quantities → Cost catalog: uses cost data
- BIM hub → BIM records: persists BIM data
backend/app/modules/bim_hub/models.py - Estimator → Bill of quantities: creates estimates
README.md - Estimator → BIM hub: imports takeoff
README.md - Schedule risk → Schedule and CPM: uses CPM
backend/app/modules/schedule_advanced/schedule_risk_engine.py - Resource planning → Schedule and CPM: uses CPM
backend/app/modules/resources/resource_engine.py - Estimator → Schedule and CPM: plans work
README.md - Estimator → Tender management: manages tenders
README.md - Estimator → Requirements and quality: checks requirements
README.md - Estimator → Property development: models development
README.md - Estimator → Clash coordination: reviews clashes
README.md - Estimator → Geo hub: views project geography
README.md - Estimator → BI dashboards: reviews reports
README.md - Pipeline builder → Canvas state: reads canvas state
frontend/src/features/pipelines/canvas/PipelineNode.tsx - Canvas state → Pipeline API: uses API
frontend/src/features/pipelines/usePipelineStore.ts - Match records → Database: uses database models
backend/app/modules/match_elements/models.py - BIM records → Database: uses database models
backend/app/modules/bim_hub/models.py - Blob storage → Application config: loads configuration
backend/app/core/storage.py - Geo hub → Blob storage: writes tile artifacts
backend/app/modules/geo_hub/tile_pipeline.py - Match service → Localization: localizes messages
backend/app/modules/match_elements/service.py - Match service → Project records: uses project context
backend/app/modules/match_elements/service.py - Estimator → User repository: authenticates