123

doc/前端设计/前端设计.md

@@ -87,7 +87,20 @@
 
 **禁止**：同一区间用两个 `type="date"` 的 `el-date-picker` 分别选开始、结束（旧页面若仍存在，新功能与改版时须改为 `daterange`）。
 
-#### 5.「ruoyi-ui」默认布局设置 **一律**使用 Element UI：
+#### 5. 商家端店铺上下文（统一规范）
+
+凡 **店铺经营管理端**（`ruoyi-ui` 下 `views/agri/seller/**`）涉及 **当前店铺 / 切换店铺** 的：
+
+| 项 | 说明 |
+|----|------|
+| **唯一入口** | 顶部导航 **`Navbar.vue`** 展示「当前店铺」及 `el-select` 切换 |
+| **业务页面禁止** | **不得** 在列表卡片头、弹窗、表单中再展示店铺名称、店铺下拉、切换按钮 |
+| **页面仍需做的事** | `created` 时调用 `getSellerContext` → `setSellerShopContext`；API 通过 `sellerShopHeaders()` 携带 **`X-Shop-Id`** |
+| **切换后刷新** | Navbar 切换店铺后 **`location.reload()`**；业务页 **不要** 再实现 `handleShopSwitch` |
+
+**已实现：** `layout/components/Navbar.vue`、`api/agri/seller/context.js`、`utils/sellerShop.js`
+
+#### 6.「ruoyi-ui」默认布局设置 **一律**使用 Element UI：
 当出现 增删改查 时 默认
 ```html
 <el-card>
@@ -98,7 +111,7 @@
   表格
 </el-card> 
 
-#### 6.「ruoyi-ui」Cursor 输出规则
+#### 7.「ruoyi-ui」Cursor 输出规则
 
 1. **先看「ruoyi-ui」老代码 → 再生成代码**
 2. 给我代码前，必须先说明：

doc/店铺后台/商品管理/店铺商品分类/店铺商品分类前端技术方案.md

@@ -14,7 +14,7 @@
 | 框架 | Vue 2 + Element UI（与 RuoYi-Vue 一致） |
 | 请求 | `@/utils/request`；商家端接口携带 **`X-Shop-Id`** |
 | 参考页面 | `ruoyi-ui/src/views/agri/goods/category/index.vue`（两级分类树交互） |
-| 商家端参考 | `ruoyi-ui/src/views/agri/seller/role/index.vue`（店铺上下文、切换店铺） |
+| 商家端参考 | `ruoyi-ui/src/views/agri/seller/role/index.vue`（`loadShopContext` 写 X-Shop-Id） |
 | 布局 | 检索区 `el-card` + `<br/>` + 列表区 `el-card` + 表格 `border` |
 
 ---
@@ -71,7 +71,6 @@
 ├── 检索区（el-card）
 │   └── 分类名称 keyword（模糊，选填）
 ├── 列表区（el-card + border 表格）
-│   ├── 卡片头：当前店铺名称；经营账号可多店时下拉切换
 │   ├── 提示：本店分类与平台分类数据隔离
 │   ├── 工具栏：添加一级分类、批量删除
 │   ├── 列：分类名称（层级标识）、上级分类、分类图片、是否显示、是否热门、排序
@@ -96,11 +95,9 @@
 |------|------|
 | 页面 `created` | `GET /agri/seller/context` → `setSellerShopContext(shopId, shopName)` |
 | 每次 API | `sellerShopHeaders()` 注入 `X-Shop-Id` |
-| 页头展示 | 当前店铺名称（只读） |
-| 多店切换 | 卡片头 `el-select` 调 `PUT /agri/seller/context/shop`，成功后刷新列表与一级下拉 |
-| 导航栏 | `Navbar.vue` 对 `merchant` 角色同样提供店铺切换（切换后 `location.reload()`） |
+| 切换店铺 | **仅 Navbar**（`merchant` 角色）→ `PUT /agri/seller/context/shop` → `location.reload()` |
 
-未选店铺或无效店铺时，后端返回业务错误；前端依赖全局 `request` 拦截器提示。
+**业务页禁止** 展示店铺名称或选择器（见 `doc/前端设计/前端设计.md` §5）。
 
 ---
 
@@ -173,8 +170,8 @@
 ## 9. 联调检查清单
 
 - [ ] 后端菜单配置组件路径 `agri/seller/shopCategory/index` 及按钮权限
-- [ ] 商户经营账号登录，Navbar / 页头显示当前店铺
-- [ ] 多店账号切换店铺后列表仅展示该店分类
+- [ ] 商户经营账号登录，Navbar 显示当前店铺并可切换
+- [ ] 多店账号 Navbar 切换店铺后列表仅展示该店分类
 - [ ] 添加一级、添加二级、编辑、单删、批删
 - [ ] 分类下有商品时删除失败，错误提示可读
 - [ ] 子管理员无权限时按钮隐藏、接口 403

doc/店铺后台/商家端店铺上下文接口说明.md

@@ -221,7 +221,7 @@ buildContext(account, shopId)             → 返回新上下文（结构同 GET
     → 后续 /agri/seller/** 请求头附加 X-Shop-Id: {shopId}
 经营账号切换店铺
     → PUT /agri/seller/context/shop { shopId }
-    → 更新缓存 → 刷新当前页列表
+    → 更新缓存 → Navbar 刷新页面（location.reload）
 ```
 
 ### 5.2 已实现前端
