Skip to content

规划管理 · 概要设计文档 ​

文档版本:1.01 | 最近核对日期:2026-11-09

本文面向设计评审、实现和验收,只确定模块在平台中的定位、模块边界与相邻模块关系、页面与路由、数据模型概览、流程概览、权限方案和关键技术决策,不展开字段级、参数级与类级实现。字段矩阵、接口参数与流程定义 JSON 细节进入数据库设计与详细设计。

本文是模块正式总体设计,按交付口径描述模块定位、边界与总体结构;业务规则见需求分析,字段矩阵和接口契约分别见数据库设计与详细设计,验证结果见测试与验收。

文档控制 ​

项目内容
模块名称规划管理
实现进度说明初版已上线(提交 c8a5913),并按端到端复验反馈完成多轮修复(最近一次为 12e8729);2026-09-20 的实现与验证范围见测试与验证报告,当前代码状态待复核
编写日期2026-09-20
受测代码状态2026-09-20 核对的提交 f13cf89 及当时工作区状态;台账权限码统一的实际提交与验证范围见测试与验证报告,不代表当前工作区已复验
业务确认人待确认
关联需求分析规划管理需求分析
关联资料需求分析、详细设计、数据库设计、测试与验收、操作手册

1. 模块在平台中的定位与复用 ​

规划管理是工程规划业务的一级业务模块,与工程变更监管、招投标监管、开投安质环监管同级,挂在「规划管理」一级菜单下(菜单排序位于平台业务模块序列中),下设「项目储备」与「规划报建」两个目录。模块不新建用户、组织、权限、文件或工作流体系,全部沿用平台既有能力:

复用能力复用内容本模块的使用方式
Warm-Flow流程实例、任务、互斥网关、会签节点、退回、流程图与办理工作台9 条流程定义承载报审链路;业务侧只通过工作流对外契约启动、办理与查询,不直接耦合引擎
流程事件与回写流程状态事件、任务事件业务侧监听事件回写业务状态、当前节点、审批记录与实例登记状态;审批记录按引擎办理记录幂等
权限体系三段式权限码、菜单与按钮权限、角色授权planning:<资源>:<动作>;后端注解、菜单权限串、前端指令三处一致;发起方式分设动作权限
文件服务文件上传与对象引用、文件查询成果文件、明细附件与部门意见附件统一保存文件服务对象引用,不复制实体文件
字典业务状态、模块类型、工作阶段、专题业务阶段、发起方式、征求部门类别数据库只存稳定枚举值,展示层由字典映射为中文
项目主数据业务项目任务与项目多对多关联并保存名称/编码快照;专题类型目录与项目多对多关联
组织与用户部门、用户发起单位解析(所属单位/集团根部门)、审核人选择、部门意见接收人
平台页面与组件列表页模板、流程工作台、用户选择、文件上传、字典标签、分页与导出台账、新增/编辑、审核与只读工作台按既有模式组装

模块自身承担的部分:规划业务任务与成果的事实源、阶段任务的建模口径、台账聚合口径、意见征求业务语义、审批记录快照(含发起单位)与流程实例登记(支持历史多实例与重启)。

2. 模块边界与相邻模块关系 ​

本模块负责:

  • 5 个业务模块(储备清单、状态跟踪、线网规划、建设规划、工可研究)的任务、阶段记录、成果版本、成果明细与附件引用;
  • 专题类型目录(可配置主数据)及其与项目的关联;
  • 业务提交校验、流程启动与继续、退回后重提、状态回写与自动引用;
  • 意见征求的部门选择、会签办理、部门意见回写与轮次结论;
  • 审批记录快照、流程实例登记与重启实例;
  • 任务台账、项目台账、项目历史数据聚合、列表查询与导出;
  • 专题类型目录页面、5 个模块的新增/编辑/审核/详情页面与全部办理页。

本模块不负责:

  • 用户、角色、部门、岗位与权限授权维护;
  • 项目主数据与工程结构树的维护;
  • 通用待办、委托、转办、加签、减签与流程引擎本身;
  • 「信息管理/文件目录配置」模块本体(只预留成果文件引用目录的来源字段与目录标识);
  • 站内信/短信通知与外部系统对接。

