feat: balance api

2025-11-30 23:04:21 +08:00
parent 9006a530d1
commit 9acc4e14fc
21 changed files with 714 additions and 64 deletions
--- a/docs/payment_receipt_workflow.md
+++ b/docs/payment_receipt_workflow.md
@@ -5,6 +5,7 @@
 - `ReceiptOrder`：针对客户的资金收入单据，审批通过后代表“确认收款”。
 - 两者均位于 `business` 模块，API 路径分别为 `/api/v1/payment-orders/`、`/api/v1/receipt-orders/`。
 - 与采购/销售相比，不涉及产品与库存，仅维护资金方向、对方主体、金额与状态。
+- 审批通过会同步更新供应商/客户余额表（`SupplierBalance` / `CustomerBalance`），提供 O(1) 的欠款查询。

 ## 2. 创建流程
 | 字段 | 付款单 | 收款单 |