Files
junhong_cmp_fiber/.scratch/ur38-agent-main-wallet-credit/issues/02-role-default-credit-template.md
2026-07-22 17:25:12 +09:00

1.8 KiB
Raw Blame History

02 — 配置客户角色的新建代理默认信用模板

What to build: 获得授权的平台人员可以为客户角色配置“新建代理默认信用”模板,并清楚获得该设置只影响未来新建店铺的接口契约。模板变更与不可变 Audit Event 同事务提交,任何审计失败都会回滚业务更新。

Blocked by:

  • .scratch/ur38-agent-main-wallet-credit/issues/01-agent-main-wallet-credit-foundation.md — 01 — 扩展代理主钱包信用模型与领域不变量
  • .scratch/tech-global-audit/issues/01-audit-event-write-loop.md — 01 — 交付不可变 Audit Event 写入闭环

Status: ready-for-agent

架构通道: 简单写 Application 事务脚本。

完整业务边界: 本票收口角色默认信用模板的配置、权限、校验、读取响应和审计。明确不调整任何既有钱包实际额度,不扫描既有店铺,不让店铺角色关系成为运行时信用来源。

  • 客户角色可通过独立接口保存合法的信用开关和额度组合;响应及角色管理所需读取契约明确这是新建代理模板。
  • 平台角色只能保持关闭/0代理账号一律禁止配置模板平台账号仍需满足既有角色管理权限超级管理员按既有规则放行。
  • 负额度、开启/0、关闭/非零、超出 int64 或分单位转换不精确的请求以统一中文错误拒绝Handler 不泄露底层校验信息。
  • 模板更新和包含操作人、角色、开关及额度前后值的 Audit Event 在同一事务提交;审计失败时模板不变。
  • 修改模板后,所有既有代理主钱包和后续店铺角色增删结果保持不变,并有集成测试证明不存在级联更新。
  • 新接口完成路由注册、统一响应、OpenAPI 文档生成接入及权限回归测试。