勘察管理 · 需求分析

文档版本：1.20 ｜ 最近核对日期：2026-11-04

勘察合同类型（2026-11-04）：勘察标段候选及保存校验限定“勘察标段”“勘察设计标段”，综合统包标暂不纳入。测试标段不代表正式主数据齐备，标段仍允许为空；无标段提交时项目必填。

项目	内容
业务来源	用户指定《勘察管理原型设计界面-20261024.pdf》为最新业务基线；用户本次关于平台组件、样式与数据范围的明确决定
适用范围	勘察设计管理下的勘察管理，不覆盖总体与方案设计、初步设计、施工图设计、设计巡检和考核

1. 基线与目标

勘察管理统一管理勘察大纲、外业计划、进度上报、专项勘察和勘察成果的填报、审批与资料留存。五项业务以同一工程范围内的计划、钻孔及进度关联为核心，避免计划明细、上报明细与附件分散而无法核查。

本目录是上述五项业务的最新单一基线。父目录旧需求与概要设计中的勘察管理内容，如与本目录冲突，以本目录为准；父目录设计管理等其他业务不因本次基线而变更。原型用于确定业务内容，不要求复制套表、按钮位置、颜色、弹窗叠加和示例数据。

资料职责：概要设计、详细设计、数据库设计、测试与验收、操作手册。通用约束引用公共开发约定、界面规范，不另造公共规则。

1.1 来源定位

原型页	业务内容	采用方式
1、5、9、13、17	导航与业务分段	确定五项业务及勘察外业下的计划、进度层级
2—4	大纲台账、报审表、办理与流程	保留字段、附件分类及审核链
6—8	外业计划台账、钻孔明细、办理与流程	保留明细维护、表格导入导出、模板、计划调整及关联台账需求
10—12	进度台账、逐孔上报、影像、办理与流程	保留计划关联、逐孔实际信息和审批要求；示例完成率不作为公式
14—16	专项勘察台账、报审表、办理与流程	保留报告与其他附件、审核链
18—20	勘察成果台账、报审表、办理与流程	保留成果报告与其他附件、审核链；标题误写“专项勘察”应纠正

1.2 已确认与待确认的区分

用户已确认：五项业务遵循平台通用规范；人员选择复用平台组件；本域按工程授权过滤，只可访问获授权线路、标段、工点的数据。

用户于2026-11-03补充确认：本次完成数量按用户手动勾选的钻孔数自动统计，选10个即为10，不按日期、孔深或影像判定。已提交且进行中、退回修改、已通过的上报立即计入累计；退回修改后按现值重算，不重复增加。未提交草稿仅在编辑本单时预览，不计入其他上报；撤销、作废、终止或删除记录不计入。累计为此前有效上报本次数量之和加本单有效贡献，不按孔ID跨上报去重。完成率＝该次累计完成孔数÷该次上报引用的计划版本钻孔数×100%，保留两位小数。计划台账是计划任务台账，完成台账是完成上报记录台账。计划调整重走原审批链，通过前沿用原已通过计划，每次完整前后数据及审批历史均保留，支持多次调整。其余实施核对见第8节。

2. 范围与角色

业务	本次包含	来源
勘察大纲	查询、新增、修改、删除、导出、草稿、提交、详情、办理、流程图及审批历史；大纲及施工组织等文件	第 2—4 页
外业计划	同类台账操作；计划日期、钻机数量、布孔图、逐孔计划、明细增改删与 Excel 导入导出及模板；计划调整、计划台账、计划完成台账的业务需求	第 6—8 页；调整审批及生效规则已由用户确认，两种台账粒度已由用户确认
进度上报	同类台账操作和审批；选计划、选择钻孔、逐孔实际信息、影像上传及数量、计划与实际日期、完成说明	第 10—12 页
专项勘察	同类台账操作和审批；专项报告、专家审查意见等其他附件	第 14—16 页
勘察成果	同类台账操作和审批；勘察成果报告、专家审查意见等其他附件	第 18—20 页

不含：设计管理其他业务、组织和工程主数据维护、新建独立待办中心、通知系统、自动生成钻孔、GIS 坐标转换、自动专业成果审查、旧数据兼容及没有来源的额外报表。上传文件后形成可查看的业务资料引用，不据此新增“归档审批”流程。

角色包括勘察单位填报人员、勘察审查单位项目负责人、设计总体单位相关办理人、工点设计单位项目负责人、建设单位经办人及主管部门负责人、开投集团项目中心部门窗口/经办人/部门负责人。角色名称用于表达业务责任，不等同于系统角色编码；实际组织与人员映射见 Q-SM-004。

