78 行
2.5 KiB
Markdown
78 行
2.5 KiB
Markdown
---
|
||
schema: "hl-changelog/v2"
|
||
ticket: "N/A"
|
||
title: "核单「完成核单」按钮校验逻辑简化"
|
||
consumer: "admin"
|
||
change_type: "修改接口"
|
||
author: "yaosutu(GIT)"
|
||
backend_status: "deployed"
|
||
gateway_status: "verified"
|
||
frontend_status: "implemented"
|
||
frontend_owner: "mmg"
|
||
frontend_ref: "ce4d98b3"
|
||
target_release: ""
|
||
verified_at: ""
|
||
status_note: "已实现。canComplete 由 5 条减为 3 条 UI 态防误触（hasLoadingStep/hasSavingStep/dirty），askComplete 同步删 vehicleSettlementBlocked 兜底拦截，并删除车辆分类顶部常驻提示条；LEGACY 金额未知空态的车辆编辑锁保留（防空草稿存成 0 元）。frontend_ref=ce4d98b3。"
|
||
updated_at: "2026-08-09"
|
||
base: "dev-v3"
|
||
---
|
||
|
||
# 核单「完成核单」按钮校验逻辑简化
|
||
|
||
## 变更类型
|
||
修改接口（前端逻辑调整，后端零改动）
|
||
|
||
## 端类型
|
||
管理后台
|
||
|
||
## 变更说明
|
||
|
||
「完成核单」按钮的前端校验逻辑简化，去掉业务约束类校验，只保留 UI 态防误触校验。
|
||
|
||
### 改动前（5 条校验）
|
||
|
||
```javascript
|
||
const canSubmit = computed(() =>
|
||
!hasLoadingStep && // 1. 没有任何分类在加载中
|
||
!hasSavingStep && // 2. 没有任何分类在保存中
|
||
!dirty && // 3. 没有任何未保存的修改
|
||
!vehicleSettlementBlocked && // 4. 车辆核单状态不被拦（删）
|
||
reportsReady // 5. 司机报账表 + 单团核算表都已生成（删）
|
||
)
|
||
```
|
||
|
||
### 改动后（3 条校验）
|
||
|
||
```javascript
|
||
const canSubmit = computed(() =>
|
||
!hasLoadingStep && // 1. 没有任何分类在加载中
|
||
!hasSavingStep && // 2. 没有任何分类在保存中
|
||
!dirty // 3. 没有任何未保存的修改
|
||
)
|
||
```
|
||
|
||
### 删除的 2 条校验及原因
|
||
|
||
| 删除项 | 原因 |
|
||
|---|---|
|
||
| `vehicleSettlementBlocked` | 后端 `finalize` 已有统一硬校验（`performSubmitBlockingChecks`），前端无需重复拦截 |
|
||
| `reportsReady` | 报表是 finalize 的**产出**而非**前置条件**，逻辑反了，直接删除 |
|
||
|
||
### 后端统一拦截行为
|
||
|
||
用户点击「完成核单」后，后端 `finalize` 接口统一校验：
|
||
- 对账一致性（支付流水 = 手工收款）
|
||
- 车辆费用 freeze 校验
|
||
- 导游/摄影费用确认状态
|
||
- 司机结算完成 + 转账凭证
|
||
- 其他收入确认状态
|
||
|
||
校验失败返回对应错误码 + 提示信息，前端直接展示即可。
|
||
|
||
## 影响范围
|
||
- 管理后台核单页面「完成核单」按钮
|
||
- 后端零改动
|
||
|
||
## 关联
|
||
- 无 Issue（口头需求）
|