主题
运营对接管理 · 概要设计文档
文档版本：0.10 ｜ 最近核对日期：2026-09-26
本文说明模块定位、边界、页面、数据模型、工作流与共享平台的关系。业务范围、规则和验收标准以需求分析为唯一正文；字段级接口和流程变量见详细设计，实际持久化结构见数据库设计。
文档控制
| 项目 | 内容 |
|---|---|
| 模块名称 | 运营对接管理 |
| 编写日期 | 2026-09-26 |
| 关联需求分析 | 运营对接管理需求分析 |
1. 模块定位与边界
运营对接管理承载工程建成向运营移交阶段的问题闭环台账和三权移交记录，位于平台业务模块层。当前范围依据已确认的业务资料包含“问题清单及闭环”和“三权移交”，不包含资产移交、联调联试，也不另建用户、组织、权限、文件或流程底座。
| 平台能力 | 本模块复用方式 |
|---|---|
| Warm-Flow | 创建流程实例、待办、固定办理页、流程图、审批时间线、退回与办理记录 |
| 权限体系 | 菜单、三段式权限码、后端 @SaCheckPermission、前端 v-hasPermi |
| OSS 文件服务 | 业务表只保存 OSS 标识，附件表记录业务附件组和顺序 |
| 项目与工程结构 | 问题清单引用项目及关联线路；三权移交选择 LINE 节点作为接收线路 |
| 部门与用户 | 处理部门、发起人、填报人及审批人员选择 |
| 字典与台账组件 | 移交类型、分页表格、筛选、导出与上传控件 |
本模块负责两类业务事实、附件分组、业务状态与查询导出；审批过程和历史由 Warm-Flow 管理，不复制审批快照。
2. 页面与路由
| 页面 | 路由 | 职责 |
|---|---|---|
| 问题清单及闭环 | /operationDock/problemCloseLoop | 查询、分页、状态显示、新增、暂存、提交、退回记录修改重提、删除和导出 |
| 问题清单及闭环办理 | /operationDock/problemCloseLoop/flowForm | 展示业务表单与附件，办理当前任务，查看流程图和时间线 |
| 三权移交 | /operationDock/threeRightsTransfer | 查询、分页、新增、暂存、提交、退回记录修改重提、删除和导出 |
| 三权移交办理 | /operationDock/threeRightsTransfer/flowForm | 展示移交信息和附件，办理当前任务，查看流程图和时间线 |
流程办理路由按平台约定固定注册，并使用隐藏办理菜单支持面包屑和侧边栏定位；没有独立业务详情页。查询区与列表列按已确认的业务字段保留；三权台账在审批完成前不显示状态列（列表展示方式按平台同级台账确定）。
3. 数据模型
开发库包含四张表，实际字段和 MCP 回读矩阵见数据库设计。
| 表 | 职责 |
|---|---|
BIZ_OPERATION_DOCK_PROBLEM | 问题主记录、项目/线路/部门与人员快照、审批人快照、业务状态及实例关联 |
BIZ_OPERATION_DOCK_PROBLEM_FILE | 问题记录的待处理问题和处理结果文件引用 |
BIZ_OPERATION_DOCK_TRANSFER | 三权移交主记录、接收线路和区段、移交类型、时间、填报人与单节点审批人快照 |
BIZ_OPERATION_DOCK_TRANSFER_FILE | 三权记录的移交表和接收协议文件引用 |
两张附件关联表以业务主键、file_group、oss_id 和 sort_no 表达附件组及顺序；业务主表与附件表使用 ID 逻辑关联，不创建物理外键。业务主表保存稳定业务状态和 Warm-Flow 实例关联；Long ID 遵循项目 JSON 映射。
4. 流程与状态
问题清单流程编码为 operation_dock_problem，流程 V5 为“责任部门部长 → 发起部门部长 → 责任部门经办人 → 选填的责任部门副部长”。服务端注入审批人员和是否选填副部长变量；副部长未选择时条件网关跳过。退回固定到申请人，审批历史由 Warm-Flow 保留。
三权流程编码为 operation_dock_transfer，流程 V3 为“申请人 → 单一审批人”。审批人由表单单选，完成节点后流程结束。审批完成后业务记录进入 finish 并生效；待审批记录仍可在台账查询，但不可修改、删除。台账没有审核状态列，因此台账可见性不作为生效标志。
两类业务使用平台状态 draft、waiting、back、finish。暂存保存草稿；提交后进入审批；退回后由发起人修改并沿原实例重提；审批结束写回完成状态。问题台账展示四态，三权移交在审批完成前不展示状态列（列表展示方式按平台同级台账确定）。问题规则与三权规则的确认来源见需求分析。
流程图结构
两份流程定义 JSON 保存在 digital-construction-modules/digital-construction-workflow/src/main/resources/flow/operation-dock/。流程图均使用 CLASSICS 设计器模型和四向锚点；业务线为正交 PASS 连线，不画 REJECT 线。V5 在同一局部区域布置选填副部长分支，V3 使用横向线性布局。设计器核对结果和版本定义 ID 记录于详细设计。
5. 权限、数据范围与事务
- 菜单权限标识使用
operationDock:problemCloseLoop:<action>和operationDock:threeRightsTransfer:<action>；后端注解与前端指令逐字匹配。记录所有权、状态与任务办理资格另由 Service/流程服务校验。 - 问题闭环列表、详情和导出沿用跨部门协同全量可读基线；其表单线路→工点候选按共享工点授权过滤，写入由服务端复核。三权移交是工点共享工程资源，候选、列表、详情和写入按当前用户的整线授权或包含该工点的有效标段×工点组合过滤。两类资源的读取与录入范围分别执行。
- 业务字段校验、附件引用、业务状态及流程启动在 Service 事务中完成。启动失败回滚主记录和附件；事件监听按流程状态更新业务记录和流程实例 ID。
- 前端大整数 ID 保持原值，分页列表使用
PageResult.rows与total。
6. 实现、验证与未覆盖事项
后端源码位于 digital-construction-modules/digital-construction-business/src/main/java/com/bokun/business/operationdock/；前端页面位于 digital-construction-ui/src/views/business/operationDock/；流程 JSON 位于 workflow 模块对应目录。业务接口与变量、附件及校验细节见详细设计。
问题闭环 V5 的退回重提、三节点审批、副部长跳过和已完成状态已通过真实页面验证；三权 V3 的单人单节点提交与同意通过真实页面验证。其他角色权限负向、三权退回、筛选导出、附件失败边界及三权最终状态的数据库直接回读尚未验证，完整记录见测试报告。