114 lines
2.8 KiB
Markdown
114 lines
2.8 KiB
Markdown
# 车辆三检模块改动说明
|
||
|
||
## 1. 本次改动
|
||
|
||
本次对车辆三检模块新增了以下能力：
|
||
|
||
1. 新增字段 `rejectReason`，表示审核不通过原因。
|
||
2. 新增批量审核接口，管理员可以一键审核多条不同的车辆三检内容。
|
||
|
||
## 2. 字段变更
|
||
|
||
### 2.1 新增字段
|
||
|
||
- 字段名：`rejectReason`
|
||
- 含义：审核不通过原因
|
||
- 生效场景：仅在审核不通过时有值
|
||
|
||
### 2.2 使用规则
|
||
|
||
- 当审核通过时：
|
||
- 后端自动将 `rejectReason` 置空
|
||
- 当审核不通过时：
|
||
- 前端需要传入 `rejectReason`
|
||
- 若未传，后端会返回业务异常：
|
||
- `审核不通过时，不通过原因不能为空`
|
||
|
||
### 2.3 数据库说明
|
||
|
||
车辆三检表需要新增字段：
|
||
|
||
```sql
|
||
ALTER TABLE hot_vehicle_three_inspect
|
||
ADD COLUMN reject_reason varchar(500) NULL COMMENT '审核不通过原因';
|
||
```
|
||
|
||
## 3. 单条审核接口调整
|
||
|
||
### 3.1 接口信息
|
||
|
||
- 路径：`POST /securityManagement/vehicleThreeInspect/audit`
|
||
|
||
### 3.2 新增请求字段
|
||
|
||
- `rejectReason`：审核不通过原因
|
||
|
||
### 3.3 审核规则
|
||
|
||
- 当前仍以 `hasHiddenDanger` 作为是否通过的判断依据：
|
||
- `hasHiddenDanger = 0`：审核通过
|
||
- `hasHiddenDanger = 1`：审核不通过
|
||
- 审核不通过时必须传 `rejectReason`
|
||
- 审核通过时 `rejectReason` 不入库
|
||
|
||
## 4. 批量审核接口
|
||
|
||
### 4.1 接口信息
|
||
|
||
- 路径：`POST /securityManagement/vehicleThreeInspect/batchAudit`
|
||
- 说明：管理员可一次性审核多条不同三检记录
|
||
|
||
### 4.2 请求体
|
||
|
||
```json
|
||
{
|
||
"auditItems": [
|
||
{
|
||
"id": 101,
|
||
"taskId": "task_001",
|
||
"auditTime": "2026-05-22 10:00:00",
|
||
"hasHiddenDanger": 0,
|
||
"auditResult": "审核通过",
|
||
"auditorSignImgUrl": "12345"
|
||
},
|
||
{
|
||
"id": 102,
|
||
"taskId": "task_002",
|
||
"auditTime": "2026-05-22 10:05:00",
|
||
"hasHiddenDanger": 1,
|
||
"auditResult": "发现问题需整改",
|
||
"rejectReason": "轮胎磨损超标",
|
||
"auditorSignImgUrl": "12345"
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
### 4.3 请求字段说明
|
||
|
||
批量项沿用单条审核字段，核心包括：
|
||
|
||
- `id`：三检记录ID
|
||
- `taskId`：流程任务ID
|
||
- `auditTime`：审核时间
|
||
- `hasHiddenDanger`：是否存在隐患
|
||
- `auditResult`：审核结论
|
||
- `rejectReason`：审核不通过原因
|
||
- `auditorSignImgUrl`：审核人签名
|
||
|
||
### 4.4 处理规则
|
||
|
||
接口会逐条执行以下逻辑：
|
||
|
||
1. 校验三检记录ID和流程任务ID。
|
||
2. 校验审核时间不能早于检查时间。
|
||
3. 若传了审核签名，则校验签名归属。
|
||
4. 根据 `hasHiddenDanger` 处理通过/不通过逻辑。
|
||
5. 审核不通过时校验 `rejectReason` 必填。
|
||
6. 更新三检记录并推进对应流程任务。
|
||
|
||
## 5. 影响范围
|
||
|
||
- 详情接口、列表接口、导出接口会返回 `rejectReason` 字段。
|
||
- 审核驳回通知优先展示 `rejectReason`，没有时才回退展示 `auditResult`。
|