与相邻模块的关系:

相邻对象关系
工程变更监管 / 招投标监管 / 开投安质环监管同级业务模块,互不调用;共用平台流程工作台与台账模板
平台流程中心(待办、流程图、流程定义)待办与办理入口由平台提供,本模块提供办理页与业务办理接口;办理页按流程定义静态注册
项目主数据只读引用,保存名称/编码快照,不做维护
文件服务只读引用文件对象标识,不管理文件实体生命周期
状态跟踪 ↔ 建设规划/工可研究单向引用关系:来源阶段「已通过」后生成状态跟踪引用记录;引用记录不反向修改来源记录

3. 模块分解 ​

子模块/能力职责上游输入下游输出
业务任务(5 个模块共用主实体)任务信息、项目关联、专题关联、发起单位快照、业务状态与当前节点发起方式、项目/线路、专题类型、填报人与填报时间草稿或已提交任务
阶段任务与成果留痕建设规划/工可研究的编制、报审、批复任务化建模,成果版本与明细留痕工作阶段、成果明细与附件阶段记录、成果版本、成果明细
意见征求是否需要意见征求决定、部门与接收人选择、会签办理、部门意见回写与轮次结论部门负责人节点决定、部门接收人办理部门意见记录、批次结论、流程流转
审批记录与实例登记逐节点审批记录快照(含发起单位)、多实例登记与重启流程事件、引擎办理记录审批记录、实例登记、重启后的新实例
台账与聚合视图任务台账、项目台账、项目历史数据聚合任务、阶段记录、项目与专题关联列表、台账行、聚合详情
专题类型目录专题类型主数据维护与关联项目专题名称、业务分类、启停状态专题类型选项与关联关系
自动引用来源阶段已通过后生成状态跟踪引用记录建设规划/工可研究已通过事件状态跟踪引用记录
页面与路由台账页、新增/编辑、审核页、详情工作台、办理页族菜单与静态路由注册可操作的业务页面

4. 页面与路由清单 ​

5 个业务模块统一四页模型:台账页(任务台账/项目台账两个视图,建设规划与工可研究另挂「专题目录」)→ 新增/编辑 → 审核 → 详情;列表「详情」直接进入流程工作台只读视图。

菜单/入口路由组件说明
规划管理(目录)/planning—一级菜单
项目储备(目录)/planning/projectReserve—二级目录
储备清单/planning/projectReserve/reservebusiness/planning/reserve/index列表 + 任务台账/项目台账(含发起单位列)
状态跟踪/planning/projectReserve/statusTrackingbusiness/planning/statusTracking/index列表 + 台账(项目台账含规划报建阶段、专题类型列)
规划报建(目录)/planning/planningSubmission—二级目录
线网规划/planning/planningSubmission/networkPlanbusiness/planning/networkPlan/index不提供台账视图入口(页面结构按平台台账模式确定)
建设规划/planning/planningSubmission/constructionPlanbusiness/planning/constructionPlan/index含工作阶段、专题类型、专题目录与台账
工可研究/planning/planningSubmission/feasibilityStudybusiness/planning/feasibilityStudy/index与建设规划同构
专题类型目录(隐藏)/planning/planningSubmission/topicTypebusiness/planning/topicType/index由建设规划/工可研究页面的「专题类型目录」按钮进入
项目历史数据(静态注册)/planning/projectHistorybusiness/planning/projectHistory/index项目台账的「该项目历史数据」聚合入口,按查询实时聚合
办理页族(9 个隐藏菜单 + 静态注册)项目储备:/planning/projectReserve/reserve/flowForm、/planning/projectReserve/statusTracking/flowForm;规划报建:/planning/planningSubmission/networkPlan/flowForm,建设规划与工可研究各含编制、报审、批复三条(/planning/planningSubmission/constructionPlan/compilation/flowForm、/planning/planningSubmission/constructionPlan/submission/flowForm、/planning/planningSubmission/constructionPlan/approval/flowForm,以及 feasibilityStudy 段对应的三条)business/planning/<模块>/flowForm每个流程定义对应一个隐藏办理菜单,并静态注册固定路由;流程定义中登记的办理页路径与之一致

