主题
业务地图
工程主数据
工程基础管理全面落地**“双核四维解耦架构”**（空间物理资产核 PBS + 商务标段合同核 CBS，通过施工质量验收 WBS 矩阵交汇，依托 OBS 统一企业主数据组织底座）。彻底终结原单棵多层折叠工程树导致的物理资产割裂、机电标段与工点重名冗余、参建单位纯文本游离无关联等根本痛点：
- PBS 空间物理资产线：线路（Line）→ 物理工点（Site Master）→ 空间部位（Zone）。维护全生命周期真实物理世界，提供终身不变的空间坐标与全景资产底座，直接支撑 BIM/GIS 与数字移交。
- CBS 商务合同管理线：建设项目（Project）→ 施工/监理标段（Bid Section）→ 参建合同（Contract）。标段支持“全线统包型（FULL_LINE）”与“指定工点型（DESIGNATED_SITES）”两种管辖模式，承载投资立项、招投标采购、履约单位绑定与造价变更归集。
- WBS 工程质量验收线：单位工程（Unit Project）→ 分部工程（Sub Project）→ 分项工程 → 检验批。单位工程由“标段 (BID) + 工点 (SITE) + 专业 (MAJOR)”三元组笛卡尔积交汇生成，由唯一性索引严密约束，承载现场施工、质量报验、工程变更与三权移交法定最小单元。
- OBS 企业组织底座：参建单位与企业主数据（
SYS_DEPT）通过 ID 外键与名称快照强关联，支持缺少时自动补齐建档。
权限模型
系统能力权限与工程数据权限是两套维度：
- 菜单和按钮权限决定用户能否进入页面、执行动作。
- 角色数据范围（部门、创建人等通用业务数据过滤，
@DataPermission）机制已于 2026-09-29 整体移除：系统管理域数据由菜单/按钮权限约束；平台数据级权限只有工程范围授权一个业务维度。 - 各业务域的数据过滤策略必须显式声明（不过滤 / 工程范围授权），不允许缺省。双核四维新架构落地后的现行数据过滤基线如下：
| 业务域 | 现行数据过滤 | 定性与实现机制 |
|---|---|---|
| 系统管理（用户/部门/岗位/角色/活跃度） | 无 | 有意不过滤，由菜单权限约束 |
| 项目主数据、招投标 | 无 | 有意不过滤，项目侧全量可见；标段包对齐标段主数据 |
| 线路、标段、工点、单位工程、质量、工程变更、工程手续 | 工程数据授权（专属/共享/整线） | 核心业务域；由 EngineeringDataAccessHelper 统一执行标段工点专属组合或共享资源判定与 EXISTS 查询注入（授权异常 fail-closed） |
| BIM引擎底座（设计阶段） | 标段工点专属工程数据授权 | 2026-11-08确认模型归属单位工程，工点汇总只含有权单位工程模型；复用专属组合规则，取代早期工点共享设计，见BIM需求 |
| 前期管理（设计基线，尚未实施） | 单位工程归属，沿现有标段工点专属工程授权 | 用户2026-11-10确认施工维护具体单位工程、对应监理审核；服务端从UnitProject反取组合并复用既有授权，同组合不同专业不新增独立unitID授权，见前期管理需求 |
| 规划管理 | 无 | 有意不过滤，挂项目或集团统筹口径 |
| 勘察管理（开发完成，生产待发布） | 工程数据授权 | 用户于2026-11-03明确选择：有工点按标段工点专属组合，无工点按标段级资源；列表、导出、详情与写入保持同范围，见勘察管理需求 |
| 公文与协同 | 无 | 有意不过滤；按发文部门隔离属新建维度，另行立项 |
| 造价单位管理 | 无 | 有意不过滤；外部造价单位隔离属新建“单位维度”，另行立项 |
| 安质环监管 | 无 | 集团监管口径，有意不过滤 |
| 工程投资 | 无 | 有意不过滤，项目侧对象 |
| 建渣（工程安全管理） | 标段工点专属工程数据授权 | 按 EngineeringDataAccessHelper 进行专属工程组合范围过滤 |
| 运营对接 | 工点共享数据范围过滤（三权移交）；问题闭环维持全量可见 | 两子域分别定性；三权移交按工点共享资源过滤，问题闭环不过滤 |
| GIS引擎底座（底图与 CAD 图层浏览已实现；编辑、进度未完成） | 工程数据授权（功能权限＋线路/工点工程范围；2026-10-24 起专业范围权限整体取消） | 工程成果按专属组合、工点共享或整线完整资源判定，未纳入工程范围的数据不下发；图层地图可见性按当前有效图层的线路/工点归属判定。专业授权矩阵、FILE_PROCESS 与未归类拒绝已退出，GIS_AUTH_SUBJECT/GIS_PROFESSION_GRANT 保留存量不再读取。规则见 GIS引擎底座需求分析 |
- 新增业务域必须按上表口径在模块
requirements.md显式声明过滤策略，并同步本表；不得缺省，也不得在未更新本表的情况下自行改变某域的可见范围。 - 工程数据授权模型：工程数据授权由
BIZ_USER_ENGINEERING_CONFIG、BIZ_USER_ENGINEERING_LINE、BIZ_USER_ENGINEERING_PAIR表承载。采用整线模式（FULL_LINE，动态继承未来工程）与受限模式（RESTRICTED，持久化具体标段工点有效组合）。资源按业务属性分为标段工点专属资源、工点共享资源与整线完整资源；业务查询统一由EngineeringDataAccessHelper判定或注入 EXISTS 谓词，杜绝独立三维 OR 交叉放行。授权配置为空或异常时严格判定为无数据权限（Fail-Closed 安全防护）。 - 项目主数据不设项目级数据范围，具备对应菜单/按钮/接口权限的用户均可使用；项目可关联标段，项目成员信息由工程数据权限实时派生、只读，不作为项目或招投标数据的访问授权。工程数据权限只约束工程与下游关联业务，不能反向限制项目或招投标数据。
- 前端隐藏按钮只负责呈现，不能代替鉴权，也不能绕过只读和数据范围限制。
工作流
Warm-Flow 统一承载待办、已办、流程进度和标准办理动作。业务模块保存单据与流程实例关联、展示业务状态，不复制一套“我的任务”。固定表单流程一般在业务台账新增和编辑，在流程工作台查看与办理。底座自身的能力范围、办理规则、接口契约与数据结构见流程引擎底座需求分析及其概要/详细设计与数据库设计。
- 新增流程定义或流程节点时，默认开启除委托、终止外的标准流程操作权限；只有明确保存过按钮权限配置的节点才按该配置收紧。
- 默认开启不绕过流程状态、当前办理人和节点类型校验；例如加签、减签仍仅适用于会签或票签节点。
- 查看流程实例图时，节点提示统一同时读取已办理历史任务和当前运行任务；当前中间节点展示实际办理人、用户账号、部门、办理状态和接收时间，办理人以引擎当前任务关联关系为准，不以业务单据快照替代。该能力由
digital-construction-workflow的 Warm-FlowChartExtService统一提供，业务模块不重复实现。
主要业务域
| 业务域 | 主要能力 |
|---|---|
| 工程信息配置 | 线路、包段、标段、单位工程、工点库、标段覆盖和工程范围授权 |
| 工程基础管理 | 项目信息配置、工程信息配置、工点配置和工程业务权限配置 |
| 系统设置 | 用户、角色、部门、岗位、字典、参数和活跃度 |
| 招投标监管 | 工程建设招标、非依法必招标、下属单位招标 |
| 开投安质环监管 | 目标、计划、督察、整改、事故、考评及六条流程 |
| 公文与协同 | 公文、联系单、内部协同和会议 |
| BIM | 模型资产、转换发布、浏览与业务绑定 |
| GIS引擎底座 | 工程地图、CAD 全解析入图、标绘编辑、多专业图层与权限、进度及业务联动；二维为首期，实景三维按服务条件演进，见 GIS引擎底座需求分析与概要设计 |
跨模块约束
- 逻辑删除必须与唯一性校验保持一致。
- 金额单位、状态编码、字典值和名称快照必须在契约中明确。
- 权限、金额、状态流转、数据范围、事务回滚和接口契约需要与风险匹配的回归验证，优先复用既有自动化测试。
- 仍缺依据的业务规则在相应模块资料中标明缺项、来源和受影响范围，不用代码现状或行业经验自动补齐；调用链、既有契约或同级先例能唯一确定的业务含义按根
AGENTS.md的可推断上下文处理。只有缺项实质影响正确性、兼容性、安全性或数据影响且无法核实时，才澄清并暂停依赖部分。