v18.5.0 开源

文档

使用 OpenConstructionERP 进行专业建筑成本估算所需的安装、配置和使用全部指南。

在 YouTube 上观看 12 分钟的功能演示

12 分钟 · 含背景音乐

完整产品演示

入门引导 → 新建项目 → BOQ → BIM 关联 → DWG → PDF 工程量提取 → 完整估算 → 任务 → 数据浏览器 → AI 估算 → 项目组合。

上方播放器内置了字幕、章节和 1.5 倍速播放功能。更愿意直接在 YouTube 上观看?▶ 在 YouTube 上打开 · 订阅频道以获取新版本的功能演示。

实际操作演示

下方每个区块都是从上面完整演示中剪辑出的简短 GIF,顺序与视频一致,因此您可以直接跳转到最关心的工作流。想要连续观看完整流程?▶ 在 YouTube 上观看 12 分钟的功能演示。

基于角色的引导

1 · 基于角色的入门引导

以 Admin / 估价师 / 经理身份登录，向导会为您的角色从 190 多个模块中预选合适的 17 个。

全球化新建项目

2 · 新建项目，覆盖任意区域

选择货币、分类标准、区域系数 - 实时地图和天气一并免费奉上。

BOQ 编辑器

3 · 编制工程量清单

键盘优先的编辑器，12 万多条带价条目，AI 成本查找与智能 AI - 质量评分实时更新。

BIM 批量关联

4 · BIM → BOQ 批量关联

将 100 面 BIM 墙体关联到一条 BOQ 明细，自动汇总面积 / 体积 / 长度。

DWG 图层

5 · DWG 图纸与图层

分布在 10 个 DWG 图层上的 636 个墙体实体 - 每一个都可关联到 BOQ，就地测量。

PDF 算量

6 · PDF 工程量提取

拖入平面图，测量距离 / 面积 / 数量，将数字直接推送到 BOQ。

完整估算

7 · 完整估算 - 626 万美元

真实 BIM 项目 → 215 个条目、88 个分项，按 CWICR 计价，质量评分 99。

BIM 关联任务

8 · 每个模块 - BIM 关联任务

问题与精确的模型构件绑定，在看板上与进度、文档和需求一同跟踪。

数据浏览器透视表

9 · 数据浏览器 - 透视 → BOQ

CAD-BIM 浏览器透视表一键变为 10 条 BOQ 条目 - 包含图表、数据条和下钻分析。

AI 照片转估算

10 · 从照片生成 AI 估算

上传一张施工照片 → GPT-4o + YOLO 在数秒内返回带范围的 BOQ，并附置信度评分。

项目仪表盘

11 · 全球项目组合看板

7 个项目、4 大洲、2830 万美元的进行中估算 - 一个工作区，一张地图。

即时搜索

附赠 · 即时搜索

按关键词、单位或分类，在 40 多个地区的 12 万多个成本条目中找到任何一条。

目录

  1. 平台概览
  2. 安装指南
  3. BOQ 编辑器
  4. 成本数据库
  5. CAD/BIM 与 PDF 工程量提取
  6. AI 估算
  7. 4D 进度与 5D 成本模型
  8. 联系人目录
  9. 任务
  10. RFI
  11. 财务
  12. 采购
  13. 安全
  14. 会议
  15. 检查
  16. 不符合项报告
  17. 报批文件
  18. 往来函件
  19. 通用数据环境
  20. 文件传递单
  21. BIM 中心
  22. 报表与 KPI 看板
  23. 通知
  24. 评论
  25. 甘特图
  26. 区域设置
  27. 模块系统
  28. 区域包
  29. 导入/导出
  30. 配置
  31. API 参考
  32. 支持

平台概览

OpenConstructionERP 是一套完整的建筑成本估算与项目管理平台，完全运行在你自己的机器上。它以开放、自托管的方案替代昂贵的商业估算套件。平台覆盖整个建筑生命周期 - 从初步可行性研究和工程量提取，到详细的 BOQ 编制、招投标、报价比选、项目执行、质量管理和财务控制。你的所有数据都保留在自己的服务器上。无需依赖云端，无订阅费，无按席位收费。

v18.5.0 亮点：190 多个模块覆盖建设全生命周期：联系人目录、带 Kanban 的任务、RFI 跟踪、财务（发票、预算、EVM）、采购、安全、会议、质量检查、NCR、submittals、往来函件、CDE（ISO 19650）、transmittals、BIM Hub、支持 COBie 导出的资产登记、报表 & KPI 仪表盘、markups（PDF↔DWG↔hub）、透视可视化 & 图表列选择器、可插拔的邮件服务、多租户联系人、定时报表、Regional Packs，以及完整的导入/导出。

仪表盘
仪表盘，包含项目 KPI、快速入门步骤、近期项目和系统状态面板
完整工作流讲解
端到端演示，照片 → AI 估算 → BOQ → BIM/DWG/PDF 工程量计算 → 任务 → 报表，一气呵成

BOQ 管理

分层级的工程量清单，包含分项、条目、资源、组合以及自动加价。

12 万多条成本条目

