主题
工程变更监管 · 详细设计文档
文档版本：1.10 ｜ 最近核对日期：2026-11-04
当前进展：施工单位 I 类需出图正式长链路已完成真实闭环；工程变更五条流程图已全部完成规范重排并发布（施工 V9、监理 V5、业主 V5、设计 V5、重新申报 V4，部门会签段统一横向轨道，文件名去掉版本后缀）；退回链路已完成「退回 → 重办 → 回到待审核」页面口径修复并实测；其他发起单位/类别和外部档案仍待专项
文档控制
| 项目 | 内容 |
|---|---|
| 模块名称 | 工程变更监管（本期范围：施工单位发起） |
| 关联需求分析 | 需求分析 |
| 关联概要设计 | 概要设计 |
| 关联数据库设计 | 数据库设计 |
| 关联代码版本 | 当前工作区；提交版本待定 |
| 编写/核对人 | Codex |
| 待确认事项 | 系统设备分支实际组织编码、工程档案中心同步 |
1. 页面、路由与交互
| 页面/组件 | 路由 | 进入条件 | 可见角色 | 主要操作 | 状态/异常反馈 |
|---|---|---|---|---|---|
| 施工单位工程变更 | /engineeringChange/construction | 一级菜单授权 | 施工单位经办及授权人员 | 查询、新增、暂存、修改、提交、办理 | 草稿/退回可编辑；审批中只读；越权由服务端拒绝；所有 I/II/III/IV 类在同一主流程内分支 |
| 监理单位工程变更 | /engineeringChange/supervision | 一级菜单授权 | 监理单位经办及授权人员 | 同上 | 已实现（2026-09 上线） |
| 业主单位工程变更 | /engineeringChange/owner | 一级菜单授权 | 业主单位经办及授权人员 | 同上 | 已实现（2026-09 上线） |
| 设计单位工程变更 | /engineeringChange/design | 一级菜单授权 | 设计单位经办及授权人员 | 同上，包含重报初步设计入口 | 已实现（2026-09 上线，含 engineeringChange:design:resubmit 按钮） |
| 工程变更综合统计 | /engineeringChange/statistics | 只读菜单授权 | 监管、领导及授权人员 | 只读查看指标卡、类别/月度/发起单位/线路图表与金额 TOP10 表 | 已实现（2026-11 上线）；数据经工程数据权限过滤，无写入动作 |
| 工程变更办理 | /engineeringChange/construction/flowForm | 待办或列表跳转 | 当前办理人及授权查看人员 | 查看表单、流程图、时间线、同意/退回/转办等 | 页面文案统一为“工程变更办理”；左表单右 SQE 时间线 |
办理路由作为对应业务台账的隐藏子菜单，使用同一父菜单并紧跟台账配置 order_num；隐藏菜单仍需配置顺序，以保持动态路由和页面标签顺序。监理、业主、设计三条办理路由按同一规则展开，四条路由 name 必须唯一；菜单文案统一为“工程变更办理”是本模块已确认的命名例外。
表单的金额单位为万元；申请人填写预计变更类型，正式类别由造价咨询估价后的服务端金额规则自动判断，类别不再用于选择施工单位流程定义。发起页不显示具体文书名称，附件统一使用通用附件入口。申请人首次填写的“发起单位/归属单位”只有一个业务概念，取值为“系统设备公司”或“分公司”，并驱动互斥分流；系统设备分支只有一个“系统设备经办”业务节点，实际经办人所属一部或二部决定办理归属。流程节点附件统一复用 Warm-Flow 流程附件能力，空附件不渲染，办理时上传后再展示；底层复用平台文件服务。
1.1 办理页 UI 约束
- 办理页名称统一为“工程变更办理”，四种发起单位使用不同路由，路由
name必须唯一； - 左侧只使用一个完整的
el-descriptions，按流程表单原型的阶段颜色分割，完整展示实际表单字段； - 左侧始终只读，节点没有的字段不显示，尚未填写的实际字段显示“待填写”；
- 表单中的日期只显示年月日；右侧时间线完全沿用 SQE 的组件、布局和年月日时分秒格式；
- 右侧操作仍使用 SQE 标准流程区；同意/退回弹窗根据当前节点动态显示字段、金额、选项、表单附件和流程附件；
- 左侧完整表单始终只读，不承载当前办理的输入控件；当前办理字段只出现在同意或退回弹窗中。同意弹窗仅在当前节点需要时展示金额、是否出图或最终核价金额，并提供快捷意见；
- 退回弹窗仅包含退回节点、退回意见、可选流程附件及签名/日期展示，不复用同意专用的下一审批人、金额、出图或最终核价字段；
- 右侧时间线完整展示，不折叠历史节点；
- 弹窗按钮统一为
取消、预览、同意或退回。预览只临时改变左侧只读表单的显示，不产生正式业务状态、办理记录或时间线事件； - 只有正式点击
同意或退回才保存当前节点数据，签名图片优先，无图片时使用系统电子签名文本，并自动带入当天表单日期； - 发起表单复用流程表单的基础字段布局，但只展示到“工期影响（天）”，其中分部（子分部）工程名称由发起人手动填报，施工单位、设计单位、监理单位从系统参建单位中选择，申请日期、原估算投资由发起人填写，原施工图号选填；实际工程名称由单位工程路径带出后允许继续编辑，变更标题由实际工程名称自动生成。参建单位仍以名称快照写入工程变更主表，不新增单位 ID 字段。合同金额、变更后合同金额仅施工单位发起时填写并必填；设计、监理、业主及重新申报发起表单不显示，历史单据有值时只读显示。
- 分公司负责人、设计部经办人在领导审批前填写“流程概述”，两节点均必填，后填节点覆盖前值；内容展示在基础表单底部、首个办理人签名卡片上方，独占一行，办理预览时回显当前填写值。
- 除领导审批节点外，其余流程节点复用 Warm-Flow 流程附件能力；领导审批节点不提供附件上传入口，服务端拒绝领导节点提交的非空流程附件，历史已上传附件仍只读展示。未上传附件时不展示附件区域，节点办理上传后才在完整表单中显示。
- 全量表单对未经过和待判定的阶段/分组默认折叠，标注“本次不适用”或“待判定”；已办理、当前和待办理环节默认展开；提供单段展开/收起及“展开全部/收起全部”。折叠只改变展示，不改变节点记录和审批数据。
- 节点状态按当前待办优先于历史办理记录计算。相同节点经退回再次成为当前待办时，卡片显示“待我办理”，不回显上一轮的签名、意见、办理日期、特殊动作值或附件。
- 工作台通过路由完整地址监听重新加载；从列表、我的任务或流程监控跳转前清除目标页缓存，返回前清除上一页缓存，避免首次点击只改地址而不加载对应待办，以及已办任务在外围列表残留可办理入口。
1.2 流程图展示与定义布局
- 平台通用的 JSON 坐标、四向锚点、阶段排布、文案上限、边标签和版本核验规则，以 Warm-Flow 流程图 JSON 编排规范为唯一事实源；
- 施工单位流程只维护一个主流程定义，I/II/III/IV 类在流程内部通过服务端可信变量分支；四类发起单位分别维护各自的主流程定义，不按金额类别复制流程；
- “系统设备公司/分公司”使用申请人首次填写的发起单位归属变量，通过互斥网关选择一条路径；分公司负责人后使用包容网关，技术部边仅在 I 类进入，工程部、成本合约部、设计部边为必选分支；
- 包容网关选中的分支同时生成待办，汇聚节点只等待实际选中的分支完成；退回到部门审核前的节点时按当前类别重新生成三条或四条分支，不允许只重置单个并行分支；
- 动态退回不绘制从当前节点到所有前置节点的静态连线，退回目标、办理人和意见在办理弹窗及时间线中体现。
- 工作流事件在推进后同时携带刚完成任务的来源节点编码/名称；工程变更业务监听器优先使用该来源节点解析
engineeringChangeAction，避免事件对象的nodeCode已指向新生成的下一待办时把本次 action 写入错误节点。来源节点缺失或 action 节点仍不一致时继续严格拒绝，不用前端隐藏按钮替代服务端校验。CompletePrepareComponent对 Warm-Flow 可选网关的“跳转条件不能为空”异常仅做受限延后处理，其他流程异常继续抛出。 - 当前基线定义源文件为
digital-construction-modules/digital-construction-workflow/src/main/resources/flow/engineering-change/engineering_change_construction.json（工程变更五个流程文件 2026-09-27 起去掉_v1版本后缀，文件内容即当前发布布局，导入版本由后端按 flowCode 自动递增，文件名不参与版本管理）：部门审核区采用技术、工程、成本、设计四条独立泳道；成本泳道保留三办理节点；四条路径在department_join汇聚。I/II/III/IV 分类网关各自从不同锚点出线，避免同一路径叠线； - 系统设备公司路径、分公司 I/II 类完成路径和部门汇聚路径均已按四向锚点重新布线，不允许线路穿过无关节点。2026-09-26 按流程图编排规范重出图（V2），并按标签定位复核结果重发为 V3：节点按 CLASSICS 设计器尺寸（办理节点 100 × 80、开始/结束半径 25）重排行距并吸附四向锚点，消除全部交叉、飘线与长共用段（保留分支出口 ≤70px 短共段），
department_gateway、class_gateway等高扇出节点改由不同锚点出线；六个超长节点名称按 7 字/3 行精简（如「总包单位审核（如有）」→「总包单位审核」、「技术管理部（总工办）/组织审查」→「技术管理部/总工办组织审查」）；业务语义（节点编码、类型、条件、办理人配置与连线关系）未改动。施工 V3 静态核对为 90 个节点、105 条FLOW_SKIP连线；带名称连线的标签坐标经"不压节点、不压线、不互相重叠"复核后重算。开发库已导入并发布 V3（V1 保留给在途实例，V2 被 V3 取代）。2026-09-26 再按「画布尺寸与屏幕适配」重排为 V4 并发布：画布由 5400 × 4400 压到 2490 × 1350（12 行 × 14 列，最小行距 100、最小列距 180），1650 × 790 视口下整屏缩放约 0.59；同日按"竖向不滚动、横向两屏内"口径再排为 V5：8 行、行距 110、每行 10~12 个节点，渲染范围 3470 × 870、按高度缩放约 0.91（横向 3151px 在两屏内），网关呼吸空间（边到边最小 65px、出线首段/入线末段 65px、标签距网关 ≤208px）与分支组相邻（12 组分叉/汇聚 140px）达标，长跳转直线 2 条、短距离斜线 0、最大累计共段 70px（上限内），主链改蛇形短边、分支组保留纵向展开、通道就近不贯穿全图；六项清晰度计数与语义差异仍为 0。设计器渲染核对与业务方视觉验收状态见测试记录。
2026-09-27 施工单位流程按旧平台参考图的阅读特点再次调整，并在开发库导入发布 V8（定义 ID 2104084581199171585）。当前布局以业务阶段从左到右推进：前置办理、专业审核、部门审核、类别与出图判断、各类别审批及共同收尾依次排列；局部分支在入口附近上下展开，完成后向右汇聚。画布允许横向滚动，整图缩略视图用于定位，放大后逐段阅读。此次只调整节点、连线与边标签坐标，90 个节点、105 条连线及其业务语义均保持不变；V6/V7 为重排过程版本，已取消发布。实际页面与数据库回读结论见测试与验收文档。
2026-09-27 监理单位流程按 V8 参考重出图为 V4（定义 ID 2104099569750036482）并发布。监理与施工两条流程在 scheme_parallel 之后节点编码、分支条件与汇聚结构完全同源，该区段连同部门分流、类别出图分支和收尾链直接采用 V8 几何；差异只在头部：监理流程从专业监理工程师审核起步，无施工申报段，头链按 V8 行间距重排为「开始 → 专业监理 → 总监理」紧凑段，再以一条不与任何线、节点相交的长直线跨阶段留白接入「分公司经办人 → 项目负责人」及方案蛇形行。改动只涉及 86 个节点与 100 条连线的坐标；节点/连线语义字段与已发布 V3 逐字段比对差异为 0，V4 导入发布后 FLOW_NODE/FLOW_SKIP 无重复行，V3 转为未发布保留给在途实例。验证证据见测试记录。
2026-09-27 设计单位流程按 V8 参考重出图为 V4（定义 ID 2104101229834588161）并发布。设计与施工两条流程在 scheme_parallel 之后节点编码、分支条件与汇聚结构完全同源，该区段连同部门分流、类别出图分支和收尾链直接采用 V8 几何；差异只在头部：设计流程无总包与监理初审段，头链为「开始 → 设计单位发起 → 设计单位项目负责人 → 分公司经办人 → 项目负责人 → 分公司负责人 → 重报判断网关」，重报网关沿用 V8 的侧出口模式——「满足重报条件」向右上接入独立结束节点，「继续工程变更」向下进入「现场核验 → 估价 → 造价负责人审核」折返行，行位与 V8 同区段对齐。改动只涉及 88 个节点与 102 条连线的坐标，另有 design_project_manager 名称换行符由 \r\n 规整为 \n（渲染语义不变）；节点/连线语义字段与已发布 V3 逐字段比对差异为 0，V4 导入发布后 FLOW_NODE/FLOW_SKIP 无重复行，V3 转为未发布保留给在途实例。验证证据见测试记录。
2026-09-27 业主单位流程按 V8 参考重出图为 V4（定义 ID 2104102410615050241）并发布。业主与施工两条流程同构：业主缺少施工单位申报与监理初审的 6 个节点，由开始直接进入分公司经办人，其余业务阶段、分支、网关与收尾链路逐一对应，因此 scheme_parallel 之后的专业审核、部门审核、类别与出图判断、各类别审批和共同收尾各区直接采用 V8 几何。差异只在头部：无申报与监理段，头链为「开始 → 分公司经办人 → 分公司项目负责人 → 分公司负责人」同排从左到右，分公司负责人下折进入「现场核验 → 造价咨询估价 → 造价咨询负责人审核」折返行，折返行反向回到左侧并行网关与归属网关；归属网关下移到系统设备分支正上方，系统设备分支直落进入本分支首节点，分公司分支沿发起区下方留白横行长跳接入并行组入口，两个分流标签分别落在所属线段的中段与直落段上。头部折返保留明确留白，左上空区收紧，画布 7317 × 1482（施工 V8 为 7350 × 1515）。改动只涉及 84 个节点与 98 条连线的坐标；节点/连线语义字段与已发布 V3 逐字段比对差异为 0，V4 导入发布后 FLOW_NODE/FLOW_SKIP 无重复行，V3 转为未发布保留给在途实例。验证证据见测试记录。
2026-09-27 设计单位流程部门会签段按「并行分支横向轨道」反馈重排为 V5（定义 ID 2104107140741386242）并发布。技术部（仅 I 类）、工程部、设计部、成本合约部四条链由纵向四列改为从左到右的横向轨道上下堆叠（行距 160）：左侧由 department_gateway 分叉——工程、设计两路共用 68px 短叉段后上下分开，仅 I 类提前上折走独立通道，成本经网关下锚点直落最下轨道；右侧按「上折入顶锚点、左入汇聚锚点、下折入底锚点」收拢进 department_join；成本三节点链置于最下轨道，避免其较长横线被其他轨道折返穿越。改动只涉及部门段 11 个节点、16 条连线的坐标；节点/连线语义字段与 V4 逐字段比对差异为 0，FLOW_NODE/FLOW_SKIP 重复行为 0，V4 转为未发布。施工 V8 与监理 V4 的同区段仍为纵向列布局，待业务方认可横向轨道后再统一调整。验证证据见测试记录。
2026-09-27 部门会签横向轨道推广至其余流程并修复重新申报贴边线：施工 V8→V9（定义 ID 2104111147471917058）、监理 V4→V5（2104111217659400194）、业主 V4→V5（2104111284558548993）套用与设计 V5 相同的部门段横向轨道坐标（三条流程该区段原坐标与 V8 基线一致，变换脚本对 11 个节点、16 条连线逐项断言旧坐标后才替换）；重新申报初步设计 V3→V4（2104112567948464129）无部门会签段且并行会签本就是横向轨道，仅修复 technical_leader→review_join_gateway 贴边线——原路由从右锚点绕行卡片背后回到左锚点再沿 x=1000 下行，贴着设计部负责人卡片左边缘走过，改为右锚点直出经 x=1195 通道下行进汇聚，与其他三条分支汇入形态一致。导入前四条流程仓库文件与线上已发布定义逐字段比对语义差异为 0；本批仅动坐标，FLOW_NODE/FLOW_SKIP 重复行均为 0，旧版本转未发布保留给在途实例。同日仓库五个流程文件去掉 _v1 版本后缀改为无后缀命名。验证证据见测试记录。
2026-10-23 五条流程按本批业务调整升版并在开发库发布：施工 V10（定义 ID 2113585283608932354）、设计 V6（2113585397517840385）、业主 V6（2113585512764731394）、监理 V6（2113585616674418689）、重新申报 V5（2113585722714812417）。设计流程将重报判断前移至分公司项目负责人；删除设计部审核、需出图分支的监理单位审核/造价咨询复核、最终核量核价及造价咨询负责人审核；领导审批节点移除附件按钮；领导顺序统一为建设分管领导 → 成本分管领导 → 设计分管领导 → 总经理 → 董事长（I 类）/总经理（II 类）；现场踏勘步骤名调整为“监理单位组织现场踏勘（若需）/施工单位或设计单位编制变更方案”。调整后主流程节点/连线数为施工 79/92、设计 77/89、业主 73/85、监理 75/87，重新申报保持 27/31；五份 JSON 静态检查锚点、穿节点、交叉、长共段和标签问题均为 0；新定义 FLOW_NODE/FLOW_SKIP 无重复行，旧版本转未发布保留给在途实例（发布前回读无运行中实例）。生产库于 2026-10-24 使用同一批 JSON 导入并发布（施工 V10 2113752704551456769、设计 V6 2113752787565121538、业主 V6 2113752788861161474、监理 V6 2113752789645496322、重新申报 V5 2113752788395593729），生产发布包 20261024-gis 已包含本批前后端，生产库同步新增 process_overview 列；发布前回读生产设计 V5 在途单 1 条等待、1 条取消，均保留旧定义。
2. 接口契约
| 接口 | 方法 | 调用方 | 权限 | 请求对象 | 响应对象 | 幂等/事务 |
|---|---|---|---|---|---|---|
/business/engineering-change/construction/list | GET | 施工台账 | engineeringChange:construction:list | 分页、工程节点（可选）、类别、状态、关键字 | PageResult<EngineeringChangeVo> | 只读；按工程数据范围过滤；未选项目节点时加载当前用户权限范围内的全量变更记录（监理、设计、业主四端列表同构支持） |
/business/engineering-change/construction/{id} | GET | 台账/工作台 | engineeringChange:construction:query | 变更 ID | EngineeringChangeVo | 只读；越权返回业务异常 |
/business/engineering-change/construction | POST | 新增/暂存 | engineeringChange:construction:add | EngineeringChangeBo | ID | 事务；只创建草稿；表单带状态联动防御 |
/business/engineering-change/construction | PUT | 修改草稿/退回 | engineeringChange:construction:edit | 含 ID 的 EngineeringChangeBo | 空 | 事务；锁定流程绑定快照；表单带状态联动防御 |
/business/engineering-change/construction/submit | POST | 提交流程 | engineeringChange:construction:submit | ID、首个办理人 | 空 | 事务；分类校验后启动 Warm-Flow |
/business/engineering-change/construction/process-info/{id} | GET | 工作台 | engineeringChange:construction:query | 变更 ID | ProcessInfoVo | 只读 |
/business/engineering-change/construction/export | POST | 台账 | engineeringChange:construction:export | 同列表筛选 | xlsx | 只读 |
/business/engineering-change/statistics/overview | GET | 综合统计页 | engineeringChange:statistics:list | 无参数 | EngineeringChangeStatisticsVo（状态计数与金额合计、类别/发起单位/月度/线路分布、金额 TOP10） | 只读；空条件全量查询并复用台账工程数据权限过滤，Java 内存聚合；已撤销/已作废单据不参与金额与分布统计，图表金额为审定优先、无审定取预计 |
审批人不写死在表字段中：首个办理人由提交人通过选人弹窗选择（可多选，逗号拼接进流程变量 nextHandlerId，多人共享任务、任一人办理即或签通过），后续办理人由标准 FlowActionPanel 依据流程节点弹窗选择。服务端仍会校验每次提交的办理权限和当前状态；前端全量表单统一增加各节点状态联动防御，避免草稿和历史审批状态错乱。
3. 状态与业务动作
| 当前状态 | 动作 | 允许角色 | 前置校验 | 数据变化 | 下一状态 | 失败处理 |
|---|---|---|---|---|---|---|
| 草稿/退回 | 暂存 | 发起人 | 基础字段可为空 | 保存基础字段；不启动流程 | 草稿/退回 | 事务回滚并提示 |
| 草稿/退回 | 提交 | 发起人 | 单位工程、实际工程名称、参建单位、申请日期、原估算投资、三项金额、变更内容、首个办理人按规则校验（原施工图号选填） | 变更标题由实际工程名称生成，按发起单位启动对应主流程；正式类别在估价后由系统计算 | 审批中 | 启动失败整体回滚 |
| 审批中 | 预览 | 当前待办人 | 当前页面填写内容 | 临时改变左侧只读表单显示，不改正式数据和流程状态 | 审批中 | 关闭或取消后预览丢弃 |
| 审批中 | 同意/退回 | 当前待办人 | Warm-Flow 任务归属和节点字段校验 | 将弹窗内容写入正式节点记录，生成签名、表单日期并推进流程 | 审批中/退回/完成 | 工作流失败不回写业务状态 |
| 审批中 | 设计资料出具后直接核定签发/分送 | 分公司经办人 | 流程已删除最终核量核价及负责人审核节点 | 不再写入最终金额，直接进入下达和归档 | 审批中 | 历史 final_amount/final_class 保留只读兼容 |
4. 权限与数据范围
| 资源/动作 | 菜单权限 | 按钮权限 | 接口权限 | 数据范围 | 越权结果 |
|---|---|---|---|---|---|
| 施工单位台账 | 一级模块 + 施工页面 | list/query/add/edit/remove/submit/export | 同名 Sa-Token 权限 | EngineeringDataAccessHelper 标段工点专属授权组合（必须具备明确标段与工点归属，无整标段业务） | 403/业务异常 |
| 工程变更办理 | 隐藏办理页 | 工作流标准权限 | 工作流任务归属 | 当前任务办理人 | 非当前办理人不能办理 |
| 统计 | 一级模块 + 统计页 | query/export | 待实现 | 只读授权范围 | 待实现 |
工程变更主单属于标段工点专属资源；EngineeringDataAccessHelper 对列表与直接对象入口校验同一有效线路、标段、工点组合或整线授权。工点/标段任一维度单独命中其他授权组合不得放行，越权详情按业务异常拒绝。共享授权有效性、候选 token 和配置版本契约见工程基础详细设计 §4.2。
发起页共享工程选择器先请求 /business/engineering-tree/tree?maxLevel=bid 获取标段层级。受限授权用户的标段候选按至少一个当前有效的 (bidId, siteId) 授权组合判定；该层级不返回工点叶节点，不能以空叶节点过滤标段。选中标段后，请求 /business/engineering-tree/tree?maxLevel=site-unit&bidId={bidId} 一次取得该标段的工点及单位工程；后端按目标标段缩小主数据查询，并按完整 (lineId, bidId, siteId) 三元组复核候选，未授权标段返回空树。候选失败时两组叶节点共同显示失败与重试状态，加载期间禁止确认；过期响应不得覆盖后来选中的标段。一般 site/unit 树查询也按当前可见线路和标段缩小数据读取，避免全库扫描。组件挂载和首次打开重叠时复用同一个进行中树请求，避免首开重复读取。
5. 异常、事务与并发
| 场景 | 检测位置 | 用户提示 | 回滚/补偿 | 日志与告警 | 测试用例 |
|---|---|---|---|---|---|
| 重复提交 | 服务层状态校验 + @RepeatSubmit | 当前状态不支持提交 | 事务回滚 | 操作日志 | TC-006 |
| 并发修改 | 修改前重新读取状态；流程任务由 Warm-Flow 锁定 | 记录已被其他人处理 | 不覆盖已变更记录 | 工作流日志 | TC-019 |
| 最终核量核价 | 核量核价服务 | 记录最终金额和结果，不补走高等级审批 | 不回改已完成审批 | 金额/类别记录 | TC-008 |
| 流程定义变更 | 重出图并按新版本导入 | 已发布且可能被在途实例使用的定义不直接改写：2026-09-26 五条流程按流程图编排规范重出图后用导入路径生成 V2、标签定位修正后重发 V3 并发布（施工/设计/重新申报/业主/监理），V1 保留给在途实例（施工 2 条运行中、设计 1 条运行中）；V3 的节点/连线无重复行，业务语义与 V1 一致 | 不直接改写其他任务范围的定义与实例 | 流程版本、实例和节点记录 | TC-009 |
| 外部档案同步失败 | 归档适配层 | 归档成功、同步待重试 | 保留 archive_status | 待实现 | archive_status=pending 已在正式长链路回读，外部接口仍待接入 |
6. 实现映射与验证
| 责任 | 代码位置 | 验证方式 | 证据 |
|---|---|---|---|
| 后端 | digital-construction-modules/digital-construction-business/src/main/java/com/bokun/business/engineeringchange | 单测、接口测试 | 开发中 |
| 前端 | digital-construction-ui/src/views/business/engineeringChange | 类型检查、页面操作 | 开发中 |
| 数据库 | 交付数据库基线 | MCP 实际结构核验 | 待核对 |
7. 变更记录
| 版本 | 日期 | 变更 | 原因/来源 | 确认人 |
|---|---|---|---|---|
| v0.1 | 2026-08-30 | 建立施工单位发起流程的页面、接口、状态和权限映射 | 原型核对及用户确认 | 待业主确认 |
| v0.3 | 2026-08-30 | 确认施工单位单主流程、部门包容分流及紧凑流程图连线规则 | 用户确认 | 待业主确认 |
| v0.4 | 2026-08-30 | 流程图 JSON 编排规则迁入平台开发手册，工程变更仅保留业务特例 | 用户确认 | 待业主确认 |
| v0.5 | 2026-08-31 | 施工单位主流程按最终横向折返布局重置为 V1；固化四部门泳道、四分类出口及无穿节点连线核验 | 用户确认与项目 MCP 回读 | 待业主确认 |
| v0.6 | 2026-09-01 | 收敛发起表单、标题生成、通用节点附件和最终核价双节点；开发库清空旧施工变更数据并导入、发布最新 V1 | 用户确认与项目 MCP 回读 | 待业主确认 |
| v0.7 | 2026-09-01 | 收敛办理与退回弹窗字段；补充快捷意见、工作台首开刷新及退回重新待办状态优先级 | 用户确认与局部自动化验证 | 待业主确认 |
| v0.8 | 2026-09-06 | 监理/业主/设计三条流程状态从待实现更新为已实现；补充设计重报主流程（design_resubmit）与重报按钮权限；综合统计页仍为占位待实现 | 用户确认与项目 MCP 回读 | 待业主确认 |
| v0.9 | 2026-09-10 | 施工单位发起页新增手填分部（子分部）工程名称；施工、设计、监理单位改为从系统参建单位选择并保存名称快照 | 用户补充及当前页面核对 | 待业主确认 |
| v0.10 | 2026-09-14 | 补充工作流事件来源节点元数据设计，修复动态 action 写入下一待办节点的问题；补充空条件网关兼容；记录施工单位 I 类需出图正式长链路、最终核价 300/正式类别 I、流程完成但外部档案 archive_status=pending 的验证边界 | 真实端到端回归、定向后端单测和 DM8 回读 | 待业主确认 |
| v0.11 | 2026-09-15 | 修复退回件从台账「办理」进入后无任何办理动作的死路（办理入口限定 waiting，退回件统一走「提交」重办，实测 back → waiting 并生成新待办）；四类发起页单位工程选择器限定 SITE 节点，避免线路/标段被存成单位工程（库内已有此类历史单据）；按 EngineeringChangeRules 修正变更类别口径说明文案，消除 X=-60 被判为 II 类的误导 | 真实用户端到端体验（新增→提交→退回→重办）与代码核对 | 待业主确认 |
| v0.12 | 2026-09-17 | 原施工图号调整为选填：后端移除 @NotBlank 与提交必填拼接校验，四类发起页移除必填规则，留空不影响提交审批 | 用户要求与前后端校验核对 | 待业主确认 |
| v0.13 | 2026-09-27 | 监理单位流程图按施工 V8 参考重出图并导入发布 V4（仅坐标变更，头链按阶段留白分段） | 用户指定 V8 为参考及 flow-graph 规范 | 待业主确认 |
| v0.14 | 2026-09-27 | 设计单位流程图按施工 V8 参考重出图并导入发布 V4（仅坐标变更，重报网关侧出结束、继续变更向下折返） | 用户指定 V8 为参考及 flow-graph 规范 | 待业主确认 |
| v0.15 | 2026-09-27 | 业主单位流程图按施工 V8 参考重出图并导入发布 V4（仅坐标变更，发起区紧凑折返、归属网关下移、分公司分支横行长跳接入） | 用户指定 V8 为参考及 flow-graph 规范 | 待业主确认 |
| v0.16 | 2026-09-27 | 设计单位流程图部门会签段按业务反馈改为横向轨道并导入发布 V5（仅坐标变更，分叉短共段与汇聚收拢重排） | 用户反馈及 flow-graph 规范「分支占用上下轨道」 | 待业主确认 |
| v0.17 | 2026-09-27 | 部门会签横向轨道推广至施工 V9、监理 V5、业主 V5，重新申报 V4 修复贴边线；五个流程文件改为无版本后缀命名 | 用户确认横排样式并交办四条流程 | 待业主确认 |
| v0.18 | 2026-10-23 | 五条流程升版并发布：设计重报判断前移、删除冗余审批节点、领导顺序与命名调整、领导附件权限收紧；全量表单折叠未经过环节；新增流程概述；三类发起去除合同金额 | 用户逐项确认（2026-10-23） | 待验收 |
| v0.19 | 2026-11-04 | 综合统计页从占位转正：新增统计聚合接口（状态计数、金额合计、类别/发起单位/月度/线路分布、金额 TOP10），页面提供指标卡、四张图表与 TOP10 表；口径为撤销作废不参与分布与金额、正式类别 finalClass 优先、月度按申请日期归月、复用台账工程数据权限过滤 | 用户确认方案并授权实施（2026-11-03） | 待验收 |
导出列（2026-09-15）
EngineeringChangeVo已补齐中文导出列：变更编号、单位工程名称、工程变更名称、工程变更内容及原因、初步估算费用增减（万元）、合同金额（万元）、变更后合同金额（万元）、工期影响（天）、申请日期、预计变更类型、审核状态；类别与状态列通过ExcelDictConvert输出中文。- 导出列与台账页面列一致，附件与流程内部字段不参与导出。