路由注册约定:普通业务页面由后端菜单驱动(菜单组件路径对应源码目录);办理页在流程办理路由表、固定路由路径清单与流程办理路径映射中登记;项目历史数据聚合入口在基础路由中静态注册,不依赖菜单授权。专题类型目录当前由隐藏菜单驱动(建设规划/工可研究页面按钮跳转其菜单路径),未静态注册,与「跨模块共用入口一律静态注册」的确认口径存在差异,见第 12 节 Q-PL-008。建设规划/工可研究的三条办理路由复用同一办理组件,按流程定义区分为三个路由与页面标签。

页面职责分工:列表/台账/工具栏由统一的规划任务页组件承载,按模块参数开启工作阶段、专题类型、台账视图与专题目录入口;新增/编辑表单组件负责草稿与提交;办理页组件承载流程头部、操作面板、只读业务表单、时间线与流程图抽屉,列表「详情」以只读方式复用同一组件。

5. 数据模型概览 ​

模块共 13 张业务表(biz_planning_*,已在开发库建立,表名与开发库回读一致;全量字段矩阵在数据库设计文档中按列补齐):

表职责(一句话)
BIZ_PLANNING_TASK业务任务主实体,5 个模块共用;建设规划/工可研究下编制、报审、批复各为一条独立任务
BIZ_PLANNING_TASK_PROJECT任务与项目的多对多关联(含项目名称/编码快照)
BIZ_PLANNING_TASK_TOPIC任务与专题类型的多对多关联,承载专题类型多选
BIZ_PLANNING_STAGE_RECORD阶段记录,每条任务 1 条(序号恒为 1),保存阶段业务状态、实例与是否需要意见征求
BIZ_PLANNING_RESULT_VERSION成果版本,随任务创建生成版本号 1;退回重提与重启实例复用同一条版本
BIZ_PLANNING_RESULT_ITEM成果明细行(主要内容),按版本与阶段记录归集
BIZ_PLANNING_ATTACHMENT_REF附件引用,保存文件服务对象标识与文件元数据;预留文件目录来源与目录标识
BIZ_PLANNING_TOPIC_TYPE专题类型目录(可配置主数据),含业务分类与启停状态
BIZ_PLANNING_TOPIC_PROJECT专题类型与项目的多对多关联
BIZ_PLANNING_CONSULTATION_BATCH意见征求批次(一轮一条),保存轮次、实例与轮次结论
BIZ_PLANNING_CONSULTATION_TASK单个部门意见任务(会签明细),保存部门类别、接收人、意见、结果与完成时间
BIZ_PLANNING_APPROVAL_RECORD审批记录快照(不可篡改),含节点、审批人及其部门、发起单位、意见、结果与时间
BIZ_PLANNING_PROCESS_INSTANCE流程实例登记,支持同一业务的历史多实例查询与重启(含实例序号、是否当前、原实例标识、实例状态)

设计要点:

  1. 业务与流程分离:业务状态与流程实例标识分列;实例以登记表为准,业务标识为 {阶段记录ID}#{实例序号},保证同一业务可登记多个实例且查询唯一;该标识含 #,前端查询流程历史时路径段必须 URL 编码,否则时间线为空。
  2. 阶段性任务建模:每个工作阶段各建一条独立任务,单阶段模块(储备清单、状态跟踪、线网规划)创建 1 条任务与 1 条阶段记录(工作阶段为空);同一任务内退回重提沿用原实例与版本,重启实例新建实例序号但不新增阶段记录与版本。
  3. 聚合而非复制:项目台账按关联关系实时聚合查询,不建第二套业务表;状态跟踪的项目台账在查询侧合并建设规划、工可研究与状态跟踪自身的数据。
  4. 引用而非复制:状态跟踪自动引用只复制关联关系并记录来源任务与来源阶段记录,不创建阶段记录、成果版本与流程实例,不参与审批。
  5. 结构化落库:成果明细、意见征求、审批记录均为结构化表;不使用 JSON 承载业务字段,JSON 仅用于平台流程扩展信息。
  6. 版本与唯一性(开发库回读):成果版本以 UK_BIZ_PLANNING_VERSION(阶段记录 + 版本号)唯一,流程实例登记以 UK_BIZ_PLANNING_INSTANCE_BUSINESS(业务标识)唯一;意见征求按任务与轮次组织;审批记录按引擎办理记录幂等。任务与项目、任务与专题的关联表当前只有主键与普通索引,无唯一约束,重复关联由业务侧写入逻辑保证。

