2.7 KiB
2.7 KiB
1. API And Types
- 1.1 在角色 API 和类型中新增
PUT /api/admin/roles/{id}/default-credit请求类型与服务方法。 - 1.2 在店铺 API 和类型中新增
PUT /api/admin/shops/{id}/credit-limit请求类型与服务方法。 - 1.3 扩展代理商资金概况类型，包含
credit_enabled、credit_limit、available_balance、is_in_debt、debt_amount和version。
2. Role Default Credit
- 2.1 在客户角色配置页展示“新建代理默认信用”开关、额度输入和“修改后不会影响已有店铺”提示。
- 2.2 平台员工角色不展示信用配置。
- 2.3 关闭默认信用时将额度输入归零并提交
credit_limit=0。 - 2.4 保存默认信用配置时调用
PUT /api/admin/roles/{id}/default-credit。
3. Shop Credit Initialization
- 3.1 确认店铺创建页不把角色默认信用表现为会影响已有店铺的配置。
- 3.2 确认新建店铺实际信用额度由后端按所选客户角色默认信用初始化。
4. Agent Fund Overview
- 4.1 在代理商资金概况页展示现金余额、冻结金额、实际信用额度、可用金额、欠款金额和版本。
- 4.2 金额字段按接口返回值展示，不在前端重新计算可用金额或欠款金额。
- 4.3 新增店铺实际额度调整弹框，展示当前值、修改后值和关闭信用归零行为。
- 4.4 提交调额时携带当前
version调用PUT /api/admin/shops/{id}/credit-limit。 - 4.5 并发冲突时展示提示并刷新最新资金概况。
5. Verification
- 5.1 验证客户角色默认信用保存后不会修改已有店铺展示的实际信用额度。
- 5.2 验证新建店铺使用所选客户角色默认信用初始化实际额度。
- 5.3 验证资金概况页展示字段与接口返回一致。
- 5.4 验证关闭信用时额度输入归零。
- 5.5 验证并发冲突后页面提示并刷新最新资金概况。
- 5.6 运行相关 lint、类型检查或构建命令。
Verification Notes
- 角色默认信用保存只调用角色默认信用接口，店铺资金概况只读取后端返回的实际额度，未发现前端同步历史店铺额度的逻辑。
- 店铺创建参数未包含信用额度字段，实际额度初始化由后端按所选客户角色处理。
- 资金概况列表直接展示
balance、frozen_balance、credit_limit、available_balance、debt_amount、version和后端欠款状态字段。 - 关闭信用时角色配置和店铺调额表单均将额度归零，并以
credit_limit=0提交。 - 调额响应或异常命中版本冲突时，页面提示并重新加载资金概况。