3. 通用规则

3.1 工程关联与数据范围

数据过滤策略明确为工程数据授权。菜单与按钮权限决定是否具备功能资格，工程授权决定是否可访问具体记录，两者须同时满足。列表、详情、导出、钻孔选择、关联计划、附件所属记录和写入操作使用一致范围；不能只过滤列表而允许按 ID 越权读取或修改。

包含线路、标段、工点的专属数据遵循平台同线整线授权或同一有效 (bidId, siteId) 组合，不以线路、标段、工点分别命中后 OR 放行。勘察标段暂未建立时允许为空：有工点的记录按工点共享范围判定（整线授权或任一当前有效组合包含该工点），无工点的记录只允许整线授权；标段建立后恢复标段级/标段工点组合判定，不因空值自动放宽到全线。项目引用与工程授权对象需准确关联，不能拿业务项目 ID 代替线路 ID。无授权不显示数据，也不提供跨范围候选。一期按单任务一个工程范围实施，设计假设见 Q-SM-005。

线路是空间核（PBS），勘察标段是合同核（CBS），台账筛选、表单选择和列表展示均分开，不用一个“线路/标段”控件合并两者。标段候选带标段类型并排除运营线路及其下辖节点；工点候选来自所选标段管辖范围，暂未选标段时按线路读取可见物理工点。

3.2 台账、草稿与审批

• 查询条件至少保留线路、勘察标段、勘察阶段，线路与标段分别作为独立条件（可只选标段查该合同下的任务），支持重置和分页；运营线路不进入候选。列表显示任务、发起单位、发起人、发起时间、状态及业务专有指标。
• 新增和修改在台账表单完成；草稿保存不创建流程实例。草稿可由具有相应权限及记录操作资格的人员继续编辑、删除或提交，不因原型某行缺按钮而禁止。
• 状态沿用平台 draft、waiting、back、finish，分别展示草稿、进行中、退回、已通过。退回申请节点才进入back；退回中间审核节点仍为waiting，退回行为在审批历史体现，不因此开放申请人编辑。不得另外创建一套业务审批状态编码。
• 已提交记录按当前流程控制，不能由普通修改接口绕过办理修改成“已通过”。已通过单据只读；计划调整另建调整版本走原流程，通过前原已通过计划继续有效，不直接覆盖原版本。
• 当前待办办理人经模块权限、工程范围和引擎任务归属校验后办理。单纯拥有编辑权限不能同意他人的待办；详情入口不获得办理权限。
• 退回选择平台允许的目标节点并填写意见；具体目标策略以流程配置及确认结果为准，不杜撰“所有节点都退回发起人”。重新提交沿用平台支持的退回续办机制，不无条件新建第二实例。

草稿由 createBy 对应创建人操作；退回记录由引擎当前申请人任务持有人操作，均须同时具备功能权限及工程授权。退回目标使用引擎定义允许项，不新增本模块审批决定点。多人协作不属于本期已确认范围，见第 8 节 Q-SM-006。

3.3 基础信息与附件

通用报审信息包括项目名称、合同编号、勘察标段、勘察阶段、工点名称、任务名称和内容说明；计划、进度按其专有表单使用相应字段。工程名称、合同等可从已存在主数据可靠取得时采用选择后回填，不要求用户重复录入同一信息。原型示例合同号、钻孔号、人员姓名和日期不是固定选项或编码规则。

勘察标段先不作为必选，草稿和提交均允许为空；无标段提交时项目名称必填，保证建设单位审批节点可定位责任单位。候选限定勘察标段和勘察设计标段，正式主数据齐备后再按业务决定恢复必选。

人员选用平台通用选人组件，候选必须来自当前节点业务范围，服务端校验候选资格；不能让用户以自由文本或任意全员选择替代正式办理人。没有合法候选时提示配置缺失，不默认当前用户或管理员。

附件按业务分类保留多文件引用，支持预览与下载。编辑中移除引用不应删除已经被业务引用的底层文件；取消编辑不改变已保存附件。只读详情不显示上传或移除入口，文件访问遵循平台权限和所属记录范围。

3.4 表单校验边界

保存草稿允许业务内容未完整，已填写字段仍需类型合法；提交要求具备可定位的工程范围、任务名称、适用正文/明细及下一节点办理条件。标题长度、日期与数值精度等按详细设计约束；原型未标明的附件强制必填、多项目/工点关联、阶段选项不得单凭截图编造，见 Q-SM-005、Q-SM-007。

