fujian_water_biz_doc/docs/evidence/rev004-accounting/2026-06-10-prestore-test-results.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.2 KiB

预存余额功能 — 测试与部署结果

2026-06-10 | 预存余额 P0-1~P1-2 功能测试验证

后端编译

项目 结果
mvn compile -pl sw-business/sw-business-server -am -o PASS
mvn package -pl sw-business/sw-business-server -am -o -DskipTests PASS (147MB jar)

后端单元测试

测试类 状态 备注
ChargeServiceCounterPaymentTest (7 tests) 7/7 PASS 修复了 AccountLogContext + CustBillTypeService mock
其他已有单元测试 (300+ tests) 全部 PASS 仅 2 个已有失败 (CustServiceImplCustomerPageTest, PaymentRecordServiceImplTest) 非本次引入

新增测试代码

文件 类型 编译
test/.../CounterChargeFullChainIntegrationTest.java (新增方法) 集成测试 PASS
test/resources/sql/prestore/01_counter_topup_log_seed.sql SQL 种子 N/A

集成测试需要 PostgreSQL 环境运行 (REV004_IT_DB_URL 等环境变量)。代码已通过编译验证,实际执行待部署环境就绪。

前端

项目 结果
TypeScript 类型检查 (tsc --noEmit) 新文件无新增错误
dist 构建 dist/ 已存在
E2E 测试代码 (2 文件) 已创建,待后端运行后执行

新增 E2E 测试

文件 覆盖
tests/e2e/prestore/counterTopup.e2e.spec.ts counterTopup充值流程, 欠费拒绝, counterPreview余额查询
tests/e2e/prestore/prestorageAdjustBpm.e2e.spec.ts 预存调整列表, BPM创建, 详情查询

部署就绪项

产物 路径
后端 JAR sw-business/sw-business-server/target/sw-business-server.jar
前端 dist water-frontend/dist/
DDL (PG) sql/rev005/REV006_account_log_ddl.sql
DDL (MySQL) sql/rev005/REV006_account_log_ddl_mysql.sql
DDL (MySQL) sql/rev005/REV006_cust_bill_type_ddl_mysql.sql

待执行项

  1. 部署 PostgreSQL 并执行 DDL
  2. 启动后端 (java -jar sw-business-server.jar --spring.profiles.active=local)
  3. 启动前端 (pnpm dev)
  4. 运行 Browser 手动冒烟 (按 plan Task 7 清单)
  5. 运行 Playwright E2E 测试 (npx playwright test tests/e2e/prestore/)