2.0 KiB
2.0 KiB
09 — 资金概况返回信用、总可用金额与欠款
What to build: 平台和代理在现有资金概况范围内可以直接查看代理主钱包的账面余额、冻结金额、现金可用金额、信用额度、总可用金额、欠款和版本。所有派生金额由服务端统一投影，前端无需自行重算。
Blocked by:
.scratch/ur38-agent-main-wallet-credit/issues/01-agent-main-wallet-credit-foundation.md— 01 — 扩展代理主钱包信用模型与领域不变量.scratch/ur38-agent-main-wallet-credit/issues/04-manage-shop-credit-limit.md— 04 — 授权平台人员调整店铺实际信用额度
Status: ready-for-agent
架构通道: Query。
完整业务边界: 本票收口现有资金概况读取模型的信用字段、派生金额、分页筛选和数据权限。明确不通过聚合根读取，不执行任何写操作，不新增绕过现有范围的全量接口，不把信用纳入 UR#97 的现金低余额预警。
- 现有资金概况接口对每个代理返回账面余额、冻结金额、现金可用金额、信用开关、额度、总可用金额、欠款状态、欠款金额和钱包版本，金额单位统一为分。
- 现金可用金额固定为余额减冻结金额，总可用金额只加启用后的额度；欠款只由负账面余额决定，冻结占用信用但余额非负时不能误报欠款。
- Query 延续现有分页、店铺和主账号筛选及平台/代理数据范围，批量投影主钱包信息且不存在按行钱包查询的 N+1。
- 代理和无调额权限的平台账号仍可在既有查看范围读取资金事实，但响应不暗示其具有调整权限；后端调额授权继续由写接口独立判断。
- UR#97 的现金低余额口径继续只消费现金可用金额，信用额度不能掩盖现金风险。
- API 集成测试覆盖关闭信用、使用信用、冻结信用、负余额欠款、分页筛选、数据范围和金额边界；OpenAPI 契约明确前端展示及并发冲突刷新所需字段。