@@ -230,14 +230,14 @@ buildContext(account, shopId)             → 返回新上下文（结构同 GET
 |------|------|
 | `api/agri/seller/context.js` | `getSellerContext`、`switchSellerShop` |
 | `utils/sellerShop.js` | `setSellerShopContext`、`sellerShopHeaders()` |
-| `views/agri/seller/role/index.vue` | 卡片头展示店铺、下拉切换 |
-| `views/agri/seller/employee/index.vue` | 同上 |
+| `layout/components/Navbar.vue` | **唯一** 展示「当前店铺」及下拉切换（`merchant` 角色） |
+| `views/agri/seller/**/index.vue` | 仅 `loadShopContext` 写缓存；**不** 展示店铺 UI |
 
 ### 5.3 注意事项
 
 - `GET /agri/seller/context` **不要** 带 `X-Shop-Id`（也不需要）。
-- 切换店铺后，角色/员工等 **按店铺隔离** 的列表须重新请求。
-- `switchable === false` 时不展示店铺切换控件。
+- Navbar 切换店铺后整页刷新，各业务列表自动按新店 `X-Shop-Id` 重新请求。
+- **业务页面禁止** 重复实现店铺选择器（见 `doc/前端设计/前端设计.md` §5）。
 
 ---
 

doc/店铺后台/账号管理/员工管理/员工管理前端技术方案.md

@@ -58,7 +58,7 @@
 ├── 检索区（el-card）
 │   └── 员工名称 employeeName（模糊，仅此一项）
 ├── 列表区（el-card + border 表格）
-│   ├── 卡片头：当前店铺、商户名称、员工配额 usedCount/maxCount、店铺切换
+│   ├── 卡片头：商户名称、员工配额 usedCount/maxCount
 │   ├── 配额已满 warning
 │   ├── 工具栏：创建员工（配额满 disabled）
 │   ├── 列：员工账号、员工名称、手机号（脱敏）、邮箱、状态
@@ -113,7 +113,7 @@
 
 | 字段 | 展示 |
 |------|------|
-| shopName / merchantName | 卡片头只读 |
+| shopName / merchantName | quota 接口返回；页头 **仅展示商户名称**（店铺切换见 Navbar） |
 | usedCount / maxCount | 「员工 3/5」；**商户级**计数 |
 | quotaFull | `usedCount >= maxCount` 时禁用创建、展示 warning |
 
@@ -152,7 +152,7 @@
 
 | 场景 | 前端行为 |
 |------|----------|
