tangweijie/fujian_water_biz_doc
1
0
Fork 0
Code Issues Pull Requests 12 Actions Packages Projects Releases 1 Wiki Activity
fujian_water_biz_doc/docs/evidence/bugfix/frontend/revenue-bugfix-clear-scope-frontend-2026-06-08.md
tangweijie 3eccab2cf9 docs: 文档治理统一 — AGENTS.md 生命周期规则 + 模块归档 + DDL 修正 
1. AGENTS.md 更新
   - water-docs: 新增 specs/ 与 docs/design/ 生命周期规则章节
   - water-backend: 更新协作引用（建设期/建成后、evidence 模块化）

2. specs/ 重复合并
   - 006-reminder-event-design 合并入 003-rev006-reminder-event-design
   - 001-rev004-accounting 删除冗余 data-model.md + contracts/
   - 002-rev005-invoice-flow 删除冗余 data-model.md + contracts/

3. evidence 按模块归档
   - 35 个 REV-004 文件归入 evidence/rev004-accounting/
   - 7 个通用 bugfix 文件归入 evidence/bugfix/ 和 bugfix/frontend/
   - 新建 rev005-invoice/、rev006-reminder/、rev007-statistics/ 目录

4. guides/ 清理
   - 14 个 REV004_*.md 移入 evidence/rev004-accounting/

5. 遗留文件处理
   - docs/research/ 归档到 Archive/06_Migration_Plans/
   - backend-check detached worktrees 清理

6. 交叉引用修复
   - 006-reminder-event-design → 003-rev006-reminder-event-design
   - docs/guides/REV004_ → docs/evidence/rev004-accounting/REV004_

7. DB 设计文档修正（01_Database_Design.md）
   - biz_invoice 明确为开票配置表，非发票记录表
   - 新增 biz_invoice_record 为发票申请/结果主表
   - 新增 biz_charge_invoice_rel 账单-发票关联说明
   - REV-005 承接口径表名全部修正

8. 发票审计证据
   - 新增 evidence/rev005-invoice/2026-06-16-invoice-document-audit.md
2026-06-16 11:47:16 +08:00

2.9 KiB
Raw Blame History

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

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