Files
one-pipe-system/openspec/changes/update-role-default-credit-and-shop-credit-limit/tasks.md
luo d7c2c146fe
All checks were successful
构建并部署前端到测试环境 / build-and-deploy (push) Successful in 6m12s
feat: 角色默认信用与店铺实际额度管理
2026-07-23 14:10:48 +08:00

2.0 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_enabledcredit_limitavailable_balanceis_in_debtdebt_amountversion

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、类型检查或构建命令。