日期存在时起始日不得晚于结束日，数量为非负整数，孔深为非负数；设计坐标允许符合实际坐标系的合法正负数，不用示例值推断范围。标段存在时必须属于所选线路；工点存在时必须属于线路，且有标段时必须在标段管辖范围内；项目存在时必须属于标段关联项目。上传、导入、保存或提交失败须保留当前可恢复内容并明确提示，不显示成功或推进状态。

4. 五项业务要求

4.1 勘察大纲

填写大纲报审内容，分类上传“勘察大纲”和“施工组织设计、安全措施、应急措施等其他文件”。台账与详情可查看发起信息、当前审核状态、附件及办理历史。

审批链按原型第 4 页：勘察单位编制提交 → 勘察审查单位项目负责人审核 → 设计总体单位审核 → 建设单位经办人审核 → 建设单位部门负责人审核 → 开投集团项目中心部门窗口 → 项目中心经办人确认 → 项目中心部门负责人审核 → 结束。不得沿用旧资料中地勘监理与外业见证并行节点替代本链。

4.2 外业计划

记录线路、勘察标段、阶段、工点、任务名称、计划起止日期、紧急程度、计划钻机数量、布孔图和计划说明。维护逐孔的地探孔编号、设计坐标 X/Y 和预计孔深；钻孔数量从保存的明细计数，不允许主表数量与明细人为矛盾。

钻孔明细支持新增、修改、删除、Excel 导入、导出和模板下载。导入需反馈行号、字段和原因；不得把部分失败文件显示为全部成功。导入先预览校验，成功后追加到本地明细，最终随保存统一落库；同一计划去空白后的孔编号不得重复，冲突报错，不静默覆盖。完整契约见详细设计。

原型包含调整次数、计划调整、计划台账、计划完成台账入口。计划调整基于当前有效的已通过计划形成新版本，重新走本节原审批链；调整草稿、审批中或退回时，原已通过版本继续有效；调整通过后切换为新有效版本。用户进一步明确要求保留每次调整历史及调整前、调整后数据，支持同一计划多次调整。每次调整均可查看来源版本、完整前后数据和对应审批记录，包含计划信息、钻孔明细及附件变化；已生效历史不得被下一次调整覆盖，已关联进度保持原版本引用。计划台账按计划任务/版本展示；计划完成台账按每次进度上报展示，并支持按同一计划筛选，不另建按根计划聚合的完成台账。调整次数按已通过并生效的调整版本计数，普通编辑、退回重提不另加次数，此为配套设计口径；调整历史同时展示待批/退回记录的实际状态，不能只保留当前生效版。原版及调整版保持同一项目、线路、标段、工点和勘察阶段，保证它们是同一项计划的历次调整；其他工程另行新建计划。台账展示版本的审批状态与是否当前有效，不把旧版的“已通过”误作仍在执行。

审批链按第 8 页：勘察单位编制提交 → 勘察审查单位项目负责人审核 → 建设单位主管部室经办人审核 → 建设单位主管部室部长审核 → 结束。

4.3 进度上报

关联可访问的外业计划，继承工程、任务相关信息及计划日期。选择计划中的钻孔填写本次实际孔深、实际开始/完成时间及逐孔影像资料，保留布孔/进度图、实际起止日期和完成说明。不得关联其他计划或越权工程的钻孔；不能以钻孔显示编号替代稳定关联 ID。

台账保留本次完成数量、累计完成数量、计划钻孔数量、完成率、实际日期和影像数量等原型要求。影像数量由实际文件引用统计，不允许手填后与附件不一致；累计完成数量不以审核通过为前提：本次累计值＝此前各次上报的本次数量之和＋本次值，例如1＋1＋1＋n。各次贡献是本次增量，不能累加各单已经累计后的值；不能擅自改为按钻孔ID去重计数。“此前”只包括排在当前上报之前的记录，不能把后续上报加到历史行。例：按顺序上报1、2、3，各行累计应为1、3、6，而不是三行都显示6。新增、当前值修改时即应计算/预览，当前单只计一次，重复保存或审批不再追加贡献。本次数量来自勾选孔的明细数量；同一上报内同孔只能选择一次，不因未填完成日期而剔除。有效统计集合为已提交且未删除的进行中、退回修改、已通过记录。未提交草稿只在编辑本单时预览，其他记录不引用其贡献；撤销、作废、终止、删除均不贡献。退回修改按最新选孔数重算本行及后续累计。完成率使用本次引用计划版本的有效钻孔数作分母，乘100后保留两位小数；分母为0显示“—”，大于100%如实显示，不截断。后两项为显示与异常值处理设计。原型第 10、11 页示例数值互不一致，不能据此推导计算公式。

