diff --git a/docs/evidence/revenue-bugfix-clear-scope-frontend-2026-06-08.md b/docs/evidence/revenue-bugfix-clear-scope-frontend-2026-06-08.md new file mode 100644 index 0000000..9a7c017 --- /dev/null +++ b/docs/evidence/revenue-bugfix-clear-scope-frontend-2026-06-08.md @@ -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/` 目录下。