用途:本技能是 OpenConstructionERP 的平台总览指南,用于在开始任何 OpenConstructionERP 相关工作或引导用户入门时,快速了解其架构、模块划分、API 接口与启动方式。
主要能力:OpenConstructionERP 是 DataDrivenConstruction 出品的自托管开源(AGPL-3.0)建筑 ERP,集成 BOQ 管理、CAD/BIM 算量(RVT/IFC/DWG/DGN)、4D 进度、5D 成本建模、招标、现场管理及 180+ 模块。技术栈为内嵌 PostgreSQL(无需 Docker)、FastAPI 后端与 Vite/React 前端。
模块与接口:成本库用 costs(GET /api/v1/costs/base-catalog、POST /api/v1/costs/load-cwicr/{db_id});资源目录用 catalog;工程量清单用 boq(POST /api/v1/boqs,支持 GAEB 校验/导入);BIM 用 bim;进度与成本用 scheduling;质量用 punch_list、validation;现场用 daily_diary、hse;文档/任务/风险用 documents、tasks、risks;另有 geo_hub、property_dev。
使用方式:开发启动命令为 cd backend && python -m uvicorn app.main:create_app --factory --reload --port 8000 与 cd frontend && npm run dev。认证采用首个注册用户为引导管理员、JWT 令牌与角色权限(viewer/editor/manager/admin),接口为 POST /auth/register、POST /auth/login。
数据契约:CWICR 工项 parquet 遵循 95 列主模式;区域 id 匹配 ^[A-Z]{2,3}_[A-Z0-9]+$;导入器对 (code, region) 幂等。
最佳实践与限制:先加载基础库再切换语言、再按市场重新定价;不要臆造价格,未定价系数库保持 rate 0;用 GET /api/v1/costs/regions/stats/ 校验导入。官网 https://openconstructionerp.com,仓库 https://github.com/datadrivenconstruction/OpenConstructionERP,文档 https://openconstructionerp.com/docs。