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:勘察完成提交技术复核与复核按钮改名
This commit is contained in:
1 parent
dff366a823
commit
7c915f8946
18 files changed
+553
No files matched your search
@@ -0,0 +1,42 @@
|
||||
# 勘察完成提交技术复核 + 复核按钮改名 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
|
||||
无。
|
||||
Reference in new issue
Block a user