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

48 lines
2.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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` 当前列表/弹窗展示字段已基本满足,不建议继续为展示字段扩充后端响应。