来自 9 个国家级来源的成本库，以本地货币和语言发布为 48 个市场版本，另有 36 个区域数据库可供导入。

AI 估算

使用任意 LLM 提供商，从文本、照片、PDF、Excel 或 CAD/BIM 模型生成 BOQ。

CAD/BIM 工程量提取

通过 DDC 转换器从 RVT、IFC、DWG、DGN 中提取工程量。

4D/5D 计划编排

含关键路径法（CPM）的甘特进度、挣值管理（EVM）、S 曲线、蒙特卡洛模拟。

190 多个模块

财务、安全、质量、CDE、BIM 中心、采购、RFI、任务、会议等等。按需启用。

安装后的第一步

安装 OpenConstructionERP 后，按以下步骤建立你的第一个项目并创建第一份成本估算。整个过程约需 10 分钟。

第 1 步：登录

打开浏览器并访问 http://localhost:5173(本地开发)或 http://localhost:8080(Docker)。您将看到带有「演示访问」面板的登录页面。点击 管理员 即可立即使用演示账户登录,或者输入您自己的凭据(如果您已注册新账户)。

第 2 步：完成入门引导

首次登录时，入门引导向导会带你完成初始设置：

  1. 选择您的语言 - 从 44 种可用语言中选择。整个 UI 会立即切换。
  2. 选择您的地区 - 这决定了默认使用哪个成本数据库和分类标准(例如德国使用 DIN 276,英国使用 NRM,美国使用 MasterFormat)。
  3. 配置 AI(可选) - 如果您想使用 AI 估算功能,请输入任一受支持提供商(Anthropic、OpenAI、Gemini 等)的 API 密钥。您可以跳过此步骤,稍后在设置中添加。
  4. 加载成本数据库 - 系统会提示为您所选地区下载并导入 CWICR 成本数据库(55,719 项)。这大约需要 30 秒。

第 3 步：创建第一个项目

在仪表板上点击 新建项目,或导航至「项目」。填写:

创建项目后，你会被跳转到项目详情页，可在此开始添加 BOQ。

第 4 步：创建第一份 BOQ

在项目页面中,点击 新建估算。为其命名(例如「成本估算 v1」),并可选择一个模板。BOQ 编辑器会打开一个空白网格,准备录入您的第一条项。

第 5 步：添加条目

在 BOQ 编辑器中,点击 添加项 或在空行上按 Enter 键。填写:

合计 列会自动计算(数量 x 单价)。您也可以点击任意项旁边的数据库图标,从 120,000 多个 CWICR 项中搜索并应用单价。

安装指南

无论您的技术背景如何,OpenConstructionERP 都设计得易于安装。选择与您的环境相匹配的方法,所有选项都不到 5 分钟即可完成。应用默认使用内置的 PostgreSQL（无需 Docker，无需单独的数据库服务器，无需任何设置），因此开箱即用。pip 和一行命令方式 需要 Python 3.12+。

方案 A：pip（推荐 - 一条命令）

pip install --upgrade openconstructionerp
openconstructionerp

将后端 + 预构建的 React 前端安装在一个 wheel 包中。在 http://localhost:8080 打开完整 UI。内置 PostgreSQL,零配置。如有任何异常,请运行 openconstructionerp doctor。

Linux / Ubuntu 用户 - 请阅读此处

在 Ubuntu 23.04+(包括 Ubuntu 26)和 Debian 12+ 上,直接对系统 Python 执行 pip install 会因 error: externally-managed-environment(PEP 668)而失败。请改用虚拟环境:

# 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
openconstructionerp

如果 pip 回退到源码构建,请安装头文件:sudo apt install -y build-essential libpq-dev libjpeg-dev zlib1g-dev libgeos-dev。完整的 Linux 指南及故障排除:docs/INSTALL_LINUX.md。

方案 B：一行命令安装（自动检测 Docker / uv / pip）

# 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 | iex

如已安装 Docker 则选用 Docker,否则用 uv,再否则用 pip。运行在 http://localhost:8080。

方案 C：Docker

git clone https://github.com/datadrivenconstruction/OpenConstructionERP.git
cd OpenConstructionERP
make quickstart

在 http://localhost:8080 打开(首次构建约 2 分钟)。

方案 D：本地开发（clone + npm + uvicorn）

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 dev

后端:http://localhost:8000 / 前端:http://localhost:5173

演示账号

账号邮箱密码角色
Admindemo@openconstructionerp.comDemoPass1234!完全访问
Estimatorestimator@openconstructionerp.comDemoPass1234!估算员
Managermanager@openconstructionerp.comDemoPass1234!经理

5 个演示项目（柏林、伦敦、纽约、巴黎、迪拜），含完整的 BOQ、进度和成本模型。

BOQ 编辑器

工程量清单编辑器是你花费时间最多的地方。它由 AG Grid 驱动，提供专业的类电子表格界面，并内置建筑专用功能 - 分层级分项、资源关联、组合配方以及自动加价计算。每一处改动都受到完整的撤销/重做支持的跟踪。42 条校验规则在后台自动运行，在缺少工程量、零价格、重复条目和分类合规问题成为隐患之前将其捕获。

