# 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 文档生成接入及权限回归测试。
