# 营收明确缺陷第一批前端修复验证记录

日期：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/` 目录下。