🎬 在 YouTube 上观看 BOQ 编辑器的实际操作 - 键盘优先编辑、120K+ 已定价项、实时质量评分。

BOQ 编辑器
工程量清单概览，展示 5 个项目下的 11 份估算，统计数据：424 个条目，总价值 2.326 亿
快速构建 BOQ
键盘优先的 BOQ 构建，Tab 键在单元格间切换、从 120K+ 已定价项自动补全、实时质量评分、每步可撤销/重做
BOQ 编辑器实操
章节&项管理，拖放式层级、内联编辑、AI 成本查找器、区域单价切换

使用分项

分项将你的 BOQ 组织成逻辑分组（例如「300 结构」「400 暖通空调」）。创建分项：

  1. 点击工具栏中的 添加章节
  2. 输入分项名称及可选的 DIN 276/NRM 分类编码
  3. 在分项标题之后添加的所有条目都归属于该分项
  4. 每个分项在底部显示自己的小计

你可以折叠/展开分项以专注于特定专业工种。拖动分项即可重新排列整个 BOQ 结构。

关联资源

每条 BOQ 条目都可以关联资源，将单价细分为各个组成部分：

添加资源：展开某条目行，点击「添加资源」，搜索目录，设置数量系数（例如每立方米混凝土 120 公斤钢筋）。条目单价会根据其资源之和自动更新。

配置加价

加价在净总额（所有条目之和）之后应用。常见的加价包括：

点击工具栏中的 添加加价。您可以设置区域默认值或按项目自定义。加价可以基于百分比或固定金额,并按顺序复合计算(先管理费,然后在含管理费金额上计利润,再在合计上计增值税)。

运行校验

按 Ctrl+Shift+V 或点击工具栏中的盾牌图标即可运行校验。系统会根据所选规则集检查您的 BOQ,并内联显示结果:

导入数据

BOQ 编辑器支持从多种来源导入：

键盘快捷键

快捷键操作
Ctrl+K命令面板
Ctrl+N新建项目
Ctrl+Shift+V运行校验
Ctrl+Z / Y撤销 / 重做

成本数据库

访问全球最大的开源建设成本数据库：40 多个地区的 12 万多个成本条目。全球 CWICR 数据库提供 55,000 多个条目，描述最多支持 9 种语言，按专业组织（土方、混凝土、砌筑、钢结构、屋面、幕墙、暖通、电气、给排水、装修、景观）。每个条目包含计量单位、指定地区的基础单价、分类代码（DIN 276、NRM、MasterFormat），并在可用时提供材料、人工和机械的构成明细。

成本数据库
成本数据库，选中德国/DACH，显示 55,719 条条目，含德语描述、单价和分类
即时搜索
在 40 多个地区的 12 万多个已定价条目中即时搜索：输入关键词、单位或分类，直接应用到 BOQ 条目
区域货币标准条目数
德国（DACH）EURDIN 27655,719
英国GBPNRM 1/255,719
美国USDMasterFormat55,719
法国EURDPGF55,719
俄罗斯RUBGESN55,719
阿联酋AED本地55,719
中国CNYGB/T55,719
印度INRCPWD55,719

如何使用成本数据库

成本数据库针对两种主要工作流设计：

工作流 A：浏览并应用到 BOQ

  1. 导航至 数据库 → 成本数据库
  2. 选择你的区域标签页（例如「德国 / DACH」）
  3. 在搜索栏中输入关键词查找成本条目（例如「混凝土基础」）
  4. 点击星标图标将常用条目加入收藏夹
  5. 在 BOQ 编辑器中，点击任意条目旁的数据库图标，搜索并应用单价

工作流 B：导入你自己的数据库

  1. 导航至 数据库 → 成本数据库 → 导入数据库
  2. 准备一份 Excel 或 CSV 文件，列为：编码、描述、单位、单价、货币
  3. 上传文件并在导入向导中映射各列
  4. 提交前预览数据
  5. 导入的条目会与 CWICR 数据并列显示，并带有你的自定义来源标签

理解成本条目结构

每条成本条目包含：

向量搜索

启用语义搜索，按含义而非仅按精确关键词匹配来查找成本条目。当你搜索「混凝土墙」时，系统还会找到诸如「带模板的 C30/37 钢筋混凝土隔墙，24 厘米」这类条目 - 即便其中并未出现确切的字面词语。这由句子转换器嵌入向量驱动，它将描述转换为数值向量，并在多维空间中查找最接近的匹配。支持两种向量数据库后端：LanceDB（嵌入式，像 SQLite 一样在进程内运行，384 维嵌入向量）和 Qdrant（生产级服务器，提供可从 GitHub 下载的预构建 3072 维快照）。

CAD/BIM 与 PDF 工程量提取

直接从你的项目图纸和模型中提取工程量 - 无需人工计数。上传 RVT、IFC、DWG 或 DGN 文件，系统会提取每个建筑构件的体积、面积和长度。对于 PDF 图纸，可直接在浏览器中打开，使用经过标定的测量工具提取距离、面积和构件数量。所有提取的工程量都可转入 BOQ 进行计价。

