审核入驻申请¶

场景：平台运营审核商家入驻申请的全流程 实际路径：admin 后台 → 店铺管理 → 店铺申请（审核列表）/ 商户入驻审核（详情）

📋 演示脚本¶

演示准备：

登录 admin 后台 admin / admin123
让商家先在 H5 提交一笔入驻申请（演示前 5 分钟做）

演示步骤：

步骤 1：进入审核列表¶

admin 后台左侧菜单：店铺管理 → 店铺申请

SPA 路径：/admin/merchant/application

（注意：/admin/merchant/intention/lst 是 API 路由，不是 SPA 路由——后台前端只认 SPA 路径）

页面展示所有待审核的入驻申请：

店铺申请审核列表

申请人基本信息
身份证 / 营业执照
经营类目、店铺类型
店铺名称、Logo
申请时间

步骤 2：审核判断标准¶

按以下标准判断：

检查项	通过标准
证件清晰度	五官、印章可识别
资料完整性	必填项无遗漏
类目匹配	经营类目与证件经营范围相符
名称合规	不含违禁词，不与现有店铺重名

步骤 3：审核操作¶

admin 后台还可查看商户列表（含审核状态）：

商户列表

通过：

点击 "审核通过"
系统自动：
创建店铺
发短信给商家
状态变为"已通过"

拒绝：

点击 "审核拒绝"
填写拒绝原因（必填）
用户收到拒绝通知
用户可修改后重新提交

🎓 培训材料¶

审核时效¶

平台承诺 1-2 个工作日
实际通常 2-4 小时
建议每天至少 2 次查看待审核列表

常见拒绝原因¶

原因	处理建议
身份证模糊	让用户重新上传
营业执照过期	拒绝，让用户更新证件
类目不符	拒绝，建议合适类目
名称违规（含极限词）	拒绝，要求改名
重复申请（同一身份证）	拒绝并合并账户
信息明显虚假	拒绝并记录黑名单

🔧 故障排查¶

场景 A：审核通过但商家收不到短信¶

排查：

查阿里云短信发送记录
显示发送成功 → 用户查短信拦截
显示失败 → 检查短信模板配置
短信通道异常 → 联系阿里云客服

场景 B：审核通过但店铺没创建¶

原因（按概率）：

queue:work 进程未启动
Redis 队列 key 不一致（QUEUE_NAME=shop_mer_v4_default 必须设置）
数据库连接异常

排查：

看 swoole error log
redis-cli LRANGE queues:shop_mer_v4_default 0 -1
看 ps aux | grep queue:work
必要时手动重试

场景 C：误审核后如何撤回¶

已通过：联系技术删除 ij_merchant 行
已拒绝：让用户重新提交

⚙️ 后端关键点¶

审核通过后自动创建¶

ij_merchant_intention  status=1 (通过) → 异步推 AutoCreateMerchantJob → queue:work 消费
   ↓                                                       ↓
ij_merchant 表新增                                         ↓
ij_merchant_admin 表新增                                   ↓
   ↓                                                       ↓
短信通知商家                                          ~25ms 完成

关键接口¶

GET /sys/merchant/intention/lst — 审核列表（API 路由）
POST /sys/merchant/intention/status/:id — 审核操作（核心入口）
GET /sys/merchant/intention/detail/:id — 申请详情

自动建店链路（Round 27 修复）¶

Round 27 修复了 4 大根因：

MerchantCoreServiceRepository::createMerchant ↔ MerchantRepository::create 死循环
.env REDIS_PASSWORD 切到共享 6379
.env QUEUE_NAME=shop_mer_v4_default 隔离队列
MerchantIntention::pushAutoCreateJob 改用 Queue::push（避免 BRPOP key 不一致）

关联场景¶

商家入驻申请 (H5) — 商家视角
[审核入驻申请] ← 当前