审批链按第 12 页：勘察单位编制提交 → 勘察审查单位项目负责人审核 → 建设单位主管部室经办人审核 → 建设单位主管部室部长审核 → 结束。旧需求“进度只登记不审批”在本范围失效。

4.4 专项勘察

填写专项勘察内容说明，分类上传专项勘察报告及其他附件（如专家审查意见）。审批链按第 16 页：勘察单位编制提交 → 勘察审查单位项目负责人审核 → 建设单位主管部室经办人审核 → 建设单位主管部室部长审核 → 结束。

4.5 勘察成果

填写勘察成果说明，分类上传勘察成果报告及其他附件。报审、详情和办理页面标题统一为“勘察成果”，纠正原型复用专项勘察标题的问题。

审批链按第 20 页：勘察单位编制提交 → 勘察审查单位项目负责人审核 → 工点设计单位项目负责人审核 → 设计总体单位项目负责人审核 → 建设单位主管部室经办人审核 → 建设单位主管部室部长审核 → 结束。

5. 权限与操作边界

资源标识为 outline、fieldPlan、progress、special、result，统一使用 surveyDesign:<资源>:<动作>。动作限于实际支持的 list/query/add/edit/remove/export/submit；外业计划钻孔导入使用 surveyDesign:fieldPlan:import。审批动作复用平台工作流权限并增加业务资源和任务归属校验，不自行发明未登记权限动词。

状态/身份	允许行为	服务端必须拒绝
有功能权限且工程范围内	查询、详情；有导出权限时导出同范围结果	按 ID 读取范围外记录或导出越权记录
草稿且具备记录操作资格	修改、删除、提交	用请求体指定发起人、状态、流程实例
进行中、当前待办办理人	查看、平台允许的办理动作	修改已提交正文、代他人办理、伪造任务 ID
进行中、非办理人	只读查看	同意、退回、下一节点选人
退回且具备操作资格	按确认的续办规则修改、重新提交	无条件新建实例或绕过退回目标
已通过	查看、授权范围内导出	普通编辑或删除接口覆盖历史资料

6. 平台体验与非功能要求

页面按界面规范组织为查询卡、列表卡和分页，工具栏左标题右操作，审批状态与操作列连续固定在右侧。新增/编辑使用业务弹窗，查看/办理使用固定表单工作台，不叠加原型多个窗口。

前端大整数 ID 保持原值，所有入口的工程范围一致；接口失败采用统一异常反馈。长名称、附件名和审批意见应完整可访问；适配平台主题与规定视口。业务数据、明细和流程状态的关联写入须保持事务一致，不能出现空主单、孤儿明细或提交成功但无待办的半成功状态。

7. 验收原则

五项业务应从真实台账入口完成草稿、保存回显、提交、规定节点办理和只读详情，计划明细和逐孔影像可追溯。正常链与越权、状态不合法、候选缺失、导入错误、文件/流程服务失败等路径均需按实际风险验证。

统计、台账及计划调整均已明确；第8节的组织、字典等实施核对出现实际缺项时，分别报告已完成能力和剩余依赖。整体开发完成仍须覆盖本期全部已确认能力及适用验证。具体可执行用例与证据记录见测试与验收。

8. 待确认事项与实施核对

