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/rev004-accounting/rev004-accountlog-action-wiring-notes-2026-04-13.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.0 KiB
Raw Blame History

REV004 accountLog 操作链接线说明（2026-04-13）

结论

当前 accountLog 的 4 条操作链在后端契约层已具备接线条件，不需要继续补新的稳定字段；前端主要做提交映射即可。

1. 查看流程 log-process

  • 前端来源：handleProcess(row)
  • 后端接口：GET /business/accounting-adjust/log-process
  • 后端入参：adjustmentNo
  • 当前行数据可用字段：row.adjustmentNo
  • 接线结论：可直接接

2. 查看附件 log-attachments

  • 前端来源：handleAttachment(row)
  • 后端接口：GET /business/accounting-adjust/log-attachments
  • 后端入参：adjustmentNo
  • 当前行数据可用字段：row.adjustmentNo
  • 接线结论：可直接接

3. 转退款 log-refund

  • 前端来源：RefundForm
  • 后端接口：POST /business/accounting-adjust/log-refund
  • 后端请求对象：AccountingAdjustSecondaryActionReqVO
  • 推荐映射：
    • adjustmentNo = row.adjustmentNo
    • reason = form.remark
    • collectionMethod = form.collectionMethod
    • refundUser = form.refundUser
    • attachmentRefs = 前端上传结果（如有）
  • 说明：前端 refundAmount 当前仅用于展示，不是后端必填字段
  • 接线结论：可接，主要是前端提交映射

4. 转预存 log-prestorage

  • 前端来源：TransferPrestoreForm
  • 后端接口：POST /business/accounting-adjust/log-prestorage
  • 后端请求对象：AccountingAdjustSecondaryActionReqVO
  • 推荐映射：
    • adjustmentNo = row.adjustmentNo
    • targetCustCode = form.targetCustCode
    • reason = form.remark
    • attachmentRefs = 前端上传结果（如有）
  • 说明：前端 transferAmount 当前仅用于展示，不是后端必填字段
  • 接线结论：可接，主要是前端提交映射

补充说明

  • 本轮后端新增的 accountLog.custId 已可支撑前端客户编号点击后稳定跳客户详情。
  • sold 当前列表/弹窗展示字段已基本满足，不建议继续为展示字段扩充后端响应。