店铺分组

平台端 / 店铺 / 店铺管理

📍 店铺分组（商圈）

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

📖 它是干什么的？

店铺分组是用于标识店铺所属商圈的地理层级结构，主要用于移动端的商圈切换功能。它支持最多三级结构，比如：”陕西省 / 西安市 / 雁塔区”。

💡 大白话: 想象一下外卖 App 顶部那个”切换到 xxx 商圈”——就是这个。用户在 App 里切到”三里屯”，看到的全是三里屯的店，而不是五环外的店。

🔧 功能操作

操作 说明

查看树形列表 树形表格展示全部分组，含 ID、名称、店铺范围、店铺数量、关联微页面

新增分组 创建一级商圈分组

新增下级 在某个分组下添加子分组（最多三级）

编辑分组 修改分组信息

启用/禁用 开关控制商圈是否生效

显示/隐藏 开关控制商圈在移动端是否可见

批量关联微页面 将选中分组批量绑定到 DIY 装修的微页面

📸 操作截图

⚙️ 列表字段详解

列名 说明

店铺分组名称 商圈名称，树形展示父子关系

店铺范围 该商圈覆盖的地理范围描述

店铺数量 当前分组下的店铺总数

关联微页面 该商圈关联的 DIY 装修微页面名称

状态 启用/禁用开关——关了，移动端就看不到这个商圈

是否显示 显示/隐藏开关——控制商圈入口是否在 App 中展示

🗃️ 技术要点

项目 说明

核心实体 商圈（eb_circle）+ 商圈-店铺关联表（eb_circle_merchant）

结构限制 最大三级树形结构

前端页面 mer_plat_admin/src/views/area/index.vue（树形表格 el-table + tree-props）

移动端联动 商圈切换驱动 getRegionMerListApi() 查询对应店铺列表

API 路由 api/front/circle/areas/*（前端接口）+ api/admin/*（后台管理）

🔌 接口速查

方法 路径 说明

GET api/front/circle/areas/tree 获取商圈树

GET api/front/circle/areas/list/location 根据经纬度获取商圈列表

GET api/front/circle/areas/list/address 根据地址获取商圈列表