-| 店铺上下文 | 与角色管理相同：context → X-Shop-Id → 切换店铺刷新 |
+| 店铺上下文 | `loadShopContext` 写 X-Shop-Id；切换店铺 **仅 Navbar** reload |
 | 创建 | 配额满拦截；角色至少 1 个 |
 | 创建成功 | 提示须改密；可选立即打开改密弹窗 |
 | 启用员工 | 编辑 status=0；超配额由后端 msg |
@@ -194,7 +194,7 @@ v-hasPermi="['agri:seller:employee:remove']"
 - [ ] 编辑 / 修改账号 / 改密 / 删除各接口正常  
 - [ ] 超配额创建/启用后端 msg  
 - [ ] 手机号重复后端 msg  
-- [ ] 切换店铺后列表变化  
+- [ ] 切换店铺后列表变化（Navbar reload）  
 
 ---
 

doc/店铺后台/账号管理/角色管理/角色管理前端技术方案.md

@@ -58,7 +58,6 @@
 ├── 检索区（el-card）
 │   └── 角色名称 roleName（模糊，仅此一项）
 ├── 列表区（el-card + border 表格）
-│   ├── 卡片头：当前店铺名称（只读）；经营账号可多店时下拉切换
 │   ├── 工具栏：创建角色
 │   ├── 列：角色名称、角色描述、状态、绑定员工数、创建时间
 │   └── 操作：修改角色、删除
@@ -79,9 +78,9 @@
 |------|------|
 | 页面 `created` | `GET /agri/seller/context` → 缓存 `shopId` / `shopName` |
 | 后续请求 | `sellerShop.js` 为 `/agri/seller/role/*` 附加 `X-Shop-Id` |
-| 切换店铺 | 经营账号且 `switchable=true` 时展示下拉 → `PUT /agri/seller/context/shop` → 刷新列表 |
+| 切换店铺 | **仅 Navbar**（`layout/components/Navbar.vue`）→ `PUT /agri/seller/context/shop` → `location.reload()` |
 
-未携带有效 `X-Shop-Id` 时后端可能返回「请先选择当前店铺」。
+**业务页禁止** 展示店铺名称或选择器（见 `doc/前端设计/前端设计.md` §5）。
 
 ---
 
@@ -188,13 +187,13 @@ v-hasPermi="['agri:seller:role:remove']"
 
 - [ ] 菜单组件路径 `agri/seller/role/index` 可打开  
 - [ ] 登录后 context 写入 `X-Shop-Id`；列表仅当前店铺角色  
-- [ ] 卡片头展示当前店铺名称  
+- [ ] Navbar 展示当前店铺（经营账号可切换）  
 - [ ] roleName 模糊检索  
 - [ ] 创建：名称+至少一项权限；店铺内重名后端 msg  
 - [ ] 权限树仅商家端菜单  
 - [ ] 编辑回显 menuIds；修改成功  
 - [ ] 删除已绑定角色后端阻断  
-- [ ] 切换店铺后列表范围变化  
+- [ ] 切换店铺后列表范围变化（Navbar reload）  
 - [ ] 经营账号外访问后端 msg「仅商户经营账号可管理角色」  
 
 ---

ruoyi-ui/src/views/agri/seller/employee/index.vue

@@ -19,24 +19,8 @@
     <el-card shadow="never" class="table-card">
       <div slot="header" class="card-header">
         <span>员工列表</span>
-        <span class="header-tip">当前店铺：{{ quota.shopName || currentShopName || '—' }}</span>
         <span class="header-tip" v-if="quota.merchantName">商户：{{ quota.merchantName }}</span>
         <span class="quota-tip">员工 {{ quota.usedCount != null ? quota.usedCount : '—' }}/{{ quota.maxCount != null ? quota.maxCount : '—' }}</span>
-        <el-select
-          v-if="shopSwitchable && shopOptions.length > 1"
-          v-model="currentShopId"
-          size="small"
-          placeholder="切换店铺"
-          style="width: 200px; margin-left: 12px"
-          @change="handleShopSwitch"
-        >
-          <el-option
-            v-for="item in shopOptions"
-            :key="item.shopId"
-            :label="item.shopName"
-            :value="item.shopId"
-          />
-        </el-select>
       </div>
 
       <el-row :gutter="10" class="mb8">
