fujian_water_biz_doc/docs/evidence/revenue-bugfix-clear-scope-frontend-2026-06-08.md

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

日期：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 中实现，尚未提交

验证命令

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/ 目录下。