店铺列表

平台端 / 店铺 / 店铺管理

🏪 店铺列表

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

📖 它是干什么的？

店铺列表是店铺全生命周期管理的中枢——这里能看到平台上所有店铺（或你旗下的店铺），并对其执行启停、编辑、改密、调归属等一切日常运维操作。

💡 一句话定位: 如果说入驻申请是”入职流程”，分类/类型/分组是”员工档案字段”，那店铺列表就是HR 的员工名册——增删改查、升降级、调部门，都在这。

🔍 列表筛选

筛选项 说明 谁可见

选择时间 按创建日期范围过滤 全部

店铺名称 模糊搜索 全部

店铺类别 自营 / 非自营 仅平台

店铺分类 下拉选择行业分类 全部

店铺类型 下拉选择经营模式 全部

状态 Tab

Tab 含义

正常开启的店铺 isSwitch = true，正常营业中

已关闭店铺 isSwitch = false，已打烊/关闭

每个 Tab 标签上实时显示对应状态的店铺数量。

📋 列表字段

列名 说明 谁可见

ID 店铺编号 全部

店铺名称 店铺对外展示名 全部

店铺姓名 店铺联系人姓名 全部

创建类型 admin（后台创建）/ apply（入驻申请通过） 全部

店铺手机号 管理员手机号（即登录账号） 全部

剩余采集次数 商品采集功能剩余可用次数 全部

推荐指数 数值越高越靠前展示 仅平台

创建时间 店铺创建时间 全部

开启/关闭 开关控制店铺营业状态 全部

推荐 开关控制是否推荐店铺 仅平台

操作 登录 / 详情 / 更多操作 全部

🔧 操作详解

基础操作

操作 说明 权限标识

登录 一键登录到该店铺管理后台 platform:merchant:detail

详情 以只读模式查看店铺完整信息（基础信息 + 店铺资料 + 结算信息） platform:merchant:detail / business:store:info

编辑 修改店铺信息（名称、分类、类型、手续费、资质图片等） platform:merchant:update / business:store:update

更多操作（下拉菜单）

操作 说明 谁可见

修改归属商户 将店铺转移给另一个商户主体（或改为平台直营） 仅平台

修改手机号 更新店铺管理员登录手机号 仅平台

重置店铺密码 将店铺管理员密码重置为 000000 全部

修改剩余采集次数 调整商品采集功能的剩余可用次数 全部

快捷开关

开关 说明 效果

开启/关闭 控制店铺营业状态 关闭后店铺及其商品在前端不可见

推荐 控制是否推荐店铺 推荐店铺在移动端优先展示

➕ 添加店铺

平台管理员和商户主体管理员都可以在后台直接创建店铺，无需走入驻申请流程。

点击「添加店铺」按钮，右侧弹出抽屉表单，填写以下信息：

字段 必填 说明

店铺名称 ✅ 最多 16 字符

店铺账号

手机号作为登录账号（编辑已有店铺时可见）

店铺手机号 ✅ 即管理员登录账号

店铺姓名 ✅ 联系人真实姓名

店铺分类 ✅ 选择后自动带出对应手续费

手续费(%) ✅ 平台可手动调整，商户端不可见

店铺类型 ✅ 旗舰店/自营店/工厂店等

归属商户

仅平台可见，可选归属商户主体或平台直营

店铺关键字 ✅ 搜索关键词，回车添加多个

资质图片 ✅ 营业执照等，最多 10 张，可拖拽排序

备注 ❌ 内部备注

推荐指数

仅平台，数值越高越靠前

星级评分

仅平台，1-5 星

是否开启

创建后是否立即营业

是否推荐

仅平台

是否自营

仅平台，打标”自营”

商品审核

仅平台，开启后该店铺上架商品需审核

⚠️ 提示: 店铺登录账号为手机号，初始密码为 000000，管理员可从个人中心修改密码。

📸 操作截图

🔌 接口速查

方法 路径 说明

GET api/admin/platform/merchant/list 店铺分页列表

GET api/admin/platform/merchant/list/header/num 表头数量（开启/关闭各多少）

POST api/admin/platform/merchant/add 添加店铺

POST api/admin/platform/merchant/update 编辑店铺

GET api/admin/platform/merchant/detail/{id} 店铺详情

POST api/admin/platform/merchant/switch/recommend 推荐开关

POST api/admin/platform/merchant/open/{id} 开启店铺

POST api/admin/platform/merchant/close/{id} 关闭店铺

POST api/admin/platform/merchant/update/phone 修改手机号

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

POST api/admin/platform/merchant/copy/product/num 修改采集次数

POST api/admin/platform/merchant/update/business 修改归属商户

商户主体后台对应路径前缀为 api/admin/business/merchant/*，仅可操作旗下店铺。

🗃️ 技术要点

项目 说明

数据表 eb_merchant

创建类型枚举 admin=后台直接创建 / apply=入驻申请审核通过

前端页面 列表: mer_plat_admin/src/views/merchant/list/index.vue / 表单: creatMerchant.vue

关键逻辑 选择分类后自动填充手续费、平台端和商户端表单字段差异、归属商户转移

权限体系 平台和商户主体共用同一组件，通过 isPlatform 区分可见字段和可用操作