@@ -179,7 +163,7 @@ import {
   resetSellerEmployeePassword,
   delSellerEmployee
 } from "@/api/agri/seller/employee"
-import { getSellerContext, switchSellerShop } from "@/api/agri/seller/context"
+import { getSellerContext } from "@/api/agri/seller/context"
 import { setSellerShopContext } from "@/utils/sellerShop"
 import passwordRule from "@/utils/passwordRule"
 
@@ -215,10 +199,6 @@ export default {
       open: false,
       profileOpen: false,
       pwdOpen: false,
-      currentShopName: "",
-      currentShopId: undefined,
-      shopSwitchable: false,
-      shopOptions: [],
       quota: {},
       roleOptions: [],
       queryParams: {
@@ -298,24 +278,9 @@ export default {
         const data = response.data || {}
         if (data.shopId != null) {
           setSellerShopContext(data.shopId, data.shopName)
-          this.currentShopId = data.shopId
-          this.currentShopName = data.shopName || ""
-          this.shopSwitchable = data.switchable === true
-          this.shopOptions = data.shops || []
         }
       })
     },
-    /** 切换店铺 */
-    handleShopSwitch(shopId) {
-      switchSellerShop({ shopId: shopId }).then(response => {
-        const data = response.data || {}
-        setSellerShopContext(data.shopId, data.shopName)
-        this.currentShopId = data.shopId
-        this.currentShopName = data.shopName || ""
-        this.queryParams.pageNum = 1
-        this.refreshPage()
-      })
-    },
     /** 刷新列表与配额 */
     refreshPage() {
       this.loadQuota()

ruoyi-ui/src/views/agri/seller/role/index.vue

@@ -17,26 +17,6 @@
 
     <!-- 列表区 -->
     <el-card shadow="never" class="table-card">
-      <div slot="header" class="card-header">
-        <span>角色列表</span>
-        <span class="header-tip">当前店铺：{{ currentShopName || '—' }}</span>
-        <el-select
-          v-if="shopSwitchable && shopOptions.length > 1"
-          v-model="currentShopId"
-          size="small"
-          placeholder="切换店铺"
-          style="width: 200px; margin-left: 12px"
-          @change="handleShopSwitch"
-        >
-          <el-option
-            v-for="item in shopOptions"
-            :key="item.shopId"
-            :label="item.shopName"
-            :value="item.shopId"
-          />
-        </el-select>
-      </div>
-
       <el-row :gutter="10" class="mb8">
         <el-col :span="1.5">
           <el-button type="primary" plain icon="el-icon-plus" size="mini" @click="handleAdd" v-hasPermi="['agri:seller:role:add']">创建角色</el-button>
@@ -128,7 +108,7 @@ import {
   updateSellerRole,
   delSellerRole
 } from "@/api/agri/seller/role"
-import { getSellerContext, switchSellerShop } from "@/api/agri/seller/context"
+import { getSellerContext } from "@/api/agri/seller/context"
 import { setSellerShopContext } from "@/utils/sellerShop"
 
 export default {
@@ -148,14 +128,6 @@ export default {
       title: "",
       // 是否显示弹窗
       open: false,
-      // 当前店铺名称
-      currentShopName: "",
-      // 当前店铺 ID
-      currentShopId: undefined,
-      // 是否可切换店铺
-      shopSwitchable: false,
-      // 可切换店铺列表
-      shopOptions: [],
       // 菜单树数据
       menuOptions: [],
       menuExpand: false,
@@ -201,24 +173,9 @@ export default {
         const data = response.data || {}
         if (data.shopId != null) {
           setSellerShopContext(data.shopId, data.shopName)
-          this.currentShopId = data.shopId
-          this.currentShopName = data.shopName || ""
-          this.shopSwitchable = data.switchable === true
-          this.shopOptions = data.shops || []
         }
       })
     },
-    /** 经营账号切换店铺 */
-    handleShopSwitch(shopId) {
-      switchSellerShop({ shopId: shopId }).then(response => {
-        const data = response.data || {}
-        setSellerShopContext(data.shopId, data.shopName)
-        this.currentShopId = data.shopId
-        this.currentShopName = data.shopName || ""
-        this.queryParams.pageNum = 1
-        this.getList()
-      })
-    },
     /** 查询角色列表 */
     getList() {
       this.loading = true
@@ -374,17 +331,6 @@ export default {
 .search-card {
   margin-bottom: 0;
 }
-.card-header {
-  display: flex;
-  align-items: center;
-  flex-wrap: wrap;
-  gap: 8px;
-}
-.header-tip {
-  color: #909399;
-  font-size: 13px;
-  font-weight: normal;
-}
 .tree-border {
   margin-top: 8px;
   border: 1px solid #e5e6e7;

ruoyi-ui/src/views/agri/seller/shopCategory/index.vue

@@ -17,26 +17,6 @@
 
     <!-- 列表区 -->
     <el-card shadow="never" class="table-card">
-      <div slot="header" class="card-header">
-        <span>店铺商品分类</span>
-        <span class="header-tip">当前店铺：{{ currentShopName || '—' }}</span>
-        <el-select
-          v-if="shopSwitchable && shopOptions.length > 1"
-          v-model="currentShopId"
-          size="small"
-          placeholder="切换店铺"
-          style="width: 200px; margin-left: 12px"
-          @change="handleShopSwitch"
-        >
-          <el-option
-            v-for="item in shopOptions"
-            :key="item.shopId"
-            :label="item.shopName"
-            :value="item.shopId"
-          />
-        </el-select>
-      </div>
-
       <el-alert type="info" :closable="false" class="mb12" title="当前店铺商品分类（shop_id 非空），与平台全部分类数据隔离；最多两级" />
 
       <el-row :gutter="10" class="mb8">
@@ -145,7 +125,7 @@ import {
   updateShopCategory,
   delShopCategory
 } from "@/api/agri/seller/shopCategory"
-import { getSellerContext, switchSellerShop } from "@/api/agri/seller/context"
+import { getSellerContext } from "@/api/agri/seller/context"
 import { setSellerShopContext } from "@/utils/sellerShop"
 
 export default {
@@ -161,10 +141,6 @@ export default {
       level1List: [],
       title: "",
       open: false,
-      currentShopName: "",
-      currentShopId: undefined,
-      shopSwitchable: false,
-      shopOptions: [],
       queryParams: {
         pageNum: 1,
         pageSize: 10,
@@ -201,25 +177,9 @@ export default {
         const data = response.data || {}
         if (data.shopId != null) {
           setSellerShopContext(data.shopId, data.shopName)
-          this.currentShopId = data.shopId
-          this.currentShopName = data.shopName || ""
-          this.shopSwitchable = data.switchable === true
-          this.shopOptions = data.shops || []
         }
       })
     },
-    /** 经营账号切换店铺 */
-    handleShopSwitch(shopId) {
-      switchSellerShop({ shopId: shopId }).then(response => {
-        const data = response.data || {}
-        setSellerShopContext(data.shopId, data.shopName)
-        this.currentShopId = data.shopId
-        this.currentShopName = data.shopName || ""
-        this.queryParams.pageNum = 1
-        this.getList()
-        this.loadLevel1Options()
-      })
-    },
     /** 查询分类列表 */
     getList() {
       this.loading = true
@@ -343,17 +303,6 @@ export default {
 .search-card {
   margin-bottom: 0;
 }
-.card-header {
-  display: flex;
-  align-items: center;
-  flex-wrap: wrap;
-  gap: 8px;
-}
-.header-tip {
-  color: #909399;
-  font-size: 13px;
-  font-weight: normal;
-}
 .mb12 {
   margin-bottom: 12px;
 }