0 Fork 0

Files

T

wk 7c915f8946 docs(specs): 新增现场勘察业务相关 spec 文档

- rework-survey-equipment-tree：勘察设备树明细模式重构
- fix-equipment-topology-display：设备拓扑图完整显示修复
- survey-detail-building-select：勘察明细所属建筑下拉
- generate-floor-options-from-building：按建筑楼层生成楼层下拉
- survey-progress-track-detail：进度跟踪跳转勘察明细页
- survey-complete-to-tech-review：勘察完成提交技术复核与复核按钮改名

2026-10-25 02:34:18 +08:00

2.7 KiB

Raw Blame History

勘察完成提交技术复核 + 复核按钮改名 Spec

Why

现场勘察员完成勘察后缺少「勘察完成」操作，工单无法从「现场勘察中」流转到「待技术复核」；同时台账「审核测绘成果」按钮文案与复核语义不符，需统一为「技术复核」。

What Changes

后端：新增勘察完成状态流转接口 PUT /api/survey-orders/:id/complete，将「现场勘察中(1)」工单流转为「待技术复核(2)」（仅此状态可流转；权限校验沿用现有可见性校验；写审计日志）
前端 API：client/src/api/surveyOrder.ts 新增 complete(id) 客户端方法
勘察明细页（client/src/views/dispatch/survey/detail.vue）：头部操作区新增「勘察完成」按钮，仅「现场勘察中」状态显示；点击弹确认 → 先调用保存勘察明细逻辑 → 成功后再调用 complete 接口 → 跳回台账页
台账页（client/src/views/dispatch/survey/index.vue）：「审核测绘成果」改为「技术复核」——主操作按钮文字（primaryAction）与复核弹窗标题同时修改
状态枚举/标签不变（「待技术复核」标签已存在）

Impact

Affected specs: 无（独立增量）
Affected code:
- server/src/controller/survey_order.controller.ts
- server/src/service/survey_order.service.ts
- client/src/api/surveyOrder.ts
- client/src/views/dispatch/survey/detail.vue
- client/src/views/dispatch/survey/index.vue

ADDED Requirements

Requirement: 勘察完成提交技术复核

系统 SHALL 提供勘察明细页「勘察完成」操作：先保存当前勘察明细，再将工单状态由「现场勘察中(1)」变更为「待技术复核(2)」。

Scenario: Success case

WHEN 勘察明细页工单处于「现场勘察中」状态，用户点击「勘察完成」并确认
THEN 系统先保存当前勘察明细，成功后调用状态流转接口，工单变更为「待技术复核」，页面跳回台账页，台账该行主按钮显示「技术复核」

Scenario: 非勘察中状态

WHEN 工单处于待指派/待技术复核/已归档/已取消等状态
THEN 勘察明细页不显示「勘察完成」按钮

Requirement: 复核按钮改名

系统 SHALL 将台账「审核测绘成果」主操作按钮文字与复核弹窗标题统一改为「技术复核」。

MODIFIED Requirements

Requirement: 勘察完成状态流转接口

新增后端接口 PUT /api/survey-orders/:id/complete：仅「现场勘察中」状态可流转至「待技术复核」；无权限返回 403；工单不存在返回 404；状态不符返回 400；成功后写审计日志。

REMOVED Requirements

无。

2.7 KiB Raw Blame History Unescape Escape