主题
工程手续办理 · 需求分析文档
文档版本：1.00 ｜ 最近核对日期：2026-10-15
本文档是工程手续办理模块的业务基线。业务规则已根据原型、流程图、推进台账和用户确认整理；截至 2026-10-15，代码契约、数据库结构、两套流程资源和主要真实角色端到端链路均已核对。运行态最新流程定义为土建
V3、机电V2，已在流程设计器导入且导入结果确认无问题。本轮按用户 2026-10-15 需求完成录单入口改造：新增年度计划拆分为“新增年度计划（土建）”与“新增年度计划（机电）”两个入口，取消逐工点手选办理通道；土建入口按“线路-标段-工点”选择工点并带入责任标段，机电入口按“线路-标段”选择标段（标段即办理对象）；推进总台账表头首列为“工点/专业”，完成时间按“已完成/计划完成日期”展示。首期不固化组织岗位映射，办理人、审核人和候选岗位可按实际办理需要选择；退回重办和新建可选单位工程不足的浏览器场景仍单独标记为待补测。
文档控制
| 项目 | 内容 |
|---|---|
| 模块名称 | 工程手续办理 |
| 编写日期 | 2026-09-07 |
| 业务确认人 | 待补充 |
| 原型或资料来源 | 受控原型图片、手续办理流程图、线路级推进台账样例、建设工程规划许可证办理要件与责任主体协调清单流程图；原始资料不在文档中记录本机路径 |
| 关联设计文档 | 概要设计、详细设计、数据库设计、测试与验收、操作手册 |
1. 背景与目标
1.1 业务背景
建设项目的手续办理涉及年度计划、规划、设计、用地、施工图和施工许可等连续业务。现有原型同时包含办理台账、流程节点、单位工程进度记录和证件/成果资料，若将这些内容拆成互不关联的表单，容易出现单位工程漏办、同一节点重复建任务和台账数据不一致。
1.2 建设目标
- 以工程主数据中的“工点/标段”作为办理对象：土建按工点办理，机电按标段办理，原型文案中的“工点”在土建语义下按工点主数据理解；
- 复用 SQE、工程变更监管已经使用的 Warm-Flow 流程能力和办理工作台框架；工程手续办理按录单入口建立土建、机电两套独立流程定义，共用同一套流程能力和办理工作台；
- 年度计划下达拆分为“新增年度计划（土建）”与“新增年度计划（机电）”两个入口：土建入口按“线路-标段-工点”选择工点并自动带入责任标段，机电入口按“线路-标段”选择标段（标段即办理对象）；入口决定流程分支与选择层级，不再逐行手选办理通道；
- 年度计划下达仍是独立业务页面；办理工作区顶部以流线型步骤向导条（Workflow Stepper Header）呈现：在手续阶段（土建 5、机电 2）之外，集成“年度计划”只读 Tab 与“办理清单”全景功能 Tab（含建设工程规划许可证主体责任协调清单与高清流程全景图），主线阶段带有 01~05 阶段序号、已办结徽标、当前待办微动效；Tab 只是分组与视图，不等同于流程节点；
- 彻底移除顶部“查看历史”按钮及带有“轮次（
WORK_ROUND_NO）”概念的复杂弹窗，简化为直观的线性推进； - 提供单位工程及节点“就绪诊断悬浮卡”，明确检验实际完成日期、成果附件、前置子手续闭环状态，消除未就绪原因黑盒；条件栏升级为卡片式决策指引组件，支持分段胶囊按钮和前置子手续联动锁定警示；针对 1920×911 视口进行紧凑排版调优，彻底杜绝横向滚动条；
- 流程图中的每个外层框才是一个 Warm-Flow 业务节点；框内看似两步的内容是同一节点的两个层次：先在左侧表单中反复填报、修改和保存进度，再填写最终资料并提交节点；
- 规划方案审查意见阶段在同一 Tab 内包含
2.1子手续节点和2主节点；土建流程在4 建设工程规划许可证节点先判断是否需要4.1 建设用地规划许可证及土地划拨决定书，再由4.1判断是否需要4.1.1 土地征收和转用批复、林地占用手续办理；子手续完成后按流程图回到对应父节点重新判断； - 流程图按流程图编排规范绘制：节点文案精简后每行不超过 7 个中文字符、最多 3 行；连线从节点四向锚点出发并进入目标锚点，折线保持正交，串行链和分支尽量铺满画布；任意两条连线不得共享水平/垂直线段、交叉、重叠或穿过节点，回父节点必须使用独立外圈通道；不绘制静态退回线，退回使用 Warm-Flow 标准动作；子手续完成回到父节点的业务闭环线保留，不视为退回线；
- 年度计划表按每个单位工程逐行填写各适用阶段的计划完成日期；草稿阶段可编辑，提交后工作区只读带出，提交校验要求对应类型的全部阶段日期齐全；
- 只有当前节点涉及的单位工程全部完成后，才允许流程实例进入下一节点；
- 流程编号采用原型泳道口径：
1年度计划下达、2规划方案审查意见、3初步设计批复、4建设工程规划许可证、5施工图审查合格书、6施工许可证，子手续随父节点编号（2.1、4.1、4.1.1）； - 全部手续阶段完成后，流程进入工程部“
7接收、备案并归档”节点，归档确认后流程结束；归档是结束前的直通办理节点，不生成手续阶段 Tab，也不按单位工程分别填报； - 将前六个业务页面产生的业务数据汇总为第七页“手续办理推进总台账”，支持查询、查看和固定格式导出，避免维护第二套数据。
2. 建设范围
2.1 本期包含
模块设置 7 个页面：
- 年度计划下达；
- 规划方案审查意见；
- 初步设计批复；
- 建设工程规划许可证；
- 施工图审查合格书；
- 施工许可证；
- 手续办理推进总台账。
前六页分别提供年度计划和手续阶段入口，第七页是独立的只读汇总页面。年度计划提交时，系统按所选单位工程类型绑定独立的土建或机电流程定义：年度计划作为独立页面维护，不生成办理阶段；办理工作区顶部横向 Tab 在手续阶段之外增加一个只读“年度计划”Tab，因此土建共 6 个 Tab、机电 3 个 Tab。Warm-Flow 中保留年度计划申请人节点，用于承接计划提交和退回重提，年度计划 Tab 只读带出、不作为业务阶段或办理对象。进入任一条流程的办理工作区后，默认打开当前流程阶段，只有当前阶段表单允许当前办理人编辑，其他阶段只读；工作区采用左侧手续表单、右侧审批时间线的布局，移除独立“办理规则”区域。Warm-Flow、SQE 和工程变更监管已经使用的流程任务、时间线、流程图、标准办理动作和工作台框架继续复用，主要改造左侧业务表单。
2.2 明确不做
- 不把流程图外层框内“反复填报进度”和“上传最终资料并提交”拆成多个 Warm-Flow 流程节点、任务或审批历史；外层框之间的
2.1、4.1.1、4.1等外层框仍是独立业务节点； - 第七页不新增进度、不修改证件结果、不推动流程，不复制前六页的录入数据；
- 不在本期擅自对接自然资源、住建、审图等外部审批系统；
- 不对“建设用地规划许可证”“建设工程规划许可证”“工程规划许可证”等名称做全局合并或替换；各流程节点、条件子手续和台账列按其实际业务名称分别维护，具体对应关系以流程定义和业务资料核对为准；
- 不另建一套与工程基础管理冲突的“工点/标段”主数据；土建引用工点主数据、机电引用标段主数据，历史单据保存必要快照；
- 首期不固化具体办理人、审核人和候选岗位的组织映射；不在文档初稿中确定未经核对的菜单权限编码、流程定义编号和物理数据库字段。
- 办理人、审核人和候选岗位均通过平台现有通用用户选择器选择，不使用普通下拉框。选择器必须支持部门树、人员筛选和多人选择；单人字段只保存一名人员，多人候选字段保留完整人员列表。
2.3 已确认的技术约束
- 工程对象复用工程信息配置的工程树，
SITE节点在本模块业务语义中为“单位工程”； - 流程任务、流程图、待办、已办和标准办理动作复用平台 Warm-Flow；
- 附件复用平台文件上传、预览和下载能力；
- 页面权限与线路/单位工程数据范围权限同时生效，后端不能仅依赖前端隐藏按钮；
- 工程数据范围来自工程基础的整线授权或有效标段×工点组合；流程任务分配本身不扩大受理人的工程数据范围。
- 结果资料、条件判断和流程动作按平台规则保留可追溯信息；进度记录在当前节点未锁定前允许物理删除，删除后不再作为业务记录展示，不能依赖进度表保存删除历史；
- 数据库设计采用逻辑类型，最终物理字段和索引以实体、Mapper、迁移及项目 MCP 实测为准。
2.4 系统资源建设范围
“工程手续办理”是应用菜单中的一级业务模块，与“工程变更监管”同级，不挂在工程基础管理或工程变更监管下面。实现时需要同步建立：
- 一级菜单“工程手续办理”及其 7 个页面子菜单、按钮权限和隐藏办理路由；
- Warm-Flow 流程分类“工程手续办理”；
- “工程手续办理”流程分类下的两套独立流程定义：
engineering_procedure_civil（土建）和engineering_procedure_mep（机电）；历史公共编码engineering_procedure仅用于兼容在途旧实例，不作为新计划的启动流程； - 两套流程定义分别与工程类型、业务主单、手续类型、外层业务节点、当前任务和共用办理工作区关联；条件菱形只承担分流，不生成表单 Tab；
- 第七页总台账作为只读菜单，不绑定流程定义。
菜单路由、流程分类和流程示例属于模块交付的一部分，不能只通过文档或前端静态页面替代。
3. 用户角色与使用场景
| 角色 | 使用目的 | 前置条件 | 主要结果 |
|---|---|---|---|
| 年度计划经办人 | 建立年度计划：土建按“线路-标段-工点”选择工点、机电按“线路-标段”选择标段 | 有新增/编辑/提交权限，且具备对应线路/工点或标段范围 | 形成一个覆盖多个同类型推进单元的年度计划流程实例 |
| 手续办理人 | 在当前节点内逐个单位工程填报进度、修改记录并上传结果 | 当前任务分配给本人或本人所属办理范围 | 各单位工程完成当前节点，节点可继续流转 |
| 条件确认人 | 按所在节点分别确认三个条件：产权单位意见征求/规划调整、土地征收和转用批复/林地占用手续办理、建设用地规划许可证/土地划拨决定书 | 具备当前节点办理权限 | 形成对应条件确认结果；选择“需要”时启动对应子手续 |
| 审核/审批人 | 查看办理材料并执行平台审批动作 | 当前任务分配给本人 | 通过、退回或按平台规则执行其他动作 |
| 管理查看人员 | 查看各手续进度、完成状态、流程和结果资料 | 具备页面和线路/单位工程数据范围权限 | 只读查看或导出总台账 |
| 流程/系统管理员 | 配置流程、候选人、字典和权限 | 具备平台管理权限 | 维护运行所需的基础配置，不代替业务办理 |
首期不要求把各流程节点绑定到固定部门、岗位或人员；流程发起/配置时可选择平台中的有效办理人、审核人或候选岗位。系统仍须校验人员/岗位有效、具备相应流程权限和线路/单位工程数据范围，后续再根据实际运行情况补充固定映射。
4. 核心业务场景
4.1 年度计划下达
- 年度计划经办人进入“年度计划下达”，从“新增年度计划（土建）”或“新增年度计划（机电）”入口新建计划，选择年度并完成对应层级的选择：
- 土建入口：按“线路-标段-工点”在工程树中勾选工点，责任标段随选择路径自动带入（工点未被标段管辖时留空）；
- 机电入口：按“线路-标段”在工程树中勾选标段，标段即办理对象，不再选择工点；
- 录单入口在进入新增弹窗时确定；编辑已有计划时按主单类型回读，入口切换后选择器清空重选；不再逐工点手选办理通道，同一计划内的推进单元类型天然一致，不存在混选场景；
- 土建入口保存选择的工点 ID、名称、“线路/标段/工点”路径快照（工点无责任标段时为“线路/工点”两段）和责任标段 ID、名称及施工单位中文名称快照；机电入口保存标段 ID、标段名称、“线路/标段”路径及标段施工总包单位名称快照；服务端校验责任标段与该工点存在管辖关系（指定工点或全线统包），不满足时拒绝保存；
- 同一推进单元同一年度不能重复进入另一份有效年度计划（土建按“工点+年度”、机电按“标段+年度”查重，服务端拒绝并点名重复对象）；不按线路设置年度计划唯一限制；草稿阶段可调整清单，提交后不能新增或移除；
- 计划业务单按入口绑定独立流程定义：土建使用
engineering_procedure_civil并生成 5 个实际手续阶段，机电使用engineering_procedure_mep并生成 2 个实际手续阶段；年度计划页面同时按推进单元逐行维护对应阶段的计划完成日期，提交后只读带入办理工作区；流程实例覆盖本次选择的多个同类型推进单元； - 流程办理人后续在每个节点内逐个推进单元完成办理，不能只完成其中一个就让整个实例进入下一节点。
4.2 一个节点内的单位工程办理
- 办理人打开当前任务，先看到本流程实例覆盖的单位工程清单及各自状态；
- 办理人在当前阶段 Tab 内选择流程图外层业务节点；阶段 Tab 不代表可以直接办理全部节点；
- 办理人选择一个单位工程，通过独立弹窗新增、编辑和删除进度记录，进度表格只读展示、附件列显示文件数量；已保存内容对有权限的其他办理人即时可见；主手续进度记录含进展情况、是否重难卡点、完成日期、附件，子手续进度记录含进展情况、总体进度、附件；
- 办理人再填写该单位工程的结果/证件资料并暂存；本节点能否提交由“同意”统一校验：每个适用单位工程须条件子手续已闭环、实际完成日期已填、最终成果附件已上传，仅填写进度记录不算完成；
- 办理人继续处理其他单位工程。普通节点及条件已闭环的父节点，所有适用单位工程均完成后才允许提交；父节点存在待办理条件时（任一单位工程需要且未完成对应子手续），可直接提交进入对应子手续分支，暂不强制校验主节点各单位工程结果数据，待子手续全部办结或无需子手续离开主节点时才统一校验所有单位工程完成时间和成果文件；
- 节点提交使用 Warm-Flow 标准办理动作，提交前重新按当前条件计算分支和下一节点办理人。
“暂存”只保存当前单位工程的工作内容，不改变流程节点；不再有独立的“完成单位工程”动作。单位工程是否完成由结果数据（实际完成日期 + 最终成果附件 + 需要条件的子手续已完成）判定；同意校验只读，只有流程真正前进离开节点时，才把该节点数据就绪的单位工程落库为已完成并记完成时间（不提前锁定，避免同意失败时单位工程被锁死）。
4.3 条件子手续
流程图中有三个独立的条件菱形，分别是：
- 是否需要产权单位意见征求、规划调整；
- 是否需要土地征收和转用批复、林地占用手续办理；
- 是否需要建设用地规划许可证及土地划拨决定书。
三个条件在各自所在父节点中分别判断、分别留痕，不能合并成一个条件字段。流程阶段 Tab 只是对节点的分组：
| 流程图条件 | 对应条件子手续外层节点 | 所属父节点/触发规则 |
|---|---|---|
| 是否需要产权单位意见征求、规划调整 | 2.1 产权单位意见征求或规划调整 | 父节点 2；当前单位工程选择“需要”时进入 2.1（同一节点内任一单位工程需要即走子流程分支） |
| 是否需要土地征收和转用批复、林地占用手续办理 | 4.1.1 土地征收和转用批复、林地占用手续办理 | 父节点 4.1；4.1 选择“需要”时进入 4.1.1 |
| 是否需要建设用地规划许可证及土地划拨决定书 | 4.1 建设用地规划许可证及土地划拨决定书 | 父节点 4；4 选择“需要”时进入 4.1 |
上表中的“建设用地规划许可证”是流程图条件中的实际名称；第 4 个页面“建设工程规划许可证”是原型页面的实际名称，二者不做全局合并或替换。
- 每个条件项只有一个当前决策值，选项统一为“不需要”“需要”，首次打开默认“不需要”；不再区分系统建议值和办理人确认值；如需再次办理通过流程退回触发，不再提供“需要再次”；
- 选择“需要”时进入该条件对应的子手续节点；当前父节点可以先提交进入子手续，但父单位工程在条件闭环前不能完成；
- 条件子手续节点内部仍按单位工程逐个填报进度、填写结果并分别完成；一个流程实例仍只产生一个子手续任务，不按单位工程拆 Warm-Flow 任务；
- 子手续节点完成后回到原父节点判断人；判断人可选择“不需要”结束该条件；如需再次办理，通过流程退回目标节点重办，不提供“需要再次”；子手续未完成前可将“需要”改回“不需要”直接跳过；退回导致重办时，阶段和阶段-单位工程递增
WORK_ROUND_NO，旧进度和结果按轮次只读保留；条件记录不新增历史行，而是就地重置后重新保存； - 每个条件只保留一个当前生效决策（需要/不需要），不再累积“需要再次”的多轮历史行；子手续完成情况由对应子手续单位工程的完成状态体现；流程退回只切换阶段及阶段-单位工程的办理轮次，条件行就地更新，不产生条件历史轮次；
- 选择“不需要”时跳过或结束该条件子手续，继续当前流程节点后续操作；
- 系统交互统一使用“不需要”“需要”两个选项；子手续未完成前允许把“需要”改回“不需要”直接跳过。
条件判断是当前父节点工作区中的业务操作；子手续外层框是独立业务节点，但框内进度填报与最终提交仍不拆分为两个节点。三个条件的流程分支最终都回到各自父节点，不额外虚构“返回判断”业务节点。
4.4 流程图编排规范
两套流程定义均遵循项目既有流程图规范：
- 流程节点只对应流程图中的真实外层框；阶段名称只作为办理工作区 Tab 分组，不生成节点；框内“反复填报进度”和“填写最终资料并提交”属于同一节点的两个操作层次；
- 普通节点文案精简后最多 3 行，每行不超过 7 个中文字符；文案使用
\n换行，避免节点内缩放或遮挡； - 节点坐标使用中心点，连线起点和终点必须落在源节点、目标节点的四向锚点；中间折点只使用水平或垂直正交路径；
- 串行链、分支和子手续位置尽量铺满设计器画布，分支就近布置；任意两条线不得共享同一水平/垂直线段，不得交叉、重叠、穿过节点或压住文字，回父节点使用与其他线路分离的外圈通道；
- 不在流程 JSON 中绘制静态“退回/回退”线，退回使用 Warm-Flow 标准退回动作；子手续完成后回到对应父节点的 PASS 业务闭环线必须保留，它不是退回线；
- 导入前逐条核验节点数、连线数、条件表达式、锚点、正交折线和文案换行；当前运行态最新版本为土建
V3、机电V2，已在流程设计器导入并确认无问题；已发布或存在在途实例的旧定义不直接覆盖。
4.6 五个手续页面的数据范围
五个手续页面不是“只看当前阶段”的互斥列表，也不是把所有计划提前展示到后续页面。页面传入 stageCode 后，服务端按土建/机电阶段顺序判断：当前流程阶段等于该页面阶段，或已经经过该页面阶段，才允许返回该页面的节点明细；尚未到达该阶段的计划不返回。例：规划方案审查意见页可看到当前在规划方案及其后续阶段的计划；初步设计批复页只看到当前在初步设计及其后续阶段的计划；页面内部仍只返回本页面对应的节点行。这样可以形成“当前阶段 + 已经过阶段”的累计视图，避免把待办阶段提前显示。
4.5 手续办理推进总台账
- 管理查看人员进入第七页；
- 按年度、线路、标段、单位工程、施工单位和审核状态筛选；
- 系统从年度计划及前六页业务数据实时汇总计划时间、实际进展、当前流程节点、进度状态、审批状态、完成时间、结果资料和适用的条件子手续；
- 用户可查看来源详情和流程记录，并按固定格式导出台账；
- 第七页不提供新增、编辑、删除、进度追加或流程提交动作。
- 总台账与导出的手续列固定为 8 列（在原型线路级 Excel 的 7 列基础上补“施工图审查合格书”）：规划方案审查意见、初步设计批复、土地征转用、规划调整、建设用地规划许可及土地划拨、工程规划许可证、施工图审查合格书、施工许可证；每列含“完成时间/进展情况”，行按推进单元（土建=工点、机电=标段），表头首列为“工点/专业”；完成时间列展示规则为：已完成显示“已完成”，未完成显示计划完成日期，无计划日期留空；导出按线路分 sheet，表头为两行合并，页签名按 Excel 规则清理为不超过 31 个字符并在同一工作簿内保持唯一。
- 台账行“进度状态”四色派生：未开始（无进度且无成果）、正在办理（有进度/结果但未上传最终成果且未过计划时间）、已完成（有实际完成日期且已上传成果附件）、超期（已过计划完成时间仍未上传成果附件）；“办理人/办理部门”取该流程实例当前/最后办理人及其部门；“施工标段/施工单位”优先取推进单元保存的标段与施工单位快照（土建责任标段、机电办理对象标段），历史数据无快照时按管辖标段唯一反查补齐，多个候选时留空。
5. 业务规则与状态
5.1 业务规则
| 编号 | 规则 | 来源 | 状态 |
|---|---|---|---|
| R-EP-001 | 模块包含 7 个页面，第七页为独立的手续办理推进总台账 | 用户确认 | 已确认 |
| R-EP-002 | “建设用地规划许可证”“建设工程规划许可证”“工程规划许可证”等名称不做全局改名；各流程节点、条件子手续和台账列按实际业务名称分别保留 | 用户确认 | 已确认 |
| R-EP-003 | 复用 SQE/工程变更的流程能力和工作台框架；土建、机电使用两套独立工程手续办理流程定义，共用流程能力和工作台；录单入口（土建/机电）决定流程分支 | 用户确认 | 已确认 |
| R-EP-004 | 一个流程实例可以覆盖多个单位工程；单位工程来源于工程树 SITE 节点 | 用户确认、现有工程基础模型 | 已确认 |
| R-EP-005 | 办理人必须逐个单位工程填报并分别完成，不能只完成部分单位工程就提交整个节点 | 用户确认 | 已确认 |
| R-EP-006 | 流程图每个外层框代表一个流程节点；外层框内“反复填报进度”和“上传最终资料并提交”是同一节点的两个层次，不单独生成流程任务或审批历史 | 用户确认、最新流程图核对 | 已确认 |
| R-EP-007 | 当前节点的进度跟踪记录可多次追加、修改和物理删除，直到该节点提交；已保存记录对有权限的其他办理人可见；这些记录不等同于流程节点 | 用户确认 | 已确认 |
| R-EP-008 | 进度状态和审批状态分开存储、展示和计算，不能用一个状态字段互相覆盖 | 原型核对 | 已确认 |
| R-EP-009 | 普通节点只有在所有适用单位工程完成后才允许提交；决策为“需要”条件子手续的单位工程以子手续节点为准：主节点不要求该单位工程另交证件资料（含子手续已完成的情形），未完成时允许先进入对应子手续，不阻塞其他不需要子手续的单位工程推进（v0.25 口径） | 用户确认、流程规则、v0.25 调整 | 已确认 |
| R-EP-010 | 三个不同条件菱形分别判断对应子手续；每个条件使用“不需要/需要”两个选项，首次默认“不需要”；选择“需要”进入对应外层子手续，子手续返回父节点后可选择“不需要”结束；再次办理通过流程退回触发，不提供“需要再次”；子手续未完成前可把“需要”改回“不需要”直接跳过 | 用户确认、原型核对 | 已确认（v0.11 取消“需要再次”） |
| R-EP-011 | 结果/证件资料按单位工程分别维护，并与手续类型、流程实例关联；不需要条件子手续的单位工程完成至少要求实际完成日期和原型规定的最终成果附件；决策为“需要”子手续的单位工程以子手续节点的结果资料为完成依据，主节点不再强制（v0.25 口径） | 原型核对、用户确认、v0.25 调整 | 已确认 |
| R-EP-012 | 第七页只读汇总前六页及年度计划数据，不建立第二套人工进度数据 | 用户确认 | 已确认 |
| R-EP-013 | 办理只有“暂存”和“同意”两个动作：暂存只存数据、不推进流程；同意时服务端先由前端自动落库未暂存的条件决策和结果资料，再只读统一校验本节点各单位工程数据是否填全并推进；切换单位工程或阶段 Tab 时同样自动落库，避免“已填写但未保存”被误判为未填全；离开节点时把就绪单位工程落库为已完成并记完成时间，不再有独立的“完成单位工程”动作 | 业务规则整理（v0.12 简化；v0.25 自动暂存） | 已确认 |
| R-EP-014 | 单位工程、线路、标段等工程信息保存 ID、名称和路径快照，避免工程树调整影响历史单据 | 平台工程基础约定 | 设计约束 |
| R-EP-015 | 流程可退回前面阶段；退回目标阶段及其后续阶段切换新的办理轮次，当前完成结果失效但历史数据保留；条件记录就地重置后重新保存，并沿原流程实例重提 | 用户确认、方案建议 | 已确认 |
| R-EP-016 | 流程办理工作区顶部横向 Tab：手续阶段 Tab 只展示流程已到达或已完成的阶段（未审批到达的后续阶段隐藏，办结/终止后全部可见），另有只读“年度计划”Tab；年度计划 Tab 只读带出、不办理；同一阶段 Tab 内按单位工程切换展示该单位工程在本阶段的全部表单，单位工程选择行在内容区滚动时吸顶固定；默认打开当前阶段，从各手续模块“详情/办理”进入时默认定位到本模块阶段 Tab，只有当前节点表单可编辑，其他只读 | 用户确认、方案调整（v0.12 年度计划只读 Tab；v0.25 阶段显隐、吸顶与详情定位） | 已确认 |
| R-EP-017 | 阶段 Tab 的可编辑性由当前流程节点和当前办理人共同决定；仅打开 Tab 不获得写权限 | 平台流程约定、用户确认 | 设计约束 |
| R-EP-018 | 年度计划按录单入口分为土建、机电两类：土建入口选择工点并带入责任标段，机电入口选择标段（标段即办理对象）；入口决定流程分支，同一计划内不存在混选通道的场景 | 用户确认（2026-10-15 入口改造） | 已确认 |
| R-EP-019 | 土建手续阶段 5 个、机电 2 个（施工图审查合格书、施工许可证）；办理工作区额外含一个只读“年度计划”Tab，故 Tab 数土建 6、机电 3；年度计划下达同时是独立页面与 Warm-Flow 申请节点，其工作区 Tab 仅只读带出、不办理 | 用户确认、方案调整（v0.12） | 已确认 |
| R-EP-020 | 年度计划提交时按单位工程类型绑定独立流程定义，不能让前端传入的流程编码绕过类型匹配；历史公共编码仅兼容在途旧实例 | 业务规则整理 | 设计约束 |
| R-EP-021 | 土建入口只能选择工点（SITE）、机电入口只能选择标段（BID）；责任标段必须与该工点存在管辖关系（指定工点或全线统包），不满足时服务端拒绝保存和提交 | 用户确认（2026-10-15 入口改造） | 已确认 |
| R-EP-022 | 首期不固化各流程节点的办理人、审核人和候选岗位映射，可按实际需要选择平台有效人员/岗位；仍须通过权限和线路/单位工程范围校验 | 用户确认 | 已确认 |
| R-EP-023 | 同一单位工程同一年度不得重复纳入其他有效年度计划，服务端拒绝并点名重复单位工程；不按线路设置年度计划唯一限制；草稿可调整、提交后不可增删单位工程；年度计划的阶段计划日期提交后只读，退回重办只改办理数据、不改计划日期 | 用户确认（v0.12 放宽为按单位工程查重） | 已确认 |
| R-EP-024 | 单位工程完成必须满足对应条件已闭环、实际完成日期已填写和原型要求的最终成果附件已上传；仅有进度记录不能完成 | 用户确认、方案建议 | 已确认 |
| R-EP-025 | 办理人与审核人沿用 Warm-Flow 标准节点动作，不因为业务表单增加重复审核节点；流程图外框仍对应一个流程节点 | 用户确认、方案建议 | 已确认 |
| R-EP-026 | 已退回目标阶段及其后续阶段按顺序切换新的办理轮次；旧进度和旧结果保留为只读历史，新办理数据不得覆盖旧数据；条件记录就地重置，不保留条件历史行，并沿原流程实例继续 | 用户确认、方案建议 | 已确认 |
| R-EP-027 | 进度记录通过独立弹窗新增/编辑/删除，进度表格只读展示、附件列显示数量；有附件时数量可点击打开只读附件查看框，查看不改变数据；删除仍受当前节点未锁定和权限约束 | 用户确认（v0.12 由行内编辑改回弹窗）、本次界面补充 | 已确认 |
| R-EP-028 | 流程办理人、审核人和候选岗位统一使用现有通用用户选择器，不使用普通下拉框；选择器支持部门树、人员筛选和多人选择，单人字段取一人，多人候选字段保留多人 | 用户补充 | 已确认 |
| R-EP-029 | 三个子手续分别挂在 2、4 的条件分支下；子手续完成后直接回到对应父节点，由原办理人判断是否结束（再次办理走退回），不把阶段名称或框内两层操作建成节点 | 用户确认、流程图 | 已确认 |
| R-EP-030 | 年度计划按单位工程逐行维护对应阶段的计划完成日期；土建填写 5 个实际手续阶段，机电填写 2 个实际手续阶段；提交时必须完整，办理工作区只读带出 | 原型核对、用户补充 | 已确认 |
| R-EP-031 | 单位工程选择器按录单入口切换层级：土建入口展示“线路-标段-工点”树并只允许勾选工点、责任标段随选择路径带入；机电入口展示“线路-标段”树并只允许勾选标段。选择器默认隐藏运营节点并提供“显示运营”开关（默认关闭，仅切换显示层）；服务端不按运营状态过滤或拒绝，可见范围以工程数据权限授权为准 | 用户确认、原型核对；2026-09-18 运营显示口径；2026-10-15 入口改造 | 已确认（2026-10-15 口径变更） |
| R-EP-032 | 台账/总台账“进度状态”按未开始/正在办理/已完成/超期四色派生（依据计划时间、实际完成日期、成果附件），办理人/部门取流程实例当前/最后办理人 | 用户确认、原型核对 | 已确认 |
| R-EP-033 | 手续台账页每行=单位工程；总台账=单位工程×8 手续列矩阵（补施工图审查合格书）；导出按线路分 sheet 的两行合并表头固定模板；均只读、数据来自年度计划与各手续办理 | 用户确认、原型线路级 Excel 核对 | 已确认 |
| R-EP-034 | 五个手续页面按 stageCode 展示“当前阶段及已通过阶段”的累计数据；服务端先按流程当前阶段过滤，再按页面节点编码返回明细，不能把未到达该阶段的计划提前展示 | 用户补充、业务示例 | 已确认 |
| R-EP-035 | 单位工程施工单位从所属标段带出，保存中文名称快照；标段原始值为组织 ID 时必须经组织服务翻译，前端和台账不得直接显示 ID，历史空快照由读取逻辑补齐 | 用户补充、工程基础数据核对 | 已确认 |
| R-EP-036 | 工程手续通过动作在 Warm-Flow GlobalListener.start 阶段执行服务端前置校验和分支变量重算；客户端 ignore 与条件变量不具备绕过业务校验的权力 | EP-A01 根因分析、平台流程机制核对 | 设计约束 |
| R-EP-037 | 年度计划草稿选择首节点办理人后，保存/更新应同步保存办理人 ID 和名称快照；正式提交时仍由服务端重新校验办理人有效性、权限和流程归属 | 端到端复测 E2E-003、代码回归 | 已确认 |
| R-EP-038 | 节点结果完整性校验失败时，审批动作必须保持在当前对话框内，并展示包含缺失单位工程的可理解错误；校验失败不得推进流程或产生未处理异常 | 端到端复测 E2E-002 | 已确认 |
| R-EP-039 | 附件上传必须使用平台 multipart 文件接口并保留登录鉴权、扩展属性和 ossId 关联；浏览器网络失败时不得写入假附件，失败批次须收敛并允许重试；成功列表不得因临时项替换或进入动画产生明显布局抖动 | 端到端复测 E2E-004/E2E-006、文件服务契约 | 已确认 |
| R-EP-040 | 待办入口或路由回退必须指向实际待办页面 /task/taskWaiting，不能回退到不存在的旧路径 | 端到端复测 E2E-005 | 已确认 |
| R-EP-041 | 流程任务分配不自动扩展工程树数据范围；办理账号必须同时满足当前任务归属和线路/单位工程 SITE 授权，端到端测试开始前应完成范围授权 | E2E-001 权限复现与补授权复测 | 运行前置约束 |
| R-EP-042 | 只读办理工作区的“结果/证件资料”区域直接展示已关联的成果文件；沿用禁用态 FileUpload 展示文件类型图标和文件名，文件名可进入既有预览，文件提供下载动作；只读状态不显示上传、删除或修改能力，无附件时显示“—” | 用户截图、成熟只读工作台、界面规范第 8/9 节 | 已确认并实现；组件和页面回归通过 |
| R-EP-043 | 只读办理工作区的“进度跟踪记录”表保留附件数量展示；数量大于 0 时使用可访问的可点击控件，打开只读附件查看框并以禁用态 FileUpload 展示文件列表，支持既有预览和下载；数量为 0 时显示“—”且不可点击；查看和关闭均不得修改 attachmentRefs | 用户截图、成熟只读工作台、界面规范第 8/9 节 | 已确认并实现；组件和页面回归通过 |
| R-EP-044 | 进度跟踪记录字段各阶段统一为“进展情况、是否重难卡点、完成日期、附件”，不再区分主/子手续采集“总体进度”；进度弹窗对主、子手续展示相同四个字段，完成日期统一必填；历史数据中的 progressPercent 列保留但不再录入和展示（v0.11 的子手续“总体进度”口径自 v0.25 起废止） | 用户批注（最新原型口径）、v0.25 调整 | 已确认并实现 |
| R-EP-045 | “办理”入口只在流程当前所处阶段的页面上出现：年度计划下达页仅当流程处于年度计划阶段（含退回重提）时显示；各手续台账页仅当主单当前阶段与本页阶段一致且当前登录人有待办时显示，其他阶段页面只保留“详情/查看” | 用户批注（各阶段办各自阶段的）、v0.25 调整 | 已确认并实现 |
| R-EP-046 | 年度计划与各手续台账、总台账的线路/标段/单位工程/施工单位筛选统一为按当前用户单位工程权限去重提供的下拉选择（GET /business/engineering-procedure/filter-options），不再手输名称；后端仍按名称匹配既有查询契约 | 用户批注、v0.25 调整 | 已确认并实现 |
| R-EP-047 | 新增/修改年度计划弹窗的单位工程计划表在可编辑状态提供“移除”操作列，移除后同步单位工程选择器与已填数据（保留其余行）；子手续环节 2.1 名称为“产权单位意见征求或规划调整（含涉军、涉铁）”，新建计划与开发库存量阶段单位行按此名称记录 | 用户批注、v0.25 调整 | 已确认并实现 |
| R-EP-048 | 施工许可证结果表单提供“同步应用到本任务全部单位工程”开关（默认勾选）；勾选时只同步同一流程、同一阶段、当前办理节点下的单位工程，服务端逐一校验目标工点数据权限，并先按稳定顺序校验/占用所有目标版本后再写入结果；任一目标越权或版本过期时整批拒绝且不得部分保存。取消勾选时只保存当前单位工程 | 1:N 批次办证规则、代码走查与服务单测 | 已确认；页面完整办理链路待补测 |
| R-EP-049 | 总台账对缺失标段快照按当前用户可见范围批量反查；仅在项目/线路与唯一标段候选均匹配时回填，多个候选或无法唯一判定时留空，不任取首条标段 | 台账一致性复核、代码走查与服务单测 | 已确认；DM8 查询表现待 MCP 回读 |
| R-EP-050 | 年度计划新增拆分为“新增年度计划（土建）/（机电）”两个入口；入口决定流程定义、选择层级与推进单元形态，取消逐工点手选办理通道 | 用户确认（2026-10-15 入口改造） | 已确认 |
| R-EP-051 | 土建入口按“线路-标段-工点”选择工点并保存责任标段（含施工单位名称快照）；工点未被任何标段管辖时责任标段留空；保存/提交时服务端校验管辖关系 | 用户确认（2026-10-15 入口改造） | 已确认 |
| R-EP-052 | 机电入口按“线路-标段”选择标段，标段即办理对象（推进单元为标段，不展开到工点）；标段可选范围为当前线路下全部有效标段，由业务按需要选择 | 用户确认（2026-10-15 入口改造） | 已确认 |
| R-EP-053 | 年度计划查重按入口区分：土建按“工点+年度”、机电按“标段+年度”，命中时点名重复对象 | 用户确认（2026-10-15 入口改造） | 已确认 |
| R-EP-054 | 总台账与导出表头首列为“工点/专业”；完成时间列已完成显示“已完成”，未完成显示计划完成日期；机电行按标段展示，施工标段/施工单位优先取推进单元快照 | 用户确认（2026-10-15 台账对齐） | 已确认 |
5.2 状态模型
流程/审批状态
text
草稿 -> 审批中 -> 已完成
| |
| +-> 退回修改 -> 审批中
+-> 已作废/已终止草稿：计划经办人可以编辑和提交；审批中：业务主单只读，当前办理人进入节点工作区办理；退回修改：按流程退回规则允许修订并沿原实例重新提交；已完成：流程闭环，业务数据只读；已作废/已终止：保留历史数据和原因，不再继续流转。
推进单元进度状态
text
未开始 -> 办理中 -> 已完成
|
+-> 需补充/退回办理该状态仅表示当前手续节点下该单位工程的办理情况，不代表整条流程的审批结果。
进度记录生命周期
text
新增 -> 有效
有效 -> 修改后有效
有效 -> 物理删除（当前节点未锁定时）- 进度记录只能由当前节点有权限的办理人删除；节点提交后及流程退回后的历史只读记录不可删除；
- 物理删除后业务查询中不再返回该记录；本模块只保存附件引用并在成果保存时校验
ossId存在，文件生命周期由平台文件服务负责，本模块不扩展清理策略； - 流程审批历史、退回记录和条件子手续办理记录不属于进度记录，仍保留其流程历史。
6. 权限、异常与非功能要求
6.1 权限与数据范围
- 页面权限控制 7 个页面的可见性；
- 新增、编辑、提交、进度维护、结果资料维护、导出和流程查看分别配置按钮/接口权限；
- 当前任务办理必须由 Warm-Flow 校验当前办理人、节点和流程实例；
- 左侧阶段 Tab 的数量和只读/可编辑状态必须由服务端返回的流程模型类型配置、当前节点和办理权限决定，前端 Tab 切换不能绕过接口鉴权；
- 本模块不建立独立项目权限；工程数据范围按线路、标段、工点控制：土建工点行按“线路×标段×工点”组合判定，机电标段行（推进单元为标段、无工点）按整线授权或受限授权命中该标段判定；
projectId/项目名称快照仅作历史技术兼容，不作为筛选或授权条件； - 同一年度计划内只按标段类型约束单位工程，允许选择不同技术项目下的同类型单位工程；同一单位工程同一年度仍不得重复纳入其他有效计划；
- 单位工程数据必须经过线路/单位工程授权校验；第七页的汇总结果不能通过一个没有权限的明细记录推断出越权数据；
- 流程任务分配与工程数据范围是两套独立条件；被分配任务的账号若没有对应
SITE单位工程授权，详情和写操作仍应被拒绝。真实测试或上线前应为办理/查看账号准备与测试计划匹配的单位工程范围；通过管理员在「授权办理」中勾选单位工程（勾选即单点授权）不会删除或改写已有业务数据； - 退回、终止、作废、条件判断和结果资料变更必须保留操作人、时间和流程上下文；进度记录物理删除不在进度表中保留删除行；
- 管理查看人员只有查看权限时，不得出现可写接口成功的情况。
6.2 异常场景
| 场景 | 系统行为 | 用户提示或补救 |
|---|---|---|
| 流程实例未选择单位工程 | 禁止启动流程 | 先选择至少一个有效单位工程 |
| 责任标段与工点无管辖关系 | 服务端拒绝保存或提交 | 提示“标段与工点不存在管辖关系”，在选择树中重新选择 |
| 所选标段未关联线路 | 服务端拒绝保存或提交 | 提示“所选标段未关联线路，请先维护标段主数据” |
| 单位工程已从工程树失效 | 禁止新增关联，历史记录保留快照 | 联系工程基础管理员修正主数据 |
| 当前节点仍有单位工程未完成 | 禁止提交节点 | 提示未完成清单，逐个补齐 |
| 条件子手续未完成 | 禁止父手续结果完成/节点提交 | 进入子手续完成后返回父手续 |
| 多人同时修改同一单位工程 | 拒绝覆盖较新版本或提示刷新 | 重新加载后合并确认 |
| 重复点击保存/提交 | 保证幂等，不重复产生记录或流程任务 | 展示已保存/已提交结果 |
| 附件上传失败 | 不写入空附件或假成功状态 | 重试上传并保留业务表单输入 |
| 第七页存在部分来源数据 | 真实显示缺失或未开始状态，不补造数据 | 点击来源详情核查 |
| 同一单位工程重复纳入同年度计划 | 服务端按“单位工程+年度”查重拒绝保存/提交 | 提示并列出重复的单位工程名称；不同单位工程可各自下达 |
| 退回阶段后下游已有完成结果 | 目标及后续阶段切换新的办理轮次，旧进度和结果按轮次只读保留；条件记录就地重置，不保留条件历史行 | 从退回目标阶段按顺序重新办理，不能覆盖旧进度和结果 |
| 审批完整性校验失败 | 审批对话框保持打开，不调用流程推进，显示缺失单位工程和缺失项 | 按提示补齐实际完成日期、成果附件和条件子手续后重试 |
| 浏览器/代理层上传失败（如状态码 0） | 不写入空附件或假成功状态；回收本批次计数并显示网络/服务提示 | 检查网络后重试；仍失败时提供计划编号和页面错误信息 |
| 上传成功后附件列表短暂抖动 | 附件列表不播放改变布局的进入动画，并复用稳定文件键值 | 无需额外操作；如仍有抖动记录浏览器视口和计划编号 |
| 只读结果区仅显示附件数量 | 结果/证件资料区域无法直接确认成果文件 | 直接展示禁用态文件列表；文件名预览、下载均沿用公共 FileUpload，不开放上传和删除 |
| 进度附件数量不可查看 | 进度表只展示数量，未提供查看入口 | 有附件时点击数量打开只读查看框；无附件显示“—”并保持不可点击；查看失败不修改业务附件引用 |
| 流程办理人未获单位工程范围 | 详情/写接口按线路和 SITE 范围拒绝，不因有待办而绕过授权 | 由管理员补授对应单位工程范围后重新打开待办 |
6.3 非功能要求
- 列表和汇总查询应支持分页，导出采用固定列顺序和统一日期格式；
- 条件判断、结果资料和流程动作可审计；进度记录按用户确认允许物理删除，删除后不保留业务表行；
- 关键动作服务端事务化：单位工程完成、子手续完成、节点提交和结果资料关联不能出现半成功状态；
- 页面明确区分“进度状态”和“审批状态”，颜色和文案不得混用；
- 文件服务异常时给出可定位提示，不记录真实账号、令牌或外部系统凭据。
- 附件列表更新应保持稳定键值和无布局位移的紧凑展示；文件成功回显后不依赖进入动画表达成功，上传失败也不能让页面停留在无穷加载状态。
- 只读工作区的结果附件必须直接呈现文件；进度附件在表格中只呈现数量，但有附件时必须提供可访问的查看入口，查看框使用禁用态文件列表，不得引入新的持久化字段或改变附件引用。
- 审批时间线统一按三段信息展示：第一行节点名称后紧跟审批状态，会签/或签/票签固定在卡片右上角；第二行显示当前办理人并保持紧凑上下间距；第三行显示开始时间、结束时间和运行时长。协作标签与审批状态标签保持相同尺寸和排版，但使用独立色板；节点名称、办理人显示不下时提供完整悬停提示，审批意见允许自然换行且不得单行截断。
7. 验收标准
| 编号 | 角色 | 前置条件 | 操作 | 预期结果 | 证据 |
|---|---|---|---|---|---|
| AC-EP-001 | 年度计划经办人 | 有 2 个以上有效单位工程 | 新建年度计划并选择多个单位工程 | 形成一个流程实例，明细显示全部单位工程及快照 | 页面、接口、数据库 |
| AC-EP-002 | 手续办理人 | 流程进入当前节点 | 只填全其中一个单位工程就点同意 | 同意被阻止，并点名未填全（缺实际完成日期/成果附件/条件子手续）的单位工程 | 页面、接口、流程任务 |
| AC-EP-003 | 手续办理人 | 当前节点可编辑 | 对同一单位工程追加两条进度记录，修改一条并物理删除一条；使用有权限的其他账号查看 | 保存和修改后的记录正确可见；被删除记录不再出现在业务查询；流程节点不变化 | 页面、接口、数据库 |
| AC-EP-004 | 手续办理人 | 当前节点可编辑 | 保存进度但不点击节点提交 | 刷新后数据仍在，流程仍停留在当前节点 | 页面、流程状态 |
| AC-EP-005 | 条件确认人 | 三个条件项首次打开 | 分别选择“不需要”“需要”，并在子手续未完成前把“需要”改回“不需要” | 每个条件独立保存且默认“不需要”；“需要”进入子手续；子手续未完成前可改回“不需要”直接跳过；不再提供“需要再次”，再次办理通过退回；不出现系统建议值、确认值或修改原因第二套字段 | 页面、接口、数据库 |
| AC-EP-006 | 手续办理人 | 任一条件选择“需要” | 未完成对应条件子手续时点同意 | 同意被阻止并点名该单位工程（条件子手续未完成） | 页面、接口 |
| AC-EP-007 | 手续办理人 | 所有适用单位工程及子手续填全 | 点同意 | 流程进入下一节点，前一节点只读 | 流程图、接口、待办 |
| AC-EP-008 | 管理查看人员 | 前六页存在不同进度 | 进入第七页并筛选单位工程 | 汇总状态与来源明细一致，不出现新增/编辑按钮 | 页面、接口 |
| AC-EP-009 | 仅查看用户 | 无写权限 | 直接调用保存、删除或提交接口 | 服务端拒绝，数据不变化 | 接口、日志 |
| AC-EP-010 | 任意用户 | 当前页面存在办理数据 | 导出总台账 | 导出列、顺序、日期和状态与固定格式一致 | 文件、接口 |
| AC-EP-011 | 办理人 | 两个会话并发编辑 | 使用旧版本提交 | 拒绝覆盖或要求刷新，不丢失新版本 | 接口、数据库 |
| AC-EP-012 | 审核/审批人 | 流程进入退回路径 | 退回到前面阶段后重新修改并提交 | 原流程实例继续流转；退回目标及后续阶段按顺序进入待重办；旧结果保留为历史但不再作为当前完成结果 | 流程记录、接口 |
| AC-EP-013 | 年度计划经办人 | 同一年度已有覆盖部分单位工程的计划 | 用未覆盖的单位工程新建同年度计划；再把已覆盖的单位工程纳入另一计划 | 前者允许（不按线路设置年度计划唯一限制）；后者服务端拒绝并点名重复单位工程；草稿可调整，提交后不能增删单位工程 | 页面、接口、数据库 |
| AC-EP-014 | 手续办理人 | 当前单位工程仅有进度记录，缺少实际完成日期或最终成果附件 | 点击“同意” | 服务端拒绝并点名缺实际完成日期/成果附件/条件子手续的单位工程；补齐后才可通过同意 | 页面、接口 |
| AC-EP-015 | 手续办理人 | 当前节点可编辑 | 通过弹窗新增、编辑和删除进度记录 | 新增/编辑在弹窗完成，表格只读并显示附件数量；保存后记录立即可见，删除后业务查询不再返回；节点状态不被改变 | 页面、接口 |
| AC-EP-016 | 年度计划经办人 | 草稿已选择首节点办理人 | 保存草稿后再次打开提交窗口 | 提交窗口带出已保存的办理人；提交时服务端仍重新校验办理人有效性和权限 | 页面、接口、自动化 |
| AC-EP-017 | 手续办理人 | 当前节点存在未填全单位工程 | 在审批对话框点击“同意” | 对话框保持打开，红色提示点名缺失单位工程和缺失项，流程状态不变 | 页面、流程任务 |
| AC-EP-018 | 手续办理人 | 当前节点可编辑 | 上传一个或多个结果/进度附件，并覆盖失败重试场景 | 请求携带 multipart 文件、鉴权和扩展属性；成功后附件可回显；失败批次结束并提示，不产生假附件；列表稳定无明显抖动 | 页面、后端日志、组件测试 |
| AC-EP-019 | 流程办理人 | 账号有当前任务但尚无对应单位工程范围 | 打开待办详情并尝试办理 | 服务端拒绝越权访问；补充 SITE 范围后可加载并按权限编辑 | 页面、接口、权限记录 |
| AC-EP-020 | 任意登录用户 | 仪表盘或待办入口需要回退 | 进入待办页面或触发路由回退 | 地址使用 /task/taskWaiting，页面正常加载，不出现旧路径 404 | 页面、路由 |
| AC-EP-021 | 仅查看用户/前序办理人 | 只读阶段存在成果附件 | 打开结果/证件资料区域 | 直接显示文件类型图标、文件名和下载动作；点击文件可用既有预览；没有上传、删除、编辑控件；无附件显示“—” | 页面 |
| AC-EP-022 | 仅查看用户/前序办理人 | 进度记录存在 0 个、1 个或多个附件 | 查看进度表附件列并点击数量 | 0 个显示“—”且不可点击；有附件显示数量链接/按钮，点击打开只读附件查看框，文件可预览/下载；关闭后原页面和 attachmentRefs 不变 | 页面、组件测试 |
| AC-EP-023 | 任意流程查看用户 | 审批时间线存在节点名称、审批状态、办理人和协作类型 | 打开流程工作台并查看时间线卡片 | 节点名称后紧跟审批状态；会签/或签/票签固定在右上角并与状态标签同尺寸但使用独立色板；办理人行上下间距紧凑；审批意见长文本可完整换行，名称和办理人可悬停查看完整内容 | 页面、组件测试、类型/静态检查 |
8. 待确认事项与变更记录
8.1 不阻塞业务基线的待确认事项
| 编号 | 问题 | 影响 | 负责人 | 状态 |
|---|---|---|---|---|
| Q-EP-001 | 五个实际手续阶段与真实组织部门/岗位/候选人的固定对应关系是什么 | 流程候选人和权限初始化 | 业务负责人/流程管理员 | 首期不固化，后续按实际运行情况完善 |
| Q-EP-002 | 每类手续的完整字段、必填项、证件结果类型和附件清单是什么 | 表单和结果资料设计 | 业务负责人 | 首期按原型表达的业务要求实现，后续可细化 |
| Q-EP-003 | Excel 总台账的最终列顺序、状态文案和导出模板是否完全沿用 | 第七页列和导出 | 业务负责人 | 格式作为导出参考；名称按实际业务保留 |
| Q-EP-004 | 进度记录删除和节点退回后的历史查看规则 | 审计和数据模型 | 业务负责人/技术负责人 | 已确认：进度记录物理删除；已提交/历史记录只读 |
| Q-EP-005 | 三个独立条件菱形分别为：产权单位意见征求/规划调整挂在 2，建设用地规划许可证/土地划拨决定书挂在 4，土地征收和转用批复/林地占用手续办理挂在 4.1；使用“不需要/需要”两个选项，按单位工程分别判断，任一单位工程需要即走子流程分支，再次办理通过退回 | 流程图菱形分支、条件模型 | 业务负责人 | 已确认 |
| Q-EP-006 | 是否需要把历史 Excel 数据导入系统，以及导入时的唯一匹配规则 | 初始化和迁移 | 业务负责人 | 已确认：不导入，Excel 仅作格式参考 |
| Q-EP-007 | 两套独立流程定义在 Warm-Flow 中的版本、表单注册方式和流程退回策略 | 流程实现 | 流程管理员/技术负责人 | 已确认运行态最新版本为土建 V3、机电 V2，两套定义已导入且导入结果无问题；表单注册和真实业务集成继续按运行验收核对 |
| Q-EP-008 | 所属标段 bidCategory 为空或不是土建/机电时的处理规则 | 年度计划选型和数据校验 | 业务负责人/工程基础管理员 | 已确认：禁止选择并提示“基础数据异常” |
8.2 关键结论来源
| 编号 | 结论 | 来源 | 最近核对日期 |
|---|---|---|---|
| S-EP-001 | 原型中的“工点”按工程树中的单位工程理解 | 用户确认、工程基础文档 | 2026-09-07 |
| S-EP-002 | 每个外层框是一个流程节点；框内第一层反复填报进度，第二层上传最终资料并提交，二者不拆节点；三个子手续外层框分别挂在父节点条件分支下 | 用户确认、最新流程图 | 2026-09-09 |
| S-EP-003 | 一个流程实例覆盖多个单位工程，办理人逐个单位工程完成 | 用户确认 | 2026-09-07 |
| S-EP-004 | 进度跟踪记录可在节点内多次追加、修改和删除 | 用户确认 | 2026-09-07 |
| S-EP-005 | 第七页为独立的手续办理推进总台账 | 用户确认、Excel 台账 | 2026-09-07 |
| S-EP-006 | 同一单位工程同一年度只允许纳入一份有效年度计划，草稿可调整、提交后不可增删单位工程；不同单位工程可分别下达 | 用户确认、方案建议 | 2026-09-07 |
| S-EP-007 | 条件判断使用“不需要/需要”两个选项，默认“不需要”，子手续返回原判断人；再次办理通过退回，不再提供“需要再次” | 用户确认（v0.11 调整） | 2026-09-09 |
| S-EP-008 | 进度记录物理删除；授权用户可看到已保存的进度内容，流程历史和子手续轮次另行保留 | 用户确认 | 2026-09-07 |
| S-EP-009 | 进度记录采用独立弹窗新增/编辑/删除，进度表格只读展示附件数量 | 用户确认（v0.12 调整） | 2026-09-09 |
| S-EP-010 | 办理人、审核人和候选岗位使用现有部门树/人员筛选/多人选择通用用户选择器，不使用下拉框 | 用户补充 | 2026-09-07 |
8.3 变更记录
v0.22（2026-09-13）同步：标段专业大类保存回读和年度计划草稿页面链路已完成真实复测；选择器类型异常的前置配置与重复字段覆盖修复已记录在测试与验收。退回重办和新建可选单位工程不足场景仍待补测。
v0.23（2026-09-17）工程数据权限优化同步：取消运营公开后，工程手续不再按节点运营状态过滤或拒绝；R-EP-031 只保留“土建/机电”两页签与标段
bidCategory校验，运营单位工程与其他单位工程一致按授权可见、可选。（本条中“选择器不隐藏运营单位工程”的展示口径已于 2026-09-18 调整，见 v0.24。）
v0.24（2026-09-18）单位工程选择器默认隐藏运营：选择器默认隐藏
biz_status='2'（运营）的单位工程并提供“显示运营”开关（默认关闭），打开后运营单位工程可正常选择与提交；与 v0.23 的差异是“不隐藏”调整为“默认隐藏、可切换显示”，服务端仍不按运营状态过滤或拒绝，v0.23 取消的拒绝逻辑保持删除状态。2026-09-18 页面回归（有限范围）结论与未覆盖项见测试与验收。
| 版本 | 日期 | 变更 | 确认人 |
|---|---|---|---|
| v0.1 | 2026-09-07 | 建立 7 页面业务基线，统一“单位工程”、流程工作区和节点内多次进度填报口径 | 待补充 |
| v0.2 | 2026-09-07 | 补充土建/机电类型不可混选，并按类型配置阶段 | 用户补充、流程图核对 |
| v0.3 | 2026-09-07 | 确认年度计划唯一范围、单位工程完成门槛、办理/审核动作、退回重办规则、条件三选项和进度物理删除；取消许可证名称全局改名假设 | 用户确认 |
| v0.4 | 2026-09-07 | 确认进度跟踪表采用 VXE 行内编辑，不使用新增/编辑弹窗 | 用户确认 |
| v0.5 | 2026-09-07 | 补充办理人、审核人和候选岗位统一使用通用用户选择器，禁止普通下拉框 | 用户补充 |
| v0.6 | 2026-09-07 | 完成首轮前后端实现、公共流程分类/定义、菜单和权限注册；补充退回重办轮次处理 | 首轮实现与开发库核验 |
| v0.7 | 2026-09-09 | 年度计划从办理 Tab 中独立；工作区按土建 5 Tab/机电 2 Tab 展示，改为左侧单位工程表单、右侧审批时间线并优化首屏加载 | 用户确认、首轮实现调整 |
| v0.8 | 2026-09-09 | 按最新流程图修正节点模型：阶段只作 Tab 分组，外层框一一对应业务节点；补齐 1.1、3.1.1、3.1 子手续位置、父节点返回和节点内“两层操作”语义 | 用户确认、最新流程图核对 |
| v0.9 | 2026-09-09 | 土建/机电改为两套独立流程定义；补齐年度计划单位工程逐行阶段计划日期；按 7 字换行、四向锚点、正交铺满画布和无静态退回线规范校正流程资源 | 用户确认、流程规范、原型核对 |
| v0.10 | 2026-09-09 | 按原型泳道图统一流程节点编号（年度计划=1，手续阶段=2~6，子手续随父=2.1/4.1/4.1.1），新增结束前工程部“7 接收、备案并归档”直通节点；土建 15 节点/17 连线、机电 6 节点/5 连线 | 用户确认、原型泳道流程图核对 |
| v0.11 | 2026-09-09 | 条件取消“需要再次”，只保留“不需要/需要”，再次办理改由流程退回触发，子手续未完成前可把“需要”改回“不需要”直接跳过；进度记录主手续新增“是否重难卡点”、列名对齐“完成日期”，子手续用“总体进度”；同一节点任一单位工程需要即走子流程分支 | 用户确认、原型办理页核对 |
| v0.12 | 2026-09-09 | 进度记录由 VXE 行内编辑改为独立弹窗新增/编辑/删除，表格只读、附件列显示数量；“需要/不需要”条件压缩为原型式紧凑一行下拉，不再占大块 UI；父手续证件在“需要”子手续未完成前置灰；年度计划查重放宽为按“单位工程+年度”，命中时点名重复单位工程，不再限制同项目同年度只能一份；办理动作简化为“暂存 + 同意”，去掉独立“完成单位工程”按钮，同意时统一校验并点名未填全的单位工程；同意校验只读，完成状态在流程前进离开节点时才落库（不提前锁定单位工程）；结果保存引入 expectedVersion 乐观锁（并发覆盖时拒绝并提示刷新），进度新增加 @RepeatSubmit 防重复插入 | 用户确认、原型办理页核对 |
| v0.13 | 2026-09-09 | 落地手续台账页（每行=单位工程）、推进总台账（单位工程×8 手续列矩阵，补施工图审查合格书）、线路级 Excel 导出（按线路分 sheet、两行合并表头）；四色进度状态与办理人/部门按实例当前办理人派生；后端新增 /ledger 查询与 /summary/export | 用户确认、原型线路级 Excel 核对 |
| v0.14 | 2026-09-10 | 按审查报告(GPT-6 Astra)修复：数据范围(A02)、子手续进度日期契约(A03)、历史轮次保护(A04)、成果原子CAS(A05)、进子手续不过早锁定(A06)、附件存在性校验(A09)、编辑保存重难卡点(A10)、台账当前轮次(A11)、台账责任人取流程待办办理人(A12)、台账筛选与施工单位列(A14)、只读跨轮次历史(A15)、动作权限与暂存依赖(A16)；条件遗留列 DROP | 审查报告 |
| v0.15 | 2026-09-10 | 修复 EP-A01：复用 Warm-Flow 全局监听器 start 前置扩展点，由服务端校验节点数据并重算网关变量；单位工程从标段带出施工单位中文名称快照并补齐历史空值；五个手续页改为“当前阶段及已通过阶段”的累计范围；土建改为 4 → 4.1 → 4.1.1 嵌套条件流程，重排锚点和回路并补充连线不得共享线段的规范 | 用户补充、流程图核对、开发实现 |
| v0.16 | 2026-09-10 | 确认 Warm-Flow 运行态最新流程版本：土建 V3、机电 V2；两套流程均已由流程管理员导入，导入结果确认无问题 | 用户确认 |
| v0.17 | 2026-09-10 | 按当前代码反写：权限改为线路/单位工程范围且不设独立项目权限；五个手续页和总台账补充年度、线路、标段、单位工程、施工单位、审核状态筛选；退回重办时条件记录就地重置，不扩展附件生命周期；修复 Excel 页签命名规则，并清理已废弃的重办专用测试项 | 用户确认、当前代码核对 |
| v0.18 | 2026-09-10 | 收口无项目权限口径：年度计划移除前后端“同项目”选择限制和页面项目展示；单位工程筛选改按单位工程名称快照反查主单，空匹配返回空集；列表查询补齐空值安全；增加跨项目同类型选择和单位工程筛选回归用例 | 用户确认、当前代码核对 |
| v0.19 | 2026-09-12 | 完成主要真实角色端到端复测：补齐 4 个测试账号的 5 个单位工程范围，验证同一任务多单位工程、多次填报、条件子手续、跨账号节点流转和机电/土建归档；修复草稿首节点办理人快照、审批校验错误反馈、附件 multipart 上传及失败收敛、附件列表稳定展示、待办回退路由；补充保留测试数据、证据文件和未验证范围 | 用户授权的内置浏览器复测、代码/接口/自动化验证 |
| v0.20 | 2026-09-12 | 明确只读办理工作区附件展示：结果/证件资料直接显示成果文件；进度表保留附件数量并提供点击查看只读附件列表；两种展示均复用禁用态 FileUpload 的预览/下载能力，不改变附件字段、上传接口和数据生命周期 | 用户截图、成熟只读工作台、界面与交互规范核对；组件与内置浏览器回归 |
| v0.21 | 2026-09-12 | 收口审批时间线最终展示：节点名称后紧跟审批状态；会签/或签/票签固定在卡片右上角并沿用状态标签的尺寸排版但使用独立色板；当前办理人行和时间信息区采用紧凑间距；审批意见完整换行，节点名称和办理人支持悬停查看完整值 | 用户最终确认、界面与交互规范核对、组件回归和内置浏览器复测 |
| v0.22 | 2026-09-13 | 标段专业大类保存回读和年度计划草稿页面链路已完成真实复测；选择器类型异常的前置配置与重复字段覆盖修复记录在测试与验收 | 内置浏览器页面复测、代码/接口/自动化验证（来源为 v0.22 正文块，原文未单列确认人） |
| v0.23 | 2026-09-17 | 工程数据权限优化联动：单位工程选择器不再过滤或拒绝运营单位工程，R-EP-031 改为仅保留“土建/机电”两页签与标段 bidCategory 校验；节点运营状态不再参与工程手续的任何过滤或拒绝 | 用户确认（工程数据权限优化口径）、当前代码核对 |
| v0.24 | 2026-09-18 | 单位工程选择器默认隐藏运营单位工程并提供“显示运营”开关（默认关闭），打开后可正常选择与提交；服务端仍不按运营状态过滤或拒绝，v0.23 取消的拒绝逻辑保持删除状态，R-EP-031 按新口径改写 | 用户确认（业务侧默认隐藏运营口径）、当前代码核对 |
| v0.25 | 2026-09-29 | 用户批注 16 条问题修复：R-EP-009/011/013/016 按新口径改写（条件子手续以子任务节点为准、同意前自动落库、阶段 Tab 显隐/吸顶/详情定位）；新增 R-EP-044~047（进度字段统一去“总体进度”、办理入口按当前阶段门控、筛选下拉权限选项接口 filter-options、计划表移除列与 2.1 名称“含涉军、涉铁”）；工作台进度记录空状态缩小并内联滚动 | 用户问题清单与批注截图、前后端实现、开发库回写 |
| v0.26 | 2026-10-08 | 优化条件宿主节点多单位工程流转校验：在节点 2、4、4.1 等条件宿主节点，任一单位工程需要且未完成子手续（流向进入子流程分支）时，暂不校验主节点各单位工程的完成时间和成果附件；仅当所有单位工程均不需要子流程（或子流程已全部办结）、流程准备离开主节点时，才统一校验所有单位工程完成时间和成果文件；同时优化前端表单暂存按钮至吸顶切换栏并增加未保存状态感知 | 用户明确要求、业务规则对齐、代码实现与单测验证 |
| v0.27 | 2026-10-09 | 手续办理工作台体验级重构与清单全景落地：1. 新增“办理清单”全景功能面板（ProcedureChecklistPanel），梳理五大主体责任要件（重庆建工、林同棪、招商局交科院、交开投集团等）及高清交互流程图；2. 阶段 Tab 升级为流线型步骤向导条（含 01~05 序号、已办结徽标、当前待办微动效）；3. 单位工程与节点状态挂载就绪诊断卡（实际完成日期/成果附件/子手续闭环检查）；4. 条件栏升级为卡片式决策指引组件（分段胶囊按钮、前置业务提示、子手续协同联动反馈）；5. 彻底移除弃用的顶部“查看历史”及轮次弹窗；6. 适配 1920×911 视口紧凑排版，彻底消除横向滚动条 | 用户明确指令、业务体验方案一、前端实现与测试回归 |
| v0.28 | 2026-10-13 | 体验优化与真实推进台账对齐：①年度计划下达顶部筛选条件补充线路名称搜索；②子手续办理中时主节点隐藏「结果/证件资料」区域，避免无效填报；③表单自上而下顺序统一为父级在上方、子级在下方（4.1在4.1.1上方）；④未点击暂存直接点同意时增加未保存友好拦截提示；⑤子手续办结归档返回后协同决策默认切换为「不需要（直行推进）」；⑥施工许可证落实 1:N 任务批次统一办证与全部工点结果共享机制；⑦手续推进总台账结构对齐全线推进表，补充施工标段与责任部门，并通过管辖标段与统包标段动态补全标段及施工单位。 | 用户 2026-10-13 清单与全线推进表比对、前后端实现、测试通过 |
| v0.29 | 2026-10-15 | 录单入口与台账对齐改造：①新增年度计划拆分为“新增年度计划（土建）/（机电）”两个入口，取消逐工点手选办理通道；②土建入口按“线路-标段-工点”选择工点并保存责任标段（含施工单位名称快照），服务端校验标段与工点的管辖关系；③机电入口按“线路-标段”选择标段，标段即办理对象，年度计划查重按“标段+年度”；④总台账/导出表头首列改为“工点/专业”，完成时间按“已完成/计划完成日期”展示；⑤台账、施工许可证 1:N 同步与计划列表权限适配机电标段级（无工点）可见判定 | 用户 2026-10-15 需求确认与逐条拍板、前后端实现与测试 |