6. 流程概览 ​

模块共 9 条流程定义(流程编码前缀 planning_),已导入并发布,流程分类为「规划管理 → 项目储备 / 规划报建」:

#流程编码所属模块发起方式意见征求
1planning_reserve储备清单二级单位 + 开投集团(起始互斥网关分流)有(部门负责人节点判断)
2planning_status_tracking状态跟踪二级单位 + 开投集团无
3planning_network_plan线网规划二级单位 + 开投集团无
4planning_construction_compilation建设规划(编制)仅二级单位有
5planning_construction_submission建设规划(报审)二级单位 + 开投集团无
6planning_construction_approval建设规划(批复)二级单位 + 开投集团无
7planning_feasibility_compilation工可研究(编制)仅二级单位有
8planning_feasibility_submission工可研究(报审)二级单位 + 开投集团无
9planning_feasibility_approval工可研究(批复)二级单位 + 开投集团无

流程编码由「模块类型 + 工作阶段」解析得到,编制阶段不提供开投集团发起路线;是否需要意见征求不参与流程模板选择,而是流程内互斥网关的变量条件(与原型「一张图同时画两种发起方式」一致)。

节点链路(以流程定义回读为准,节点文案按模块替换):

  • 双发起单阶段流程(储备清单、状态跟踪、线网规划):申请人 → 发起方式互斥网关 → 二级单位路线:建设单位部门负责人审核 → 项目中心部门窗口 → 项目中心经办人审核 → 项目中心部门负责人审核(储备清单在此判断是否需要意见征求,需要时进入部门会签与两次确认);开投集团路线:开投集团项目中心部门负责人审核(储备清单同样含意见征求判断与后续确认)→ 结束。
  • 编制阶段流程:申请人 → 建设单位部门负责人审核 → 项目中心部门窗口 → 项目中心经办人确认 → 项目中心部门负责人审核(判断是否需要四前置需求及意见征求)→ 需要时部门会签 → 项目中心经办人确认 → 项目中心部门负责人确认 → 结束;不需要时直接结束。
  • 报审/批复流程:与双发起单阶段流程同构,节点文案与成果明细列名按「建设规划(报审/批复)」「工可研究(报审/批复)」区分。

流程设计遵循的原则:

  1. 审核节点一律「选人」:节点办理人表达式统一为下一办理人变量,提交或办理时由「选择审核人」确定并注入引擎的状态变量;不使用部门/角色待办池或角色队列派发(含项目中心部门窗口节点)。
  2. 会签用于意见征求:部门意见节点采用会签(节点比例 100%),办理人为本次选中的部门接收人集合;未选择的部门不生成任务,全部完成才汇聚。
  3. 退回不画固定连线:退回候选由引擎按实例历史计算,默认退回上一节点;退回到申请人节点时业务状态置「退回」,发起人重新提交沿用原实例;会签节点退回时其余待办自然失效,满足「任一部门退回即本轮未通过」。
  4. 幂等:提交接口声明重复提交拦截,业务侧在启动前校验既有实例并加锁,保证重复点击不产生第二个实例;审批记录按引擎办理记录幂等。
  5. 条件变量由服务端注入:发起方式与是否需要意见征求均由业务侧写入流程变量,前端参数不参与可信判定。
  6. 流程定义资产以 JSON 形式随代码维护,导入后发布并回读节点与连线核对;办理页路径同时登记在流程定义中。

