wk
7c915f8946
- 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：勘察完成提交技术复核与复核按钮改名
43 lines
2.7 KiB
Markdown
43 lines
2.7 KiB
Markdown
# 勘察完成提交技术复核 + 复核按钮改名 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
|
||
无。
|