Files
junhong_cmp_fiber/openspec/changes/archive/2026-09-21-add-agent-registration-management/proposal.md
break 4a16eb0b1e
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 9m41s
新增代理注册申请管理
2026-09-21 16:51:37 +08:00

1.9 KiB
Raw Blame History

Why

代理扫码注册记录、审批实例和终态结果已经落库,但后台没有列表或详情入口,平台和上级代理无法感知谁提交了申请、当前是否进入企业微信审批以及最终通过或驳回。提交失败或结果未知时也缺少按原审批实例恢复的业务入口,造成待审批记录长期不可处置。

What Changes

  • 新增代理注册申请后台分页列表和详情,展示注册资料、直接上级店铺、业务状态、审批状态、提交异常与终态结果。
  • 超级管理员和平台用户可查看全部申请;代理只可查看 parent_shop_id 等于其当前店铺的直接下级申请,不包含更深层级;企业账号拒绝。
  • 平台和有权代理均可查看完整手机号与完整注册地址;密码哈希、短信验证码、企业微信原始响应和内部事件字段不得返回。
  • 支持按注册状态、申请与决定时间、上级店铺、手机号及注册资料关键字筛选,并区分业务待审批、企微审批中、提交失败和结果未知。
  • 为提交失败、结果未知或已有企业微信审批单号但本地未确认的待审批注册申请新增原审批恢复入口,复用原审批实例与稳定提交事实,不创建新注册记录或第二张审批单。
  • 上级店铺停用后仍允许查看历史申请,但不得恢复待审批申请;审批仍只能由企业微信终审。

Capabilities

New Capabilities

无。

Modified Capabilities

  • agent-distribution-withdrawal: 增加代理注册申请后台查询、直接上级数据范围、个人资料展示与原审批恢复行为。

Impact

  • 新增代理注册后台 Query、DTO、Handler、路由和 OpenAPI影响通用审批恢复接缝、企业微信提交状态投影及审计。
  • 复用现有代理注册记录、通用审批实例、企业微信上下文、Outbox、Asynq 和店铺事实;不新增数据库迁移或第三方依赖。