7. 核心运行流程与状态模型 ​

业务状态进入条件允许角色可执行动作离开条件
草稿新增或暂存,未启动流程创建者或具备管理权限者编辑、删除、提交提交校验通过并启动流程
进行中流程已启动或退回后重新提交当前节点办理人(其余人只读)按节点办理、退回、查看流程图与审批历史全部节点通过;或退回申请人节点
退回流程退回至申请人节点创建者或具备重新办理权限者修改、重新提交重新提交后回到进行中
已通过该阶段/任务流程结束授权查看人员查看、导出终态(不因新建同项目阶段任务而改变)

业务状态与流程实例状态分列保存:实例状态含运行中、已结束、已退回、已被取代(重启后原实例)等取值;当前节点与当前办理人从有效流程任务解析,业务状态由流程事件回写,不以页面显示代替服务端状态。

8. 接口职责概览 ​

能力调用方接口职责关键输入/输出权限边界
列表与详情台账页按模块分页查询任务与详情装配(项目、专题、阶段、成果、意见征求)查询条件、任务标识列表/查询权限
任务台账台账页任务维度台账查询条件台账权限
项目台账与历史数据台账页、项目历史数据页按项目实时聚合任务与阶段、专题查询条件、项目标识台账权限
新增(双发起)新增页按发起方式解析发起单位并保存草稿业务表单、发起方式二级单位新增/开投集团新增
修改与删除新增页、列表记录级权限与状态校验后修改或删除草稿任务标识、业务表单修改/删除权限
提交新增页业务校验、保存、启动或继续流程、回写状态任务标识、审核人集合提交权限
审批办理办理页由平台流程接口完成节点办理,业务侧回写审批记录与状态流程任务、意见、附件审批办理权限 + 任务归属校验
意见征求审核页决定是否需要意见征求并选择部门接收人;部门接收人提交本人意见流程任务标识、部门与接收人、意见审批办理权限
流程图与审批历史办理页、详情返回流程历史与审批记录汇总业务标识查询权限 + 平台流程查询权限
重启实例详情事务内取代原实例并新建实例任务标识、下一办理人、原因流程实例重启权限
导出台账页按当前查询与数据范围导出查询条件导出权限
专题类型目录专题目录页目录维护、选项查询与关联项目专题类型、项目集合专题类型目录各动作权限
自动引用内部事件来源阶段已通过后生成状态跟踪引用记录来源任务、来源阶段记录系统内部,无对外入口

接口路径、字段校验、流程图与审批历史的查询方式在详细设计中展开。

9. 权限与安全边界 ​

  • 权限码统一为 planning:<资源>:<动作>,资源为 5 个模块标识与专题类型目录,动作为查询、二级单位新增、开投集团新增、修改、删除、提交、审批办理、导出、管理,另有台账视图与流程实例重启;后端注解、菜单权限串与前端指令三处必须逐字一致,前端隐藏按钮不代替鉴权。
  • 发起方式由服务端按权限与用户部门归属复核:以二级单位方式发起要求用户所属单位存在(按祖级路径由近及远匹配所属单位关系),以开投集团方式发起取集团根部门;条件不满足时拒绝并给出明确提示,修改前端参数不能改变发起单位归属。
  • 记录级权限:草稿仅创建者或管理权限者可编辑/删除;进行中仅当前处理人可办理节点动作;已通过业务只读。
  • 当前节点办理资格以引擎有效任务与业务标识校验为准,前端不传办理人决定归属。
  • 模块依赖的平台权限(项目查询、流程实例查询与当前实例列表、流程定义列表、文件查询)需随角色一并授予(开发库回读:三个规划管理角色均已含流程与文件查询类平台权限,项目查询授予发起人与管理员);权限按用户缓存,补授必须经角色授权保存触发缓存失效。
  • 敏感数据处理:文档与页面不出现账号口令;附件与成果文件保存对象引用,接口与日志不输出完整文件地址与外部凭据。

