主题
工程进度监管 · 概要设计文档
文档版本：0.02 ｜ 最近核对日期：2026-11-09
面向设计评审、实现和验收。本文档是模块六类交付文档中的概要设计文件，只确定模块在平台中的定位、边界、页面与路由、数据对象、流程与接口职责，不展开字段级、参数级、类级实现；业务规则条目、验收标准与业务层待确认事项的正文在需求分析中维护，本文只引用编号，不复制正文。
文档控制
| 项目 | 内容 |
|---|---|
| 模块名称 | 工程进度监管 |
| 编写日期 | 2026-09-21 |
| 业务确认人 | 待确认（责任部门与办理角色的组织归属未收敛，见需求 Q-PS-002） |
| 关联需求分析 | 工程进度监管需求分析 |
| 关联文档 | 业务地图、公共开发约定、流程图编排规范、原功能架构图历史规划（工程部讨论版，2026-08-26） |
1. 模块在平台中的定位与复用
1.1 定位
工程进度监管是「工程进度监管」一级业务域的承载模块；原功能架构图历史规划（工程部讨论版，2026-08-26）将其列为 12 月上线批次。模块以线路、包段、标段、单位工程为组织维度，以分部分项 WBS 为最小进度数据单元，承载工程建设阶段的进度全过程：向上建立一、二、三级网络进度计划的统一基准，中部按专业受理施组与专项方案报审、年/月/周计划与施工进度实际填报，向下输出形象进度看板、倒排工期、进度纠偏与工序移交闭环，实现进度业务从计划、执行、检查到纠偏的线上闭环（R-PS-001、R-PS-002、R-PS-003）。
模块与「规划管理」是并列的一级业务域，不是其子域：规划管理承载线网规划、建设规划与工可研究的规划成果报审（planning_network_plan 等 9 条流程，S-PS-011），本模块的一、二、三级网络进度计划是工程建设进度计划，两者不共用台账（R-PS-145）。
1.2 复用关系
| 复用能力 | 复用内容 | 本模块的使用方式 |
|---|---|---|
| Warm-Flow 工作流平台 | 待办、已办、流程进度、流程图查看、审批历史、标准办理动作、条件分支与互斥网关 | 16 条固定表单流程在业务台账新增编辑、在流程工作台办理，不复制「我的任务」；进度填报用条件分支区分专业链路 |
| 平台权限体系 | 三段式权限码、菜单与按钮权限、角色数据范围 | 模块段取 progress；资源段按 27 项目录形成候选映射，督办台账资源是否纳入待 Q-PS-001 确认，后端逐接口鉴权 |
| 工程范围授权 | 一条授权覆盖所选工程节点及整棵下级子树，SITE 为叶子 | 作为网络计划节点、各专业计划与进度明细、看板统计、纠偏与移交台账的数据范围来源（口径见 Q-PS-011） |
| 工程树与工点主数据 | ROOT→LINE→PACKAGE→BID→SITE 五层结构、biz_project_node、biz_site_master、节点信息表 biz_project_node_info | 计划与进度的工程维度引用、看板四层钻取的节点来源、参建单位筛选的文本口径；只读引用 + 快照，不写入工程树（S-PS-004、S-PS-005） |
| BIM 模型与构件绑定 | 旧版能力已移除，重构方案待定 | 进度管理页模型查看及高亮的对接方式待确定（S-PS-008、Q-PS-009） |
| 平台字典 | wf_business_status 单据状态；biz_node_type 工程节点类型 | 单据状态与工程节点类型复用；专业、计划期次、节点类型（里程碑）、资料类型、纠偏偏差等级与成因分类、问题类别与进度状态、督办类型、缺陷等级、移交专业类型等按需新增模块字典 |
| 平台附件存储与通知 | 附件上传、下载、在线预览；站内通知 | 承载施组与专项方案文件、设备资料、移交检查附件、会议纪要与现场照片；超期提醒与升级复用平台通知（不新建通道） |
| SnailJob 周期任务 | 分布式任务调度 | 承载「预计超期」预警、整改期限与移交节点临近提醒、看板统计预汇总等周期任务 |
| 既有模块先例 | 开投安质环监管的「主单 1 ── 0..1 处置子单、子单独立审批」；规划管理的「台账页 + 按期次办理页 + 同名流程定义」；工程手续办理的条件分支 | 纠偏问题与缺陷整改的流程组织；计划期次的三条流程与办理页命名；进度填报的专业条件分支（S-PS-009） |
2. 模块边界与相邻模块关系
2.1 模块边界
- 本模块负责：一、二、三级网络进度计划；施组与施工专项方案报审；五个专业的计划与进度填报；分部分项 WBS 与价格信息；进度看板、倒排工期、纠偏及难点卡点问题库/上报；工序移交与缺陷整改。督办台账虽有完整功能说明，但不在 §1.4 的 27 项目录中，是否纳入范围及权限资源按 Q-PS-001 确认。页面动作、导出、数据范围及未决的流程边界以需求分析为准。
- 本模块不负责：平台工程树、工点主数据与工程范围授权的维护；工效分析与 AI 分析算法（AI 一体化管控平台）；验工计价业务（造价平台二期）；在线签章与 OA 盖章业务；质量验收、试验检测、安全环保督察与运营移交流程；BIM 模型资产与转换发布底座；待办、已办、流程进度等平台统一能力。
- 与既有能力的复用关系：见 §1.2。
2.2 相邻模块关系
| 相邻对象 | 关系 |
|---|---|
| 工程基础管理 | 引用工程树的线路、包段、标段、单位工程节点与工程范围授权；保留节点快照，不修改工程树与工点主数据（R-PS-147） |
| 规划管理 | 同级并列，互不调用；其线网规划、建设规划、工可研究是规划成果报审，与本模块的网络进度计划不共用台账（R-PS-145、S-PS-011） |
| 工程投资监管 | 单向读取：进度纠偏的二级、三级阈值需比对投资完成率，取工程投资监管的投资实施完成率；投资实施未提供对应口径前该条阈值按人工判断处理（R-PS-102、Q-PS-007） |
| 工程质量管理 | 单向输出：进度数据为质量验收提供依据（交底§1.2、R-PS-144）；不反向读取质量台账 |
| 运营对接管理 | 同级并列；联调联试归属该域，本期不在本模块（R-PS-146、S-PS-016） |
| BIM 构件绑定 | 旧版能力已移除，后续对接方式待 BIM 重构方案确定（S-PS-008） |
| 外部：AI 一体化管控平台 | 双向但本期未定：本平台提供进度数据供其工效分析，获取分析结果用于技术判断；移交会议纪要由该平台 OCR 读取形成移交台账（R-PS-025、R-PS-135、R-PS-142、Q-PS-004） |
| 外部：造价平台（二期） | 单向输出：提供进度相关数据供其验工计价的精准匹配（R-PS-061、R-PS-143、Q-PS-005） |
| 外部：OA 系统 | 可选衔接：施组与专项方案审批流程后可继续挂接盖章流程（R-PS-026、Q-PS-006） |
| 工作流平台 | 依赖其流程定义装载、待办生成、流程图与审批历史能力；流程定义 JSON 落在 digital-construction-workflow 的 resources/flow/progress/ |
3. 模块分解
| 子模块/能力 | 职责 | 上游输入 | 下游输出 |
|---|---|---|---|
| 一级网络计划 | 项目总控里程碑计划的编制、审批、发布与调整留痕 | 交通开投集团编制的关键里程碑节点（洞通、轨通、电通、试运行等）、模板导入数据 | 发布版本与关键节点，作为二级、三级计划的时间约束基准 |
| 二级网络计划 | 控制性工期计划的编制、与一级节点的挂接校验与发布 | 一级网络计划关键节点、按标段与单位工程的分解结果 | 二级计划发布版本，作为三级计划的约束 |
| 三级网络计划 | 项目实施计划的编制（细化到工序与前置后置关系）与发布 | 二级计划节点、单位工程与分部工程分解结果 | 三级计划基准，作为年度计划拆分、报审与倒排比对的依据 |
| 网络计划业务规则 | 层级约束、完整性、版本管理与调整审批四类规则的落地，管理办法在线查阅 | 三级计划的计划数据、管理办法文档 | 校验结果、版本与差异对比、在线查阅入口 |
| 施组与专项方案报审 | 施组与一般、危大专项方案的线上报审、退回留痕与正式版归档 | 报审稿、内审与各级审核意见、专家论证意见、正式版文件 | 方案报审台账、归档文件与调阅入口 |
| 年度计划（含分部分项 WBS） | 按单位工程拆分分部分项、维护价格信息、设定年度计划并汇总年度产值 | 三级网络计划节点、工程量与综合单价、BIM 绑定状态 | 分部分项 WBS 清单、年度计划与年度产值计划、未基准化标记与校准差异 |
| 月度计划 | 由年度计划按分部分项分解、设定月度计划与产值、反馈上月完成 | 年度计划与分部分项清单、上月完成情况 | 月度计划与月度产值计划、计划—完成对比与偏差提示 |
| 周计划 | 由月度计划按分部分项分解、设定周计划与作业时间 | 月度计划与分部分项清单、上周完成情况 | 周计划与周完成情况，形成周—月—年贯通（车辆专业不启用） |
| 实际进度填报与里程碑登记 | 按分部分项填报实际完成工程量与完成比例、按里程碑节点登记实际完成时间、附照片与凭证 | 分部分项清单与计划数据、现场照片、交付凭证 | 实际进度明细、偏差天数与滞后高亮、纠偏发起入口 |
| 形象进度计算 | 按价格加权计算分部分项至线路各级完成率与完成产值；按权重口径计算综合完成率 | 分部分项价格信息、计划与实际明细、专业权重配置 | 各级完成率与完成产值、综合完成率、看板统计结果 |
| 设备资料管理 | 按设备与分部分项组织资料目录、提交、审核确认、归档、查询预览下载与节点关联提醒 | 出厂资料、合格证、检验/试验报告、安装调试记录、随机文件 | 已确认的资料与归档目录、缺失资料提示与待办 |
| 权重赋值 | 按专业/设备类别配置权重并校验合计 100%、调整审批与生效留痕 | 建设单位或总体咨询单位确定的权重口径 | 权重配置与生效记录，供综合完成率计算 |
| 进度总看板 | 四层钻取的形象进度统计、统计分析图表与平面完成图，支持按参建单位管理范围筛选 | 各级计划与进度明细、关键里程碑状态、难点卡点台账、甩项标记、工程树与节点信息 | 分层统计指标、统计图表、平面完成图与穿透入口、纠偏发起入口 |
| 倒排工期 | 按剩余可用工期反推工序最迟开始/完成时间与赶工措施，与三级计划逐工序比对识别冲突 | 建设公司指令、三级网络计划节点与搭接关系、实际完成情况 | 倒排工期计划与冲突提示记录 |
| 偏差技术判断 | 比对计划基准与实际完成，输出偏差天数、偏差率与四色预警等级并记录成因与建议方向 | 计划与实际明细、AI 工效分析结果（本期可选）、投资完成率（见 Q-PS-007） | 偏差判断记录与偏差等级，作为纠偏发起依据 |
| 纠偏问题闭环 | 纠偏问题的发起、多单位下发、指定单位响应回复、超期提醒升级与发起单位确认关闭 | 偏差判断结论、发起单位填写的表单、接收单位的响应回复 | 纠偏问题闭环记录与响应及时率、闭环率统计 |
| 难点卡点问题库与上报 | 按年度上报与审核、入库台账、共性标识与督办类型、进展更新与办结，形成调度会底册 | 参建单位按年度上报的问题与附件、建设单位登记的问题、责任单位进展更新 | 难点卡点问题库台账、年度统计概览、导出结果 |
| 督办台账（范围待确认） | 如按 Q-PS-001 纳入，提供面向业主与上级督查部门的督办视图与按期推进跟踪 | 由问题库筛选纳入督办的重大问题或业主独立登记、实际进度更新 | 督办台账、按期率统计与导出（含附表） |
| 移交计划与模板 | 移交节点清单维护、模板工具批量生成移交任务与表单、计划与实际对比跟踪、专业模板与字段配置 | 建设单位或总体咨询单位梳理的移交节点、专业与工序、模板字段配置 | 移交计划与移交任务、按专业的移交表单、临近提醒与滞后高亮 |
| 移交工作 | 按专业差异化表单的申请、检查、签认与归档，回写进度数据 | 移交申请的填报、现场检查记录与附件、会议纪要 | 移交单与签认记录、对应分部分项的进度状态回写 |
| 缺陷整改台账 | 缺陷登记、派发、整改、复查、销项闭环与统计 | 移交检查与过程检查发现的缺陷、责任单位整改回复、复查结论 | 缺陷闭环记录与整改及时率、销项率统计 |
| 流程与权限支撑 | 流程定义装载、流程分类树维护、权限码与菜单按钮、权限与数据范围校验 | 平台工作流与权限体系、组织与角色配置、工程范围授权 | 待办与办理痕迹、鉴权结果、审计日志 |
4. 页面与路由清单
以下页面、路由与办理入口为概要设计草案，不代表已经确认的菜单或实现范围。哪些业务需要建立 Warm-Flow 流程仍待 Q-PS-018 确认；未裁决前，流程办理页与对应路径均为候选方案。
| 菜单/入口 | 路由 | 组件 | 说明 |
|---|---|---|---|
| 工程进度监管（一级目录） | /progress | — | 一级菜单，占位目录 |
| 网络进度计划（二级目录） | /progress/networkPlan | — | 二级菜单，占位目录 |
| 一级网络计划 | /progress/networkPlan/level1 | views/business/progress/networkPlan/index.vue | 台账与编制：层级参数 level=L1；关键里程碑节点、导入校验、版本与差异对比 |
| 一级网络计划办理 | /progress/networkPlan/level1/flowForm | views/business/progress/networkPlan/flowForm.vue | 隐藏办理页，固定注册在 src/router/flowFormRoutes.ts |
| 二级网络计划 / 办理 | /progress/networkPlan/level2、/progress/networkPlan/level2/flowForm | 同上，层级参数 level=L2 | 台账与办理，保存时校验不突破一级节点 |
| 三级网络计划 / 办理 | /progress/networkPlan/level3、/progress/networkPlan/level3/flowForm | 同上，层级参数 level=L3 | 台账与办理，含工序与前置后置搭接关系维护 |
| 业务规则 | /progress/networkPlan/rule | views/business/progress/networkPlan/rule/index.vue | 四类规则的说明与校验口径展示；《进度计划管理办法》在线查阅 |
| 施组报审（二级目录） | /progress/scheme | — | 二级菜单，占位目录 |
| 施工组织设计 / 办理 | /progress/scheme/constructionOrg、/progress/scheme/constructionOrg/flowForm | views/business/progress/scheme/{index,flowForm}.vue | 台账与办理，含正式版附件入口的节点控制与版本替换 |
| 施工专项方案 / 办理 | /progress/scheme/specialScheme、/progress/scheme/specialScheme/flowForm | views/business/progress/scheme/{index,flowForm}.vue | 台账与办理，按专项类型分类归档，含危大工程论证分支 |
| 施工进度报审（二级目录） | /progress/progressReport | — | 二级菜单，占位目录 |
| 土建（二级目录） | /progress/progressReport/civil | — | 专业目录，专业参数 profession=civil |
| 计划管理（台账） | /progress/progressReport/civil/plan | views/business/progress/periodPlan/index.vue | 计划台账，按期次（年度/月度/周）切换；含分部分项 WBS 划分与价格维护入口 |
| 年度计划办理 / 月度计划办理 / 周计划办理 | /progress/progressReport/civil/plan/{annual,monthly,weekly}/flowForm | views/business/progress/periodPlan/flowForm.vue | 隐藏办理页，按期次三条流程；车辆专业不启用周计划 |
| 进度管理（台账） | /progress/progressReport/civil/progress | views/business/progress/actualProgress/index.vue | 实际进度填报台账、计划与实际并列、偏差高亮、纠偏发起入口、BIM 模型查看入口 |
| 进度填报办理 | /progress/progressReport/civil/progress/flowForm | views/business/progress/actualProgress/flowForm.vue | 隐藏办理页 |
| 系统设备（二级目录） | /progress/progressReport/system | — | 专业目录，profession=system |
| 系统设备—计划管理 / 三期次办理 | /progress/progressReport/system/plan（办理 .../plan/{annual,monthly,weekly}/flowForm） | 同土建，views/business/progress/periodPlan/* | 台账与办理，含里程碑节点（到货、安装、单系统调试、联调联试）设置与网络计划未基准化标记 |
| 系统设备—进度管理 / 办理 | /progress/progressReport/system/progress（办理 .../progress/flowForm） | 同土建，views/business/progress/actualProgress/* | 按分部分项与里程碑节点填报，按挂接情况提供 BIM 模型查看入口 |
| 系统设备—设备资料管理 / 办理 | /progress/progressReport/system/equipmentDoc、.../equipmentDoc/flowForm | views/business/progress/equipmentDoc/{index,flowForm}.vue | 按设备与分部分项组织资料目录，含查询预览下载与缺失提醒 |
| 系统设备—权重赋值 / 办理 | /progress/progressReport/system/weight、.../weight/flowForm | views/business/progress/weight/{index,flowForm}.vue | 专业权重配置，保存校验合计 100%，调整走审批 |
| 风水电及装饰装修（二级目录） | /progress/progressReport/mep | — | 专业目录，profession=mep |
| 风水电及装饰装修—计划管理 / 三期次办理 | /progress/progressReport/mep/plan（办理 .../plan/{annual,monthly,weekly}/flowForm） | 同土建，views/business/progress/periodPlan/* | 台账与办理，按车站/区间组织分部分项 |
| 风水电及装饰装修—进度管理 / 办理 | /progress/progressReport/mep/progress（办理 .../progress/flowForm） | 同土建，views/business/progress/actualProgress/* | 按分部分项填报，提供单位工程 BIM 模型查看入口 |
| 车辆（二级目录） | /progress/progressReport/vehicle | — | 专业目录，profession=vehicle；仅线路维度，不提供包段/标段/单位工程选择 |
| 车辆—计划管理 / 年度与月度办理 | /progress/progressReport/vehicle/plan（办理 .../plan/{annual,monthly}/flowForm） | 同土建，views/business/progress/periodPlan/* | 台账与办理，不启用周计划入口 |
| 车辆—进度管理 / 办理 | /progress/progressReport/vehicle/progress（办理 .../progress/flowForm） | 同土建，views/business/progress/actualProgress/* | 按月或按节点填报，数据仅计入线路层汇总 |
| 信号（二级目录） | /progress/progressReport/signal | — | 专业目录，profession=signal |
| 信号—计划管理 / 三期次办理 | /progress/progressReport/signal/plan（办理 .../plan/{annual,monthly,weekly}/flowForm） | 同土建，views/business/progress/periodPlan/* | 台账与办理，含分部分项挂接关系维护 |
| 信号—进度管理 / 办理 | /progress/progressReport/signal/progress（办理 .../progress/flowForm） | 同土建，views/business/progress/actualProgress/* | 按挂接关系汇入对应标段/包段统计，提供模型查看入口 |
| 进度总看板 | /progress/progressReport/dashboard | views/business/progress/dashboard/index.vue | 只读看板：四层钻取、统计分析图表、平面完成图、参建单位筛选与穿透 |
| 倒排工期 / 办理 | /progress/progressReport/backward、.../backward/flowForm | views/business/progress/backward/{index,flowForm}.vue | 台账与办理，含冲突工序与冲突天数高亮、冲突提示关闭 |
| 进度纠偏（二级目录） | /progress/deviation | — | 二级菜单，占位目录 |
| 技术判断 | /progress/deviation/technicalJudge | views/business/progress/deviation/index.vue | 偏差识别结果、四色预警等级、成因分类与建议方向；支持一键发起纠偏问题 |
| 问题闭环 / 办理 | /progress/deviation/issue、/progress/deviation/issue/flowForm | views/business/progress/issue/{index,flowForm}.vue | 台账与办理，含多单位下发、指定单位响应、超期升级与关闭确认、闭环统计 |
| 难点卡点问题库 | /progress/deviation/difficultyLedger | views/business/progress/difficultyLedger/index.vue | 集中台账：分类、共性标识、督办标识、进展更新与状态标签、统计导出 |
| 难点卡点上报 / 办理 | /progress/deviation/difficultyReport、.../difficultyReport/flowForm | views/business/progress/difficultyReport/{index,flowForm}.vue | 按年度页签的上报台账与年度统计概览，审核通过后入库 |
| 督办台账（待 Q-PS-001 确认纳入） | /progress/deviation/supervise | views/business/progress/supervise/index.vue | 如纳入范围，提供牵头部门、总体目标、责任单位、进度安排、实际进度、按期推进情况与问题库归集视图 |
| 工序移交管理（二级目录） | /progress/handover | — | 二级菜单，占位目录 |
| 移交计划 | /progress/handover/plan | views/business/progress/handoverPlan/index.vue | 移交节点清单与计划跟踪；页内含移交表单模板与字段配置入口 |
| 移交工作 / 办理 | /progress/handover/work、/progress/handover/work/flowForm | views/business/progress/handoverWork/{index,flowForm}.vue | 台账与办理，按专业调取差异化表单，含检查记录、签认与缺陷联动 |
| 缺陷整改台账 / 办理 | /progress/handover/defect、/progress/handover/defect/flowForm | views/business/progress/handoverDefect/{index,flowForm}.vue | 台账与办理，含派发、整改回复、复查销项与统计 |
路由注册约定：
- 台账页路由由
SYS_MENU配置驱动生成，路径段与组件路径必须与菜单配置一致；菜单名称在后端权限表中与权限码逐字对应。 - 办理页为隐藏菜单，同时固定注册在
src/router/flowFormRoutes.ts与src/router/flowFormPaths.ts，路由名称与菜单生成名称不同，组件路径与SYS_MENU.COMPONENT保持一致；flowCode到办理路径的映射同步登记在src/api/workflow/workflowCommon/index.ts的flowCodeFormPathMap。该约定见公共开发约定 · 菜单命名与排序。 - 办理页菜单名统一为「流程定义名称 + 办理」，与对应业务台账同父菜单且紧跟其后，并授权给办理角色。
- 办理页数量草案：按当前流程候选方案，16 条候选定义对应 31 个办理页菜单；流程是否成立及最终数量待 Q-PS-018 确认。该估算包括网络进度计划 3 个、施组报审 2 个、设备资料管理 1 个、权重赋值 1 个、倒排工期 1 个、问题闭环 1 个、难点卡点上报 1 个、移交工作 1 个、缺陷整改 1 个；计划管理按期次在五个专业下各设办理页（土建、系统设备、风水电及装饰装修、信号各 3 个年度/月度/周，车辆 2 个年度/月度，共 14 个）与进度填报 5 个。
- 五个专业的计划管理与进度管理共用同一组组件，以路由参数与菜单配置区分专业；车辆专业按专业参数关闭周计划入口（Q-PS-013）。
4.1 页面级设计要点
- 网络计划台账按期次层级参数复用。 一级、二级、三级计划共用一套台账与办理页组件，以
level参数区分；层级约束校验的比对对象（上级节点集合）由参数决定，不按页面分叉实现（R-PS-014、R-PS-016）。 - 计划管理的期次切换。 计划管理台账页内按期次切换（年度/月度/周）；分部分项 WBS 划分与价格维护只在年度期次可编辑，月度与周期次由上级计划分解生成后允许调整（R-PS-036、R-PS-044、R-PS-049）。
- 「网络计划未基准化」标记的呈现。 三级网络计划未批准时编制年度计划，计划头与台账行均展示该标记与提示；三级计划批准后在看板与计划页提供校准比对入口，列出差异项（R-PS-042、R-PS-043）。
- BIM 模型查看入口的可用性。 进度管理页按分部分项与单位工程判断模型可用性：未挂接单位工程或该单位工程无已发布模型时不展示入口（R-PS-060、R-PS-063、需求 §6.2）。
- 进度总看板为只读。 看板不提供任何写入动作；下钻定位到的滞后分部分项由具备纠偏权限的角色跳转至纠偏页面发起（需求 §6.1、R-PS-092）。
- 平面完成图为图片底图加要素标注。 底图与车站、区间、辅助设施、关键单体结构的位置按配置维护，着色与百分比由进度计算驱动；各线路的铺轨进度平面图、甩项标签与难点卡点标签作为底图上的附加图层（R-PS-083、R-PS-088、R-PS-089、R-PS-090，口径见 Q-PS-008）。
- 移交表单按专业动态渲染。 移交工作办理页按所选专业与工序读取模板字段配置动态渲染检查项，校验规则随模板执行（R-PS-130、R-PS-131、Q-PS-012）。
5. 数据模型概览
| 表 | 职责 |
|---|---|
BIZ_PS_NETWORK_PLAN | 网络进度计划主表。承载一、二、三级计划的抬头、计划类型与层级、版本号、发布状态、发布单位与生效时间 |
BIZ_PS_NETWORK_PLAN_NODE | 网络计划节点。承载里程碑节点与工序节点、计划开始/完成时间、工期、节点类型、工程节点引用与快照、与上级节点的挂接 |
BIZ_PS_NETWORK_PLAN_LINK | 计划节点前置/后置搭接关系。承载前节点、后节点与搭接类型或间隔 |
BIZ_PS_SCHEME | 施组与专项方案主表。以方案类型区分施工组织设计、一般专项与危大专项，含工程节点引用、专项类型、流程状态 |
BIZ_PS_SCHEME_FILE | 方案文件明细。区分报审稿、正式版、专家论证意见等附件类型，记录版本与被替换的上一版本 |
BIZ_PS_WBS | 分部分项 WBS。含单位工程引用、统计归集节点引用（可空）、编码与名称、层级、计划起止、工程量与计量单位、综合单价与合价、未基准化标记；BIM 映射待重构方案确定 |
BIZ_PS_WBS_LINK | 分部分项前置/后置搭接关系。承载分部分项之间的依赖与间隔 |
BIZ_PS_PERIOD_PLAN | 年/月/周计划主表。以计划类型与专业区分，含期次（年度、年月、周次）、状态与未基准化标记 |
BIZ_PS_PERIOD_PLAN_ITEM | 计划明细。承载分部分项在本期次的计划工程量、计划起止时间与计划金额 |
BIZ_PS_PROGRESS_REPORT | 实际进度填报主表。以专业与期次区分，含填报单位、填报人、状态与审批结论 |
BIZ_PS_PROGRESS_ITEM | 实际进度明细。承载分部分项的实际完成工程量、完成比例、实际起止时间、形象进度描述与照片附件 |
BIZ_PS_MILESTONE | 里程碑节点。承载系统设备、信号、车辆专业的到货、安装、单机或单系统调试、联调联试等节点的计划与实际完成时间及关联分部分项 |
BIZ_PS_EQUIP_DOC | 设备资料。按设备与分部分项组织，含资料类型、版本、审核状态、审核意见与关联的到货或安装节点 |
BIZ_PS_EQUIP_DOC_FILE | 设备资料文件明细。承载每次上传或替换的文件与版本留痕 |
BIZ_PS_PROFESSION_WEIGHT | 专业权重配置。含专业或设备类别、权重值、生效时间、审批状态与调整记录 |
BIZ_PS_BACKWARD_PLAN | 倒排工期计划主表。含建设公司指令、所针对的工作内容与依据的三级计划节点、编制单位与流程状态 |
BIZ_PS_BACKWARD_PLAN_ITEM | 倒排工序明细。含工序、最迟开始/完成时间、责任人、资源投入、赶工措施、冲突标记与冲突天数 |
BIZ_PS_DEVIATION | 偏差技术判断记录。含来源工作内容或分部分项、偏差天数、偏差率、偏差等级、成因分类、建议方向、投资完成率与判断时间 |
BIZ_PS_RECTIFY_ISSUE | 纠偏问题主单。含问题描述、要求完成时间、发起单位与发起人、附件、流程状态与关闭确认信息 |
BIZ_PS_RECTIFY_TARGET | 纠偏问题下发与响应记录。逐接收单位记录是否指定响应、响应内容、承诺完成时间、实际响应时间与超期标记 |
BIZ_PS_DIFFICULTY_LEDGER | 难点卡点问题库台账。含建设单位、问题类别、进度状态、是否办结、协调事项、协调单位或部门、完成时限、是否共性、是否督办与督办类型、纳入时间、解决时间、详细情况、解决建议与备注 |
BIZ_PS_DIFFICULTY_REPORT | 难点卡点上报。含所属年度、建设单位、项目名称、进度状态、上报问题、附件、审核状态与审核意见 |
BIZ_PS_DIFFICULTY_TRACK | 难点卡点进展更新记录。承载多次「更新进度」的进展内容、更新人与更新时间 |
BIZ_PS_SUPERVISE_LEDGER | 候选表，仅当 Q-PS-001 确认纳入督办台账时建立。含项目名称或标段、牵头部门（含负责人与联系人）、总体目标、项目或业主、责任单位、进度安排、实际进度、是否按期推进与备注 |
BIZ_PS_SUPERVISE_NODE | 候选表，仅当 Q-PS-001 确认纳入督办台账时建立；承载一条督办记录下的重要节点/卡点难点明细 |
BIZ_PS_HANDOVER_PLAN | 移交计划节点。含线路/包段/标段/单位工程/专业/工序、计划移交时间、移交方与接收方单位、移交前置条件与状态 |
BIZ_PS_HANDOVER_TEMPLATE | 移交表单模板。按专业与工序维护模板抬头、启用状态与版本 |
BIZ_PS_HANDOVER_TEMPLATE_FIELD | 模板字段配置。含字段名称、类型、是否必填、校验规则与排序 |
BIZ_PS_HANDOVER_ORDER | 移交单。引用移交计划节点，含专业类型、申请信息、检查结论、签认结果、状态与进度回写标记 |
BIZ_PS_HANDOVER_CHECK | 移交检查记录明细。逐检查项记录检查结果与备注 |
BIZ_PS_HANDOVER_SIGN | 移交签认记录。按移交方、接收方、监理分别记录签认结果、签认人与时间 |
BIZ_PS_DEFECT | 缺陷整改台账。含缺陷编号、标段与单位工程与部位、专业、描述与照片、缺陷等级、责任单位、整改期限、整改状态、复查人与复查时间、关联移交单 |
BIZ_PS_DEFECT_REPLY | 缺陷整改回复记录。承载多次整改回复的说明、附件与提交时间 |
设计要点：
- 分部分项 WBS 是唯一进度数据底座。 计划（年度/月度/周）明细、实际进度明细、各级完成率与完成产值、看板统计均以
BIZ_PS_WBS为最小单元，不维护第二套统计口径（R-PS-037、R-PS-058、R-PS-080）。 - 统计归集节点以可空引用表达专业差异。
BIZ_PS_WBS持有一个可空的统计归集工程节点引用：土建与风水电指向单位工程（必填）；系统设备与信号可指向包段、标段或单位工程，也可暂不挂接；车辆不挂接。未挂接的数据仅计入线路层，挂接数据按挂接节点的祖先链向上汇总（R-PS-030 至 R-PS-034、R-PS-063、R-PS-064）。 - 计划期次共表分型。 年度、月度、周计划共用主表与明细表，以计划类型与专业区分，避免三套同构结构；菜单与权限仍按「专业—计划管理」与期次办理页独立配置，权限粒度不因数据模型收紧（R-PS-036、R-PS-044、R-PS-048）。
- 看板不建统计快照表。 看板指标由分部分项计划与实际明细实时聚合，周期任务只做预汇总缓存；平面完成图的底图与要素位置按配置维护，着色由进度计算驱动（R-PS-091、Q-PS-008）。
- 流程单据必带流程状态。 有流程的主单保存流程实例关联与
wf_business_status状态；业务规则、进度总看板、技术判断、难点卡点问题库、移交计划等无流程能力不设置流程状态字段。督办台账如纳入范围，按无流程台账处理（需求 §5.12、Q-PS-001、Q-PS-018）。 - 两套统计口径并存且可区分。 按价格加权的完成率（土建、风水电等）与按权重的综合完成率（系统设备）分别计算并在看板分列展示，不互相替代（R-PS-058、R-PS-066、R-PS-074）。
- 引用而非复制工程属性。 台账只保存工程节点 ID 与名称/路径快照，不从工程树复制业务属性；参建单位筛选使用节点信息表的文本字段值，不新增单位实体（S-PS-005、Q-PS-010）。
- 构件绑定对接待确定。 BIM 旧版能力已移除，存储和接口边界待重构方案明确（S-PS-008、Q-PS-009）。
- 价格信息本期自维护。 综合单价与合价由本模块在分部分项上维护并支持批量导入，与造价系统的自动取数按接口另行确定（Q-PS-003、D-PS-013）。
字段矩阵、主外键、唯一约束、索引与字典值在数据库设计文档中给出。本模块当前只交付需求分析与概要设计，数据库设计、详细设计、测试与验收、操作手册四类按软件交付文档在实现推进过程中逐步建立，不用空文件凑齐数量。
6. 流程概览
6.1 流程分类树
现状：开发库 FLOW_CATEGORY 没有「工程进度监管」分类节点（S-PS-007），需新建。分类树按模块的页面层级建立，流程定义名称使用该分类下同名叶子名称，不重复拼接上级分类名（见公共开发约定 · 流程分类与定义命名）：
text
工程进度监管
├── 网络进度计划
│ ├── 一级网络计划
│ ├── 二级网络计划
│ ├── 三级网络计划
│ └── 业务规则
├── 施组报审
│ ├── 施工组织设计
│ └── 施工专项方案
├── 施工进度报审
│ ├── 土建、系统设备、风水电及装饰装修、车辆、信号
│ │ ├── 计划管理（年度、月度；周计划按专业确认）
│ │ └── 进度管理
│ ├── 系统设备—设备资料管理
│ ├── 系统设备—权重赋值
│ ├── 进度总看板
│ └── 倒排工期
├── 进度纠偏
│ ├── 技术判断
│ ├── 问题闭环
│ ├── 难点卡点问题库
│ ├── 难点卡点上报
│ └── 督办台账（待 Q-PS-001 确认纳入）
└── 工序移交管理
├── 移交计划
├── 移交工作
└── 缺陷整改6.2 流程定义候选清单
以下候选流程根据交底文档中的「审批」「审核」「核查」描述整理，流程是否使用 Warm-Flow、是否存在固定表单流程及准确节点仍待 Q-PS-018 等事项确认。流程确认后，定义 JSON 落在 digital-construction-modules/digital-construction-workflow/src/main/resources/flow/progress/<flowCode>_v1.json，编码保持稳定。
| # | 流程编码 | 流程定义名称 | 所属二级域 | 发起方式 | 节点链路 |
|---|---|---|---|---|---|
| 1 | progress_l1_network_plan | 一级网络计划 | 网络进度计划 | 交通开投集团经办人在业务台账提交 | 开始 → 交通开投集团经办人（编制并发布一级网络计划）→ 审批 → 结束（发布生效，关键节点作为下级基准） |
| 2 | progress_l2_network_plan | 二级网络计划 | 网络进度计划 | 交建公司技术管理部（总工办）经办人提交 | 开始 → 技术管理部（总工办）经办人（编制二级网络计划，与一级关键节点挂接）→ 审批 → 结束 |
| 3 | progress_l3_network_plan | 三级网络计划 | 网络进度计划 | 项目建设分公司或系统设备分公司经办人提交 | 开始 → 项目建设分公司或系统设备分公司经办人（编制三级网络计划，细化到工序与搭接关系）→ 审批 → 结束 |
| 4 | progress_construction_org | 施工组织设计 | 施组报审 | 施工单位项目技术负责人在业务台账提交 | 开始 → 项目部内审 → 公司技术部门审核 → 施工单位技术负责人审批盖章 → 专业监理审查 → 总监理工程师签字盖章 → 建设单位确认备案 → 交底实施、归档（开放正式版附件上传）→ 结束 |
| 5 | progress_special_scheme | 施工专项方案 | 施组报审 | 施工单位项目技术负责人在业务台账提交 | 开始 → 项目部内审 → 公司技术部门初审 → 条件分支：一般专项直接进入施工单位技术负责人审批盖章；超过一定规模的危大工程先经专家论证会（附件上传）→ 按专家意见修改完善 → 施工单位技术负责人重新审批盖章 → 专业监理审查 → 总监理工程师签字盖章 → 建设单位确认备案 → 交底实施、归档 → 结束 |
| 6 | progress_annual_plan | 年度计划 | 施工进度报审 | 施工单位项目技术负责人在计划管理台账按年度期次提交（专业为表单参数） | 开始 → 施工单位项目技术负责人（编制年度计划并完成分部分项划分与价格维护）→ 专业监理工程师审核 → 建设单位审批 → 下达执行 → 结束 |
| 7 | progress_monthly_plan | 月度计划 | 施工进度报审 | 施工单位项目技术负责人在计划管理台账按月度期次提交 | 开始 → 施工单位项目技术负责人（由年度计划分解并调整本月计划）→ 专业监理工程师审核 → 建设单位审批 → 执行并反馈上月完成情况 → 结束 |
| 8 | progress_weekly_plan | 周计划 | 施工进度报审 | 施工单位项目技术负责人在计划管理台账按周期次提交（车辆专业不启用） | 开始 → 施工单位项目技术负责人（由月度计划分解本周计划）→ 专业监理工程师核查 → 执行并反馈上周完成情况 → 结束 |
| 9 | progress_actual_report | 进度填报 | 施工进度报审 | 施工单位填报人在进度管理台账提交（专业为表单参数） | 开始 → 施工单位填报人（按分部分项填报实际完成，系统设备与信号专业同时登记里程碑节点实际完成时间）→ 专业监理工程师审核或核查 → 条件分支：车辆与信号专业增加建设单位确认 → 数据进入形象进度计算与看板 → 结束 |
| 10 | progress_equipment_doc | 设备资料管理 | 施工进度报审 | 供货单位或施工单位经办人在设备资料台账提交 | 开始 → 供货单位或施工单位经办人（按设备提交资料）→ 专业监理工程师审核 → 建设单位审核确认 → 归档并更新资料状态为已确认 → 结束 |
| 11 | progress_weight_config | 权重赋值 | 施工进度报审 | 建设单位（或总体咨询单位）经办人在权重赋值页发起调整 | 开始 → 建设单位（或总体咨询单位）经办人（配置或调整专业权重，保存校验合计 100%）→ 审批 → 生效并保留调整记录与生效时间 → 结束 |
| 12 | progress_backward_plan | 倒排工期 | 施工进度报审 | 施工单位项目技术负责人在倒排工期台账提交（或由系统预警后发起） | 开始 → 施工单位项目技术负责人（按剩余可用工期反推各工序最迟开始/完成时间与赶工措施，保存或提交时逐工序比对并高亮冲突）→ 专业监理工程师审核 → 建设单位审批 → 按倒排计划执行并跟踪 → 冲突消除后归档 → 结束 |
| 13 | progress_rectify_issue | 问题闭环 | 进度纠偏 | 监理单位或建设单位发起人在问题闭环台账发起 | 开始 → 发起人（填写问题描述、下发多家单位与要求完成时间、上传附件）→ 指定单位响应并回复处理措施与完成时间 → 专业监理工程师或建设单位核查确认 → 关闭并纳入纠偏台账 → 结束 |
| 14 | progress_difficulty_report | 难点卡点上报 | 进度纠偏 | 参建单位经办人按年度在难点卡点上报台账提交 | 开始 → 参建单位经办人（按年度填报上报问题与附件）→ 建设单位审核 → 审核通过后自动纳入难点卡点问题库台账 → 责任单位持续更新进展 → 问题解决办结 → 结束 |
| 15 | progress_handover_work | 移交工作 | 工序移交管理 | 移交方经办人在移交工作台账按移交计划节点发起 | 开始 → 移交方经办人（发起移交申请并选择专业类型）→ 移交双方与监理（按专业差异化表单现场检查并记录，缺陷一键记入缺陷整改台账）→ 接收方签认 → 监理签认 → 归档并回写进度数据 → 结束 |
| 16 | progress_defect | 缺陷整改 | 工序移交管理 | 检查发现缺陷后登记并派发，或责任单位在缺陷整改台账登记后提交 | 开始 → 登记并派发至责任单位 → 责任单位整改并回复 → 监理或接收方复查 → 条件分支：合格销项；不合格退回继续整改 → 全部缺陷销项后移交签认通过 → 结束 |
无流程的业务：业务规则（仅规则说明与管理办法在线查阅，R-PS-014、R-PS-141）、进度总看板（只读统计，R-PS-077 至 R-PS-092）、技术判断（偏差识别与等级判定为计算结果，纠偏问题另行发起，R-PS-103）、难点卡点问题库（台账与进展更新，R-PS-110 至 R-PS-114）、移交计划与模板（清单维护与模板配置，R-PS-125 至 R-PS-128、R-PS-131）。督办台账如按 Q-PS-001 纳入，按无流程台账处理（R-PS-120 至 R-PS-124）。
6.3 流程设计原则
- 每个候选流程的节点链路以交底文档「业务流程」为基础（R-PS-017、R-PS-023、R-PS-024、R-PS-041、R-PS-046、R-PS-050、R-PS-056、R-PS-068、R-PS-075、R-PS-093、R-PS-097、R-PS-105、R-PS-117、R-PS-129、R-PS-137）；链路中仅出现「审核」「核查」「备案」而未列明节点角色的环节，目前只整理候选审批节点；须先由 Q-PS-018、Q-PS-019 确认是否建流程及节点承担方式，再在详细设计定稿。
- 五个专业共用同一组计划与进度流程定义，专业作为表单参数由页面带入；专业间的链路差异（周计划是否启用、是否需建设单位确认）用条件分支或入口开关处理，不为每个专业各建一套同构流程（D-PS-003、R-PS-035、R-PS-065）。
- 危大工程分支与缺陷复查分支使用平台条件分支能力，参照工程手续办理的既有做法（S-PS-009）。
- 流程节点办理人一律选人办理，不引入按部门自动派发的新机制。
- 平台默认开启除委托、终止外的标准流程操作权限，不额外收紧。
- 倒排工期的冲突识别在保存与提交两个时点执行，冲突为计算结果而非流程分支；冲突提示的关闭不改变流程状态（R-PS-096）。
7. 核心运行流程与状态模型
事务与幂等边界：
- 主单与明细（计划明细、进度明细、里程碑节点、资料文件、检查记录、签认记录、缺陷回复、督办节点）在同一事务内保存；保存失败整体回滚，不产生只有主单或只有明细的半成品记录。
- 流程启动与状态回写分离：台账提交成功后再启动流程实例，流程事件回写单据状态；状态回写以流程实例当前状态为准，重复事件不改变终态。
- 无流程能力（看板、技术判断、问题库、移交计划与模板）不产生待办，登记完成即为可用状态；督办台账若按 Q-PS-001 纳入，也按无流程台账处理。
- 期次汇总（周→月→年）与各级完成率在同一事务边界内按明细重算，不依赖上一次的汇总结果累加，避免重复提交导致累计偏差。
状态模型（复用平台字典 wf_business_status，S-PS-003）：
| 状态 | 进入条件 | 允许角色 | 可执行动作 | 离开条件 |
|---|---|---|---|---|
草稿 draft | 新增或编辑保存，未提交 | 发起角色本人 | 编辑、删除、上传附件、提交 | 提交进入待审核 |
待审核 waiting | 提交成功、流程实例已启动 | 当前节点办理人 | 审核通过、驳回、流程图查看、审批历史、下载 | 末节点办结进入已完成；驳回进入已退回 |
已退回 back | 任一办理节点驳回 | 发起角色本人 | 编辑、上传附件、重新提交 | 重新提交回到待审核 |
已完成 finish | 末节点办结 | 数据范围内查看人员 | 查看详情、导出、下载、流程图查看、审批历史 | 终态 |
已作废 invalid / 已终止 termination / 已撤销 cancel | 平台流程操作触发 | 具备对应流程操作权限的角色 | 查看 | 终态 |
业务状态字段（不参与流程状态）：分部分项的「网络计划未基准化」标记与滞后高亮（R-PS-042、R-PS-059）；纠偏问题的待响应、处理中、待确认、已关闭（R-PS-106）；缺陷的待整改、整改中、待复查、已销项（R-PS-138）；难点卡点问题库的进度状态标签（R-PS-113）；督办台账若纳入范围，则增加其进度状态及是否按期推进（R-PS-121、R-PS-123）；资料状态（R-PS-070）。
8. 接口职责概览
| 能力 | 调用方 | 接口职责 | 关键输入/输出对象 | 权限边界 |
|---|---|---|---|---|
| 网络计划台账与节点维护 | 一、二、三级网络计划页 | 分页查询、详情、新增、编辑、删除、导出、提交、导入校验、版本与差异对比、层级约束校验 | 网络计划主表与节点、搭接关系 | progress:networkPlanL1:*、progress:networkPlanL2:*、progress:networkPlanL3:* |
| 业务规则查询 | 业务规则页 | 规则口径查询与管理办法文档读取 | 规则说明、管理办法文档 | progress:networkPlanRule:* |
| 施组与专项方案台账 | 施组报审页 | 查询、详情、新增、编辑、删除、导出、提交、附件上传与版本替换 | 方案主表与文件明细 | progress:constructionOrg:*、progress:specialScheme:* |
| 分部分项 WBS 维护 | 计划管理页（年度期次） | 按单位工程查询、自动拆分、新增、复制、批量导入、价格维护、挂接关系维护、BIM 任务映射 | 分部分项 WBS 与搭接关系 | 按专业的计划管理资源，如 progress:civilPlan:*、progress:systemPlan:* |
| 计划台账与明细 | 计划管理页（各专业与期次） | 查询、详情、新增、编辑、删除、导出、提交、由上级计划分解、未基准化标记与校准比对 | 计划主表与计划明细 | 按专业与功能点一一对应：progress:civilPlan:*、progress:systemPlan:*、progress:mepPlan:*、progress:vehiclePlan:*、progress:signalPlan:* |
| 实际进度填报 | 进度管理页 | 查询、详情、新增、编辑、删除、导出、提交、按分部分项填报、按里程碑节点登记、附件上传 | 进度填报主表与进度明细、里程碑节点 | 按专业与功能点一一对应：progress:civilProgress:*、progress:systemProgress:*、progress:mepProgress:*、progress:vehicleProgress:*、progress:signalProgress:* |
| 形象进度统计 | 进度管理页、进度总看板 | 各级完成率与完成产值计算、综合完成率计算、偏差天数与偏差率计算、分部分项至线路的逐级汇总 | 分部分项、计划与实际明细、权重配置 | progress:dashboard:*，另按专业取 progress:civilProgress:list、progress:systemProgress:list、progress:mepProgress:list、progress:vehicleProgress:list、progress:signalProgress:list |
| 进度总看板 | 进度总看板页 | 四层钻取统计查询、统计图表数据、平面完成图数据与穿透明细、参建单位筛选统计 | 分层统计指标、图表数据、平面完成图要素与着色 | progress:dashboard:*（只读） |
| 设备资料管理 | 设备资料管理页 | 查询、详情、新增、编辑、删除、导出、提交、分类与批量上传、版本替换、在线预览与下载（下载留痕）、缺失资料待办 | 设备资料主表与文件明细 | progress:equipmentDoc:* |
| 权重赋值 | 权重赋值页 | 查询、详情、新增、编辑、删除、合计校验、提交、生效与历史口径查询 | 专业权重配置 | progress:professionWeight:* |
| 倒排工期 | 倒排工期页 | 查询、详情、新增、编辑、删除、导出、提交、逐工序比对与冲突识别、冲突提示关闭、预警工作内容查询 | 倒排主表与工序明细 | progress:backwardPlan:* |
| 偏差技术判断 | 技术判断页 | 偏差识别结果查询、偏差等级与成因分类登记、建议方向、一键发起纠偏 | 偏差判断记录 | progress:deviation:* |
| 纠偏问题闭环 | 问题闭环页 | 查询、详情、发起、编辑、删除、导出、多单位下发、指定单位响应、整改回复、核查确认、关闭、超期与闭环统计 | 问题主单与下发响应记录 | progress:rectifyIssue:*、progress:rectifyIssue:process |
| 难点卡点问题库 | 难点卡点问题库页 | 查询、详情、新增、编辑、删除、导出、共性标识与督办标识、进展更新、办结、统计 | 问题库台账与进展记录 | progress:difficultyLedger:* |
| 难点卡点上报 | 难点卡点上报页 | 查询、详情、新增、编辑、删除、导出、提交、按年度页签查询、年度统计概览、进度更新 | 上报记录与审核状态 | progress:difficultyReport:* |
| 督办台账（待 Q-PS-001 确认纳入） | 督办台账页 | 如纳入，按需求确认后的页面动作提供查询、归集、实际进度更新与统计 | 督办台账与节点明细 | progress:supervise:<已确认动作> |
| 移交计划与模板 | 移交计划页 | 节点清单查询、增删改、批量生成移交任务与表单、计划与实际对比、模板与字段配置、版本管理 | 移交计划节点、模板与字段 | progress:handoverPlan:* |
| 移交工作 | 移交工作页 | 查询、详情、发起、编辑、删除、导出、按专业调取表单、检查记录、签认、归档、进度回写 | 移交单、检查记录、签认记录 | progress:handoverWork:*、progress:handoverWork:process |
| 缺陷整改台账 | 缺陷整改台账页 | 查询、详情、登记、派发、整改回复、复查、销项、退回、导出、统计 | 缺陷台账与整改回复记录 | progress:defect:*、progress:defect:process |
| 流程办理与审批记录 | 流程工作台、业务台账 | 由平台统一提供待办、办理、流程图与审批历史 | 平台流程对象 | 平台流程权限 |
| 附件上传与下载 | 各业务页面 | 由平台统一提供上传、下载与预览 | FileUpload 附件结构 | 登录态 + 业务权限 |
| BIM 模型查看与构件高亮 | 进度管理页 | 目标为查看模型及高亮构件；旧版接口已移除，对接待重构 | 模型版本、构件绑定、着色映射 | 对应专业的进度管理权限；BIM 访问边界待定（Q-PS-009） |
| 投资完成率读取 | 技术判断 | 读取工程投资监管的投资实施完成率用于二级、三级阈值比对（口径见 Q-PS-007） | 期次完成率 | 本期未定 |
| AI 一体化管控平台 | 施组与专项方案、技术判断、移交工作 | 提供进度数据供其工效分析并获取分析结果；移交会议纪要由该平台 OCR 读取（本期是否实施见 Q-PS-004） | 进度数据、工效分析结果、会议纪要 | 接口级鉴权（非用户会话） |
| 造价平台（二期） | 进度管理 | 提供进度相关数据供其验工计价精准匹配（本期是否实施见 Q-PS-005） | 已完工进度数据 | 接口级鉴权（非用户会话） |
接口路径、参数校验与响应结构在详细设计中展开；本模块尚未建立该文件。
9. 权限与安全边界
- 权限码：采用
progress:<资源>:<动作>三段式。资源段建议按 §1.4 的 27 项功能清单映射；supervise为候选资源，仅在 Q-PS-001 确认纳入督办台账后加入。其他建议资源为：networkPlanL1、networkPlanL2、networkPlanL3、networkPlanRule；constructionOrg、specialScheme；civilPlan、civilProgress、systemPlan、systemProgress、equipmentDoc、professionWeight、mepPlan、mepProgress、vehiclePlan、vehicleProgress、signalPlan、signalProgress、dashboard、backwardPlan；deviation、rectifyIssue、difficultyLedger、difficultyReport；handoverPlan、handoverWork、defect。动作段与流程、业务动作以确认的页面范围、流程和角色为准；权限码在后端@SaCheckPermission、SYS_MENU的PERMS与前端v-hasPermi三处逐字一致。共用组件不合并权限，五个专业的计划与进度权限按专业独立授予（D-PS-003、D-PS-017）。 - 菜单：一级「工程进度监管」，二级建议按网络进度计划、施组报审、施工进度报审、进度纠偏、工序移交管理五个域组织；施工进度报审按五个专业设专业目录。页面层级与路由为概要方案，须在 Q-PS-001、Q-PS-018 确认范围与流程后定稿。按当前候选流程估算 16 条定义、31 个办理页，不作为已确认数量；流程办理页如获确认，按平台隐藏菜单约定注册。
- 数据范围：假设按工程范围授权过滤（线路、包段、标段、单位工程节点及其子树），叠加角色数据范围中的部门与创建人维度；不做组织单位维度的额外隔离。车辆专业仅按线路维度管理，其数据范围以线路节点授权为准。看板按同一口径过滤，按参建单位管理范围的筛选口径见 Q-PS-010（需求 §6.1）。
- 服务端强制：前端隐藏按钮只负责呈现，不能代替鉴权，也不能绕过只读和数据范围限制；列表、详情、统计、看板、穿透明细与导出接口均在服务端校验权限与数据范围。
- 看板与只读：进度总看板为只读能力，接口层不提供写入动作；只读查看不因缺少编辑权限而失效，反之亦然。
- 敏感数据处理：本模块不采集个人敏感信息；施组与专项方案文件、设备资料、会议纪要与证明材料按业务需要留存，导出文件不携带超范围数据。
- 审计记录：计划版本与调整、权重配置与生效、设备资料版本替换、进度填报与审批、偏差判断与纠偏响应、移交签认与缺陷复查、督办进展更新均留痕办理人、部门、时间与节点；看板与台账的导出行为记录日志。
- 文件保护：方案文件、设备资料、检查附件与现场照片按平台附件规则存储与鉴权访问，不生成公开直链；附件下载走平台权限校验。
10. 异常、事务与幂等
- 层级与逻辑校验失败：二级或三级计划节点突破上级节点、三级工序逻辑倒置、必填节点与工期缺失、月度或周计划的分部分项不属于上级计划时拒绝保存或提交，保持草稿状态并提示具体冲突项（R-PS-014、R-PS-011、需求 §6.2）。
- 未基准化状态下的放宽：三级网络计划未批准时允许编制年度计划并标记「网络计划未基准化」，此时不做层级约束拦截；三级计划批准后提供校准比对并列出差异项（R-PS-042、R-PS-043）。
- 权重合计校验：权重保存与提交时校验合计为 100%，不满足时拒绝并提示差额；校验在服务端执行，不依赖前端校验（R-PS-073）。
- 加权计算的数据缺口：分部分项缺失价格信息时降级为以完成比例作为权重参与汇总，不中断整级计算，并在结果中标记该分部分项；不因单点数据缺口返回空结果或异常（需求 §6.2）。
- 暂存与提交分离：草稿不启动流程实例，明细可反复编辑；提交时整单校验后一次性落库并启动流程。
- 并发与重复提交：同一单据的提交、审核、复核、确认、签认、复查等写操作以流程当前状态与当前办理人为准，非当前办理人或状态不匹配时拒绝，返回明确提示。
- 汇总幂等：期次汇总与各级完成率按明细重算并覆盖，重复提交同一期次不产生叠加误差；同一分部分项在同一期次只保留一条有效计划明细与一条有效进度明细。
- 流程事件幂等：流程通过或退回事件回写单据状态时，终态不可被重复事件覆盖；同一流程实例的重复事件不产生重复审批记录。
- 冲突提示与统计的一致性：倒排工期的冲突记录随比对结果刷新，冲突关闭只标记提示状态、不影响流程状态；难点卡点问题库与督办台账之间的归集关系以问题库记录为准，重复归集不产生重复台账行（R-PS-096、R-PS-122）。
- 外部依赖不可用：AI 一体化管控平台、造价平台（二期）与 OA 接口不可用时不阻塞本模块的计划与进度录入、审批与统计；工效分析结果缺省为空，技术判断按其可得数据执行并在记录中标明数据来源（R-PS-142、需求 §6.2）。
- BIM 模型不可用：单位工程无已发布模型版本或未绑定构件时，模型查看入口不展示；进度数据展示与统计不受影响（R-PS-060、需求 §6.2）。
- 事务回滚边界：主单与明细同事务；文件上传与业务落库分离，文件上传失败时不产生业务记录，业务落库失败时留存的附件按平台能力清理。
- 日志、审计与告警：权限拒绝、数据范围外访问、统计接口异常与外部接口调用失败记录日志；本模块不新增独立告警通道，超期类提醒复用平台通知。
11. 外部依赖与兼容性
| 依赖 | 用途 | 复用方式 | 失败处理 | 兼容性要求 |
|---|---|---|---|---|
| Warm-Flow 工作流平台 | 流程定义装载、待办与办理、流程图、审批历史、条件分支 | 平台统一提供，本模块只落流程定义 JSON 与事件回写 | 以流程状态为准，回写失败可重试 | 固定表单流程约定；流程定义 JSON 遵循流程图编排规范 |
| 平台权限体系 | 菜单、按钮与接口鉴权 | 复用 | 拒绝并记日志 | 三段式权限码，三处逐字一致 |
| 工程树与工程范围授权 | 工程节点选择、名称/路径快照、数据范围、看板钻取层级 | 只读引用 + 快照 | 节点失效时保留历史快照展示 | 不修改工程树与工点主数据；兼容 LINE 下直接含 BID 或 SITE 的跳层结构 |
| 平台附件存储 | 方案文件、设备资料、检查附件、会议纪要与现场照片 | 复用 | 提示重试，不产生半成品记录 | 附件结构统一 |
| 平台通知 | 超期提醒、升级提示、节点临近提醒、缺失资料待办 | 复用 | 通知失败不阻塞业务动作，记录日志 | 站内通知统一口径 |
| SnailJob 周期任务 | 「预计超期」预警、期限与节点临近提醒、看板统计预汇总 | 复用 | 任务失败下轮重试，不影响在线业务 | 沿用既有执行器方式 |
| 平台字典 | 单据状态、专业、计划期次、里程碑节点类型、资料类型、偏差等级与成因分类、问题类别与进度状态、督办类型、缺陷等级、移交专业类型 | 复用 wf_business_status 与 biz_node_type，新增 progress_* 字典 | 字典缺失时按空值展示并记录 | 逻辑类型，值用英文小写 |
| BIM 域（模型与构件绑定） | 模型查看和构件高亮 | 旧版接口已移除，待重构明确 | 暂不可依赖旧接口 | 见 Q-PS-009 |
| 工程投资监管 | 投资完成率用于二级、三级预警阈值比对 | 跨模块读取（方式待定） | 未提供口径时该条阈值按人工判断处理并留痕 | 见 Q-PS-007 |
| AI 一体化管控平台 | 工效分析结果获取、移交会议纪要 OCR | 新增接口（本期是否实施见 Q-PS-004） | 结果缺省为空，不阻塞业务 | 字段映射与鉴权方式待核对 |
| 造价平台（二期） | 进度已完工与未计价数据贯通 | 新增接口（本期是否实施见 Q-PS-005） | 本期不实现 | 待对方建设节奏确定 |
| OA 系统 | 审批流程后挂接盖章流程 | 可选衔接（本期是否实施见 Q-PS-006） | 本期不做，签章线下完成 | 待核对 |
FLOW_CATEGORY 流程分类树 | 流程归类与办理页归属 | 新建「工程进度监管」分类树 | 分类缺失时流程不可发布 | 不改动既有分类节点 |
数据库设计使用逻辑类型，不绑定单一厂商类型。
12. 关键设计决策与待确认事项
12.1 本次设计决策
| 编号 | 决策 | 依据 |
|---|---|---|
| D-PS-001 | 分部分项 WBS 作为唯一进度数据底座，计划明细、实际明细、各级完成率与完成产值、看板统计均以其为最小单元 | 交底§2.3.1.1「分部分项 WBS 是 BIM 模型绑定、施工进度填报、形象进度计算的共同基础」（R-PS-037） |
| D-PS-002 | 网络计划按三个层级设三个资源与三个菜单，页面组件按期次层级参数复用 | 三级的编制主体与审批归属不同（R-PS-006、R-PS-008、R-PS-010），权限粒度需与层级对齐；页面结构同构（R-PS-013） |
| D-PS-003 | 五个专业共用同一组计划与进度流程定义与组件，专业作为表单参数，专业差异用条件分支或入口开关处理 | 交底§2.3 各专业统一设置计划管理与进度管理；避免 15 条同构流程与重复组件（R-PS-027、R-PS-035、R-PS-065） |
| D-PS-004 | 年、月、周计划共用主表与明细表，以计划类型与专业区分；菜单与权限按专业与期次独立配置 | 三者业务行为同构（R-PS-036、R-PS-044、R-PS-048）；菜单独立保留权限粒度 |
| D-PS-005 | 统计归集节点以分部分项上的可空工程节点引用表达：土建与风水电必填单位工程，系统设备与信号可挂接包段/标段/单位工程或暂不挂接，车辆不挂接 | 交底§2.3 的挂接方式表与 §2.3.2.4、§2.3.4.4、§2.3.5.4 的统计口径（R-PS-030 至 R-PS-034、R-PS-063、R-PS-064） |
| D-PS-006 | 看板聚合按实际祖先链逐级向上汇总，不假设每一层都存在 | 工程树允许 LINE 下直接含 BID 或 SITE（S-PS-004）；交底§2.3.6 的四层钻取语义（R-PS-078、R-PS-081） |
| D-PS-007 | 进度总看板不建统计快照表，指标实时聚合、周期任务只做预汇总缓存 | 交底§2.3.6「数据随进度报审审批通过后自动刷新，无需手工维护」（R-PS-091） |
| D-PS-008 | 平面完成图采用图片底图加要素标注，不引入 GIS 空间分析 | 交底§2.3.6 的呈现方式为平面图式一屏呈现，非空间分析（R-PS-083、Q-PS-008） |
| D-PS-009 | 构件绑定与进度的对接方式待 BIM 重构方案确定 | 旧版 BIM 能力及数据表已移除（S-PS-008、Q-PS-009） |
| D-PS-010 | 单价与合价本期由本模块在分部分项上维护并支持批量导入 | 交底§2.3.1.1 要求分部分项含价格信息且用于产值汇总；平台当前无造价清单数据源（Q-PS-003） |
| D-PS-011 | 两套统计口径并存：按价格加权的完成率与按权重的综合完成率分别计算并分列展示 | 交底§2.3.1.4（价格加权）与 §2.3.2.6（权重 100% 与综合完成率）（R-PS-058、R-PS-066、R-PS-074） |
| D-PS-012 | 业务状态字段与流程状态分离：未基准化标记、滞后、问题与缺陷状态标签、是否按期推进均为业务字段 | 平台统一状态口径（S-PS-003）；业务结论不占用流程状态枚举（需求 §5.12） |
| D-PS-013 | 有流程能力与无流程能力按交底文档的业务流程是否含审核或审批节点区分；无流程能力不设流程状态字段、不产生待办 | 交底文档各功能点的业务流程描述；同级先例的台账类做法（Q-PS-018） |
| D-PS-014 | 移交表单模板与字段配置落在本模块，作为移交计划页内的配置入口，预置三套专业模板 | 交底§2.5.1 的模板工具与 §2.5.2、§3.5 的「可在后台进行配置维护、支持字段增删与校验规则设置」（R-PS-127、R-PS-131） |
| D-PS-015 | 如 Q-PS-001 确认督办台账纳入范围，则与难点卡点问题库分表并互通；督办可由问题库筛选归集或独立登记 | 交底§2.4.5（R-PS-122）；范围取决于 Q-PS-001 |
| D-PS-016 | 不新建独立通知通道，超期与临近提醒复用平台通知；周期预警由 SnailJob 承载 | 交底多处要求站内通知与自动提醒；平台既有通知与 SnailJob 能力（S-PS-009、R-PS-072、R-PS-096、R-PS-107、R-PS-139） |
| D-PS-017 | 权限码模块段取 progress，资源段按 27 项目录形成建议映射；督办台账资源仅在 Q-PS-001 确认纳入后加入 | 三段式权限码约定与现有模块段取值（S-PS-012）；清单差异见 Q-PS-001 |
12.2 待确认事项
本文不复制业务层待确认事项正文，统一在需求分析 · 待确认事项中维护。其中直接决定本设计结构的事项如下：
| 编号 | 对设计的影响 |
|---|---|
| Q-PS-001 | 决定菜单数量、权限码资源段数量与流程实现范围（进度纠偏是 4 项还是 5 项功能） |
| Q-PS-002 | 决定流程节点办理角色的授权对象与菜单归属，影响 16 条流程能否端到端验证 |
| Q-PS-003 | 决定分部分项表是否含价格字段及其维护入口，影响年度产值与各级完成率的计算结果 |
| Q-PS-004 | 决定外部依赖章节是否需要落地 AI 一体化管控平台的接口对接与鉴权设计，影响技术判断与移交台账的输入 |
| Q-PS-005 | 决定外部依赖章节是否需要落地造价平台（二期）对接 |
| Q-PS-007 | 决定技术判断是否需要跨模块读取工程投资监管的投资完成率，影响权限越权范围与失败处理 |
| Q-PS-008 | 决定平面完成图的底图与要素配置表是否存在，是本模块页面设计中最大的不确定点 |
| Q-PS-009 | 决定是否为构件绑定新建表与跨模块接口，影响进度管理页模型查看的实现路径 |
| Q-PS-010 | 决定看板筛选控件的形态与统计口径，影响越权验证范围 |
| Q-PS-011 | 决定数据范围口径，影响列表、详情、统计、看板与导出接口的过滤实现 |
| Q-PS-012 | 决定移交模板与字段数据模型的完整度，影响移交工作页能否按专业差异渲染 |
| Q-PS-013 | 决定周计划入口是否按专业开关参数化，影响菜单与专业参数的呈现方式 |
| Q-PS-014 | 决定权重赋值流程的办理角色与审批链，影响第 11 条流程定义的节点链路 |
| Q-PS-015 | 决定缺陷等级是否落为字典与移交签认准入的分支实现，影响缺陷表结构与第 16 条流程的分支设计 |
| Q-PS-016 | 决定甩项标签的数据来源，可能新增一张台账表 |
| Q-PS-018 | 决定流程定义及办理页的范围和数量，是菜单、权限码与路由设计的前置条件；当前 16 条定义、31 个办理页仅为候选方案 |
| Q-PS-019 | 决定施组与专项方案流程末节点的字段与附件要求，影响第 4 条与第 5 条流程的办理面板 |
| Q-PS-020 | 决定原型未逐项说明的附件必填、格式与数量限制，影响节点校验与办理面板 |
相关文档
- 需求分析：业务范围、规则条目、验收标准与待确认事项。
- 平台规则：软件交付文档、公共开发约定、业务地图、流程图编排规范。
- 同级先例：规划管理 · 概要设计、工程质量管理 · 概要设计。