🎬 在 YouTube 上观看 BIM → BOQ 批量关联、DWG 图层工程量计算和 PDF 测量等章节。

CAD/BIM 算量
PDF 工程量提取，含 4 步工作流（上传、AI 分析、复核、加入 BOQ）、项目/BOQ 选择器和拖放上传区
BIM 转 BOQ
BIM → BOQ，在 3D 查看器中选取构件，将其几何&属性直接推送到 BOQ 项
批量关联 BIM 组
将 100 面 BIM 墙批量关联到一条 BOQ 行，汇总面积、体积和长度，一键创建
DWG 图层
跨 10 个 DWG 图层的 636 个墙实体，切换图层、隔离工种、就地将任意实体关联到 BOQ
PDF 算量实操
拖入平面图，用画布上的工具测量距离 / 面积 / 数量，数秒内将数字推入 BOQ
格式软件转换器
.rvt / .rfaBIMDDC RvtExporter
.ifcIFC（任意 BIM）DDC IfcExporter
.dwg / .dxfCADDDC DwgExporter
.dgnCADDDC DgnExporter

CAD/BIM 工程量提取：分步操作

  1. 导航至 工程量计算 → CAD/BIM 工程量计算
  2. 将你的 CAD/BIM 文件（.rvt、.ifc、.dwg、.dgn）拖放到上传区
  3. 等待 DDC 转换器提取构件（普通文件约需 30-60 秒）
  4. 系统会显示可用的列并建议分组预设： 标准 BIM QTO - 按类别 + 类型名称分组，汇总体积/面积/数量 详细 - 添加楼层以按楼层细分 按族 - 按族分组，用于采购清单 自定义 - 从提取出的 1200 多列中任选组合
  5. 点击 应用分组 查看工程量表
  6. 复核分组结果 - 过滤掉空分组、删除无关类别、按体积排序
  7. 点击 保存为 BOQ,将工程量转入工程量清单进行定价

PDF 工程量提取：分步操作

  1. 导航至 工程量计算 → PDF 工程量计算
  2. 上传你的 PDF 施工图纸
  3. 系统会自动从 PDF 中提取文本和表格
  4. 点击用 AI 分析，提取带工程量的建筑构件
  5. 或切换到测量选项卡进行手动算量：
    • 设置图纸比例（点击两个已知点并输入真实距离，或选择 1:100 之类的预设）
    • 选择距离工具，点击两个点以测量长度
    • 选择面积工具，点击多边形的各个角点以测量面积
    • 选择计数工具，点击各个构件进行计数
  6. 所有测量结果都会被保存，并可导出到 BOQ

QTO 分组预设

AI 估算

连接任意 LLM 提供商，从纯文本描述、建筑照片、扫描的 PDF、Excel 表格或 CAD/BIM 模型生成建筑成本估算。AI 系统会创建带工程量和市场价的完整 BOQ 条目。生成后，你可以将每条条目与 CWICR 成本数据库匹配，用经过核验的区域市场价替换 AI 估算的单价。AI 功能完全可选 - 平台不依赖它们也能完整运行。

🎬 在 YouTube 上观看“照片智能估算” - 上传一张施工照片，几秒内获得带范围的 BOQ。

AI 估算
AI 估算页面，含文本输入框、地点/货币/标准选择器，以及 5 种输入模式：文本、照片、PDF、Excel、粘贴
照片智能估算
照片 → AI 估算 - 上传施工照片，GPT-4o + YOLO 几秒内返回带范围的 BOQ 并附置信度评分
提供商模型功能
AnthropicClaude Sonnet / Opus文本、视觉、文档
OpenAIGPT-4o文本、视觉、文档
GoogleGemini Pro文本、视觉
Mistral / Groq / DeepSeek多种文本
1

快速估算

用纯文本描述你的项目，AI 即可生成 15-30 条带工程量和市场价的 BOQ 条目。

2

成本库匹配

将 AI 估算与 CWICR 数据库匹配，用真实市场价替换推测单价。

3

AI 成本顾问

以你的成本数据库为上下文，就成本、材料和定价与 AI 对话。

AI 成本顾问
AI 成本顾问对话，含建议问题、区域选择器和 CWICR 数据库集成

4D 进度与 5D 成本模型

借助一体化的进度编排和财务建模工具，规划你的施工项目时间线并跟踪成本随时间的变化。

4D 进度

进度编排模块提供专业的甘特图，用于管理你的施工时间线。创建活动、设置工期、定义依赖关系，系统会自动计算关键路径，显示哪些活动不容延误。

5D 成本模型

成本模型将你的 BOQ 数据与项目时间线连接，为你呈现含挣值管理指标的、按时间分布的施工成本视图。

招投标与报价管理

管理从创建招标包到比选方案、再到向分包商授标的完整采购工作流。

创建招标包

前往采购，选择一个项目，点击「创建招标包」。指定招标包名称、范围描述、提交截止日期，并选择要纳入的 BOQ 条目。每个项目可创建多个招标包（例如结构工程、机电、装饰）。

管理投标

