主题
工程手续办理 · 操作手册
文档版本：1.00 ｜ 最近核对日期：2026-10-15
进展说明：本轮（2026-10-15）完成录单入口改造与台账对齐：年度计划新增拆分为“新增年度计划（土建）/（机电）”两个入口——土建按“线路-标段-工点”选择工点并自动带入责任标段，机电按“线路-标段”选择标段（标段即办理对象），不再逐工点选择办理通道；推进总台账与导出首列改为“工点/专业”，完成时间按“已完成/计划完成日期”展示。
本手册描述确认后的目标操作方式。菜单最终名称、按钮文案、流程表单路径和角色权限以开发后实际系统为准；本文不记录真实账号、密码或令牌。
1. 适用角色与权限
| 角色 | 可做什么 |
|---|---|
| 年度计划经办人 | 建立年度计划、选择多个单位工程、保存和提交 |
| 手续办理人 | 在当前流程节点内逐个单位工程维护进度、条件、结果资料并暂存，最后统一“同意”提交 |
| 审核/审批人 | 由流程发起/配置时按实际需要选择，查看材料并从平台待办办理通过、退回等动作 |
| 管理查看人员 | 查看前六页办理详情和第七页总台账，按权限导出 |
| 仅查看用户 | 只能查看有权限的工程数据和流程记录 |
最终按钮权限和线路/单位工程数据范围由系统权限配置控制。本模块不设独立项目权限；没有写权限时，即使直接调用接口也不能修改数据。
办理账号必须同时具备两类条件：一是当前 Warm-Flow 任务的办理人身份，二是工程基础管理中该单位工程所属标段×工点的有效工程数据授权，或对应线路整线授权。把账号分配到流程任务不会自动授予工程范围；如果待办能看到但打开详情提示无权访问，应由管理员在「工程基础管理 → 工程数据授权」中为该账号配置正确线路、标段和工点组合后重新进入待办。临时测试授权应在测试结束后清理。
2. 菜单入口
工程手续办理下包含 7 个页面：
- 年度计划下达；
- 规划方案审查意见；
- 初步设计批复；
- 建设工程规划许可证；
- 施工图审查合格书；
- 施工许可证；
- 手续办理推进总台账。
原型中的“工点”在系统中按“单位工程”理解。第七页是汇总查看页，不用于录入或推动流程。页面、流程节点和台账中的手续名称按实际业务定义维护，不因名称相近而全局替换。
3. 业务操作
3.1 建立年度计划
- 进入“年度计划下达”；
- 按业务类型点击“新增年度计划（土建）”或“新增年度计划（机电）”，填写年度和计划基本信息；入口在弹窗打开时确定，编辑已有计划时按原入口回读；
- 完成对应层级的选择：
- 土建入口：在选择器“线路-标段-工点”树中勾选工点，责任标段随选择路径自动带入；工点未被标段管辖时显示“未归属标段”；
- 机电入口：在选择器“线路-标段”树中勾选标段，标段即办理对象，不需要选择工点；
- 选择器默认隐藏运营节点，需要查看时打开选择器上的“显示运营”开关即可（仅切换显示，不构成拒绝），能否选择以工程数据权限的授权范围为准；
- 服务端会校验责任标段与该工点的管辖关系（土建）以及选择对象与入口的一致性；不满足时保存或提交会被拒绝并给出提示；
- 确认带出的线路、标段/工点名称、施工单位中文名称与路径；在表格中逐个工点/标段填写对应阶段的计划完成日期及备注；如果施工单位显示为空，联系工程基础管理员维护标段的施工总包单位；
- 保存草稿，确认清单和阶段计划日期无误后提交；草稿允许阶段计划日期暂空，提交时对应入口的全部阶段日期必须填写；
- 同一工点（土建）或标段（机电）同一年度不能重复纳入其他有效年度计划（保存/提交时会点名提示重复对象）；不按线路设置年度计划唯一限制；草稿可调整清单，提交后不能新增或移除；
- 提交后按入口形成对应独立流程实例：土建使用
engineering_procedure_civil（规划方案审查意见、初步设计批复、建设工程规划许可证、施工图审查合格书、施工许可证 5 个阶段），机电使用engineering_procedure_mep（施工图审查合格书、施工许可证 2 个阶段）。
首期办理人、审核人和候选岗位不绑定固定组织映射，可在流程发起或配置时选择平台有效人员/岗位；选择时点击人员选择入口打开通用用户选择器，通过部门树和人员筛选查找，并按字段要求选择一人或多人，不使用普通下拉框；系统仍会校验权限和工程数据范围。
3.2 在实际手续阶段中办理
- 从任一阶段台账进入详情或从平台待办进入办理工作区；
- 步骤向导条（Workflow Stepper）：
- 工作台顶部以步骤向导形式展现推进逻辑，从左至右依次为：
- 年度计划：只读 Tab，带出计划详情与各单位工程阶段计划日期；
- 主线手续阶段（01~05）：土建 5 个、机电 2 个；已完成阶段显示绿色
✓和“已办结”；当前正在办理的阶段显示主题色高亮和“当前待办”动态微标；未到达阶段按流程进度自动隐藏； - 办理清单：全景功能 Tab，可随时切换查看建设工程规划许可证五大责任主体（重庆建工、林同棪、招商局交科院、交开投等）协调要件清单及高清流程全景图（支持滚轮缩放、拖拽平移与一键重置）；
- 工作台顶部以步骤向导形式展现推进逻辑，从左至右依次为：
- 单位工程切换与就绪诊断检查：
- 单位工程选择栏在内容区滚动时吸顶固定；
- 每个单位工程徽标内嵌诊断提示图标，鼠标悬停徽标即可弹出诊断检查卡片：
- 清楚查看实际完成日期是否填报、最终成果附件是否上传、前置子手续是否已办结；
- 当显示“未就绪”时，诊断卡明确标出具体缺项（如“未填报”、“未上传”或“阻断中：【某子手续】待办结”），彻底消除困惑；
- 进度跟踪记录：
- 只能在当前阶段的当前外层节点中编辑；
- 点击“新增进度”打开弹窗，填写进展情况、是否重难卡点、完成日期并上传附件（完成日期必填，不再采集“总体进度”），保存后表格新增一行；
- 附件列显示文件数量，点击数量打开只读查看框；点击“要件清单查看”可悬浮查阅该手续申报所需文件清单；
- 条件协同决策指引卡片：
- 当节点涉及前置子手续时（如规划方案阶段的产权意见/调规、工程规划许可阶段的用地规划许可、用地规划阶段的林地征收），以卡片式指引呈现；
- 阅读顶部业务指导文案，通过分段胶囊按钮直接选择：
不需要（直行推进）：主线直接继续，不启动子手续；需要办理（启动子手续）：分流启动前置子手续办理；
- 当选择“需要办理”时，卡片内实时联动显示子手续当前进展（已办结 / 办理中待归档）以及“主线最终证件资料锁定保护”提示；
- 结果 / 证件资料填报与暂存：
- 查看计划完成时间（只读），录入实际完成日期、办理说明并上传最终成果附件；
- 施工许可证阶段默认勾选「同步应用到本任务全部单位工程（1:N 批次办证）」。保持勾选时，当前结果会应用到本流程同一阶段、同一办理节点内的全部单位工程；取消勾选只保存当前单位工程。系统会校验所有目标工程数据权限和版本；任一目标无权访问或已被他人修改，整批不会部分保存，并提示刷新或按可见范围分别办理；
- 随时点击“暂存”保存当前单位工程数据（切换单位工程或阶段时系统也会自动暂存未落库修改）；
- 提交节点（流转同意）：
- 本节点所有单位工程数据齐备后，点击右上角动作面板“同意”即可流转到下一阶段；
- 若存在未填全项，系统会友好拦截并点名提示缺项内容。父节点存在待办子手续时，同意会将流程分流至对应子手续办理，子手续完成后自动回到父节点；
- 全部手续阶段完成后，流程进入工程部“
7接收、备案并归档”直通节点，归档确认后流程结束。
**审批时间线与全宽专注视图：**右侧时间线支持一键收起为竖向导轨，开启全宽专注办理视图；展开时可查看节点审批历史与当前办理人。
3.2.1 查看只读附件
只读页面不再把成果附件折叠成数量：
- 在已提交或前序只读节点的“结果 / 证件资料”区域，成果附件直接显示文件类型图标和文件名；无附件显示“—”；
- 点击成果文件名打开既有文件预览抽屉，点击“下载”获取文件；只读区域不显示“选取文件”和“删除”操作；
- 在“进度跟踪记录”表中，附件列仍显示“
N个”。当N大于 0 时，点击数量打开只读附件查看框，文件列表采用与只读编辑页面相同的文件名、预览和下载形式； - 进度附件数量为“—”时表示没有可查看附件，不能点击；打开或关闭查看框不会新增、删除或改变业务数据。
流程图只展示真实外层业务节点。节点文案精简后每行最多 7 个中文字符、最多 3 行；连线从四向锚点出发并按正交路径连接，任意两条连线不得共享同一水平/垂直线段、交叉、重叠或穿过节点，回父节点使用独立外圈通道；不展示静态退回线，退回使用平台标准动作，子手续完成后回父节点的业务闭环线不属于退回线。
3.3 处理条件子手续
- 查看当前单位工程的三个条件判断；
- 每个条件从“不需要”“需要”中选择，首次默认“不需要”；子手续未完成前可把“需要”改回“不需要”直接跳过；
- 选择“需要”时，按页面提示进入对应的外层子手续节点；
4选择需要时进入4.1，4.1再选择需要时进入4.1.1；子手续节点只展示该条件仍为待办理的单位工程，未完成前不能完成父手续单位工程； - 子手续完成后返回原父节点和条件判断人；如仍需办理，通过流程退回目标节点重办（不再提供“需要再次”）；如已不需要，选择“不需要”结束该条件；
- 每个条件只保留一个当前决策；同一节点内任一单位工程选择“需要”即进入子流程分支；退回重办时阶段和阶段-单位工程切换新的办理轮次，旧进度和结果只读保留，条件记录就地重置后重新保存；
- 三个条件分别闭环后，继续当前节点后续操作。
3.4 查看和导出总台账
- 进入“手续办理推进总台账”；
- 按年度、线路、标段、单位工程、施工单位和审核状态筛选；
- 查看各手续的完成时间、最新进展、进度状态（未开始/正在办理/已完成/超期四色）、审批状态和来源详情；总台账按“工点/专业 × 8 手续列（含施工图审查合格书）”展示（土建行为工点、机电行为标段）；完成时间列已完成显示“已完成”、未完成显示计划完成日期；
- 点击来源详情查看该单位工程的手续办理、流程时间线和结果附件；
- 点击导出，按线路分 sheet 生成“工程建设手续办理推进表”（两行合并表头、首列“工点/专业”，每手续列含完成时间/进展情况，已完成显示“已完成”、未完成显示计划完成日期）；线路名称过长或包含 Excel 不允许的字符时，系统会自动处理页签名，保证每个页签可用且不重复。
5 个手续台账页（规划方案审查意见…施工许可证）同样以“每行=一个单位工程”展示本手续的计划/实际完成时间、进度状态、办理人/部门与审核状态，并可跳转办理/详情。页面范围按当前流程阶段累计：当前处于本阶段或已经经过本阶段的计划可见，尚未到达本阶段的计划不会提前出现在后续手续页。例如初步设计批复页只看当前在初步设计及其后的计划；页面内部仍只列初步设计节点。
总台账的数据来自年度计划和前六页，不能在总台账中直接修改。
3.5 退回后重新办理
- 在平台待办或对应详情中查看退回意见；
- 进入被退回的节点和单位工程；
- 按意见修改目标阶段资料；退回目标阶段及其后续阶段按顺序进入新的办理轮次，旧进度和旧完成结果只读保留，不再作为当前完成依据；
- 条件记录不创建新的历史轮次行，而是在重办时就地重置后重新保存；已完成的条件子手续按新的阶段办理轮次重新办理；
- 逐个单位工程填写并“暂存”办理数据；年度计划的阶段计划日期在提交后只读，退回重办只改办理数据、不改计划日期；
- 全部单位工程填全后点“同意”重新提交原流程实例，历史办理记录继续保留。
4. 字段与提示
| 页面/区域 | 填写说明 | 是否必填 | 格式/范围 | 错误提示与处理 |
|---|---|---|---|---|
| 工点/标段 | 土建入口从“线路-标段-工点”选择工点并带入责任标段；机电入口从“线路-标段”选择标段 | 是 | 工程树有效节点 | 责任标段无管辖关系、标段未关联线路或对象与入口不一致时不能保存 |
| 录单入口 | 由“新增年度计划（土建）/（机电）”按钮确定 | 是 | 土建或机电 | 入口决定选择层级与流程定义，编辑时按主单回读 |
| 完成日期 | 本次主手续进度记录的完成日期（子手续进度用“总体进度%”） | 主手续必填 | 日期 | 主手续日期缺失或格式错误时不能保存 |
| 是否重难卡点 | 标记本次主手续进度是否为重难卡点 | 主手续进度项 | 是/否 | 默认“否” |
| 进展情况 | 描述本次办理进展 | 按手续字段确认 | 文本 | 内容不足时补充后保存 |
| 进度记录 | 通过独立弹窗新增/编辑，表格只读并显示附件数量；有附件时点击数量查看只读文件列表，删除走确认 | 当前节点可编辑时可操作；查看对有权限的只读用户开放 | 弹窗表单/只读附件查看框 | 节点锁定后整表只读；查看不改变附件引用 |
| 条件判断 | 分别维护三个条件的当前决策（需要/不需要） | 适用时必填 | 不需要/需要 | 首次默认“不需要”；选择“需要”后须完成对应子手续；子手续未完成前可改回“不需要”；再次办理通过退回，无“需要再次” |
| 结果资料 | 维护原型规定的计划完成时间、实际完成日期、备注和成果附件 | 按手续字段确认 | 日期/文本/附件 | 缺少实际完成日期或最终成果附件时，同意提交会被阻止并点名 |
| 结果附件 | 上传证件或成果资料；只读节点直接显示文件列表，文件名可预览、文件可下载 | 按手续字段确认 | 平台允许格式和大小 | 上传失败时重试，不使用空附件；只读状态不允许上传、删除 |
| 单位工程完成状态 | 由系统根据当前节点的条件闭环、实际完成日期和最终成果附件自动判定 | 是 | 不提供独立完成按钮；点“同意”时统一校验 | 缺少条件闭环、实际完成日期或最终成果附件时点名缺项并阻止提交 |
| 同意（提交节点） | 校验全部适用单位工程数据齐备后推进流程 | 是 | 流程动作按钮 | 点名未填全的单位工程 |
5. 常见提示与处理
| 现象/提示 | 常见原因 | 用户处理 |
|---|---|---|
| 还有单位工程未完成 | 当前流程实例包含多个单位工程，尚有明细未完成 | 按清单逐个办理并完成 |
| 请先完成对应条件子手续 | 当前条件选择为“需要”，对应子手续尚未完成 | 进入对应条件子手续完成后返回当前手续 |
| 误点“需要”想撤销 | 已选“需要”但子手续尚未完成 | 直接改选“不需要”即可跳过；若子手续已完成，则通过流程退回重办 |
| 年度计划已存在 | 单位工程已纳入同年度其他有效计划 | 打开原计划处理，不能重复下达 |
| 同意被阻止 | 有单位工程缺实际完成日期/成果附件，或条件子手续未完成 | 按点名提示补齐并暂存后再同意 |
| 数据已被其他用户修改 | 并发编辑导致版本过期 | 刷新页面，核对最新记录后再保存 |
| 当前节点不可编辑 | 节点已提交、流程终态或本人不是当前办理人 | 从待办确认当前任务和权限 |
| 附件上传失败 | 文件格式/大小、文件服务异常，或浏览器/本地代理层请求中断（可能表现为状态码 0） | 检查文件后重试；失败时不会保存空附件，页面会结束上传中状态并显示网络/服务提示；仍失败时提供流程编号和错误提示 |
| 附件上传成功后列表抖动 | 列表进入动画或临时文件项键值变化 | 当前版本已取消进入动画并复用稳定文件键值；若仍出现抖动，记录浏览器视口、计划编号和节点名称 |
| 只读结果附件只显示数量 | 进入了已提交或前序节点，页面处于只读状态 | 结果区应直接显示文件名；点击文件名预览，点击下载；若显示“—”表示无附件 |
| 进度附件数量无法查看 | 进度行没有附件，或数量控件未按有附件条件显示 | 有附件时点击“N 个”打开只读附件查看框；“—”没有可查看文件，不执行操作 |
| 总台账显示未开始或缺失 | 来源手续尚未录入或来源查询异常 | 打开来源详情核查，不在总台账手工补录 |
| 看不到某个单位工程 | 工程范围权限不足或工程主数据已失效 | 联系工程基础管理员处理 |
| 标段与工点不存在管辖关系 | 土建责任标段不是该工点的管辖标段（指定工点或全线统包） | 回到选择器按“线路-标段-工点”重新选择 |
| 所选标段未关联线路 | 标段主数据缺少所属线路 | 联系工程基础管理员维护标段主数据 |
6. 版本与来源
v0.22（2026-09-13）同步：补充“标段专业大类正确保存后才可选择单位工程”的操作前置和年度计划草稿页面回读证据；退回重办及新建可选单位工程不足场景仍待补测。
| 版本 | 日期 | 面向用户的变化 | 影响角色 |
|---|---|---|---|
| v0.1 | 2026-09-07 | 建立 7 页面操作口径，明确单位工程逐项办理、节点内多次进度填报和总台账只读汇总 | 全部角色 |
| v0.2 | 2026-09-07 | 补充土建/机电不可混选及按类型显示阶段 Tab | 全部角色 |
| v0.3 | 2026-09-07 | 补充年度计划唯一范围、条件三选项与子手续轮次、进度物理删除、完成门槛和退回后续阶段重办规则；名称按实际业务保留 | 全部角色 |
| v0.4 | 2026-09-07 | 进度跟踪表采用 VXE 行内编辑，不使用新增/编辑弹窗 | 手续办理人 |
| v0.5 | 2026-09-07 | 办理人、审核人和候选岗位统一使用部门树/人员筛选/多人选择通用用户选择器 | 年度计划经办人、流程配置人员 |
| v0.6 | 2026-09-07 | 同步首轮实现：流程能力、阶段 Tab、退回重办轮次和开发库结构已落地 | 全部角色；历史流程定义口径已由 v0.9 更新 |
| v0.7 | 2026-09-09 | 年度计划不再占用工作区 Tab；土建/机电工作区改为 5/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 接收、备案并归档”直通节点 | 全部角色 |
| v0.11 | 2026-09-09 | 条件取消“需要再次”，只保留“不需要/需要”，子手续未完成前可回改“不需要”，再次办理走退回；进度表主手续新增“是否重难卡点”、列名改“完成日期”，子手续用“总体进度”；进度行内编辑可正常上传附件 | 手续办理人、条件确认人 |
| v0.12 | 2026-09-09 | 进度记录改为独立弹窗新增/编辑/删除，表格只读并显示附件数量；“需要/不需要”条件压缩为一行下拉，不再占大块界面；年度计划新增不再因“同项目同年度已有计划”被拒，只对重复纳入的单位工程点名提示；办理只保留“暂存”和“同意”，去掉“完成单位工程”按钮，同意时统一校验并点名未填全单位工程 | 手续办理人、条件确认人 |
| v0.13 | 2026-09-09 | 5 个手续台账页改为“每行=单位工程”并显示四色进度状态、办理人/部门；第 7 页总台账为“单位工程×8 手续列”矩阵；导出按线路分 sheet 的推进表 | 管理查看人员、手续办理人 |
| v0.15 | 2026-09-10 | 土建条件链调整为 4 → 4.1 → 4.1.1；手续页面按“当前阶段及已通过阶段”累计显示；年度计划和办理工作区显示标段带出的施工单位中文名称；流程提交由服务端前置校验并重算条件分支 | 年度计划经办人、手续办理人、管理查看人员 |
| v0.16 | 2026-09-10 | 运行态最新流程版本更新为土建 V3、机电 V2；两套流程已导入且导入结果确认无问题 | 年度计划经办人、手续办理人、管理查看人员 |
| v0.17 | 2026-09-10 | 按当前系统增加年度、线路、标段、单位工程、施工单位、审核状态筛选；权限口径调整为线路/单位工程范围；明确重办时条件记录就地重置、附件只做存在性校验；Excel 页签按规则安全命名 | 年度计划经办人、手续办理人、管理查看人员 |
| v0.18 | 2026-09-10 | 年度计划不再限制同一技术项目；选择器、年度计划和工作区不展示项目字段；单位工程筛选按单位工程名称快照执行，施工单位继续显示中文名称；补充列表空参数和无匹配结果的处理说明 | 年度计划经办人、手续办理人、管理查看人员 |
| v0.19 | 2026-09-12 | 补充办理账号的单位工程授权前置、草稿首节点办理人保存口径、审批校验失败提示、附件上传失败重试和稳定回显说明、待办回退路径；更新多账号多单位工程端到端复测结论和保留测试数据说明 | 年度计划经办人、手续办理人、管理查看人员 |
| v0.20 | 2026-09-12 | 补充只读办理页附件查看方式：成果附件直接显示文件；进度附件显示数量，点击数量打开只读文件列表；统一沿用只读 FileUpload 的预览和下载，不开放上传/删除 | 手续办理人、管理查看人员、仅查看用户 |
| v0.21 | 2026-09-12 | 收口审批时间线最终展示：节点名称后紧跟审批状态；会签/或签/票签固定在卡片右上角并采用与状态标签同尺寸的独立协作色板；当前办理人行与时间区采用紧凑间距；审批意见支持完整换行，名称和办理人支持悬停查看完整值 | 手续办理人、管理查看人员、仅查看用户 |
| v0.23 | 2026-09-18 | 单位工程选择器补充「显示运营」切换开关说明，完善多数据范围筛选 | 年度计划经办人、手续办理人 |
| v0.27 | 2026-10-09 | 工作台体验重构：顶部引入横向步骤向导条、就绪体检诊断卡、单选胶囊条件决策卡片；新增「办理清单」全景面板（五大责任主体要件协同与全景图示）；全面移除废弃的查看历史及轮次弹窗；适配 1920×911 常见视口紧凑无水平滚动条排版 | 全部角色 |
| v0.28 | 2026-10-13 | 交互体验优化与真实推进表对齐：年度计划筛选补充线路；子手续办理中时主节点隐藏结果资料区域；4.1表单自上而下调整在4.1.1上方；未暂存点同意增加保存提醒；施工许可证支持1:N按任务批次统一上传并同步全工点；总台账补充标段与责任部门，反查补齐标段及施工单位 | 手续办理人、管理查看人员 |
| v0.29 | 2026-10-15 | 录单入口与台账对齐：新增年度计划拆分为“新增年度计划（土建）/（机电）”两个入口——土建按“线路-标段-工点”选择工点并自动带入责任标段，机电按“线路-标段”选择标段（标段即办理对象），不再逐工点选择办理通道；新增弹窗“查看流程图”按入口直接可看、不再要求先选择对象；总台账/导出首列改为“工点/专业”，完成时间按“已完成/计划完成日期”展示 | 年度计划经办人、手续办理人、管理查看人员 |