feat(finance): manage customer wallet balances

2026-09-05 08:34:40 +08:00
parent 48731b227b
commit 68fca1bd9f
7 changed files with 487 additions and 71 deletions
@@ -4,7 +4,12 @@

 - 本文件适用于 `src/modules/finance/`。产品范围和状态读取 `../../../../../docs/财务管理/` 的产品确认与验收契约，后端读取 `../../../../../baiyue-firstleg/finance/AGENTS.md`。
 - 页面从 `pages/` 进入，统一 API 从 `api/finance.ts` 进入；费用来源和柜次成本快照联查 `firstleg/`，凭证与异步导出联查 `file/`。
- 正式范围包括客户账户、客户应收应付、应收款统计、客户对账单、应收结算单和应付结算单；不要从历史原型自动扩大财务功能。
+- 正式范围包括客户资金账户、客户应收应付、应收款统计、客户对账单、应收结算单和应付结算单。资金账户当前只接充值申请审核和平台手工充值/扣款，冻结/解冻、消费及支付回调后续接入；不要从历史原型自动扩大其他财务功能。
+
+## 客户资金账户
+
+- `pages/FinanceCustomerAccountsView.vue` 的列表和详情展示实际余额、冻结金额、可用余额；操作列固定第一列。客户上传的充值申请在详情内按待审核优先展示，审核、驳回及凭证预览以服务端申请版本和客户归属为准。
+- 平台手工充值和扣款必须提交账户版本与幂等键；扣款不得超过服务端可用余额。页面只展示服务端余额和流水结果，不在浏览器补算或回退静态数据。

 ## 客户筛选与统计