添加分包商的投标，包含公司名称、联系方式以及每条 BOQ 条目的报价。系统支持每个招标包多份投标以便并排比较。

投标比选

价格对照表在一张比较表中展示所有投标，列出每条条目的单价和合计。可视化指示突出显示最低价和最高价。可将比较结果导出为 CSV 供相关方审阅。

授标流程

用「授标」按钮标记中标方并添加理由说明。招标包状态依次为：草稿、已发出、收集中、评标中、已授标、已关闭。

风险登记册

使用概率-影响矩阵识别、评估和管理项目风险。量化风险敞口，并为每个已识别风险制定缓解策略。

风险评估矩阵

矩阵在概率（0.1-0.9）对比影响（低/中/高/极高）的网格上以颜色标注展示所有风险。每个风险显示其计算出的敞口分值（概率乘以影响成本）。

管理风险

为每个风险记录：唯一编码（R-001）、标题、类别（技术、财务、进度、监管、环境、安全）、缓解策略、应急预案、风险责任人、成本影响以及以天计的进度影响。状态跟踪：已识别、已评估、缓解中、已关闭或已发生。

变更单

跟踪范围变更及其对项目成本和进度的影响。变更单为初始估算之后的所有修改提供审计追踪。

变更单工作流

创建变更单，含编码（CO-001）、标题和原因类别（客户要求、设计变更、不可预见情况、监管）。添加明细行，指定受影响的 BOQ 条目及其原始与新的工程量/单价。系统会自动计算成本差额。状态依次为：草稿、已提交、审核中、已批准/已驳回。

校验与质量检查

校验
校验页面 - 选择项目和 BOQ，针对可配置的规则集运行质量检查

对你的 BOQ 运行自动化质量检查，在问题成为隐患前将其捕获。校验引擎针对你的估算数据应用 42 条可配置规则。

规则集

理解结果

每次校验都会产生一个质量评分（0-100%），并以颜色标注各项发现：错误（红色，必须修复）、警告（黄色，应当复核）、信息（蓝色，建议）。点击任意发现即可直接跳转到受影响的 BOQ 条目。

报表与导出

报告
报表页面，含 9 种导出格式：BOQ（PDF/Excel）、成本报表、GAEB XML、校验、进度、5D 成本、招投标、变更单、风险登记册
数据浏览器透视表
数据浏览器透视表 → 一键生成 10 个 BOQ 条目 - 在每个 CAD/BIM 属性上提供图表、数据条和下钻
完整估算
完整的真实 BIM 估算 - 215 个条目、88 个章节、CWICR 计价、总额 $6.26M、质量评分 99

从你的项目数据生成专业文档，供相关方、客户和监管合规使用。

文档管理

文档
文档管理，含拖放上传、类别筛选（图纸、合同、规格、照片）、标签和文件预览

集中管理所有项目文档。上传图纸、合同、规格和照片，并自动分类与检索。

分析看板

分析
跨项目分析，含 KPI 卡片（总预算 1.256 亿，偏差 6340 万），以及按区域列出预算/实际/偏差的项目对比表
项目仪表盘
全球项目组合仪表盘 - 横跨 4 大洲的 7 个项目、$28.3M 的在建估算、单一地图视图

查看跨项目的预算执行情况。看板汇总所有项目的财务数据，以识别趋势、偏差和有风险的预算。

联系人目录

在集中目录中管理所有项目相关方。跟踪客户、分包商、供应商、建筑师和顾问的完整联系方式、所属公司及基于角色的分类。将联系人关联到项目、招标、采购订单和往来函件，实现完整的可追溯性。

主要功能

API 端点

方法端点描述
GET/api/v1/contacts/列出所有联系人
POST/api/v1/contacts/创建联系人
GET/api/v1/contacts/{id}获取联系人详情
PUT/api/v1/contacts/{id}更新联系人
POST/api/v1/contacts/import批量导入联系人

任务

用 5 种类型的任务分类法和可视化看板组织项目工作。任务可分配给团队成员，关联到特定的 BOQ 条目、文档或 RFI，并通过可自定义的工作流阶段进行跟踪。每种任务类型都有自己的配色和默认字段。

关联到 BIM 的任务
任务与精确的 BIM 构件绑定 - 点击某个任务，镜头会飞向它所属的构件。看板、列表和日历视图共享同一个模型关联。

主要功能

API 端点

方法端点描述
GET/api/v1/tasks/列出任务（可按项目、负责人、状态筛选）
POST/api/v1/tasks/创建任务
PATCH/api/v1/tasks/{id}更新任务（状态、负责人、优先级）
GET/api/v1/tasks/board/{project_id}获取看板数据

RFI - 信息申请

通过球权归属分配机制,跟踪项目各方之间的正式信息请求。RFI 沿着从草稿到关闭的结构化生命周期流转,确保每个问题都能得到有据可查的答复。球权归属跟踪可随时显示当前由谁负责相应行动。

主要功能

API 端点

方法端点描述
GET/api/v1/rfis/列出 RFI
POST/api/v1/rfis/创建 RFI
POST/api/v1/rfis/{id}/respond提交答复
PATCH/api/v1/rfis/{id}/status更新状态 / 球权归属