编号	事项性质与内容	推荐方向或实施边界
Q-SM-001	已确认：审核未通过即计算，累计为各次本次数量相加并含当前值	按1＋1＋1＋n计算；不设finish门槛，不按孔ID全局去重，不累加“累计值”，当前单仅计一次；不再是累计加法实施阻断项
Q-SM-002	已确认：计划调整走原流程，通过前沿用原已通过计划	按独立调整版本审批，通过后切换有效版本；历史计划和进度引用保留；不再等待重审/生效决定
Q-SM-003	已确认：计划台账为计划任务台账，完成台账为完成上报台账	复用外业计划、进度上报既有台账和导出；前者一行一份计划版本任务，后者一行一次上报，可按根计划筛选，不新增汇总驾驶舱
Q-SM-004	实际核对：各节点组织范围、业务角色与实际人员映射，窗口办理及替代人的配置	先核对平台组织、角色和节点候选能力；以最新原型串行链为目标，缺映射仅暂停相关办理配置，不允许退化为全员任选；实际资料仍无法确定的业务角色映射再澄清
Q-SM-005	明确设计假设：一期一份任务对应一个项目、一个工程范围	按此推进，不默认阻断；标段级及工点级授权沿用平台契约。仅新证据证明需多范围时重开并同步关系模型、接口与逐项授权，不用 CSV 混装 ID
Q-SM-006	记录操作资格设计：草稿创建人、退回当前申请人任务持有人操作	同时校验功能权限、工程授权及适用任务归属；退回目标取引擎允许项，重提延续实例。不给全部 edit 权限人员操作资格，不新增单位多人协作，不增加用户批准点
Q-SM-007	实际核对清单：阶段/紧急程度字典、适用合同来源、提交完整性校验	先查共享字典和可靠合同信息，原型示例不作为枚举全集；其他附件不擅设必传，不因无星号统一要求用户确认。确缺业务值时仅暂停该配置并记录缺口，业务决定无法从资料取得时再澄清
Q-SM-008	已确认：勾选孔数自动统计；已提交的waiting/back/finish计入；草稿仅编辑本单预览；撤销/作废/终止/删除排除；完成率按本次引用版本分母保留两位小数	同单同孔一次，跨上报不去重；退回改孔数按现值重算；跨计划版本累计延续。具体派生接口、稳定顺序和零分母展示见详细设计，不再是待确认阻断项

Q-SM-001/002/003/008均已获用户明确决定，不再等待统计、调整或台账口径确认。Q-SM-004/007为实施者先查证的组织、候选、字典与主数据配置；只有现有资料确实无法确定且影响业务结果时才提出具体缺项，其他工作继续。Q-SM-005/006按已记录设计推进。

9. 实施核对结果（2026-11-03）

事项	实际核对与处理
Q-SM-004 组织与候选人	开发库仍无业务系统角色，但存在可用的组织分类与岗位主数据：SYS_DEPT 的 dept_type/org_type/relation_type/dept_category 可区分参建单位外部公司、建设单位内设部门和集团直属项目中心，dept_category 字典已有设计20、施工21、监理22、勘察23；SYS_POST 已有部长、主任、窗口、项目管理岗、设计单位项目负责人等岗位；项目经 BIZ_BID_PROJECT_REL 关联，BIZ_PROJECT.BUILD_UNIT_ID 为建设单位的真实来源。五条流程节点仍使用 ${nextHandlerId}，但候选接口、提交和通用完成/转办统一解析真实目标节点，并按“资源 query 权限 + 目标节点组织类别 + 目标节点岗位类别 + 目标人员本人工程授权”求候选，不提供全员兜底，不默认管理员，也不因超级管理员身份放行。外部勘察审查/设计节点按设计20或勘察23类参建公司收敛；建设单位经办/部长节点在项目可解析时限定节点所属建设单位本公司及下属部门。仍缺任务级勘察审查单位、设计总体单位、工点设计单位的明确映射及外部单位项目负责人岗位配置；建设单位“主管部室”只能限定到建设单位公司下属部门，尚不能精确到具体主管部室。上述缺项按剩余依赖报告，不硬编码单位、岗位或人员。
Q-SM-007 字典与合同	共享字典中没有勘察阶段、紧急程度，已建立 survey_stage（初步勘察/详细勘察/施工勘察）和 survey_urgency（一般/紧急/特急）；类型与编码已写入设计文档。合同编号先按录入处理，未从项目名称截取或虚构合同主数据。其他附件未因原型无星号而设为必传。
Q-SM-005/006	按一期单任务单工程范围实现；草稿创建人、退回当前申请人任务持有人操作，重提延续原实例。
菜单与路由	为保持详细设计的精确路由（/surveyDesign/survey/fieldPlan、/surveyDesign/survey/progress），外业计划、进度上报直接挂在“勘察管理”下，按大纲、外业计划、进度上报、专项勘察、勘察成果顺序展示；流程分类仍保留“勘察外业”分组。未恢复旧并行审批链或旧十七页面方案。
工程授权	列表按有工点/无工点互斥分支过滤；详情、写入、导出、选计划/孔、附件和通用办理入口均执行服务端范围校验。无授权用户在开发环境验证为列表空、详情/写入 403。
标段可选与线路/标段拆分	标段暂不必选；开发库 BID_ID/BID_NAME 可空。表单和台账拆分线路与勘察标段，候选排除运营线路并限定勘察类合同；后端按四类工程范围分支校验，工点须在标段管辖范围、项目须属于标段关联项目。正式主数据齐备后是否恢复必选由业务决定。