店铺入驻申请

平台端 / 店铺 / 店铺管理

📝 店铺入驻申请

所属模块: 店铺管理
版本: JAVA-MER-v2.1
最后更新: 2026-06-04
适用角色: 平台管理员 / 商户主体管理员

📖 它是干什么的？

店铺入驻申请是店铺进入平台的唯一闸门。用户在前端（移动端 / PC 端）填写入驻表单 → 提交申请 → 平台管理员后台审核 → 审核通过后系统自动创建店铺 + 管理员账号。

💡 一句话流程: 用户填表 → 平台审核 → 自动开店 → 短信通知。整个过程除了审核环节需要人工介入外，其余全自动。

🔄 完整业务流程

┌─────────────┐     ┌─────────────────┐     ┌──────────────────┐
│  用户提交申请  │ ──→ │  平台管理员审核    │ ──→ │  系统自动创建店铺   │
│  (移动端/PC端) │     │  (通过 / 拒绝)    │     │  + 管理员账号      │
└─────────────┘     └─────────────────┘     └──────────────────┘
                            │                        │
                     拒绝 → 填写原因           账号: 手机号
                     短信通知用户              初始密码: 000000
                                              短信通知用户

第一步：用户提交入驻申请

用户登录后在移动端或 PC 端进入入驻页面，填写以下信息：

字段 必填 说明

店铺名称 ✅ 最多 16 个字符

店铺分类 ✅ 从平台预设的分类中选择

店铺类型 ✅ 从平台预设的类型中选择

店铺联系人 ✅ 真实姓名

联系电话 ✅ 需短信验证码校验

验证码 ✅ 6 位数字短信验证码

关键字 ❌ 店铺搜索关键词

归属商户 ❌ 如果是商户主体下的子店铺，需指定归属

资质图片 ✅ 营业执照等，最多 5 张

入驻协议 ✅ 需勾选同意

第二步：平台审核

管理员在平台后台”店铺入驻申请”页面看到待审核列表，支持按时间、分类、类型、关键字筛选。

• 审核通过: 系统自动创建 eb_merchant 店铺记录 + 管理员账号（账号=手机号，初始密码=000000），并发短信通知申请人

• 审核拒绝: 需填写拒绝原因，短信通知申请人，申请人可在移动端”申请记录”页查看原因并重新提交

第三步：店铺上线

审核通过后的店铺自动出现在店铺列表中，管理员可以在店铺管理中对店铺进行进一步的设置（头像、背景图、开关、推荐等）。

🔧 管理后台功能操作

列表与筛选

功能 说明

时间筛选 按申请日期范围过滤

分类/类型筛选 仅店铺入驻模式可用

关键字搜索 按店铺名称或关键字模糊搜索

状态 Tab 待审核 / 审核通过 / 审核拒绝（显示各状态数量）

列表字段

列名 说明

ID 申请编号

店铺名称 申请人填写的店铺名称

联系方式 申请人手机号（脱敏显示）

申请时间 提交时间

状态 已通过（绿色）/ 未处理（灰色）/ 已拒绝（橙色）+ 拒绝原因

操作 审核（待审核时）/ 详情 / 备注

展开行额外展示：店铺联系人、店铺类别（自营/非自营）、备注。

审核操作

• 审核抽屉: 查看申请完整信息（账号、分类、类型、联系人、手机号、手续费、简介、备注、资质图片）

• 审核通过: 一键通过，系统自动开店

• 审核拒绝: 填写拒绝原因（必填），通知申请人修改重提

• 添加备注: 对申请记录添加内部备注，不影响审核状态

📸 操作截图

⚙️ 状态枚举

状态值 含义 标签颜色

1 待审核 灰色

2 审核通过 绿色

3 审核拒绝 橙色

🔌 接口速查

方法 路径 说明

GET api/admin/platform/merchant/apply/list 分页列表

GET api/admin/platform/merchant/apply/list/header/num 状态数量统计

POST api/admin/platform/merchant/apply/audit 审核操作（通过/拒绝）

GET api/admin/platform/merchant/apply/detail/{id} 申请详情

POST api/admin/platform/merchant/apply/remark 添加备注

商户主体后台对应路径前缀为 api/admin/business/merchant/apply/*，仅可审核自己旗下的申请。

🗃️ 技术要点

项目 说明

申请表 eb_merchant_apply

申请类型 applyType = "store"（店铺入驻）/ "business"（商户主体入驻）

自动创建 审核通过后事务中创建店铺(eb_merchant) + 管理员账号，保证原子性

短信通知 提交时通知管理员、审核后通知申请人（含账号密码）

手机号脱敏 列表中联系方式做脱敏处理

前端页面 列表: mer_plat_admin/src/views/merchant/application/index.vue / 审核抽屉: audit.vue

权限标识 platform:merchant:apply:page:list/audit/detail/remark

❓ 常见问题

Q: 审核通过后店铺为什么没有立即显示？

A: 系统在审核通过后会自动创建店铺和管理员账号，但店铺可能还需要手动开启”店铺开关”(isSwitch)。检查 eb_merchant 表中对应记录的 isSwitch 字段。

Q: 拒绝后用户可以重新申请吗？

A: 可以。被拒绝的申请在移动端”申请记录”页显示”重新提交”按钮，用户修改后可重新提交。注意重新提交会生成一条新的申请记录，原申请记录保留。

Q: 手续费在哪里设定？

A: 手续费在店铺分类中按行业预设（如美妆护肤 3%），也可以在入驻审核时手动调整单店手续费。

Q: 店铺和商户主体是什么关系？

A: 在当前版本中，店铺可以归属于某个商户主体（通过 businessId 字段关联）。如果店铺不归属任何商户主体，则店铺本身就是一个独立的商户实体。详情参考 商户与店铺概念分析。