财务

全面的项目财务管理,涵盖发票、预算、付款和挣值管理(EVM)。跟踪计划成本与实际成本,生成付款申请,并通过实时偏差分析监控预算健康状况。与 BOQ 数据集成,自动生成成本基线。

主要功能

API 端点

方法端点描述
GET/api/v1/finance/invoices/列出发票
POST/api/v1/finance/invoices/创建发票
GET/api/v1/finance/budgets/列出预算
POST/api/v1/finance/budgets/import从 Excel 导入预算
GET/api/v1/finance/evm/{project_id}获取 EVM 指标
GET/api/v1/finance/payments/列出付款

采购

管理建筑材料和服务的采购订单与到货验收。创建关联到 BOQ 项的采购订单,跟踪交付状态,并通过数量核验记录到货验收。与联系人模块集成,实现供应商管理。

主要功能

API 端点

方法端点描述
GET/api/v1/procurement/orders/列出采购订单
POST/api/v1/procurement/orders/创建采购订单
POST/api/v1/procurement/orders/{id}/receive记录到货验收
GET/api/v1/procurement/receipts/列出到货验收记录

安全

通过风险评分系统记录安全事故、未遂事件和行为观察。跟踪各项目的安全绩效指标,识别趋势,并确保符合职业健康与安全法规。

主要功能

API 端点

方法端点描述
GET/api/v1/safety/incidents/列出事故
POST/api/v1/safety/incidents/上报事故
GET/api/v1/safety/observations/列出观察记录
POST/api/v1/safety/observations/记录观察
GET/api/v1/safety/dashboard/{project_id}获取安全 KPI

会议

通过结构化议程和可跟踪的行动项管理会议纪要。创建定期会议系列(例如每周现场会议)、记录与会人员、捕捉讨论要点,并自动生成与任务模块集成的行动项。

主要功能

API 端点

方法端点描述
GET/api/v1/meetings/列出会议
POST/api/v1/meetings/创建会议
GET/api/v1/meetings/{id}/minutes获取会议纪要
POST/api/v1/meetings/{id}/actions添加行动项

检查

使用可配置的检查清单开展质量检查。按工种或活动类型定义检查模板,在现场填写、附加照片并跟踪缺陷整改。检查结果会汇入项目质量评分和 NCR 工作流。

主要功能

API 端点

方法端点描述
GET/api/v1/inspections/列出检查
POST/api/v1/inspections/从模板创建检查
GET/api/v1/inspections/templates/列出检查清单模板
PATCH/api/v1/inspections/{id}/items更新检查清单项结果

不符合报告(NCR)

记录并跟踪工作不符合规范要求时的质量不符合项。NCR 遵循从识别、根本原因分析到纠正措施验证的正式生命周期,确保所有质量偏差都得到妥善解决和记录。

主要功能

API 端点

方法端点描述
GET/api/v1/ncr/列出 NCR
POST/api/v1/ncr/创建 NCR
PATCH/api/v1/ncr/{id}/status更新 NCR 状态
POST/api/v1/ncr/{id}/actions添加纠正措施

报审

管理建筑材料、加工图和产品数据的报审审查流程。跟踪多阶段审查工作流,报审在最终批准前需经过多名审查人。完整保留所有审查周期和修订历史的审计追踪。

主要功能

API 端点

方法端点描述
GET/api/v1/submittals/列出报审
POST/api/v1/submittals/创建报审
POST/api/v1/submittals/{id}/review提交审查决定
POST/api/v1/submittals/{id}/revise上传新修订版

函件往来

为所有项目函件往来维护正式的沟通登记册。通过唯一的参考编号、答复跟踪和全文搜索,跟踪项目各方之间的信函、电子邮件、通知和指令。确保合同性沟通得到妥善记录且可追溯。

主要功能

API 端点

方法端点描述
GET/api/v1/correspondence/列出函件往来
POST/api/v1/correspondence/创建函件条目
GET/api/v1/correspondence/{id}获取含附件的详情
GET/api/v1/correspondence/{id}/thread获取关联的函件链

通用数据环境(CDE)

符合 ISO 19650 标准的通用数据环境,通过受控的状态转换管理项目信息。文档经由审批关卡在进行中(WIP)、共享、发布和归档等状态之间流转。确保信息管理遵循 BIM 标准以实现协同交付。

主要功能

API 端点

方法端点描述
GET/api/v1/cde/documents/列出 CDE 文档(可按状态、适用性筛选)
POST/api/v1/cde/documents/上传文档到 CDE
PATCH/api/v1/cde/documents/{id}/status转换文档状态
GET/api/v1/cde/documents/{id}/history获取修订历史

文件传递单

通过可跟踪的送达与签收,正式向外部各方分发文档。创建包含多份文档的传递单包、指定收件人,并跟踪每位收件人是否已收到并签收文档。提供信息交换的合同性记录。

主要功能

API 端点

方法端点描述
GET/api/v1/transmittals/列出文件传递单
POST/api/v1/transmittals/创建文件传递单
POST/api/v1/transmittals/{id}/send向收件人发送文件传递单
PATCH/api/v1/transmittals/{id}/acknowledge记录收件人签收