10. 异常、事务与幂等 ​

  • 草稿保存与流程启动分离:暂存允许数据不完整,提交必须完成全量业务校验。
  • 提交在事务内完成业务保存、流程启动或继续与状态回写;流程启动失败回滚业务提交。
  • 意见征求在事务内完成批次与部门任务写入、会签变量注入;科室意见回写与批次结论分别按接收人与流程事件落地,全部完成才流转。
  • 流程事件回写与审批记录写入在同一事务内完成;审批记录按引擎办理记录幂等,避免重复事件产生重复记录。
  • 自动引用按来源阶段记录幂等,同一来源重复触发不重复生成。
  • 重启实例在一个事务内完成原实例取代、新实例登记与业务状态重置,历史完整保留。
  • 外部依赖(文件服务、项目主数据、组织数据)不可用时拒绝相应操作并给出提示,不写入占位成功记录。
  • 日志包含业务标识、流程实例、节点、操作者与结果,不记录凭据或完整敏感附件地址。

11. 与设计稿的关系与关键设计来源 ​

本文按正式交付口径确定模块定位、边界、页面路由、数据模型与流程概览,业务规则以需求分析和已确认用户决定为准,差异记录在第 12 节。字段矩阵、接口契约与逐节点流程变量进入数据库设计与详细设计;实际验证范围和结果见测试与验收,本文不复制。

来源用途
《规划管理原型确认-004-20260916-合稿版》PDF(V4)模块范围、页面清单与整体审批流程图(设计稿初版依据)
《规划管理原型确认-图片版本》(2026-09-20,36 张页面图)业务内容依据:四页模型、台账与表单的业务字段、阶段性页面职责与批注;页面布局、列顺序和控件形态按平台规范设计,不以原型视觉细节为准
《20260918 数智建管平台工程规划管理功能架构与系统审批流程》整体架构与 5 个模块审批链路,与 9 条已发布流程定义逐节点一致
用户书面开发指令与 2026-09-20 逐条裁决四页模型、阶段性任务口径、专题类型多选、文案对齐、共用入口静态路由等最终口径
当前代码(后端计划管理包、流程定义 JSON、前端页面与路由注册)表清单、权限码、流程节点、办理页路径与页面职责的核实依据
开发库回读(菜单、权限串、字典、角色、流程定义、13 张业务表)菜单层级与顺序、字典项、角色与授权、流程发布状态与表清单
需求分析业务范围、规则条目、验收标准与待确认事项

12. 待确认事项 ​

问题正文、来源与确认状态只在需求分析维护;下表仅说明本设计受影响的位置和当前设计处理,提案不等于已获业务确认。

关联问题受影响设计点当前设计处理(以需求侧状态为准)
Q-PL-001台账视图切换按钮与台账接口鉴权已完成对齐(2026-09-20);后续可在新授权角色下复核台账接口鉴权结果
Q-PL-002会签后确认节点实际办理人已通过端到端复验;建议在会签完成路径显式指定确认节点办理人,待确认后调整
Q-PL-003意见征求、导出与提醒当前业务决定为运营/资产/建设三部门必选、OTHER 接收人选填;只为选择的部门生成并行待办。储备清单集团/二级单位 V3 已发布,集团版无会签路线已端到端通过;需会签路线未运行。导出/提醒口径沿用需求文档
Q-PL-004发起单位归属解析与意见征求部门候选开发库按祖级最近所属单位关系解析,项目中心与三个职能部门当前均为启用状态;正式环境清单待业务确认
Q-PL-005成果文件引用目录的落地路径本期只预留来源字段与目录标识,按直接上传兼容实现;对接待该模块立项
Q-PL-006自动化回归覆盖与附件页面上传证据验证受阻范围,详见需求分析 6.4;有可用环境时重跑
Q-PL-007数据约束说明、验证范围记录与后续资料引用业务规则以需求分析为准,数据约束与验证范围分别以数据库设计、测试与验收中的实际核对结果为准,不回引早期方案稿
Q-PL-008专题类型目录入口的注册方式与菜单依赖已记录到需求分析 R-PL-031 与 Q-PL-008;入口当前可用,是否改为静态注册待按实现口径统一

相关文档 ​