主题
设计管理 · 概要设计文档
文档版本：0.11 ｜ 最近核对日期：2026-11-09
勘察管理基线更新（2026-11-03）：勘察大纲、外业计划、进度上报、专项勘察、勘察成果以勘察管理最新需求及其六类资料为准。本页原勘察相关范围、流程、字段、待确认项与设计提案已被替代，不再作为这五项业务的实施依据；总体与方案、初步设计、施工图、巡检、考核等其他设计管理业务保留原资料状态。本页历史核验日期不代表当前数据库现状。新勘察管理按用户决定采用工程授权过滤，不沿用本页旧数据范围提案。
本文面向设计评审、实现和验收，只确定模块在平台中的定位、模块边界与相邻模块关系、页面与路由、数据模型概览、流程概览、权限方案和关键技术决策，不展开字段级、参数级与类级实现。字段矩阵、接口参数与流程定义 JSON 细节进入数据库设计与详细设计。
本模块尚未实现，本文是设计基线而非已实现事实：表名、路由、组件路径、权限码与流程编码均为设计提案，落地后按「当前代码 + 开发库回读」核对实际技术标识并记录差异；业务规则仍以适用需求基线为准，不能用实现差异静默改写。
文档控制
| 项目 | 内容 |
|---|---|
| 模块名称 | 设计管理 |
| 实现进度说明 | 模块尚未进入实现；本轮建立需求与概要设计基线 |
| 编写日期 | 2026-09-21 |
| 受测代码状态 | 不适用（本模块无代码）；平台既有契约对照基线为提交 067b72c（BusinessStatusEnum、flowFormRoutes.ts/flowFormPaths.ts、规划管理已落地口径等），开发库菜单、字典、部门与流程定义现状按项目 MCP 只读回读核对 |
| 业务确认人 | 待确认 |
| 关联需求分析 | 设计管理需求分析 |
| 设计来源 | 《数智建管平台勘察设计管理模块.pdf》（2026-09-20，单页流程图）；桌面文件《勘察设计管理功能需求架构清单.csv》（扩展名为 .csv，实为 OLE2/Excel 97-2003 工作簿；工作表「基于BIM+3DGIS的管理平台勘察设计管理功能需求架构及功能」，UsedRange 35×9、34 行非空）；两份来源未纳入仓库 |
1. 模块在平台中的定位与复用
勘察设计管理是工程勘察与设计业务的一级业务模块，与规划管理、招投标监管、开投安质环监管、工程变更监管同级；原功能架构图历史规划（工程部讨论版，2026-08-26）将勘察设计管理列为 12 月上线批次，并将工程变更监管列入 9 月批次、归属勘察设计管理域。模块不新建用户、组织、权限、文件或工作流体系，全部沿用平台既有能力：
| 复用能力 | 复用内容 | 本模块的使用方式 |
|---|---|---|
| Warm-Flow | 流程实例、任务、互斥网关、并行分支、会签节点、流程图与办理工作台 | PDF 第 1 页绘出 20 条链路，但范围与节点未全部确认（Q-SD-005、Q-SD-006）；只为最终确认的链路建立流程定义，退回语义按 Q-SD-021 决定 |
| 流程事件与回写 | 流程状态事件、任务事件 | 业务侧监听事件回写业务状态、当前节点、审批记录与实例登记状态；审批记录按引擎办理记录幂等 |
| 权限体系 | 三段式权限码、菜单与按钮权限、角色授权 | surveyDesign:<资源>:<动作>；后端注解、菜单权限串、前端指令三处一致；发起方式分设动作权限 |
| 文件服务 | 文件上传与对象引用、文件查询 | 成果文件、成果明细附件、审查意见附件、支撑材料与考核依据统一保存文件服务对象引用，不复制实体文件 |
| 字典 | 业务状态、模块类型、工作阶段、差异类别、征求部门类别、参建单位类别、附件类型 | 数据库只存稳定枚举值，展示层由字典映射为中文 |
| 项目主数据 | 业务项目 | 任务与项目多对多关联并保存名称/编码快照 |
| 组织与用户 | 部门、用户 | 参建单位（勘察单位、设计单位、监理单位等）与建设单位（含分公司、主管部室）以部门承载；审核人选择、意见征求接收人、审批记录中的办理单位 |
| 工程结构 | 线路、标段、工点 | 设计交底按工点（专业）维度、施工图计划按分公司维度的关联与快照 |
| 平台页面与组件 | 列表页模板、流程工作台、用户选择、文件上传、字典标签、分页与导出 | 台账、新增/编辑、审核与只读工作台按既有模式组装 |
模块自身职责为设计提案：勘察设计业务任务与成果、跨单位审核链、审批记录与流程实例关联；具体流程与页面范围须以业务确认结果为准。
2. 模块边界与相邻模块关系
下列为本模块的候选职责，最终边界以已确认的页面、流程与待决项为准：
- 经确认纳入的业务页面所需任务、阶段记录、成果版本、成果明细与附件引用；页面数和阶段记录粒度分别受业务范围与 Q-SD-023 约束；
- 施工图报审的图册、差异类别（Ⅰ~Ⅳ类）与差异金额、经济测算结论；
- 经确认流程的提交、办理与状态回写；退回和重提规则待确认（Q-SD-021）；
- 意见征求与多部门会签的部门选择、办理、意见回写与轮次结论；
- 分管领导会签节点的办理与结论；
- 考核表、打分结果与考核依据；
- 设计巡检整改与复核记录；
- 流程审批记录与实例关联；是否需要模块专属重启或多实例查询待确认（Q-SD-021）；
- 台账查询与导出；任务/项目双台账视图是候选设计（Q-SD-019）；
- 确认页面的新增、编辑、查看及办理入口；四页模型和缺失页面动作分别待 Q-SD-009、Q-SD-008 决定。
本模块不负责：
- 用户、角色、部门、岗位与权限授权维护；
- 参建单位与建设单位组织主数据的维护（只读引用部门与用户）；
- 项目主数据与工程结构树的维护；
- 通用待办、委托、转办、加签、减签与流程引擎本身；
- 站内信/短信通知与外部系统对接；
- 相邻业务域（工程建设审批手续、工程变更监管、规划管理）的页面与流程。
与相邻模块的关系：
| 相邻对象 | 关系 |
|---|---|
| 规划管理 / 招投标监管 / 开投安质环监管 / 工程变更监管 | 同级业务模块，互不调用；共用平台流程工作台与台账模板 |
| 工程基础管理（项目主数据、工程结构） | 只读引用，保存名称/编码快照，不做维护 |
| 系统设置（部门、用户、角色、字典） | 只读引用；本模块按业务申请新增所需部门、字典与角色授权 |
| 平台流程中心（待办、流程图、流程定义） | 待办与办理入口由平台提供，本模块提供办理页与业务办理接口；办理页按流程定义静态注册 |
| 文件服务 | 只读引用文件对象标识，不管理文件实体生命周期 |
| 工程变更监管（工程变更、交开投变更管理） | 设计类差异若涉及工程变更，由业务在工程变更模块另行发起，本模块不直接调用其接口（见 Q-SD-013） |
3. 模块分解
| 子模块/能力 | 职责 | 上游输入 | 下游输出 |
|---|---|---|---|
| 业务任务（17 个页面共用主实体） | 任务信息、模块类型、项目/工点关联、发起单位与发起方式快照、业务状态与当前节点 | 模块类型、项目/工点、填报人与填报时间 | 草稿或已提交任务 |
| 阶段链路与成果留痕 | 总体与方案设计、初步设计管理的编制/报审/批复阶段及成果版本、明细留痕；阶段与业务任务的对应粒度待 Q-SD-023 确认 | 工作阶段、成果明细与附件 | 经确认的阶段记录、成果版本与成果明细 |
| 并行审核 | 勘察类流程中地勘监理与外业见证的并行节点汇聚与结论 | 并行节点办理结果 | 汇聚结论与流程流转 |
| 意见征求与会签 | 是否需要意见征求决定、部门与接收人选择、多部门会签、分管领导会签、意见回写与轮次结论 | 开投集团项目中心部门负责人节点决定、各部门/分管领导办理 | 意见记录、轮次结论、流程流转 |
| 施工图差异分类 | 图册、差异类别（Ⅰ~Ⅳ类）、差异金额、经济测算结论与按类别分流 | 造价咨询单位审核结果 | 类别与金额、分支流转条件 |
| 审批记录与实例登记 | 逐节点审批记录快照（区分发起单位与办理单位）；多实例及重启仅作候选方案 | 流程事件、引擎办理记录 | 审批记录与经确认的实例关联；多实例/重启待 Q-SD-021 裁决 |
| 考核管理 | 考核表结构、打分结果、考核依据与下发接收 | 考核表模板、打分与依据附件 | 考核记录与待办 |
| 设计巡检整改 | 整改要求、整改材料与并行复核结论 | 分公司经办人确认、施工单位整改 | 整改与复核记录 |
| 台账与聚合视图 | 任务台账、项目台账、项目维度聚合 | 任务、阶段记录、项目与工点关联 | 列表、台账行、聚合详情 |
| 页面与路由 | 台账页、新增/编辑、审核页、详情工作台、办理页族 | 菜单与静态路由注册 | 可操作的业务页面 |
4. 页面与路由清单
需求清单将「设计联络」标为仅台账；其余 16 个页面采用四页模型属于基于规划管理先例的页面组织提案，不是原型明确要求（Q-SD-009）。列表详情是否进入流程工作台只读视图也属提案。
| 菜单/入口 | 路由（提案） | 组件（提案） | 说明 |
|---|---|---|---|
| 勘察设计管理（目录） | /surveyDesign | — | 一级菜单 |
| 勘察管理（目录） | /surveyDesign/survey | — | 二级目录 |
| 勘察大纲 | /surveyDesign/survey/outline | business/surveyDesign/outline/index | 列表 + 台账；流程含并行审核 |
| 勘察外业（目录） | /surveyDesign/survey/field | — | 三级目录（分组，无独立页面） |
| 外业计划 | /surveyDesign/survey/field/plan | business/surveyDesign/fieldPlan/index | 含计划调整 |
| 进度上报 | /surveyDesign/survey/field/progress | business/surveyDesign/fieldProgress/index | 实时填报与跟踪 |
| 专项勘察 | /surveyDesign/survey/special | business/surveyDesign/specialSurvey/index | 流程含并行审核 |
| 勘察成果 | /surveyDesign/survey/result | business/surveyDesign/surveyResult/index | 流程含工点设计单位与设计总体单位审核 |
| 总体与方案设计 | /surveyDesign/overallDesign | business/surveyDesign/overallDesign/index | 含工作阶段（编制/报审/批复）与台账 |
| 初步设计管理 | /surveyDesign/preliminaryDesign | business/surveyDesign/preliminaryDesign/index | 与总体与方案设计同构 |
| 施工图设计管理（目录） | /surveyDesign/drawing | — | 二级目录 |
| 招标图设计管理（目录） | /surveyDesign/drawing/tender | — | 三级目录 |
| 招标图纸 | /surveyDesign/drawing/tender/drawing | business/surveyDesign/tenderDrawing/index | 成果文件审批 |
| 用户需求书 | /surveyDesign/drawing/tender/requirement | business/surveyDesign/userRequirement/index | 流程含并行意见与分公司内部会签 |
| 专项设计管理 | /surveyDesign/drawing/specialDesign | business/surveyDesign/specialDesign/index | 含汇总、归档、移交、生成清单 |
| 施工图图纸管理（目录） | /surveyDesign/drawing/sheet | — | 三级目录 |
| 施工图计划 | /surveyDesign/drawing/sheet/plan | business/surveyDesign/drawingPlan/index | 含前置条件确认 |
| 施工图报审 | /surveyDesign/drawing/sheet/submission | business/surveyDesign/drawingSubmission/index | 含图册与Ⅰ~Ⅳ类差异分支 |
| 施工图分发 | /surveyDesign/drawing/sheet/distribution | business/surveyDesign/drawingDistribution/index | 接收与分发 |
| 设计联络 | /surveyDesign/drawing/sheet/liaison | business/surveyDesign/designLiaison/index | 仅台账 |
| 设计交底 | /surveyDesign/drawing/sheet/disclosure | business/surveyDesign/designDisclosure/index | 工点（专业）维度 |
| 设计巡检 | /surveyDesign/inspection | business/surveyDesign/inspection/index | 含整改与并行复核 |
| 考核管理 | /surveyDesign/assessment | business/surveyDesign/assessment/index | 含考核表单 |
| 已确认流程的办理页（路由数量待定） | 为实际确认的流程配置 flowForm 路由；总体与初步设计如确认阶段流程再按阶段区分 | business/surveyDesign/<页面标识>/flowForm | 隐藏菜单与固定路由仅为实现提案；每个确认保留的流程才注册办理入口，流程路径保持契约一致 |
路由注册约定：普通业务页面由后端菜单驱动（SYS_MENU.COMPONENT 对应源码目录）；办理页在 src/router/flowFormRoutes.ts（固定路由表）与 src/router/flowFormPaths.ts（固定路由路径清单）中登记，并与流程定义 FORM_PATH 及前端权限路由映射逐条一致，不依赖菜单授权；流程分类按页面层级建立（见第 6 节）。
页面职责分工：列表/台账/工具栏由统一的勘察设计业务页组件承载，按模块参数开启工作阶段、台账视图与页面特有动作入口；新增/编辑表单组件负责草稿与提交；办理页组件承载流程头部、操作面板、只读业务表单、时间线与流程图抽屉，列表「详情」以只读方式复用同一组件。
5. 数据模型概览
本模块业务表按 biz_survey_design_* 前缀设计（开发库当前无对应表，以下为设计提案，全量字段矩阵在数据库设计文档中按列补齐）：
| 表（提案） | 职责（一句话） |
|---|---|
BIZ_SURVEY_DESIGN_TASK | 统一业务任务主实体与 17 个页面的对应关系为候选模型（页面组织待 Q-SD-009）；总体与方案设计、初步设计管理各阶段是否对应独立任务待 Q-SD-023 |
BIZ_SURVEY_DESIGN_TASK_PROJECT | 任务与项目的多对多关联（含项目名称/编码快照） |
BIZ_SURVEY_DESIGN_TASK_SITE | 任务与工程结构节点（标段/工点）的多对多关联（含名称与路径快照），承载设计交底的工点（专业）维度与施工图计划的分公司维度 |
BIZ_SURVEY_DESIGN_STAGE_RECORD | 阶段记录，每条任务 1 条，保存工作阶段、阶段业务状态、实例与是否需要意见征求 |
BIZ_SURVEY_DESIGN_RESULT_VERSION | 成果版本；版本如何随退回、重提及确认后的流程实例变化待 Q-SD-021 决定 |
BIZ_SURVEY_DESIGN_RESULT_ITEM | 成果明细行，按版本与阶段记录归集 |
BIZ_SURVEY_DESIGN_ATTACHMENT_REF | 附件引用，保存文件服务对象标识、文件元数据与附件类型（送审图纸、三审意见、总体单位意见、方案变化审批申请表、差异费用计算表、经济测算报告、会议纪要、盖章图纸、考核依据等） |
BIZ_SURVEY_DESIGN_DRAWING_VOLUME | 施工图报审的图册记录，保存图册标识、差异类别（Ⅰ~Ⅳ类）、差异金额、是否涉及分公司与系统设备公司支撑材料、分支结论 |
BIZ_SURVEY_DESIGN_CONSULTATION_BATCH | 意见征求批次（一轮一条），保存轮次、实例与轮次结论 |
BIZ_SURVEY_DESIGN_CONSULTATION_TASK | 单个部门/单个会签人的意见任务，保存部门或会签人类别、接收人、意见、结果与完成时间（多部门意见与分管领导会签共用） |
BIZ_SURVEY_DESIGN_APPROVAL_RECORD | 审批记录快照（不可篡改），含节点、审批人及其部门、发起单位与办理单位、意见、结果与时间 |
BIZ_SURVEY_DESIGN_PROCESS_INSTANCE | 流程实例关联提案；是否需要多实例历史与重启、所需字段和生命周期待 Q-SD-021 决定 |
BIZ_SURVEY_DESIGN_ASSESSMENT | 考核记录主表（考核周期、被考核单位、总分、下发与接收状态） |
BIZ_SURVEY_DESIGN_ASSESSMENT_ITEM | 考核打分明细（考核项、标准分、实际得分、扣分依据） |
BIZ_SURVEY_DESIGN_INSPECTION_RECTIFY | 设计巡检整改记录（整改要求、整改材料、并行复核人与结论） |
设计要点：
- 业务与流程分离：业务状态与流程实例标识分列；实例以登记表为准，业务标识建议沿用
{阶段记录ID}#{实例序号}口径，保证同一业务可登记多个实例且查询唯一；该标识含#，前端查询流程历史时路径段必须 URL 编码，否则时间线为空。 - 阶段性任务建模：阶段与业务任务的主从关系属于候选方案；总体与方案设计、初步设计管理的编制/报审/批复阶段粒度待 Q-SD-023 确认，其余页面的统一任务实体与页面组织待 Q-SD-009 确认。未确认前不把每阶段独立任务、单阶段页面各建一条任务或同一任务内重提沿用原实例视为定稿。
- 差异分类结构化：施工图报审的图册、差异类别与金额落在图册表上，类别作为流程分支条件变量由服务端注入，前端参数不参与可信判定。
- 聚合视图候选：如业务确认需要项目台账，可按关联关系聚合查询；是否同时提供任务台账和项目台账待 Q-SD-019 决定。
- 结构化落库：成果明细、意见征求、会签、审批记录、考核打分均为结构化表；不使用 JSON 承载业务字段，JSON 仅用于平台流程扩展信息。
- 仅台账页面：设计联络使用任务主表承载（模块类型为设计联络），不启动流程；是否提供写入动作与数据来源待确认（Q-SD-011）。
- 逻辑删除与唯一性：逻辑删除必须与唯一性校验保持一致；成果版本建议以（阶段记录 + 版本号）唯一，流程实例登记以业务标识唯一，考核记录以（考核周期 + 被考核单位）唯一，具体约束在数据库设计中定稿并回读核对。
字典（提案，命名沿用 <模块>_<名称> 现状口径）：survey_design_business_status（草稿/进行中/退回/已通过）、survey_design_module_type（17 个模块类型枚举）、survey_design_work_stage（编制阶段/报审阶段/批复阶段）、survey_design_consultation_dept_type（运营管理部/资产管理部/建设管理部/其他部门）、survey_design_drawing_change_category（Ⅰ类/Ⅱ类/Ⅲ类/Ⅳ类）、survey_design_unit_role（勘察单位/地勘监理单位/外业见证单位/设计总体单位/工点设计单位/设计审查单位/造价咨询单位/监理单位/施工单位/建设单位/建设单位分公司/开投集团/运营公司等）、survey_design_attachment_type（附件用途分类）。
6. 流程概览
PDF 第 1 页绘出 20 条流程链路，以下清单是来源链路盘点与流程编码提案，不是 20 条已确认的实现范围。总体与方案设计、初步设计管理的 7 条流程标注「与开投讨论确认」，用户需求书流程可能简化（Q-SD-005、Q-SD-006）；最终流程数以确认结果为准。
| # | 流程编码（提案） | 所属页面 | 发起单位 | 特殊节点 |
|---|---|---|---|---|
| 1 | survey_design_outline | 勘察大纲 | 勘察单位 | 并行审核（地勘监理、外业见证） |
| 2 | survey_design_field_plan | 外业计划 | 勘察单位 | 并行审核 |
| 3 | survey_design_field_progress | 进度上报 | 勘察单位 | 并行审核 |
| 4 | survey_design_special_survey | 专项勘察 | 勘察单位 | 并行审核 |
| 5 | survey_design_survey_result | 勘察成果 | 勘察单位 | 并行审核 + 工点设计单位审核 |
| 6 | survey_design_overall_compilation | 总体与方案设计（编制） | 建设单位部门经办人 | 意见征求（会签）＋两次确认 |
| 7 | survey_design_overall_submission | 总体与方案设计（报审） | 二级单位 / 开投集团（互斥网关分流） | — |
| 8 | survey_design_overall_approval | 总体与方案设计（批复） | 二级单位 / 开投集团 | — |
| 9 | survey_design_preliminary_compilation | 初步设计管理（编制） | 建设单位部门经办人 | 意见征求（会签）＋两次确认 |
| 10 | survey_design_preliminary_submission | 初步设计管理（报审） | 二级单位 / 开投集团 | — |
| 11 | survey_design_preliminary_approval | 初步设计管理（批复） | 二级单位 / 开投集团 | — |
| 12 | survey_design_tender_drawing | 招标图纸 | 设计单位 | — |
| 13 | survey_design_user_requirement | 用户需求书 | 设计单位 | 并行意见（会签）＋项目分公司内部会签 |
| 14 | survey_design_special_design | 专项设计管理 | 设计单位（可自行创建条目） | — |
| 15 | survey_design_drawing_plan | 施工图计划 | 建设单位分公司经办人 | — |
| 16 | survey_design_drawing_submission | 施工图报审 | 设计单位专业负责人 | 两次并行汇聚 + 判断是否零号台账变化 + Ⅰ~Ⅳ类分支（含分管领导会签） |
| 17 | survey_design_drawing_distribution | 施工图分发 | 设计单位专业负责人 | — |
| 18 | survey_design_design_disclosure | 设计交底 | 工点（专业）设计单位 | — |
| 19 | survey_design_design_inspection | 设计巡检 | 设计单位负责人 | 整改判断 + 并行复核 |
| 20 | survey_design_assessment | 考核管理 | 设计部经办人 | — |
节点链路（对源图的结构化转录；待确认的流程链路仅供讨论，不作为实现基线）：
- 勘察类单阶段流程（1–4）：申请人（勘察单位编制，提交）→ 并行审核（地勘监理单位项目负责人审核 / 外业见证单位项目负责人审核）→ 并行同意后 → 建设单位主管部室经办人审核 → 建设单位主管部室部长审核 → 结束。勘察大纲（1）的链路为：并行同意后 → 设计总体单位审核 → 建设单位经办人审核 → 部长 → 项目中心经办人审核 → 结束。
- 勘察成果（5）：并行同意后 → 工点设计单位项目负责人审核 → 设计总体单位项目负责人审核 → 建设单位主管部室经办人审核 → 建设单位主管部室部长审核 → 结束。
- 总体与方案设计、初步设计管理（6–11）：编制阶段为「建设单位部门经办人上传 → 建设单位部门负责人审核 → 开投集团项目中心部门窗口 → 开投集团项目中心经办人确认 → 开投集团项目中心部门负责人审核（是否需要四前置需求及意见征求）→ 是：四部门会签 → 各部门意见同意后 → 项目中心经办人确认 → 项目中心部门负责人确认 → 结束 / 否：结束」；报审与批复阶段为「方式一 二级单位发起：建设单位部门经办人上传 → 建设单位部门负责人审核 → 项目中心部门窗口 → 项目中心经办人审核 → 项目中心部门负责人审核 → 结束」与「方式二 开投集团发起：开投集团部门经办人上传 → 项目中心部门负责人审核 → 结束」。
- 施工图报审（16）：设计单位专业负责人上传送审图纸附件＋三审意见、总体单位意见 → 并行（设计审查单位项目负责人正式审核、建设单位主管部室窗口接收分发）→ 并行（建设单位/运营公司/开投集团相关主管部室经办人审查意见上传）→ 并行同意后 → 并行（窗口确认提交设计单位修改、窗口确认提交审查单位确认并上传意见）→ 并行同意后 → 设计单位专业负责人上传最终图纸文件、意见回复、判断是否零号台账变化 → 否：设计审查单位项目负责人确认 → 结束；是：设计单位项目负责人上传上一阶段方案变化支撑文件（填写类别和金额）→ 设计审查单位项目负责人审核 → 造价咨询单位项目负责人审核（填写类别和金额、上传经济测算报告）→ 按类别分支（Ⅰ~Ⅳ类，每类内再按是否涉及分公司和系统设备公司分流）→ 建设单位设计部窗口接收分发 → 设计单位项目负责人按意见修改并上传修订图纸 → 设计审查单位项目负责人确认 → 结束。
流程设计遵循的原则：
- 办理人选择提案：规划管理采用「选人」办理，可作为候选设计；本模块各节点办理人与部门候选范围须结合业务确认，不能仅凭先例固化。
- 并行审核与多部门会签复用引擎既有节点：并行审核为并列节点全部完成后汇聚；多部门意见与分管领导会签采用会签节点（节点比例 100%），办理人为本次选中的部门接收人或会签人集合，未选择的部门不生成任务。
- 退回路径待确认：需求流程图只画正向节点，没有定义退回目标、并行/会签时其他待办处理、单据状态或重提实例规则。不得默认退回上一节点或发起人；按 Q-SD-021 确认后设计。
- 条件变量由服务端注入：发起方式、是否需要意见征求、差异类别、是否零号台账变化均由业务侧写入流程变量，前端参数不参与可信判定。
- 幂等：提交接口声明重复提交拦截，业务侧在启动前校验既有实例并加锁；审批记录按引擎办理记录幂等。
- 流程定义资产以 JSON 形式随代码维护，导入后发布并回读节点与连线核对；办理页路径同时登记在流程定义
FORM_PATH中；流程分类按页面层级建立（勘察设计管理 → 二级业务域 → 存在页面的三级分组），流程定义名称按「页面叶子名称」命名，多阶段页面按「页面名称 + 阶段」（如「总体与方案设计编制阶段」，与既有「建设规划编制阶段」口径一致）。
7. 核心运行流程与状态模型
| 业务状态 | 进入条件 | 允许角色 | 可执行动作 | 离开条件 |
|---|---|---|---|---|
| 草稿 | 新增或暂存，未启动流程 | 创建者或具备管理权限者 | 编辑、删除、提交 | 提交校验通过并启动流程 |
| 进行中 | 流程已启动或退回后重新提交 | 当前节点办理人（其余人只读） | 按节点办理、退回、查看流程图与审批历史 | 全部节点通过；或退回申请人节点 |
| 退回 | 流程退回至申请人节点 | 创建者或具备重新办理权限者 | 修改、重新提交 | 重新提交后回到进行中 |
| 已通过 | 该任务流程结束 | 授权查看人员 | 查看、导出 | 终态 |
业务状态与流程实例状态分列保存为设计提案。实例状态枚举、退回和重提关系以 Q-SD-021 确认；当前节点与当前办理人从平台有效流程任务解析，不能用页面展示替代服务端校验。
8. 接口职责概览
| 能力 | 调用方 | 接口职责 | 关键输入/输出 | 权限边界 |
|---|---|---|---|---|
| 列表与详情 | 台账页 | 按模块分页查询任务与详情装配（项目、工点、阶段、成果、意见征求、图册） | 查询条件、任务标识 | 列表/查询权限 |
| 任务台账 | 台账页 | 任务维度台账 | 查询条件 | 台账权限 |
| 项目台账 | 台账页 | 按项目实时聚合任务与阶段 | 查询条件、项目标识 | 台账权限 |
| 新增 | 新增页 | 按发起方式解析发起单位并保存草稿 | 业务表单、发起方式 | 新增权限（双发起分设） |
| 修改与删除 | 新增页、列表 | 记录级权限与状态校验后修改或删除草稿 | 任务标识、业务表单 | 修改/删除权限 |
| 提交 | 新增页 | 业务校验、保存、启动或继续流程、回写状态 | 任务标识、审核人集合 | 提交权限 |
| 审批办理 | 办理页 | 由平台流程接口完成节点办理，业务侧回写审批记录与状态 | 流程任务、意见、附件 | 审批办理权限 + 任务归属校验 |
| 意见征求与会签 | 审核页 | 决定是否需要意见征求并选择部门接收人；部门接收人/会签人提交本人意见 | 流程任务标识、部门与接收人、意见 | 审批办理权限 |
| 图册与差异分类 | 施工图报审页 | 维护图册、差异类别、差异金额与经济测算结论 | 任务标识、图册集合、类别与金额 | 施工图报审新增/修改权限 |
| 分发与接收 | 施工图分发页、考核管理页 | 窗口接收与分发、分公司接收；考核下发与接收 | 任务标识、接收单位 | 分发/接收权限 + 任务归属校验 |
| 汇总/归档/移交/生成清单/归集 | 对应页面 | 按页面语义汇总成果、归档、移交或生成清单 | 任务标识、选择范围 | 资源特有动作权限 |
| 设计巡检整改 | 设计巡检页 | 提交整改材料、并行复核结论 | 任务标识、整改材料、复核意见 | 整改/复核权限 + 任务归属校验 |
| 流程图与审批历史 | 办理页、详情 | 返回流程历史与审批记录汇总 | 业务标识 | 查询权限 + 平台流程查询权限 |
| 流程实例重启（候选，Q-SD-021） | 待确认 | 是否开放、操作角色、原实例与新实例关系待业务确认 | 待确认 | 未确认前不配置专属入口或权限 |
| 导出 | 台账页 | 按当前查询与数据范围导出 | 查询条件 | 导出权限 |
接口路径、字段校验、流程图与审批历史的查询方式在详细设计中展开。
9. 权限与安全边界
- 权限码统一为
surveyDesign:<资源>:<动作>，资源取 17 个业务页面标识，动作为查询、新增、修改、删除、提交、审批办理、导出，另有资源特有动作与台账视图、流程实例重启：
| 资源标识（提案） | 页面 | 资源特有动作（提案，仅取自需求清单按钮列） |
|---|---|---|
outline | 勘察大纲 | — |
fieldPlan | 外业计划 | — |
fieldProgress | 进度上报 | — |
specialSurvey | 专项勘察 | — |
surveyResult | 勘察成果 | 归集 |
overallDesign | 总体与方案设计 | 归档、变更审批 |
preliminaryDesign | 初步设计管理 | 归档、变更审批 |
tenderDrawing | 招标图纸 | — |
userRequirement | 用户需求书 | — |
specialDesign | 专项设计管理 | 汇总、归档、移交、生成清单 |
drawingPlan | 施工图计划 | — |
drawingSubmission | 施工图报审 | — |
drawingDistribution | 施工图分发 | — |
designLiaison | 设计联络 | — |
designDisclosure | 设计交底 | 归集 |
inspection | 设计巡检 | 归集 |
assessment | 考核管理 | — |
资源标识与前端组件目录名一致（如 outline ↔ business/surveyDesign/outline），与既有 planning:reserve ↔ business/planning/reserve 的口径相同。表内「—」表示该页面在需求清单按钮列中没有任何清单列出的特有动作，不代表页面没有流程动作。
流程节点级动作（窗口接收与分发、建设分公司接收、组织交底、组会、整改与复核、考核登记与下发、差异分类确认、意见回复等）来自流程节点文案而非按钮列，由流程办理权限与任务归属校验承载，不自动成为独立权限码；是否需要独立按钮权限待确认（Q-SD-018）。勘察大纲与专项勘察的清单说明文案提到「过程资料的自动归集」，但按钮列未列出归集动作，故不单列权限（Q-SD-018）。
台账视图权限、页面动作和资源权限仍须结合已确认范围定稿；模块专属流程重启未见于需求来源（Q-SD-021）。后端注解、菜单权限串与前端指令三处逐字一致。
- 数据范围：Q-SD-010 尚未裁决单位隔离及项目/工程范围；页面权限不能等同于全量数据可见。列表、详情、导出必须在服务端实施最终确认的数据过滤。
- 发起方式由服务端按权限与用户部门归属复核：以「二级单位发起」要求用户归属建设单位（含分公司）部门，以「开投集团发起」要求用户归属集团部门；条件不满足时拒绝并给出明确提示，修改前端参数不能改变发起单位归属。
- 记录级权限：草稿仅创建者或管理权限者可编辑/删除；进行中仅当前处理人可办理节点动作；已通过业务只读。
- 当前节点办理资格以引擎有效任务与业务标识校验为准，前端不传办理人决定归属。
- 模块依赖的平台权限（项目查询、工程结构查询、流程实例查询与当前实例列表、流程定义列表、文件查询）需随角色一并授予；权限按用户缓存，补授必须经「角色管理 → 授权保存」触发缓存失效，直接写库补授不生效。
- 比选与金额类数据（施工图报审的差异金额、经济测算）按业务确认的可见范围展示，接口与日志不输出完整文件地址与外部凭据。
- 敏感数据处理：文档与页面不出现账号口令；附件与成果文件保存对象引用。
10. 异常、事务与幂等
- 草稿保存与流程启动分离：暂存允许数据不完整，提交必须完成全量业务校验。
- 提交在事务内完成业务保存、流程启动或继续与状态回写；流程启动失败回滚业务提交。
- 并行审核与会签在事务内完成节点任务的生成与变量注入；各节点结论按办理人与流程事件分别落地，全部完成才流转。
- 施工图报审的类别确认与该分支流转条件在同一事务内落地，避免出现「已写类别但未按类别流转」的中间态。
- 流程事件回写与审批记录写入在同一事务内完成；审批记录按引擎办理记录幂等，避免重复事件产生重复记录。
- 若后续确认启用模块专属流程重启，其事务边界、原新实例关系与业务数据影响再按 Q-SD-021 设计；当前不把重启能力作为已确认要求。
- 外部依赖（文件服务、项目主数据、组织数据）不可用时拒绝相应操作并给出提示，不写入占位成功记录。
- 日志包含业务标识、流程实例、节点、办理单位、操作者与结果，不记录凭据或完整敏感附件地址。
11. 关键设计来源与决策
| 来源 | 用途 |
|---|---|
| 《数智建管平台勘察设计管理模块.pdf》（2026-09-20，PDF 第 1 页） | 绘出 6 个二级业务域、17 个页面和 20 条流程链路；其中 7 条标注「与开投讨论确认」，用户需求书流程可能简化，不能视为已批准范围 |
桌面《勘察设计管理功能需求架构清单.csv》（扩展名为 .csv，实为 OLE2/Excel 97-2003 工作簿；工作表「基于BIM+3DGIS的管理平台勘察设计管理功能需求架构及功能」，UsedRange 35×9、34 行非空） | 页面功能点与按钮清单（功能区/数据行/详情页三层）与页面说明文案 |
| 原功能架构图历史规划（工程部讨论版，2026-08-26） | 本模块在建设批次中的定位（12 月上线批次）与一级业务域归属 |
| 规划管理需求分析、规划管理概要设计 | 业务状态编码、附件分层、办理人选择、意见征求与页面组织等先例；仅作设计参考，四页模型、任务/项目台账与退回语义需按 Q-SD-009、Q-SD-019、Q-SD-021 确认 |
| 公共开发约定、流程图编排规范 | 三段式权限码、大整数 ID、流程菜单与分类命名、流程定义 JSON 编排 |
开发库只读回读（SYS_MENU、SYS_DICT_TYPE/SYS_DICT_DATA、SYS_DEPT、FLOW_DEFINITION） | 菜单与字典现状（确认本模块尚无任何菜单/字典/流程定义）、部门与「参建单位」现有口径、既有流程编码与分类命名口径、平台权限与流程能力现状 |
| 需求分析 | 业务范围、规则条目、验收标准与待确认事项 |
关键设计决策：
- 整体沿用规划管理已落地的业务与流程口径，不自建第二套状态机、审批记录表或文件体系；差异仅在业务语义（并行审核、跨单位办理、差异分类、考核表单）上。
- 结算类数据（差异金额）只在本模块结构化落库，不接入成本或投资模块；如后续需要联动，按跨模块契约另行设计。
- 菜单层级与页面层级一致：6 个二级业务域为目录或页面，勘察外业、招标图设计管理、施工图图纸管理为目录分组节点；该层级直接决定流程分类树与权限资源划分。
- 未决事实不进入实现：Ⅰ~Ⅳ类分类依据、多图册混合场景、用户需求书流程取舍、零号台账判定口径等按需求分析确认后再实施，不用代码现状或行业经验自动补齐。
需求到设计的对照（摘要，便于实现与验收回溯；完整规则条目见需求分析第 5 节）：
| 设计内容 | 对应需求规则 |
|---|---|
| 模块层级、6 个二级业务域与 3 个目录分组节点 | R-SD-001 |
| 四页模型与详情进入流程工作台只读视图 | R-SD-002、R-SD-022、Q-SD-009 |
| 发起单位与两种发起方式的服务端复核 | R-SD-003、R-SD-004 |
| 并行审核、多部门与分管领导会签、意见征求 | R-SD-005、R-SD-006、R-SD-007 |
| 办理人「选人」 | R-SD-008 |
| 图册差异分类与 Ⅰ~Ⅳ类分支层级 | R-SD-009、R-SD-010、R-SD-011 |
| 附件分层与附件用途分类 | R-SD-012 |
| 阶段链路的任务/记录建模（编制、报审、批复阶段的业务任务粒度待 Q-SD-023） | R-SD-013 |
| 业务状态与审批记录区分发起/办理单位 | R-SD-014、R-SD-015 |
| 提交校验、重复提交拦截、退回与重提 | R-SD-016、R-SD-017、R-SD-018 |
| 记录级权限与数据范围 | R-SD-019、R-SD-020 |
| 权限码方案与资源划分 | R-SD-021 |
| 办理页静态路由注册 | R-SD-023 |
| 设计联络仅台账 | R-SD-024 |
| 参建单位与建设单位的组织承载 | R-SD-025 |
| 考核表单结构化 | R-SD-027 |
| 流程图标注的确认状态 | R-SD-028 |
12. 待确认事项
问题正文、来源与确认状态只在需求分析维护；下表仅说明本设计受影响的位置和当前设计处理，提案不等于已获业务确认。
| 关联问题 | 受影响设计点 | 当前设计处理（以需求侧状态为准） |
|---|---|---|
| Q-SD-001 | 发起人归属解析、审核人选人范围、审批记录办理单位 | 按「参建单位 → 各类单位」补建部门；正式清单待业务确认 |
| Q-SD-002 | 审核人选择范围与发起单位归属 | 开发库按现状核对，正式清单与角色族写法待业务确认 |
| Q-SD-003 | 流程建模与数据结构（单流程分流 vs 按图册子任务） | 建议按图册子任务承载并分别分流；待业务确认后实施 |
| Q-SD-004 | 流程分支条件与节点层级 | 分类依据待业务给出；确认前不实施分支条件 |
| Q-SD-005 | 该流程与并行意见节点是否纳入实现 | 待业务确认后实施 |
| Q-SD-006 | 相关节点顺序、文案和办理人 | 流程图仅作讨论材料，确认前不作为实现或验收基线 |
| Q-SD-007 | 勘察大纲节点数量与办理层级 | 独立节点与连线说明两种解释待确认，不预建独立节点 |
| Q-SD-008 | 页面动作范围与按钮权限码范围 | 不按同级页面推定；待补明细后定页面动作 |
| Q-SD-009 | 页面数量、路由、办理入口、权限动作与验收范围 | 规划管理仅为先例；四页模型和只读视图为候选方案，待业务确认 |
| Q-SD-010 | 台账可见范围与接口数据过滤 | 服务端需执行经确认的数据范围；用户、单位及工程过滤口径待确认，不默认全量可见 |
| Q-SD-011 | 页面动作范围、权限码与表设计 | 仅台账为来源事实；数据来源与读写动作均未定，不预设只读或写入 |
| Q-SD-012 | 考核表数据结构与页面打分展示 | 按管理办法附件设计；待业务提供表单 |
| Q-SD-013 | 是否需跨模块引用 | 本地闭环与跨模块关联均为候选，待边界确认 |
| Q-SD-014 | 表单字段与会议留痕结构 | 附件与结构化会议记录均为候选，待确认 |
| Q-SD-015 | 征求部门候选与会签办理人 | 规划管理口径仅供参考，不能代替本模块确认 |
| Q-SD-016 | 是否引入可配置主数据及关联页面 | 待业务澄清；确认前不纳入范围 |
| Q-SD-017 | 流程条件变量与是否跨模块联动 | 本模块条件变量仅为候选；判定口径与归属确认前不固化分支 |
| Q-SD-018 | 页面动作范围、权限码与状态字段 | 逐项澄清后实施 |
| Q-SD-019 | 页面入口、查询聚合、权限与数据范围、导出内容 | 任务/项目双台账与聚合为候选方案；导出列口径待业务确认 |
| Q-SD-020 | 待办提醒方式 | 通知方式与范围待确认，不设业务默认 |
| Q-SD-021 | 流程状态、待办清理、权限与验收标准 | 流程图只画正向路径，退回语义待确认 |
| Q-SD-022 | 设计及量化验收门槛 | 来源未给定数值，需确认平台基线或业务阈值 |
| Q-SD-023 | 主从关系、状态、版本附件、统计与验收追踪 | 流程图只画阶段链路，阶段独立任务仅为先例候选，待确认 |