BIM 中心

BIM 模型管理的中央枢纽,支持构件级数据访问和直接 BOQ 关联。上传 IFC/RVT 模型,浏览建筑构件及其属性和工程量,并将构件关联到 BOQ 项以实现 5D 成本集成。在设计数据与成本估算之间架起桥梁。

🎬 在 YouTube 上观看 BIM 批量关联演示 - 100 面 BIM 墙体 → 一条 BOQ 行，汇总面积、体积和长度。

主要功能

API 端点

方法端点描述
GET/api/v1/bim/models/列出 BIM 模型
POST/api/v1/bim/models/上传 BIM 模型
GET/api/v1/bim/models/{id}/elements列出模型构件
POST/api/v1/bim/elements/{id}/link-boq将构件关联到 BOQ 项

报表与 KPI 看板

功能全面的报表引擎,配备 KPI 看板、可自定义的报表模板和定时报表生成。跨项目汇总数据以获得项目组合层面的洞察。创建组合任意模块(BOQ、财务、进度、安全、质量)数据的自定义报表模板。

主要功能

API 端点

方法端点描述
GET/api/v1/reporting/kpi/{project_id}获取项目 KPI
GET/api/v1/reporting/templates/列出报表模板
POST/api/v1/reporting/generate从模板生成报表
GET/api/v1/reporting/portfolio/获取项目组合看板数据

通知

应用内通知系统,让用户及时了解与自己相关的事件。通知由所有模块中的操作触发,包括任务分配、RFI 答复、报审审查、审批请求、逾期项等。用户可按类别控制各自的通知偏好。

主要功能

API 端点

方法端点描述
GET/api/v1/notifications/列出通知(未读优先)
PATCH/api/v1/notifications/{id}/read将通知标记为已读
POST/api/v1/notifications/read-all全部标记为已读
GET/api/v1/notifications/preferences获取通知偏好

评论

线程式评论系统,可附加到平台中的任何实体上,包括 BOQ 项、任务、RFI、报审、文档、检查等。支持 @提及以通知团队成员、文件附件,以及面向行动的讨论的解决状态跟踪。

主要功能

API 端点

方法端点描述
GET/api/v1/comments/?entity_type=task&entity_id=...列出某实体的评论
POST/api/v1/comments/创建评论
POST/api/v1/comments/{id}/reply回复评论
PATCH/api/v1/comments/{id}/resolve将线程标记为已解决

甘特图

用于建筑进度可视化的纯 SVG 甘特图。无需外部库,直接在浏览器中渲染时间线、依赖关系、里程碑和关键路径。支持从日级到年级的视图缩放,并可导出为 PDF/PNG 以供报表使用。

主要功能

API 端点

方法端点描述
GET/api/v1/schedule/gantt/{project_id}获取甘特图数据(活动、依赖关系)
PATCH/api/v1/schedule/activities/{id}更新活动日期/进度
POST/api/v1/schedule/dependencies/创建依赖关系

区域设置

为每位用户和每个项目配置时区、货币、数字格式和日期格式偏好。区域设置从系统默认值逐级覆盖到项目级再到用户级偏好,确保每位团队成员看到的数据都按其语言区域进行格式化。

主要功能

API 端点

方法端点描述
GET/api/v1/settings/regional/获取当前区域设置
PUT/api/v1/settings/regional/更新区域设置
GET/api/v1/settings/regional/timezones列出可用时区
GET/api/v1/settings/regional/currencies列出支持的货币

模块系统

启用或禁用平台模块,以根据您的工作流定制 OpenConstructionERP。每个模块都可独立切换而不影响其他模块。被禁用的模块会从 UI 中隐藏,其 API 端点返回 404,而其数据库表保持完好以便重新激活。

主要功能

API 端点

方法端点描述
GET/api/v1/modules/列出所有模块及其状态
PATCH/api/v1/modules/{name}/toggle启用或禁用某模块
GET/api/v1/modules/{name}/dependencies检查模块依赖关系

区域包

预先配置的区域包,可为特定市场设置分类标准、税务规则、成本数据库默认值、报表模板和法规合规规则。安装一个区域包即可立即为您所在的国家或地区配置好平台。

可用区域包

区域包地区标准货币
US美国MasterFormat, UniFormat, CSIUSD
DACH德国、奥地利、瑞士DIN 276, GAEB, VOB, HOAIEUR/CHF
UK英国NRM 1/2, RICS, JCTGBP
Russia俄罗斯、独联体GESN, FER, TER, SNIPRUB
中东阿联酋、沙特阿拉伯、卡塔尔RICS, CESMM, FIDICAED/SAR/QAR
Asia-Pacific中国、日本、澳大利亚GB/T, AS 4000, JASSCNY/AUD/JPY
India印度CPWD, IS standards, DSRINR
LatAm巴西、墨西哥、哥伦比亚SINAPI, CMIC, local normsBRL/MXN/COP

主要功能

API 端点

