主题
规划管理 · 操作手册
文档版本：1.00 ｜ 最近核对日期：2026-09-20
本手册面向业务用户，按当前实际页面与接口口径编写。两项与页面操作有关的验证状态须先说明，避免误读：
- 后端 13 项规划管理测试（
PlanningTaskServiceImplTest、PlanningProcessEventListenerTest）在本机因 Mockito 插件加载失败报错，属验证受阻，不得记为通过；本手册涉及的规则以真实页面、真实接口与开发库回读结果为依据。- 附件上传的页面选择动作在内置浏览器不可执行（不支持文件选择），无法通过页面完成上传验证；附件随办理提交写入流程历史的能力已用真实文件标识验证，附件展示依赖文件查询平台权限。使用外部浏览器可正常选择文件。
文档控制
| 项目 | 内容 |
|---|---|
| 模块名称 | 规划管理（项目储备：储备清单、状态跟踪；规划报建：线网规划、建设规划、工可研究；专题类型目录；9 条流程定义） |
| 关联需求分析 | 需求分析 |
| 关联测试与验收 | 测试与验证报告 |
| 关联设计 | 概要设计、详细设计、数据库设计 |
| 适用角色 | 二级单位（建设单位）部门经办人/部门负责人、开投集团项目中心部门窗口/经办人/部门负责人、征求意见部门接收人、开投集团部门经办人、查看人员、系统管理员/流程管理员 |
| 编写/核对人 | ZCode 文档 Agent |
| 前置环境 | 已在开发环境登录并取得对应菜单与按钮授权；项目下拉需项目查询权限；附件上传建议使用支持文件选择的外部浏览器。账号与密码按私有仓库 README 的私有开发环境账号章节申请与维护，本文不记录任何账号、密码或私有地址 |
1. 菜单与权限
1.1 业务入口
规划管理为一级菜单，下设两个目录、五个业务页面，另有专题类型目录与各流程办理页（隐藏入口）。
| 入口 | 菜单路径 | 页面能力 | 备注 |
|---|---|---|---|
| 储备清单 | 规划管理 → 项目储备 → 储备清单 | 查询、双发起方式新增、修改、删除、导出、任务台账/项目台账切换、行操作 | 列表含「发起方式」列 |
| 状态跟踪 | 规划管理 → 项目储备 → 状态跟踪 | 同上 | 专题类型必填；项目台账额外展示「规划报建阶段」「专题类型」列与「历史数据」入口；自动引用记录不可编辑 |
| 线网规划 | 规划管理 → 规划报建 → 线网规划 | 查询、双发起方式新增、修改、删除、导出、行操作 | 不提供任务台账/项目台账切换（页面结构按平台台账模式确定） |
| 建设规划 | 规划管理 → 规划报建 → 建设规划 | 查询（含工作阶段）、双发起方式新增、修改、删除、导出、台账切换、专题类型目录入口、行操作 | 编制/报审/批复各为一条独立任务 |
| 工可研究 | 规划管理 → 规划报建 → 工可研究 | 同建设规划（业务模块独立） | 同上 |
| 专题类型目录 | 规划管理 → 规划报建 → 专题类型目录（隐藏菜单） | 查询、新增、修改、删除、详情、关联项目 | 由建设规划/工可研究工具栏按钮进入；菜单未授权时按钮跳转报 404，见第 7 节 |
| 项目历史数据 | 项目台账行「历史数据」（固定路由） | 按项目汇总同一模块的历史任务 | 不依赖菜单授权 |
| 办理页 | 各流程「流程定义名称 + 办理」（隐藏菜单，固定路由） | 只读表单、流程图、审批时间线、同意/退回、重启实例 | 只读详情与办理共用同一页面 |
1.2 三种规划管理角色能做什么
| 角色 | 可查看范围 | 可执行操作 | 不可执行操作 |
|---|---|---|---|
| 规划管理发起人 | 本模块全部台账（默认不做单位隔离，具备页面权限即可查询全部） | 新增（按所属单位使用二级单位新增）、暂存、提交、退回后修改重提、删除本人草稿、导出、查询与详情 | 办理非本人待办；重启流程实例 |
| 规划管理审批人 | 当前待办关联记录与本模块台账 | 按节点办理（同意/退回）、意见征求决定节点选择部门与接收人、部门意见会签提交、查看流程图与审批时间线 | 修改业务表单；删除任务；重启流程实例 |
| 规划管理管理员 | 本模块全部台账与配置 | 上述全部能力，另有全部台账视图、专题类型目录维护、重启流程实例 | — |
1.3 办理的两个入口
| 入口 | 位置 | 说明 |
|---|---|---|
| 平台待办 | 平台首页工作台「我的待办」卡片（待办任务列表）点「办理」 | 按流程编码跳转到对应模块的办理页 |
| 业务列表行内「办理」 | 五个业务页面的任务台账/项目台账行操作 | 仅当前登录人在该记录上有待办时显示（该行待办任务标识非空）；非当前办理人看不到该按钮 |
2. 使用前准备
- 登录和权限前提：管理员已为账号授予对应模块的页面菜单与按钮权限。权限按用户缓存 30 天，补授必须经「角色管理 → 授权保存」触发缓存失效，直接写库补授不生效。
- 除规划管理业务权限外，还需按角色授予平台权限：项目查询（发起时项目下拉）、流程实例查询与当前实例列表（流程图与审批时间线）、流程定义列表（流程图定义）、文件查询（时间线附件）。
- 必要的组织与基础数据：本人部门归属（二级单位归属或集团部门归属，决定可用哪种发起方式）；项目下拉中的项目（来自已解耦的项目主数据）；专题类型目录中已启用的专题（建设规划只列规划阶段专题、工可研究只列工可阶段专题、状态跟踪列全部启用项）；征求意见部门（运营管理部、资产管理部、建设管理部及「其他部门」）接收人。
- 附件与格式：成果文件上传沿用平台统一文件组件与文件策略，本模块不另行限制格式与大小。成果文件默认非必填，未上传也可暂存或提交；提交只要求每条成果明细的「主要内容」不为空。
- 建议使用支持文件选择的外部浏览器完成含附件的操作（内置浏览器不支持文件选择）。
3. 业务操作
3.1 台账查询与列表操作
从
规划管理 → 项目储备/规划报建 → 目标模块进入页面；在「筛选条件」中填写查询条件后点击「查询」，或点击「重置」清空条件重新查询。可用条件：
- 项目名称（项目选择控件，按项目查询权限过滤）；
- 填报单位（文本，支持回车查询）；
- 工作阶段（仅建设规划、工可研究：编制阶段/报审阶段/批复阶段）；
- 审核状态（草稿/进行中/退回/已通过）；
- 任务名称（文本，支持回车查询）。
在工具栏按需执行动作（按钮按权限显示）：
工具栏动作 说明 开投集团新增 以开投集团发起方式新增任务（需对应动作权限与集团部门归属） 二级单位新增 以二级单位发起方式新增任务（需对应动作权限与二级单位归属） 专题类型目录 仅建设规划/工可研究显示，跳转专题类型目录页面 修改 选中一条记录后可用；按状态与记录级权限判定 删除 选中记录后可用；仅草稿可删除，非草稿记录会被跳过并在提示中说明 导出 按当前查询条件导出 xlsx 任务台账 / 项目台账 仅储备清单、状态跟踪、建设规划、工可研究显示，用于切换视图 刷新 / 列设置 表格右侧通用工具，用于重新加载与调整显示列 行操作按钮按状态显示：
草稿：编辑、删除（不显示「详情」，草稿没有流程实例）；退回：编辑（重新提交）、详情；进行中：详情；若当前登录人有待办则显示「办理」；发起人（或有管理权限者）另有编辑；已通过：详情（只读）。
任务台账与项目台账的区别：
| 视图 | 维度 | 主要列 | 适用场景 |
|---|---|---|---|
| 任务台账 | 每条业务任务一行 | 项目名称、任务名称、工作阶段（建设规划/工可研究）、发起方式（储备清单）、填报单位、填报人员、填写时间、审核状态 | 查看某条任务当前由谁在办、要不要催办 |
| 项目台账 | 按项目聚合，一个项目一行 | 项目名称、规划报建阶段（状态跟踪、建设规划、工可研究）、专题类型（状态跟踪、建设规划、工可研究）、主要内容、填报单位、填报人员、填写时间、审核状态 | 查看一个项目下本模块的全部历史任务 |
- 项目台账不复制业务数据，按查询条件实时聚合；行数据取该项目在本查询范围内的最新一条任务，行操作按该行自己的模块调用接口（状态跟踪的项目台账会混入建设规划/工可研究的任务行）。
- 项目台账行操作为：详情（草稿行回退为只读业务弹窗，其余进入流程工作台只读视图）、办理（仅当前登录人有待办时显示）、历史数据、编辑（仅草稿/退回且本人为创建人或具备管理权限时显示）、删除（仅草稿）。
- 项目台账行提供「历史数据」入口：点按后进入「项目历史数据」页面，按项目汇总同一模块的历史任务，可查看条数、任务名称、规划报建阶段、专题类型、填报单位/人员/时间与审核状态，并对行执行「详情」「办理」，页面「返回」回到列表。缺少项目参数时列表为空。
**成功标准：**列表按条件返回对应记录，状态列显示草稿/进行中/退回/已通过；台账按钮切换后表格列与聚合维度随之变化。
3.2 发起任务（新增 / 编辑）
在列表工具栏点击「二级单位新增」或「开投集团新增」（编辑时点击行内或工具栏「修改」）；
在弹窗中填写表单：
字段 填写方式 是否必填 项目名称 下拉多选，可筛选；一份任务可关联多个项目，列表与台账按顿号拼接展示 是（至少一个） 任务名称 文本，不超过 100 字 是 专题类型 下拉多选；状态跟踪必填，建设规划只列规划阶段专题、工可研究只列工可阶段专题、状态跟踪列全部启用项 状态跟踪必填，其余按需 工作阶段 下拉单选：编制阶段/报审阶段/批复阶段（仅建设规划、工可研究） 建设规划/工可研究必填 填报人 由当前登录人自动带出，只读 自动 填报时间 日期选择，默认当天 是 备注 多行文本，不超过 500 字 否 成果明细 点「新增」增加明细行，填写「主要内容」（不超过 500 字）并上传成果文件；每行可「编辑/完成/删除」 明细至少一条且主要内容非空（提交时校验） 成果明细区的标题与文件列名按模块与工作阶段自动命名：前期储备研究成果文件（储备清单）、进度成果文件（状态跟踪）、线网规划成果文件（线网规划）、建设规划编制阶段文件/建设规划报审成果文件/建设规划批复成果文件（建设规划三阶段）、工可研究编制阶段文件/工可研究报审成果文件/工可研究批复成果文件（工可研究三阶段）。建设规划与工可研究的明细区标题为编制成果/报审版本/批复成果。
弹窗底部左侧「流程图」可查看本次表单对应的流程图（先选好工作阶段；建设规划/工可研究未选工作阶段时不显示该入口，相关操作会提示「请先选择工作阶段后再查看流程图」）；
底部右侧按钮：
- 点击「暂存」：只保存业务数据，不启动流程，记录状态为草稿；
- 点击「提交」：先校验表单，通过后弹出「选择下一步审核人」弹窗，选择审核人后点「确定」；提交后启动流程，状态变为进行中，多选审核人时按或签处理；
- 点击「取消」：关闭弹窗，不落库（查看详情时为「关闭」）。
**暂存与提交的区别：**暂存不启动流程、不校验成果明细与审核人，可在草稿状态反复修改；提交执行完整校验（项目、任务名称、工作阶段/专题类型按模块、填报时间、明细主要内容、下一步审核人），任一缺失只拦截提交、不阻断暂存。
**成功标准：**暂存后列表出现记录且状态为「草稿」；提交后状态为「进行中」，列表行出现「详情」，若审核人是本人则出现「办理」。
发起方式说明：
- 「二级单位新增」要求账号归属解析为二级单位（所属单位），「开投集团新增」要求账号归属为集团部门；发起方式由后台根据权限与部门归属复核，修改前端参数不能冒充另一种发起方式。
- 未分配部门时无法发起，会提示联系管理员配置部门；不属于二级单位却以二级单位方式发起时，后台拒绝且不生成业务记录。
- 编辑与再次提交时发起方式不可变更。
- 建设规划编制阶段与工可研究编制阶段只有二级单位发起路线，不提供开投集团发起。
3.3 办理与审批
- 从平台「我的待办」点「办理」，或在业务列表行内点「办理」，进入办理页。页面顶部显示业务标题、流程信息（流程名称与版本）、单据编号，右侧为「流程图」「审批动作」「重启实例」（满足条件时）「返回」；
- 页面左侧为该单据的只读表单（含项目名称、任务名称、工作阶段、专题类型、填报单位/人员/时间、发起方式、审核状态、发起单位、备注）与成果明细（附件可点开预览）；成果版本多于一条时另显示「成果版本」表；右侧为「审批时间线」，按节点展示办理人、部门、审批意见、结果与时间；
- 同意：进入办理时会自动弹出审批弹窗（标题为「审批办理」）。弹窗内可：
- 点击快捷意见按钮
请审核.无意见.拟同意.同意.快速带入审批意见，也可自行输入； - 按需上传办理附件；
- 当下一个节点需要选人时，按节点选择「下一步审批人」；也可增加抄送人。 确认后提交，办理完成并返回列表，时间线新增一条记录；
- 点击快捷意见按钮
- 退回：点击「退回」，选择「退回节点」（默认最近的上一个节点，可按需改选）、填写退回意见（可用快捷意见并上传附件），确认后提交。退回到申请人节点时记录状态变为「退回」，发起人修改后重新提交，沿用原流程实例，原审批记录保留、不覆盖；
- 办理面板按流程与平台配置还可能显示转办、委托、加签、减签、终止等平台既有动作，按平台既有规则使用；
- 非当前办理人打开办理页只有只读视图，不显示办理面板；用非本人待办的任务标识调用办理接口会被拒绝。
意见征求（仅储备清单与建设规划/工可研究的编制阶段）：
- 是否需要意见征求节点（由开投集团项目中心部门负责人办理）：办理页左侧下方显示「填写意见并提交」面板，而非通用审批弹窗；
- 选择「是否需要意见征求」：
- 选「否」：填写审批意见后点「提交并流转」，本节点结束，流程按定义继续；
- 选「是」：运营管理部、资产管理部、建设管理部各选择 1 名接收人；「其他部门接收人」为选填项，选中时也须与其他接收人不同；只有本次已选部门生成待办，未选择其他部门时不会产生该办理任务；
- 填写审批意见（必填）并按需上传附件（最多 5 个），点「提交并流转」；缺少三个必选部门中的任一接收人时页面会提示补选，未填意见时提示「请填写审批意见」；
- 各部门提出意见节点（会签）：被选中的部门接收人在各自待办中打开同一办理页，显示「部门意见」面板；填写意见/备注（必填）、按需上传意见附件，点「同意并提交」提交本人意见；
- 会签规则：本轮为并行会签，所有本次选中的部门全部提交意见后才进入下一步；任一部门退回即本轮未通过，流程回到业务发起人节点，本轮意见征求视为未通过、已完成部门的意见保留在历史记录中；
- 发起人在列表通过「编辑 → 提交」修改后重新提交，继续流转；会签完成后依次由项目中心经办人确认、项目中心部门负责人确认，全部完成后状态变为「已通过」。
**退回确认文案提示：**决定节点退回提示「流程回到业务发起人，历史意见保留」；部门意见节点退回提示「本轮意见征求视为未通过，流程回到业务发起人，已完成意见保留」。未填意见时提示「请填写退回意见」；无可退回节点时提示「未找到可退回的节点」。
**成功标准：**办理后当前待办消失、时间线新增该节点办理记录；发起人重提后状态回到「进行中」；流程走到结束节点后状态为「已通过」。
3.4 查看详情
- 在任务台账或项目台账行内点击「详情」，进入流程工作台只读视图（
type=view）：业务表单只读，可查看流程图与审批时间线，满足条件时显示「重启实例」；点「返回」回到列表； - 各节点意见不单独设为分节点卡片，统一由审批时间线呈现；
- 草稿在任务台账不显示「详情」；项目台账中的草稿行点「详情」回退为只读业务弹窗；
- 状态跟踪中由建设规划/工可研究「已通过」自动生成的引用记录没有流程实例，其详情页不会显示流程图与时间线数据；
- 「重启实例」（仅具备重启权限的系统管理员/流程管理员）：在弹窗中填写重启原因（必填）并选择下一步审核人（1 人，必填），确认后原流程实例保留、新建实例继续办理，审批历史中可同时看到原实例与新实例。
3.5 维护专题类型目录
从
建设规划或工可研究页面工具栏点击「专题类型目录」进入；页面按规划报建阶段（规划阶段/工可阶段）、专题类型名称、启用状态（启用/停用）查询；「新增」或选中一条后「修改」，在弹窗中填写：
字段 说明 是否必填 规划报建阶段 规划阶段或工可阶段（专题属于的业务分类，与工作阶段「编制/报审/批复」是两个维度） 是 专题类型名称 不超过 100 字；同一业务阶段下同名会被拒绝 是 编码 不超过 50 字 否 启用状态 启用或停用，新增默认启用 默认启用 排序 数字，影响列表排序 否 关联项目 下拉多选，仅用于目录维护，不改变项目主数据 否 备注 不超过 500 字 否 行操作：编辑、详情（只读）、删除、关联项目（该弹窗只允许维护关联项目，其余字段只读）；
「删除」在专题类型被任务引用时会被服务端拒绝并提示「专题类型「…」已被任务引用，不能删除，可改为停用」，此时应改为把启用状态置为停用；仅与项目存在关联关系不阻止删除。
**成功标准：**新增/修改后列表出现或更新对应记录；被停用的专题不再出现在任务表单的专题类型下拉中。
3.6 导出
- 在列表页按需设置筛选条件（导出与列表使用同一筛选与数据范围）；
- 点击工具栏「导出」，浏览器下载 xlsx 文件，文件名形如
模块名_时间戳.xlsx； - 导出列共 9 列：项目名称、任务名称、工作阶段、专题类型、填报单位、填报人员、填报时间、审核状态、发起方式；不含成果明细。当前实现中工作阶段、审核状态、发起方式输出的是英文枚举值（如
COMPILATION、waiting、GROUP），未做中文转换，属已知口径（见第 7 节）。
4. 字段与提示
| 页面/字段 | 填写说明 | 是否必填 | 格式/范围 | 错误提示与处理 |
|---|---|---|---|---|
| 项目名称（查询/表单） | 项目选择控件；表单中可多选，一份任务关联多个项目不拆成多条任务 | 表单中必填 | 至少一个项目 | 「请至少选择一个项目」；下拉为空见第 5 节 |
| 任务名称 | 单据业务名称，同时用于台账展示与项目历史数据 | 是 | 不超过 100 字 | 「任务名称不能为空」 |
| 专题类型 | 可配置主数据，多选；状态跟踪必填，建设规划/工可研究按业务分类过滤选项 | 状态跟踪必填 | 已启用的专题类型 | 「专题类型不能为空」；无选项时先到专题类型目录维护 |
| 工作阶段 | 编制阶段/报审阶段/批复阶段，决定使用的流程与成果明细列名 | 建设规划/工可研究必填 | 三选一 | 「工作阶段不能为空」；未选时流程图入口不显示 |
| 填报人 | 自动带出当前登录人，不可修改 | 自动 | — | — |
| 填报时间 | 默认当天，可改 | 是 | 年月日 | 「填报时间不能为空」 |
| 备注 | 补充说明；沿用既有实现保留 | 否 | 不超过 500 字 | — |
| 成果明细-主要内容 | 一条明细对应一项成果内容 | 提交时是 | 不超过 500 字 | 「请填写成果明细」/「成果明细的主要内容不能为空」 |
| 成果明细-成果文件 | 按模块与阶段命名的文件列，可上传多个 | 否 | 平台支持格式 | 上传失败可重试；内置浏览器不支持文件选择 |
| 选择下一步审核人 | 提交时确定下一节点办理人，不使用部门/角色待办池 | 提交时是 | 可选用户；多人按或签处理 | 「请选择下一步审核人」 |
| 审批意见（办理） | 同意时填写，可用快捷意见 请审核. 无意见. 拟同意. 同意. | 同意时必填 | 文本 | 可先点快捷意见再补充 |
| 下一步审批人（办理） | 下一节点需要选人时按节点选择 | 弹窗出现时必填 | 可选用户 | 未选时无法完成办理 |
| 退回节点 / 退回意见 | 默认选最近的上一个节点；意见征求节点优先回到业务发起人 | 退回时是 | 文本 | 「未找到可退回的节点」 |
| 是否需要意见征求 | 决定节点选择；选「是」时须选部门接收人 | 决定节点必填 | 是/否 | 「请选择意见征求部门与接收人」 |
| 部门接收人 | 运营管理部/资产管理部/建设管理部各 1 人，可新增「其他部门」 | 选择「是」时必填 | 可选用户 | 未选部门不生成待办 |
| 部门意见/备注 | 会签节点提交本部门意见 | 会签节点必填 | 文本 | 「请填写意见/备注」；退回时「请填写退回意见」 |
| 意见附件 | 决定节点与会签节点均可上传 | 否 | 平台支持格式，决定节点上限 5 个 | 上传失败可重试 |
| 重启原因 / 下一步审核人 | 仅具备重启权限者可见 | 是 | 文本/1 个用户 | 「请填写重启原因」/「请选择下一步审核人」 |
| 专题类型目录字段 | 规划报建阶段、名称、编码、启用状态、排序、关联项目、备注 | 阶段与名称为是 | 名称≤100 字、编码≤50 字、备注≤500 字 | 「规划报建阶段不能为空」「专题类型名称不能为空」；同阶段同名被拒 |
5. 常见问题与异常
| 现象/提示 | 常见原因 | 用户处理 | 仍失败时提供给运维的信息 |
|---|---|---|---|
| 项目下拉为空，或提示「项目选项加载失败，请刷新后重试」 | 账号缺少项目查询平台权限，或项目主数据未配置 | 联系管理员补授项目查询权限（须经「角色管理 → 授权保存」） | 用户名、角色、操作时间 |
| 看不到「任务台账」「项目台账」按钮，或调用台账提示无权限 | 账号未获台账按钮授权（台账按钮与接口权限码统一为 planning:ledger:task / planning:ledger:project） | 联系管理员按该权限串补授并保存授权 | 用户名、模块、目标按钮 |
| 流程图或审批时间线为空 | 缺少流程实例查询或流程定义列表平台权限；或该记录没有流程实例（如状态跟踪的自动引用记录） | 补授流程实例查询与流程定义列表权限；自动引用记录属正常现象 | 模块、单据编号、操作时间 |
| 附件点开无法预览 | 缺少文件查询平台权限 | 联系管理员补授文件查询权限 | 用户名、单据编号 |
| 页面上无法选择文件 | 内置浏览器不支持文件选择 | 使用外部浏览器重新打开页面 | 浏览器类型与版本 |
| 提交时提示「当前用户不属于二级单位，不能以二级单位方式发起」 | 以二级单位新增入参调用，但账号部门归属不是二级单位（所属单位） | 改选与本人归属一致的发起方式，或联系管理员更正部门归属 | 用户名、部门、操作时间 |
| 提交时提示未分配部门 / 无法发起 | 账号未配置部门 | 联系管理员配置部门后重试 | 用户名、操作时间 |
| 提示「您不是当前办理人，无权提交」 | 退回后重提要求提交人是该实例申请人节点的待办人 | 由当前申请人节点的办理人提交 | 模块、单据编号、当前节点 |
| 提示「该任务不是您的待办，无法办理」 | 待办已由他人办理、已流转或使用了他人的任务标识 | 从「我的待办」或列表重新打开当前待办 | 模块、单据编号、操作时间 |
| 提示「仅草稿状态的任务可以删除」或「仅创建人或具备管理权限的人员可以…」 | 记录不是草稿，或本人不是创建人且无管理权限 | 按状态改用办理/退回流程；或由创建人操作 | 模块、单据编号、状态 |
| 提示「专题类型「…」已被任务引用，不能删除，可改为停用」 | 专题已被任务引用 | 改为把启用状态置为停用 | 专题名称、操作时间 |
| 提交后提示重复提交或状态不支持提交 | 重复点击提交；同一业务记录只允许一个活动流程实例 | 刷新列表查看已有状态后继续 | 模块、单据编号、操作时间 |
| 提示「流程发起失败」或「任务办理失败」 | 下一办理人为空、流程定义未发布、发起方式与单据不一致等 | 检查办理人、发起方式与流程定义后重试 | 单据编号、接口响应、操作时间 |
| 点「专题类型目录」报 404 或空白 | 该入口当前由隐藏菜单驱动，菜单未授权时无法进入 | 联系管理员授予专题类型目录菜单权限 | 用户名、模块、操作时间 |
| 点台账行「详情」提示「请先选择工作阶段后再查看流程图」 | 建设规划/工可研究缺少工作阶段，无法解析流程编码 | 检查该任务的工作阶段数据，必要时联系管理员 | 模块、单据编号 |
| 导出文件中状态、阶段、发起方式为英文 | 当前导出未做字典转换（已知口径，见第 7 节） | 以列表页中文状态为准；导出列最终口径待业务确认 | 模块、导出时间 |
| 状态跟踪出现来源为「自动引用」的记录 | 建设规划/工可研究某阶段「已通过」后系统自动生成引用记录 | 属正常结果，不参与审批、不可编辑；同一来源阶段不会重复生成 | 来源模块、来源任务 |
6. 版本变更
| 版本 | 日期 | 面向用户的变化 | 影响角色 |
|---|---|---|---|
| v0.1 | 2026-09-20 | 初稿：按 5 个业务入口、专题类型目录与 9 条办理流程的当前实现口径建立操作手册 | 全部规划管理角色 |
| v0.2 | 2026-09-20 | 同步台账权限码修复：台账按钮与接口权限码统一为 planning:ledger:task / planning:ledger:project，第 5 节排查口径与第 7 节已知限制随之更新 | 具备台账视图的角色 |
| v0.3 | 2026-10-14 | 储备清单集团/二级单位流程定义升级并发布 V3；「其他部门」仅在选择接收人时产生办理分支；集团版「无需会签」路径已完成页面回归 | 储备清单发起人与办理人 |
7. 已知限制与待确认事项
以下事项按事实记录，涉及用户操作时已在正文或第 5 节说明；不确定项不作已确认表述。
- 验证受阻：后端 13 项规划测试在本机因 Mockito 插件加载失败报错；附件上传的页面选择动作在内置浏览器不可执行。两项均不得记为通过，相关结论以真实页面、真实接口与开发库回读为依据。
- 台账权限码（已修复）：最终取值统一为
planning:ledger:task/planning:ledger:project；后端 5 个控制器注解与前端台账按钮指令已按菜单与角色授权口径对齐，三处逐字一致（2026-09-20）。授权时按该权限串补授，并须经「角色管理 → 授权保存」触发权限缓存失效。 - 导出列口径待业务确认：当前导出 9 列、不含成果明细，且工作阶段/审核状态/发起方式输出英文枚举值。
- 专题类型目录入口：当前由隐藏菜单驱动，未按「共用入口一律静态注册固定路由」的口径静态注册，菜单未授权时按钮跳转 404（办理页族与项目历史数据已静态注册）。是否改为静态注册待按实现口径统一。
- 自动引用记录的详情与重启：引用记录无阶段记录与流程实例，详情页无流程图与时间线数据；该记录的「重启实例」入口点击后可能因缺少阶段记录而失败，待确认处理方式。
- 状态跟踪项目台账范围：当前展示状态跟踪、建设规划、工可研究的全部任务（不限已产生引用的任务），范围比原型文案更宽，是否收窄待业务确认。
- 会签完成后的确认节点办理人：会签完成后「项目中心经办人确认/部门负责人确认」的办理人取值依赖实例中残留的办理人变量，是否符合业务待确认；其他路径下由办理弹窗的选择审核人确定。
- 「其他部门」征求意见范围与上限：设计默认为可选任意启用部门、上限 3，代码未设限，待业务确认。
- 数据范围：当前默认不做单位隔离，具备页面权限即可查询全部台账；发起单位字段用于展示与审批记录区分。