docs: add revenue bugfix frontend evidence

This commit is contained in:
tangweijie 2026-06-08 19:40:18 +08:00
parent 97c505a01c
commit 1823213a0b

View File

@ -0,0 +1,51 @@
# 营收明确缺陷第一批前端修复验证记录
日期2026-06-08
## 范围
本记录对应 `docs/superpowers/plans/2026-06-08-revenue-bugfix-clear-scope.md` 中前端 Task 5 至 Task 8
- `#69/#76` 未销分账、呆坏账、价差、违约金减免提交后状态提示
- `#78` 水价调整失败后重试闭环
- `#58/#59` 柜台红冲记录页面接口与查询语义
- `#39/#53` 柜台结账预存充值行展示、柜台收费预存抵扣为 0 的确认保护
## 前端基线
- 仓库:`water-frontend`
- Worktree`/Volumes/Dpan/github/water-workspace/worktrees/frontend-revenue-bugfix-clear-scope`
- 分支:`frontend-revenue-bugfix-clear-scope`
- 基础提交:`2a13e63e941e0a990f025844979847b3196effa9`
- 状态:前端修复已在 worktree 中实现,尚未提交
## 验证命令
```bash
cd /Volumes/Dpan/github/water-workspace/worktrees/frontend-revenue-bugfix-clear-scope
node --test tests/revenue-bugs/revenueBugfixClearScope.contract.test.mjs
pnpm dev --host 0.0.0.0
```
## 验证结果
- 前端合约测试通过5 项通过、0 项失败。
- Playwright 登录 smoke通过。使用默认租户 `福建水投集团`、用户 `admin` 登录到 `http://localhost:18080/home/index`
- Playwright 页面 smoke
- `/operatingCharges/redReversalRecord`:页面可打开,查询区和表格已显示 `收费员``红冲时间``红冲金额``红冲原因` 等柜台红冲语义字段。
- `/operatingCharges/counterCheckout`:页面可打开,未结账表中空收费单号显示为 `--`
- `/operatingCharges/counterCharging`:页面可打开。使用现有客户 `20260512111` 验证“预存抵扣金额为 0”确认弹窗出现且未调用 `/business/charge/update`,未提交收费。
- `/accountProcess/unsoldAdjustment`:页面可打开。
- `/settings/price/priceTemplate`:页面可打开,显示 `开始调价`
- 后端接口口径核对:
- 远端接口 `/admin-api/business/charge/counter-settle/red-flush-record-page` 返回业务 `code=404`,提示 `请求地址不存在:admin-api/business/charge/counter-settle/red-flush-record-page`
- 本地后端 worktree `backend-revenue-bugfix-clear-scope``ChargeController` 当前也未提供 `/counter-settle/red-flush-record-page``/counter-settle/red-flush-record-export`,与前端 Task 7 口径未闭合。
- 预存抵扣后端兜底校验闭合:`ChargeServiceImpl` 校验抵扣金额非负且不超过应收金额,`AccountService.decreaseDeposit()` 校验账户预存余额不足并抛错。
- `typecheck`:未执行完成。按用户要求停止并不再执行 typecheck。
- `build`:未执行。
## 备注
依赖安装采用 `pnpm install`。安装过程中 pnpm 11 提示 `@carbon/icons` 构建脚本未批准;该临时配置改动未纳入本次业务修复。
Playwright 运行时按需安装了 Chromium 单浏览器。截图保存在前端 worktree 的 `test-results/` 目录下。