方法端点描述
GET/api/v1/regional-packs/列出可用区域包
POST/api/v1/regional-packs/{name}/install安装区域包
GET/api/v1/regional-packs/{name}/details获取区域包内容与配置

导入/导出

覆盖所有模块的全面数据导入和导出功能。通过智能列映射,从 Excel 和 CSV 文件导入联系人、预算、BOQ 和成本数据库。使用可自定义的模板将项目数据导出为 Excel、PDF 和 CSV。所有导出都保留格式并包含元数据标头。

主要功能

API 端点

方法端点描述
POST/api/v1/import/contacts从文件导入联系人
POST/api/v1/import/budget从 Excel 导入预算
POST/api/v1/export/boq/{id}导出 BOQ(格式:excel、pdf、gaeb、csv)
POST/api/v1/export/report生成并导出报表

配置

基于角色的引导
按角色的引导向导：以 Admin / 估价师 / 经理身份登录，向导会为您的角色从 190 多个模块中预选合适的 17 个
新建项目，任意地区
新建项目，任意地区 - 选择货币、分类标准、区域系数；地图与天气小部件会自动随之配置
设置
设置页面,提供个人资料管理、简单/高级界面模式切换以及模块配置
变量默认值说明
DATABASE_URL（未设置 = 内置 PostgreSQL）数据库（默认使用内置 PostgreSQL；使用外部 PostgreSQL 时设置）。使用内置 PostgreSQL 时请留空，使用外部数据库时请设置，例如 postgresql+asyncpg://oe:oe@localhost:5432/openestimate。
JWT_SECRETdev-keyJWT 密钥(生产环境请务必更改!)
SEED_DEMOtrue创建演示账户
VECTOR_BACKENDlancedb向量搜索后端

API 参考

OpenConstructionERP 提供一套全面的 REST API，它驱动着前端，并可用于集成、自动化和自定义工作流。UI 中可用的每一项操作 - 创建项目、编辑 BOQ、运行 AI 估算、搜索成本 - 都以 API 端点的形式提供。运行后端时，可在 /api/docs 访问带“试用”按钮的交互式 Swagger 文档。

核心端点

方法端点描述
POST/api/v1/users/auth/login登录
GET/api/v1/projects/列出项目
GET/api/v1/boq/boqs/?project_id=...列出 BOQ
GET/api/v1/costs/?q=concrete搜索成本
POST/api/v1/ai/quick-estimateAI 估算
POST/api/v1/takeoff/cad-extractCAD 提取
GET/api/health健康检查

v18.5.0 模块

模块前缀描述
Contacts/api/v1/contacts/联系人目录增删改查、导入
Tasks/api/v1/tasks/任务管理、看板
RFI/api/v1/rfis/信息请求
Finance/api/v1/finance/发票、预算、付款、EVM
Procurement/api/v1/procurement/采购订单、到货验收
Safety/api/v1/safety/事故、观察、风险评分
Meetings/api/v1/meetings/纪要、议程、行动项
Inspections/api/v1/inspections/质量检查、检查清单
NCR/api/v1/ncr/不符合报告
Submittals/api/v1/submittals/多阶段报审审查
Correspondence/api/v1/correspondence/沟通登记册
CDE/api/v1/cde/ISO 19650 文档环境
Transmittals/api/v1/transmittals/文档分发
BIM Hub/api/v1/bim/BIM 模型、构件、BOQ 关联
Reporting/api/v1/reporting/KPI 看板、报表模板
Notifications/api/v1/notifications/应用内通知系统
Comments/api/v1/comments/任意实体上的线程式评论
Gantt/api/v1/schedule/gantt/SVG 进度可视化
Regional/api/v1/settings/regional/时区、货币、格式偏好
Modules/api/v1/modules/启用/禁用模块
Regional Packs/api/v1/regional-packs/安装区域配置
Import/Export/api/v1/import/ / /api/v1/export/批量数据导入与导出

详细的端点文档(含参数和说明)请参见上方各模块章节。

项目智能(PCI)

AI 驱动的项目分析，跨9 个加权领域对您的项目评分，并生成 0 到 100 的完整度评分（A 至 F 等级）。

领域与权重

功能特性

API： GET /api/v1/project_intelligence/score/?project_id=X - 返回总评分、各领域评分、关键缺口和成就。

用户管理

管理团队成员、角色以及按模块的访问控制。

角色

模块访问矩阵

管理员可通过 /users 页面配置按用户的模块可见性和访问级别（无、查看、编辑、完全）。可分配自定义角色名称（例如“现场工程师”“成本经理”）。

功能特性

支持与贡献

在 GitHub 上点赞

为仓库点赞，帮助更多人发现本项目。

YouTube 频道

订阅以获取版本讲解和教程。可从这段 12 分钟产品讲解开始。

反馈问题

在 GitHub 上提交 issue。

讨论区

加入 Telegram 社区提问交流。

咨询服务

如需部署和培训，请联系我们。

许可证： AGPL-3.0。商业授权：info@datadrivenconstruction.io

OpenConstructionERP

由 DataDrivenConstruction 团队构建

2026 Data Driven Construction. AGPL-3.0