商户列表

平台端 / 店铺 / 商户管理

🏢 商户列表

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

📖 概念先行：商户 vs 店铺

在深入商户列表之前，先搞清楚一个核心概念：

商户主体 (Business)  ≠  店铺 (Merchant)

商户主体 = 一个企业/组织/品牌方，比如"星巴克中国"
店铺     = 该主体下的具体经营门店，比如"星巴克-三里屯店""星巴克-国贸店"

• 一个商户主体可以拥有 多个店铺（连锁店模式）

• 店铺通过 businessId 字段归属到商户主体

• 每个商户主体有一个超管账号（SystemAdmin type=5），统一管理旗下所有店铺

💡 现实类比: 商户主体是”品牌总部”，店铺是”品牌门店”。总部管财务和策略，各门店独立经营。

📖 商户列表是干什么的？

商户列表是平台对商户主体的统一管理入口。在这里可以创建商户主体、编辑主体信息、管理旗下店铺归属、启停账号等。

💡 一句话流程: 创建商户主体 → 分配超管账号 → 关联旗下店铺 → 商户超管登录后台统一管理。

🔍 列表筛选

筛选项 说明

商户名称 模糊搜索

手机号 按超管手机号搜索

状态 启用 / 禁用 下拉筛选

日期范围 按创建时间过滤

📋 列表字段

列名 说明

ID 商户主体编号

商户名称 商户主体名称

联系人 超管联系人姓名

手机号 超管登录账号（手机号）

关联店铺数量 该商户主体下有多少个店铺

状态 启用/禁用开关——禁用后超管无法登录

创建时间 商户主体创建时间

操作 详情 / 编辑 / 更多

🔧 操作详解

基础操作

操作 说明

详情 抽屉展示商户完整信息（基本信息 + 关联店铺表格）

编辑 抽屉表单编辑（名称、联系人、角色、手机号、邮箱、备注、状态）

更多操作（下拉菜单）

操作 说明

复制登录信息 一键复制超管账号和初始密码，方便交付给商户

重置密码 将超管密码重置为 000000

删除 软删除。注意：有关联店铺时无法删除

➕ 新建商户主体

点击「添加商户」按钮，抽屉表单填写：

字段 必填 说明

商户名称 ✅ 商户主体名称

联系人 ✅ 超管真实姓名

登录账号 ✅ 超管登录账号，创建后不可修改

角色 ✅ 下拉选择角色

手机号 ✅ 超管手机号

邮箱 ❌ 联系邮箱

备注 ❌ 内部备注

状态

创建后是否立即启用

⚠️ 重要提示: 商户主体后台登录账号创建后不可修改，初始密码为 000000。创建成功后系统自动创建超管账号并与商户主体绑定。

🔗 关联店铺管理

在详情/编辑抽屉中，可以看到该商户主体下的关联店铺表格，支持：

操作 说明

查看店铺列表 展示该商户主体下所有店铺（名称、ID、创建时间等）

添加关联店铺 弹窗搜索并选择已有店铺，将其归属到该商户主体下

移除关联店铺 解除店铺与商户主体的归属关系（店铺不会被删除）

关联店铺的底层逻辑就是修改 eb_merchant.businessId 字段。

📸 操作截图

🔌 接口速查

方法 路径 说明

GET api/admin/platform/business/list 分页列表

GET api/admin/platform/business/detail/{id} 商户详情（含关联店铺）

POST api/admin/platform/business/add 添加商户主体

POST api/admin/platform/business/update 编辑商户主体

POST api/admin/platform/business/delete/{id} 删除商户主体

POST api/admin/platform/business/update/status/{id} 启用/禁用

POST api/admin/platform/business/reset/password/{id} 重置密码

🗃️ 技术要点

项目 说明

数据表 eb_business（商户主体）+ eb_system_admin（管理员，type=5）

前端页面 mer_plat_admin/src/views/platform/business/list/index.vue

路由路径 /platform/business/list

关联关系 eb_merchant.businessId → eb_business.id

删除保护 软删除，检查关联店铺数量，>0 则拒绝删除

权限前缀 platform:business:*

超管类型 SystemAdmin.type = 5（商户超管），businessId 已设置

❓ 常见问题

Q: 商户主体和店铺的区别到底是什么？

A: 商户主体是”公司/品牌层面”的概念，店铺是”具体经营门店”。一个品牌（商户主体）可以有 N 家门店（店铺）。商户超管登录后看到的是商户主体管理后台，可以管理旗下所有店铺。详细说明参考 商户与店铺概念分析。

Q: 删除商户主体会影响旗下店铺吗？

A: 有关联店铺的商户主体无法删除。需要先将旗下店铺全部移除关联或重新归属，才能删除商户主体。这是为了防止误删导致店铺变成”孤儿数据”。

Q: 禁用商户主体后，旗下店铺还能正常经营吗？

A: 超管账号被禁用后无法登录商户后台，但店铺本身在前端仍然可见和正常交易。如需关停店铺，需在店铺列表中单独操作。