主题
工程手续办理 · 概要设计文档
文档版本：1.00 ｜ 最近核对日期：2026-10-15
进展说明：代码、流程资源和主要真实角色端到端链路已复验；运行态土建
V3、机电V2已导入。本轮（2026-10-15）按用户需求完成录单入口改造与台账对齐：年度计划新增拆分为“新增年度计划（土建）/（机电）”两个入口——土建按“线路-标段-工点”选择工点并带入责任标段，机电按“线路-标段”选择标段且标段即办理对象，取消逐工点手选办理通道；推进总台账与导出表头首列改为“工点/专业”，完成时间按“已完成/计划完成日期”展示；台账、施工许可证 1:N 同步与计划列表权限适配机电标段级（无工点）可见判定。
本文不对许可证名称做全局归并。流程节点、条件子手续、页面和台账中的名称按实际业务定义分别保存；同名或相近名称是否属于同一业务对象，在流程资源核对时单独确认。
1. 设计目标与边界
1.1 设计目标
- 用一个流程实例承载多个推进单元（土建=工点、机电=标段）；
- 用流程图外层框一一对应 Warm-Flow 业务节点；同一外层框内的反复填报进度、填写成果并提交是一个节点内的两个操作层次；
- 将单位工程级完成状态、节点级流转状态和流程级审批状态分开；
- 让前六个业务页面保持统一交互，第七页只读聚合；办理工作区顶部以流线型步骤向导条呈现（含年度计划只读 Tab + 01~05 编号的手续阶段向导 + 办理清单全景 Tab）；彻底移除弃用的“查看历史”按钮及轮次弹窗；
- 提供单位工程就绪诊断检查卡（消除未就绪黑盒）与卡片式条件协同决策组件（分段胶囊按钮组与联动锁定警示），针对 1920×911 视口紧凑排版，彻底消除横向滚动条；
- 最大限度复用工程树、Warm-Flow、文件服务和既有流程工作台组件；土建与机电各自使用独立流程定义，不复制流程能力和工作台；通过
GlobalListener.start的业务扩展点在路由前执行服务端校验。
审批时间线作为流程工作台的全局共享组件统一收口：卡片第一行显示“节点名称 + 审批状态”，协作标签（会签/或签/票签）固定右上角并沿用审批状态标签的几何规格但使用独立色板；第二行显示当前办理人并保持紧凑间距，第三行显示时间信息；节点名称和办理人提供完整悬停提示，审批意见自然换行且不做单行截断。
1.2 模块边界
本模块负责年度计划及土建五个、机电两个实际手续阶段的业务数据、单位工程明细、进度记录、条件子手续、结果资料、流程关联及总台账汇总；年度计划独立维护。
本模块不负责工程树主数据、组织岗位主数据、Warm-Flow 通用任务能力、外部审批系统真实办理和文件存储底层实现。
2. 模块分解
| 子模块/能力 | 职责 | 上游输入 | 下游输出 |
|---|---|---|---|
| 年度计划下达 | 建立年度计划，选择多个单位工程并启动流程 | 工程树、年度、计划信息 | 计划主单、流程实例、单位工程快照 |
| 阶段手续办理（五个实际手续阶段） | 统一展示阶段 Tab、外层手续节点、单位工程清单和办理工作区 | 流程任务、单位工程明细 | 进度记录、结果资料、完成状态 |
| 条件子手续 | 分别管理三个条件菱形及对应子手续：产权单位意见征求/规划调整、土地征收和转用批复/林地占用手续办理、建设用地规划许可证/土地划拨决定书 | 工程基础数据、办理人确认 | 多条条件记录、子手续状态、父子关联 |
| 流程交互 | 启动、办理、退回、提交和查看流程 | Warm-Flow | 当前节点、历史记录和流程状态 |
| 推进总台账 | 从来源业务数据实时汇总进度和完成状态 | 年度计划、前六页业务数据 | 查询结果、详情跳转、导出文件 |
| 权限与审计 | 校验资源权限、线路/单位工程范围和关键操作留痕 | 平台权限、工程树范围 | 授权结果、审计证据 |
3. 菜单、路由与流程资源
3.1 应用菜单层级
text
工程手续办理（一级业务模块，与“工程变更监管”同级）
├─ 年度计划下达
├─ 规划方案审查意见
├─ 初步设计批复
├─ 建设工程规划许可证
├─ 施工图审查合格书
├─ 施工许可证
└─ 手续办理推进总台账（只读）前六个页面分别提供年度计划和手续阶段入口，也是对应台账；年度计划下达页提供“新增年度计划（土建）/（机电）”两个入口，入口决定选择层级（土建“线路-标段-工点”、机电“线路-标段”）与流程定义。进入某条流程的办理工作区后，顶部以步骤向导条展现：年度计划只读 Tab、手续阶段向导（土建 5、机电 2）以及“办理清单”全景功能 Tab。年度计划仍作为 Warm-Flow 申请人节点承接计划提交和退回重提，其工作区 Tab 只读带出、不生成业务阶段记录。办理工作区采用左侧手续表单、右侧审批时间线的布局，为隐藏路由，由当前任务或台账操作进入；独立“办理规则”与“查看历史”区域不再展示。第七页只提供查询、详情跳转和导出，不绑定流程资源。
3.2 流程分类与流程示例
| 资源 | 建设要求 | 说明 |
|---|---|---|
| 系统菜单 | 一级菜单“工程手续办理” | 与“工程变更监管”同级，不能作为其子菜单 |
| 流程分类 | “工程手续办理” | 分类 ID 2110000000000000800；与“工程变更监管”一级模块同级 |
| 土建流程定义 | 独立土建流程 | 编码 engineering_procedure_civil；运行态最新版本 V3，已导入且导入结果确认无问题；bidCategory=土建 时启动，生成 5 个实际手续阶段 |
| 机电流程定义 | 独立机电流程 | 编码 engineering_procedure_mep；运行态最新版本 V2，已导入且导入结果确认无问题；bidCategory=机电 时启动，生成 2 个实际手续阶段：施工图审查合格书、施工许可证 |
| 旧流程兼容 | 历史公共流程 | 编码 engineering_procedure 仅兼容在途旧实例，不作为新年度计划的启动定义 |
| 流程表单 | 共用手续办理工作区 | 通过工程类型、流程实例和单位工程明细动态显示当前流程的阶段 Tab 和节点内容 |
| 汇总页面 | 不绑定流程 | 只读聚合前六页和年度计划数据 |
运行态流程版本以 Warm-Flow 已导入的定义为准：土建 engineering_procedure_civil 使用 V3，机电 engineering_procedure_mep 使用 V2。两套定义已导入，导入结果已确认无问题；历史公共定义和在途实例仍按兼容策略保留，不直接覆盖。
年度计划按推进单元查重：土建按“工点+年度”、机电按“标段+年度”，同一推进单元同一年度不能重复纳入其他有效计划（服务端拒绝并点名重复对象）；不按线路设置年度计划唯一限制；草稿可调整，提交后不能新增或移除。新增入口分为“新增年度计划（土建）/（机电）”：土建入口按“线路-标段-工点”选择工点并带入责任标段（服务端校验标段与工点的管辖关系，指定工点或全线统包），机电入口按“线路-标段”选择标段（标段即办理对象，可选范围为线路下全部有效标段，不展开到工点）；选择器默认隐藏运营节点并提供“显示运营”开关（默认关闭，仅切换显示层，2026-09-18 起口径），不按运营状态拒绝；入口决定绑定 engineering_procedure_civil 或 engineering_procedure_mep 流程定义，前端入口不能替代服务端校验。年度计划表按推进单元逐行维护该类型全部阶段的计划完成日期，并保存责任标段/办理对象标段与施工单位中文名称快照；提交时校验齐全，办理工作区只读带出，历史空快照由读取接口补齐。
流程示例只把流程图外层框定义为 Warm-Flow 业务节点。框内“反复填报进度”和“上传最终资料并提交”是同一节点内的两个操作层次；2.1、4.1.1、4.1 这些自身带外层框的子手续仍是独立节点。土建条件链为 4 先判断是否需要 4.1，4.1 再判断是否需要 4.1.1。全部手续完成后进入结束前的 7 接收、备案并归档直通节点（工程部办理，不生成手续阶段 Tab）。阶段名称只用于把节点归组到阶段 Tab，条件菱形只负责分流，不额外生成表单节点。节点文案遵循流程图编排规范：精简后每行最多 7 个中文字符、最多 3 行；连线从四向锚点出发，折点为正交路径；任意两条连线不得共享水平/垂直线段、交叉、重叠或穿过节点，回父节点使用独立外圈通道；不画静态退回线，退回使用 Warm-Flow 标准动作，子手续完成回父节点的真实业务闭环线除外。
4. 核心运行流程
外层流程节点与流程图外框一一对应。2.1、4.1.1、4.1 是实际的子手续节点；三个钻石形判断分别对应三类条件，不合并为一个字段；全部手续阶段完成后进入结束前的 7 接收、备案并归档直通节点。每个外层节点内部先由办理人逐个单位工程反复维护进度，再填写最终成果并提交，不把这两个操作层次拆成两个流程节点。子手续完成后回到原父节点，由原判断人选择“不需要”结束该条件；如需再次办理，通过流程退回重办（不再提供“需要再次”），子手续未完成前也可把“需要”改回“不需要”直接跳过。阶段退回导致重办时，阶段和阶段-单位工程切换 WORK_ROUND_NO，旧进度和结果按轮次只读保留；条件记录就地重置和更新，不新增条件历史行。
5. 状态模型
| 对象 | 状态 | 进入条件 | 允许动作 | 离开条件 |
|---|---|---|---|---|
| 流程实例 | 草稿 | 计划保存未提交 | 编辑、删除、提交 | 启动流程或作废 |
| 流程实例 | 审批中 | 已启动且存在当前节点 | 当前办理人办理、查看、保存 | 节点提交、退回、终止 |
| 流程实例 | 退回修改 | 节点被退回 | 按规则修改、重新提交 | 原流程实例重新进入审批中 |
| 流程实例 | 已完成 | 全部节点完成 | 查看、导出 | 终态 |
| 流程实例 | 已作废/已终止 | 用户作废或平台终止 | 只读、查看原因 | 终态 |
| 单位工程明细 | 未开始 | 当前外层节点尚未办理 | 开始办理 | 首次保存 |
| 单位工程明细 | 办理中 | 已保存进度或结果 | 追加/修改/删除记录、上传资料 | 标记完成或退回 |
| 单位工程明细 | 已完成 | 当前外层节点的要求已满足 | 只读 | 节点退回或进入下一节点 |
| 单位工程明细 | 待重办 | 目标阶段或前置阶段退回 | 开启新办理轮次并按当前任务重新办理 | 重新完成当前阶段 |
| 条件子手续 | 不需要 | 当前决策为“不需要” | 查看当前决策 | 父手续继续 |
| 条件子手续 | 办理中 | 确认需要且已创建 | 按单位工程办理 | 子手续完成或退回 |
| 条件子手续 | 已完成 | 子手续的单位工程均完成 | 查看 | 父手续继续 |
| 条件子手续 | 待办理 | 决策为“需要”且子手续未完成 | 进入子手续节点办理 | 子手续单位工程完成后转为已完成 |
| 条件子手续 | 已完成 | 对应子手续单位工程完成 | 查看；父手续据此放行 | 决策改“不需要”或流程退回重办时就地更新条件记录，按新的阶段轮次重新办理 |
进度状态是单位工程/手续维度的业务进度；审批状态是流程实例维度的流转状态。总台账同时展示两者。
6. 数据对象关系
text
[流程实例] 1 ── N [流程阶段实例：土建 5 个 / 机电 2 个]
|
+── N [流程实例-推进单元（土建=工点、机电=标段）]
|
+── N [阶段-外层节点-推进单元明细]
|
+── N [节点进度记录]
+── N [手续结果/证件资料]
+── N [条件判断/子手续]
+── N [条件决策（需要/不需要）与子手续完成情况]
[流程实例] 1 ── 1 [Warm-Flow 流程关联]
[手续结果/证件资料] N ── N [平台附件]
[前六个业务页面来源数据] ──> [第七页总台账查询视图/聚合结果]- 流程实例是跨多个同类型推进单元、按
engineering_procedure_civil或engineering_procedure_mep独立流程定义包含 5 个（土建）或 2 个（机电）实际手续阶段的业务批次；年度计划只作为独立业务主单和 Warm-Flow 申请节点，不计入阶段实例； - 流程阶段实例保存每个 Tab 的表单、阶段状态和当前节点映射；阶段 Tab 只是节点分组，不直接代表一个 Warm-Flow 任务；
- 阶段-外层节点-推进单元明细是外层节点内逐个办理和完成的最小业务粒度；规划阶段包含
2.1/2两组明细，建设工程规划许可证阶段包含4.1.1/4.1/4三组明细；7接收备案归档为结束前直通节点，不生成阶段-推进单元明细； - 进度记录是可追加的事实记录，不是流程节点；进度记录通过独立弹窗新增/编辑/删除，进度表格只读展示并在附件列显示文件数量；数量大于 0 时可点击打开只读附件查看框，数量为 0 时显示“—”且不可点击；同一外层节点内先反复保存进度，最后以结果资料提交节点；
- 结果资料与阶段、单位工程和手续类型关联；同意提交时统一校验每个适用单位工程须有实际完成日期和原型要求的最终成果附件，未填全点名单位工程并阻止；只读结果/证件资料区域直接展示成果文件，复用禁用态
FileUpload的文件名、预览和下载能力；阶段退回后按新的办理轮次产生当前结果，旧结果只读保留； - 审批时间线卡片按三段信息层级展示：第一行节点名称后紧跟审批状态；会签/或签/票签固定在右上角，与审批状态标签保持相同尺寸、圆角、边框和排版但不复用审批状态颜色；第二行只显示当前办理人，办理人行与前后内容保持紧凑间距；第三行显示开始时间、结束时间和运行时长；长名称/多人办理人通过悬停提示展示完整值，审批意见允许完整换行；
- 条件判断每个阶段-单位工程-条件项只有一个当前决策（需要/不需要），就地更新不累积轮次；退回重办时阶段/阶段-单位工程递增办理轮次，条件记录就地重置为
NOT_REQUIRED后重新保存；子手续完成情况由对应子手续单位工程状态体现； - 附件仅保存平台文件标识引用，成果保存时校验
ossId存在；文件生命周期由平台文件服务负责，本模块不扩展附件清理和归属策略； - 第七页不复制来源数据，优先使用服务端聚合查询或只读查询对象；
- 具体表名、字段、索引和附件关联方式见数据库设计；7 张业务表结构、
REMARK、PLANNED_DATE、IS_KEY_BLOCKER、CONSTRUCT_UNIT_NAME_SNAPSHOT均已通过项目 MCP 回读确认。
7. 接口职责与上下游
| 能力 | 调用方 | 接口职责 | 关键输入/输出对象 | 权限 |
|---|---|---|---|---|
| 计划台账查询/详情 | 年度计划页 | 查询计划、流程和推进单元明细 | 分页条件、计划主单 | 页面/查询 |
| 计划保存/提交 | 年度计划页 | 保存草稿或启动流程 | 计划信息、入口通道、工点/标段 ID 列表与阶段排期 | 新增/编辑/提交 |
| 手续台账查询 | 5 个手续页 | GET /ledger?stageCode，只返回当前阶段等于或已经经过该 stageCode 的计划；每行=推进单元，含四色进度状态、办理人/部门、当前待办 | 年度、线路、标段、单位工程、施工单位、审核状态、stageCode | 页面/查询 |
| 节点工作区查询 | 办理页 | 返回当前外层节点、单位工程状态、进度、结果和条件 | 流程实例、节点、单位工程 | 流程查看/办理 |
| 进度记录维护 | 节点工作区 | 通过独立弹窗新增、修改、删除当前节点进度记录，表格只读展示 | 单位工程、进度内容、时间、是否重难卡点/总体进度、附件 | 进度维护 |
| 只读附件查看 | 节点工作区 | 结果区直接展示成果文件；进度表附件列显示数量，点击有附件的数量打开只读附件查看框 | attachmentRefs、平台文件详情 | 流程查看 |
| 审批时间线展示 | 节点工作区 | 第一行节点名称后紧跟审批状态；协作标签固定右上角并使用独立色板；第二行当前办理人保持紧凑间距；第三行展示时间信息；名称和办理人支持悬停完整提示，审批意见完整换行 | 流程节点、审批状态、协作类型、办理人、审批意见、时间信息 | 流程查看 |
| 单位工程完成状态同步 | 节点工作区/流程监听 | 节点离开前校验并落库就绪单位工程完成状态，不提供独立完成动作 | 实例、节点、单位工程 | 节点提交 |
| 节点提交 | 节点工作区 | 校验普通节点全部适用单位工程，或校验父节点中除待办子手续外的其他单位工程后推进流程 | 实例、节点、下一办理人 | 流程提交 |
| 条件确认/子手续 | 节点工作区 | 就地保存单位工程的条件决策（需要/不需要），提交时由网关判断分支 | 条件类型、决策值 | 条件维护 |
| 结果资料维护 | 节点工作区 | 保存原型规定的结果字段和附件关联 | 单位工程、手续类型、完成日期、备注、附件 | 结果维护 |
| 总台账查询 | 第七页 | GET /ledger（不带 stageCode），前端按推进单元透视成 8 手续列矩阵（首列“工点/专业”） | 年度、线路、标段、单位工程、施工单位、审核状态 | 查询 |
| 总台账导出 | 第七页 | POST /summary/export（POI），按线路分 sheet、两行合并表头、8 手续列×完成时间/进展情况；完成时间列已完成显示“已完成”、未完成显示计划完成日期；页签名按 Excel 规则清理并保持工作簿内唯一 | 与总台账相同的筛选条件 | 导出 |
上表 URL 为当前实现（/ledger、/summary/export 等）；台账/总台账/导出已落地，四色进度状态与办理人/部门按流程实例派生。
8. 权限与安全边界
- 页面、按钮和接口权限分开校验；
- 本模块不建立独立项目权限；服务端通过
EngineeringDataAccessHelper校验工程范围：土建工点行按有效整线授权或当前有效的标段×工点组合判定，机电标段行（推进单元为标段、无工点）按整线授权或受限授权命中该标段判定；列表/台账、详情和写操作均按同一工程范围执行；计划中的项目 ID/名称快照仅作技术兼容，不作为筛选或授权条件；流程任务分配不自动扩展工程范围，办理账号必须同时具备任务归属和对应工程授权； - 结果资料和进度记录不能通过更换单位工程 ID 越权写入；
- 已保存的进度记录对具有流程查看权限的人员可见，前序办理人只能查看，不能因为当前节点变化而丢失可见内容；
- 第七页聚合查询先执行来源数据权限过滤，再做汇总；
- 关键变更保留操作人、操作时间、原因和流程上下文；
- 附件仅保存平台文件标识和业务关联，不在业务表中保存凭据或临时访问令牌；成果保存时经
OssService校验 ossId 真实存在，拒绝伪造/失效引用（EP-A09）；本模块不负责附件文件的清理和生命周期管理； - 成果写入按
expectedVersion做原子 CAS、进度增删改按当前办理轮次保护历史（EP-A04/A05）。 - 工程手续通过动作复用 Warm-Flow 全局监听器的
start回调，在引擎计算下一节点之前由服务端校验当前节点，并按数据库条件及子手续完成状态重算条件变量；只有仍有待办理子手续时条件变量才为1，登录用户不能使用客户端ignore变量绕过校验，旧流程定义和在途实例不被覆盖。
9. 外部依赖与兼容性
| 依赖 | 用途 | 复用方式 | 失败处理 | 兼容性要求 |
|---|---|---|---|---|
| 工程信息配置 | 提供线路、标段和单位工程 | 使用现有工程树选择器和快照规则 | 无效节点拒绝保存 | 沿用 SITE 单位工程语义 |
| Warm-Flow | 流程实例、任务、办理记录和流程图 | 通过业务主单关联 | 事务失败回滚或显示可核对状态 | 沿用平台流程操作 |
| 组织/岗位/用户 | 候选人和权限 | 复用现有组织权限模型及 src/components/UserSelect/index.vue 通用选择器 | 无效候选人拒绝提交；不使用普通下拉框 | 真实映射待核对 |
| 文件服务 | 证件和过程资料 | FileUpload 使用带全局鉴权的 multipart 上传，复用预览、下载和附件引用；只读结果区使用禁用态直接展示，进度附件数量点击后同样使用禁用态展示 | 上传失败回收批次状态、不写入假附件并支持重试；只读文件查询/预览失败不修改业务引用 | 文件限制沿平台规则；列表成功回显保持稳定；只读查看不出现上传/删除 |
| DM8/目标数据库 | 业务数据持久化 | 通过项目 MCP 建立并回读 7 张业务表；IS_KEY_BLOCKER、REMARK、PLANNED_DATE、CONSTRUCT_UNIT_NAME_SNAPSHOT 已执行并回读 | 事务回滚并记录错误 | 物理类型已核对，见数据库设计 §3 |
10. 异常、事务与可观测性
- 单位工程完成：在服务端原子校验必填条件、条件子手续和结果资料，并更新完成状态；
- 节点提交：普通节点或条件已闭环的父节点在同一业务事务内校验所有适用单位工程已完成；父节点存在待办条件时，仅允许将存在待办子手续的单位工程分流出去，其他单位工程仍须先完成，再调用/关联流程推进结果；
- 重复提交：使用流程任务和业务版本校验保证幂等；
- 并发修改：以版本号或更新时间校验，禁止旧页面覆盖新数据；
- 第七页汇总：来源查询失败时返回明确错误，不将空结果当作“未开始”；
- 附件上传：公共
FileUpload以浏览器 multipart 请求发送文件，沿用全局鉴权和ossExt，失败时回收批次状态并提示；成功列表使用稳定键值且不播放会造成布局位移的进入动画； - 附件只读展示：结果/证件资料区域直接渲染禁用态文件列表；进度表附件列只显示数量，有附件时数量使用可访问控件打开只读附件查看框；查看、预览和关闭不改变
attachmentRefs，也不新增上传/删除入口； - 审批时间线展示：时间线卡片固定为“节点名称+审批状态 / 当前办理人 / 开始时间、结束时间、运行时长”三段布局；协作标签位于右上角并使用独立色板；长名称和办理人使用悬停提示，审批意见使用自然换行，禁止单行省略或固定高度截断；
- 审批校验：
FlowActionPanel捕获业务校验异常并在当前审批对话框中展示，保持对话框和流程状态不变； - 草稿办理人：年度计划保存/更新时同步快照首节点办理人，提交时再次校验，避免提交窗口丢失选择；
- 待办入口：路由回退统一使用
/task/taskWaiting，避免进入旧路径 404； - 记录业务操作和异常上下文，便于定位到流程实例、节点、流程任务和单位工程；阶段退回切换新办理轮次，旧进度和结果只读保留，条件记录就地重置；进度记录物理删除不在进度表中保留删除行。
11. 主要业务链路与本次复验
本次已用真实开发账号在内置浏览器完成代表性端到端验证：权限补齐后，机电多单位工程计划完成至归档；土建多单位工程计划由多个账号依次完成节点 4、5、6 并提交至节点 7，保留测试数据供继续复核。退回重办和新建可选单位工程不足场景没有被写成已通过。
| 层次 | 本次贯通范围 | 验证方式 |
|---|---|---|
| 页面 | 年度计划页、流程工作区、待办入口、节点结果/进度附件控件 | 内置浏览器真实页面；多账号切换和单位工程 Tab 核对 |
| 接口 | 计划保存/提交、节点工作区、结果/进度暂存、附件上传、节点提交、待办入口 | 页面请求和后端日志；附件 /resource/oss/upload 返回 200 |
| 数据 | 土建 1 个计划×3 个单位工程、机电 1 个计划×2 个单位工程、阶段计划日期、进度、结果和附件引用 | 开发库真实业务数据保留；未删除测试数据 |
| 权限 | 1 个管理员、4 个测试账号，分别验证办理、只读和无待办/范围差异 | 管理员在「授权办理」中勾选 5 个单位工程后复测 |
| 异常 | 未填全同意校验、浏览器上传状态码 0、审批错误反馈、待办路由和附件列表抖动 | 页面、后端日志、自动化；退回重办仍待补测 |
| 本轮展示验收 | 只读结果附件直接显示文件；进度附件显示数量，点击数量打开只读文件列表；零附件不可点击；预览/下载不改变业务引用 | 已实现；组件、类型/静态检查通过；内置浏览器核对成果文件直显/预览入口、进度数量点击和只读文件列表 |
| 本轮审批时间线展示验收 | 节点名称后紧跟审批状态；会签/或签/票签固定右上角且采用独立色板；办理人行和时间区间距紧凑；长名称/办理人可悬停查看完整值；审批意见完整换行 | 已实现；FlowTimeline 组件回归、类型/静态检查通过；内置浏览器核对最终布局和长文本展示 |
12. 待确认事项与来源
| 编号 | 事项 | 影响 | 来源 | 状态 |
|---|---|---|---|---|
| Q-OD-001 | 五个实际手续阶段的流程节点与真实岗位固定映射 | Warm-Flow 流程配置 | 用户原型、流程图 | 首期不固化，按实际需要选择 |
| Q-OD-002 | 三个条件菱形分别判断：产权单位意见征求/规划调整挂在 2，建设用地规划许可证/土地划拨决定书挂在 4，土地征收和转用批复/林地占用手续办理挂在 4.1；各自使用“不需要/需要”两个选项，首次默认“不需要”，“需要”进入子手续，返回后可结束；再次办理通过退回，不再提供“需要再次” | 子手续数据模型 | 流程图菱形分支、业务负责人 | 已确认 |
| Q-OD-003 | 第七页的导出列及 Excel 格式参考范围 | 聚合接口和迁移 | Excel 台账 | 已确认：Excel 仅作格式参考，不导入历史数据 |
| Q-OD-004 | 实际表名、字段、索引和物理类型 | 数据库交付 | 已实现代码、项目 MCP | 已核对（含新增字段 MCP 回读） |
| Q-OD-005 | 流程任务分配是否自动授予工程树单位工程范围 | 任务可见性与办理权限 | E2E-001 权限复现 | 已确认：不自动授予，需单独配置线路/SITE 范围 |
| Q-OD-006 | 新建 2027 年草稿的单位工程树当前无可选数据，无法在页面产生新的二次提交样本 | E2E-003 浏览器复测 | 运行环境基础数据 | 待补测；后端办理人快照回归已通过 |
13. 版本变更
v0.22（2026-09-13）同步：补充标段专业大类保存回读、单位工程选择器类型解析和年度计划草稿保存/列表/详情/修改回读证据；未改变土建/机电类型约束，退回重办和新建可选单位工程不足场景仍待补测。
| 版本 | 日期 | 变更 | 证据 |
|---|---|---|---|
| v0.19 | 2026-09-12 | 反写今天的实现和复验：补充任务与单位工程范围的独立权限前置；公共附件组件采用稳定 multipart 上传、失败批次收敛和稳定列表键值；审批校验错误保留在对话框；草稿首节点办理人保存快照；待办路由回退修正；记录土建/机电多单位工程、多账号、条件分支和跨节点复验结果及未验证范围 | 模块测试报告 |
| v0.20 | 2026-09-12 | 根据用户截图补充只读附件展示口径：结果/证件资料直接显示成果文件；进度跟踪表仍显示附件数量，但数量可点击进入只读附件查看框；统一复用禁用态 FileUpload 的预览和下载，不改变附件接口、字段或生命周期 | 需求分析、详细设计、操作手册 |
| v0.21 | 2026-09-12 | 收口审批时间线最终展示：节点名称后紧跟审批状态；会签/或签/票签固定在卡片右上角并沿用状态标签的尺寸排版但使用独立协作色板；当前办理人行和时间信息区采用紧凑间距；审批意见完整换行，节点名称和办理人支持悬停查看完整值 | 需求分析、详细设计、测试与验收、操作手册 |
| v0.29 | 2026-10-15 | 录单入口改造与台账对齐：年度计划新增拆分为土建/机电两个入口（土建按“线路-标段-工点”选择工点并带入责任标段、机电按“线路-标段”选择标段且标段即办理对象），取消逐工点手选办理通道；年度计划查重按“工点+年度”“标段+年度”区分；推进单元称谓与权限适配机电标段级（无工点）判定；总台账/导出首列“工点/专业”、完成时间按“已完成/计划完成日期”展示 | 需求分析、详细设计、数据库设计、操作手册、测试与验收 |