75 lines
2.2 KiB
Markdown
75 lines
2.2 KiB
Markdown
# 柜台收费预存款详情修复验证
|
||
|
||
## 根因
|
||
|
||
柜台收费页面的预存款展示行使用支付记录 ID，但“详情”按钮统一调用账单详情接口 `/business/charge/get`。支付记录 ID 被误作账单 ID 后，接口无法返回对应预存业务数据，账单详情弹窗中的字段全部显示为 `--`。
|
||
|
||
## 修复
|
||
|
||
- 按 `displayChargeType` 分流普通账单与预存款详情。
|
||
- 预存款不再调用账单详情接口，改用专用弹窗展示客户、支付和余额快照。
|
||
- 历史预存记录保留 `lastDeposit`、`deposit`、预存金额、收费时间和收费方式。
|
||
- 刚办理成功的预存优先使用重新查询到的持久化记录；查询未恢复记录时使用成功响应降级展示。
|
||
- 普通账单继续使用原 `/business/charge/get` 详情链路。
|
||
- 金额或余额为 `0` 时显示 `0.00`，仅空值显示 `--`。
|
||
|
||
## TDD 证据
|
||
|
||
### RED
|
||
|
||
命令：
|
||
|
||
```bash
|
||
node --test tests/operatingCharges/counterChargingPersistentTopup.test.mjs
|
||
```
|
||
|
||
结果：退出码 `1`，共 7 个测试，原有 4 个通过，新增 3 个失败。失败分别证明缺少预存款详情分流、专用字段与余额映射、零值格式化。
|
||
|
||
### GREEN
|
||
|
||
命令：
|
||
|
||
```bash
|
||
node --test tests/operatingCharges/counterChargingPersistentTopup.test.mjs
|
||
```
|
||
|
||
结果：退出码 `0`，7/7 通过。
|
||
|
||
## 回归验证
|
||
|
||
### 柜台收费既有测试
|
||
|
||
```bash
|
||
pnpm test:counter-charging
|
||
```
|
||
|
||
结果：退出码 `0`，4/4 通过。
|
||
|
||
### 组合测试
|
||
|
||
```bash
|
||
node --test tests/operatingCharges/counterChargingPersistentTopup.test.mjs tests/operatingCharges/counterChargingInventory.test.mjs
|
||
```
|
||
|
||
结果：退出码 `0`，11/11 通过。
|
||
|
||
### 前端构建
|
||
|
||
```bash
|
||
NODE_OPTIONS=--max-old-space-size=8192 pnpm build:dev
|
||
```
|
||
|
||
结果：退出码 `0`，输出 `Build successful. Please see dist directory`。构建过程中存在项目既有的 SVG symbolId 和 Rollup 注释警告，但未导致构建失败。
|
||
|
||
## 代码基线
|
||
|
||
- 前端分支：`fix/counter-topup-detail`
|
||
- RED 测试提交：`2aeecaa8`
|
||
- 余额快照提交：`83142c72`
|
||
- 专用详情实现提交：`c6941001`
|
||
- 验证日期：2026-07-14
|
||
|
||
## 约束
|
||
|
||
按用户要求，未运行 `vue-tsc`、`pnpm ts:check` 或任何会调用 `vue-tsc` 的命令。
|