会员管理代码

baqing-shop/src/main/java/com/ruoyi/web/modules/goods/constant/GoodsConstants.java

@@ -35,7 +35,7 @@ public final class GoodsConstants
 
     public static final String MSG_NOT_OWNER = "无权操作该商品";
 
-    public static final String MSG_CATEGORY_INVALID = "请选择本店二级分类";
+    public static final String MSG_CATEGORY_INVALID = "请选择平台二级分类";
 
     public static final String MSG_SUBMIT_INVALID = "当前状态不可提交上架";
 

doc/平台后台/关联需求分析.md

@@ -2,12 +2,12 @@
 
 > **范围：** 基于 `doc/农资商城web/` 下各模块 **功能需求定稿** 梳理跨模块关系；**不涉及** 数据库表结构、接口路径、技术实现。  
 > **目录（v3.0）：** 组织管理（商户/店铺/店铺设置/入驻审核）、商品管理（主模块 + 分类/服务/审核）、内容管理、会员管理、订单管理；详见 [文档索引.md](文档索引.md)。  
-> **依据：** 《商户管理功能需求》v1.3.1、《店铺管理功能需求》v1.3.2、《商品分类功能需求》v1.4、《商品管理功能需求》v1.3.3、《商品服务管理功能需求》v1.0.1、《会员管理功能需求》v1.0、《订单管理功能需求》v1.0.1。  
+> **依据：** 《商户管理功能需求》v1.3.1、《店铺管理功能需求》v1.3.2、《商品分类功能需求》v1.5、《商品管理功能需求》v1.3.3、《商品服务管理功能需求》v1.0.1、《会员管理功能需求》v1.0、《订单管理功能需求》v1.0.1。  
 > **说明：** 不修改任何 `*-草稿.md`；技术方案、测试用例为验收参考，本分析以功能需求为准。  
 > **v1.1：** 纳入 **商品服务管理**（平台主数据 + 商品勾选快照）。  
 > **v1.2：** 纳入 **用户链**（会员、订单）；定稿 **未完成订单 O10**、待支付自动关闭 **O8**、消费统计 **O11**。  
 > **v1.3：** 文档目录重组（组织管理 / 商品管理 / 内容管理）；路径见 [文档索引.md](文档索引.md) v3.0。  
-> **v1.5：** C 端入驻 **审核→公示→建档**；平台添加商户主体字段精简；商户/入驻文档 v1.5/v1.1。
+> **v1.6：** 发品分类口径：`category_id` = 平台二级；`shop_category_id` = 本店店铺商品二级。
 
 ---
 
@@ -76,7 +76,7 @@
 | **店铺管理** | 平台 | 为合格商户开店、店铺开业/停业、**配置商户级经营账号**、删店；商家端可改店资料（列表同源） | 不维护商品分类；店铺策略见《店铺设置》；不审核商品 |
 | **店铺设置** | 平台 | 全平台 **商品默认审核**、**子管理员上限**（针对所有店铺） | 非逐店配置；见 `组织管理/店铺设置/` |
 | **入驻审核** | 平台 + C 端 | 用户商城入驻申请、平台审核→公示→首店创建 | 不替代商户管理日常维护；协议见内容管理 |
-| **商品分类** | **平台 + 商家** | 平台维护全平台分类（`shop_id` 为空）；商家维护本店二级分类树 | 商品 **不可** 挂一级分类；商品仍挂 **本店** 二级类 |
+| **商品分类** | **平台 + 商家** | 平台维护全平台分类（`shop_id` 为空）；商家维护本店店铺商品分类树 | 商品 **category_id** 挂 **平台二级**；**shop_category_id** 可选挂本店二级；均 **不可** 挂一级 |
 | **商品管理** | 平台 + 商家 | 商家发品与状态流转；平台审核、下架、全平台检索；勾选服务并保存 **快照** | 不维护服务目录 |
 | **商品审核** | 平台 | 待审/出售中商品 **监管列表**、审核、下架（与商品管理同源状态机） | 不重复商家发品表单；见专册或合入商品管理菜单 |
 | **商品服务管理** | 平台 | 全平台服务目录（名称、简介、图标、默认显示、排序） | 非店铺维度；商家/C 端 **不维护** 目录 |
@@ -147,7 +147,8 @@
 【商家】商品分类：添加一级 / 二级分类
         ↓
 【商家】商品管理：发布商品 → 未上架（草稿）
-    → 选择本店二级分类 → 勾选商品服务（可选，默认显示项预勾选）→ 保存生成快照
+    → 选择平台二级「商品分类」（必选）；可选本店「店铺商品分类」
+    → 勾选商品服务（可选，默认显示项预勾选）→ 保存生成快照
     → 提交上架
         ↓
     ┌─ 店铺「默认审核通过」= 关 ─► 待审核 ──【平台】审核──► 出售中 / 审核失败
@@ -224,7 +225,8 @@ C 端：该店禁止下单（购物车/立即购买均拦截）
 
 | 编号 | 规则 | 说明 |
 |------|------|------|
-| C-P1 | 商品 **仅可关联本店二级分类** | 不可挂一级 |
+| C-P1 | 商品 **category_id** **仅可关联平台二级分类** | 不可挂一级 |
+| C-P1b | **shop_category_id** 若填写则 **仅可关联本店店铺商品二级** | 见《店铺商品分类功能需求》 |
 | C-P2 | 删二级分类前须无关联商品 | 须先改商品分类或处理商品 |
 | C-P3 | 删一级：子级无商品方可删；通过则 **级联删** 下属二级 | 批量删整批失败 |
 | C-P4 | 改分类显示/排序 **不自动** 改商品上下架状态 | 分类 G8 |
@@ -415,7 +417,7 @@ C 端：该店禁止下单（购物车/立即购买均拦截）
 | 组织管理/店铺管理/店铺管理功能需求.md | v1.3.5 | 开店、账号、商家端店资料 |
 | 组织管理/店铺设置/店铺设置功能需求.md | v1.1 | 全平台店铺策略 |
 | 组织管理/入驻审核/商户入驻审核功能需求.md | v1.1 | C 端完整填报；审核→公示→入驻 |
-| 商品管理/商品分类/商品分类功能需求.md | v1.4 | 平台 + 商家分类 |
+| 商品管理/商品分类/商品分类功能需求.md | v1.5 | 平台 + 商家分类；发品双字段口径 |
 | 商品管理/商品管理功能需求.md | v1.3.3 | 商品状态与商家发品 |
 | 商品管理/商品审核/商品审核功能需求.md | v1.0 | 平台审核/下架 |
 | 商品管理/商品服务/商品服务管理功能需求.md | v1.0.1 | 平台服务目录 |
@@ -437,4 +439,4 @@ C 端：该店禁止下单（购物车/立即购买均拦截）
 
 ---
 
-*文档版本：v1.5 · 仅功能需求关联分析 · 不修改草稿 · 路径对齐文档索引 v3.1*
+*文档版本：v1.6 · 仅功能需求关联分析 · 不修改草稿 · 路径对齐文档索引 v3.1*

doc/平台后台/商品管理/商品分类/商品分类功能需求.md

@@ -5,7 +5,8 @@
 > **说明：** **平台** 维护全平台统一分类（`shop_id` 为空）；**商家** 维护本店分类；平台 **商品管理** 按店铺引用商家分类做检索。  
 > **v1.1：** 商品仅挂二级分类、批量删除整批失败、店铺停业 C 端禁止下单已产品定稿。  
 > **v1.3：** **不考虑会员体系**；商家端使用 **店铺经营账号** 登录。  
-> **v1.4：** 平台端提供分类 CRUD；列表 **分页**；`shop_id` 可空区分平台/店铺分类。
+> **v1.4：** 平台端提供分类 CRUD；列表 **分页**；`shop_id` 可空区分平台/店铺分类。  
+> **v1.5：** 发品 **商品分类**（`category_id`）挂 **平台二级**；**店铺商品分类**（`shop_category_id`）为并列字段，见《店铺商品分类功能需求》。
 
 ---
 
@@ -33,7 +34,7 @@
 |----------|------|----------|
 | 商户管理 v1.3.1 | 无直接操作 | 不维护分类 |
 | 店铺管理 v1.3.2 | 上游 | 分类 **归属店铺**；商家端 **店铺经营账号** 在开店时由平台配置 |
-| 商品管理 | 下游消费 | 商品须关联 **本店二级分类**；平台按店铺名称 + **该店** 商品分类检索 |
+| 商品管理 | 下游消费 | 商品 **category_id** 须挂 **平台二级分类**；**shop_category_id** 可选挂本店店铺商品二级；平台检索可按店铺名称 + 分类筛选 |
 
 ### 1.3 使用端与角色
 
@@ -73,7 +74,8 @@
 | C2 | 添加一级：上级分类为空（或选择「无 / 顶级」） |
 | C3 | 添加二级：上级分类 **必须** 选择本店某一 **一级分类** |
 | C4 | 同一店铺、同一上级下，**分类名称不可重复** |
-| C5 | 商品发布/编辑时 **须且仅能关联本店二级分类**；**不可** 关联一级分类 |
+| C5 | 发品 **商品分类**（`category_id`）**须且仅能关联平台二级分类**（`shop_id IS NULL`）；**不可** 关联一级 |
+| C6 | **店铺商品分类**（`shop_category_id`）为并列可选字段，规则见 **《店铺商品分类功能需求》** |
 
 ---
 
@@ -244,15 +246,16 @@
 | 场景 | 行为 |
 |------|------|
 | 商品列表检索 | 可按 **商品分类**（展示分类全路径，如「一级 > 二级」）、店铺名称等筛选 |
-| 商品数据来源 | 读取各店商家已维护的 **店铺分类**；平台另维护 **平台分类**（与发品分类独立，本期商品仍挂本店二级类） |
+| 商品数据来源 | **商品分类** 读平台二级（`shop_id IS NULL`）；**店铺商品分类** 读各店维护的店铺分类；两字段并列展示 |
 
 ### 10.2 商品发布（商家端 / 与商品管理衔接）
 
 ```text
 商家在当前店铺发布/编辑商品
-    → 分类下拉仅展示本店分类
-    → 须选择 **二级分类**（仅二级，规则 C5）
-    → 保存后平台商品管理可按该分类检索
+    → 「商品分类」下拉：平台二级（`GET /agri/seller/goods/categoryOptions`）
+    → 「店铺商品分类」下拉：本店二级（`GET /agri/seller/goods/shopCategoryOptions`）
+    → 商品分类必选（规则 C5）；店铺商品分类视产品是否必填
+    → 保存后平台商品管理可按分类、店铺检索
 ```
 
 ### 10.3 C 端展示与下单（定稿）
@@ -313,7 +316,7 @@
     ↓
 商家：经营账号登录 → 选择当前店铺 → 商品分类 → 添加一级 / 二级
     ↓
-商家：商品管理 → 选二级分类发品
+商家：商品管理 → 选平台二级「商品分类」发品（可选本店「店铺商品分类」）
     ↓
 平台：商品管理 → 按店铺、分类检索与审核
 ```
@@ -346,7 +349,8 @@
 | v1.3 | **不考虑会员**；店铺经营账号 |
 | v1.3.1 | 同步取消单商户 **3 店** 上限表述 |
 | v1.4 | 平台端分类 CRUD；`shop_id` 可空；列表分页 |
+| v1.5 | 统一发品口径：`category_id` = 平台二级；`shop_category_id` = 本店店铺商品二级 |
 
 ---
 
-*文档版本：v1.4（定稿）· 关联《商品分类技术方案.md》v1.2、《商品分类测试用例.md》v1.0 · 草稿保持不变。*
+*文档版本：v1.5（定稿）· 关联《商品分类技术方案.md》v1.2、《商品分类测试用例.md》v1.0、《店铺商品分类功能需求.md》v1.1 · 草稿保持不变。*

doc/平台后台/商品管理/商品分类/商品分类技术方案.md

@@ -1,9 +1,9 @@
 # 商品分类 — 技术方案
 
-> **依据：** 《商品分类功能需求.md》v1.4  
+> **依据：** 《商品分类功能需求.md》v1.5  
 > **关联：** 《商户管理》《店铺管理》《商品管理》功能需求 v1.3.1 / v1.3.2 / v1.3.3；对应技术方案 v1.3 / v1.2.1 / v1.2  
 > **范围：** **平台端 + 商家端** 分类 CRUD；对商品/C 端提供 **Facade 与协作接口**。  
-> **原则：** **仅两级**（一级 + 二级）；`shop_id` 为 **NULL** 表示平台分类、非空表示店铺分类；商品发品 **仅挂本店二级类**；商家端复用 **当前店铺** 上下文（`X-Shop-Id`）。
+> **原则：** **仅两级**（一级 + 二级）；`shop_id` 为 **NULL** 表示平台分类、非空表示店铺分类；发品 **category_id** 挂 **平台二级**、**shop_category_id** 可选挂 **本店二级**；商家端复用 **当前店铺** 上下文（`X-Shop-Id`）。
 
 ---
 
@@ -20,12 +20,13 @@
 ### 1.1 模块落位
 
 ```text
-baqing-shop
-├── com.ruoyi.web.modules.category.controller.PlatformCategoryController   （平台）
-└── com.ruoyi.web.modules.category.controller.SellerCategoryController     （商家）
-    ├── domain.BizGoodsCategory
-    ├── service.ICategoryService / IPlatformCategoryService
-    └── facade.CategoryFacadeImpl  → ICategoryFacade
+baqing-shop/src/main/java/com/ruoyi/web/modules/category/
+├── controller/PlatformCategoryController.java           # /agri/category（平台 CRUD）
+├── controller/SellerShopGoodsCategoryController.java    # /agri/seller/shopCategory（店铺 CRUD）
+├── controller/SellerPlatformCategoryController.java     # /agri/seller/category（平台分类只读）
+├── service/IPlatformCategoryService、IShopGoodsCategoryService
+├── service/impl/CategoryServiceImpl.java
+└── facade/CategoryFacadeImpl、ShopGoodsCategoryFacadeImpl
 ```
 
 **前端页面：**
@@ -33,16 +34,17 @@ baqing-shop
 | 端 | 组件路径 |
 |----|----------|
 | 平台 | `agri/category/index` |
-| 商家 | `agri/seller/category/index` |
+| 商家 · 店铺商品分类 | `agri/seller/shopCategory/index` |
 
 ### 1.2 业务链
 
 ```text
 biz_goods_category（shop_id 可空：NULL=平台分类；非空=店铺分类）
     ├── 平台分类树（shop_id IS NULL）
+    │       └── biz_goods.category_id（发品「商品分类」，平台二级）
     └── biz_shop
-            └── 店铺分类树（shop_id = 店铺ID）
-                    └── biz_goods.category_id（仅指向 **本店** 二级节点）
+            └── 店铺商品分类树（shop_id = 店铺ID）
+                    └── biz_goods.shop_category_id（发品「店铺商品分类」，本店二级）
 ```
 
 | 模块 | 关系 |
@@ -57,9 +59,12 @@ biz_goods_category（shop_id 可空：NULL=平台分类；非空=店铺分类）
 | 接口 | 提供方 | 调用方 | 方法 |
 |------|--------|--------|------|
 | **`ICategoryFacade`** | **分类** | 商品、C端 | `isCategoryVisible(categoryId)` |
-| | | | `listLevel2ByShopId(shopId)` — 商家发品下拉 |
+| | | | `listPlatformLevel2Options()` — 平台二级下拉 |
+| | | | `listLevel2ByShopId(shopId)` — **店铺**二级下拉（`shop_id` 非空） |
 | | | | `getCategoryPath(categoryId)` → `一级 > 二级` |
 | | | | `listVisibleByShopId(shopId)` — C 端导航（show_flag=1） |
+| **`IPlatformCategoryService`** | **分类** | 商品 | `selectPlatformLevel2Options()` — 发品「商品分类」 |
+| **`IShopGoodsCategoryFacade`** | **店铺商品分类** | 商品 | `listOptionsByShopId(shopId, visibleOnly)` |
 | **`IGoodsFacade`** | 商品 | **分类** | `existsByCategoryId(categoryId)` |
 | **`IShopFacade`** | 店铺 | 分类 | 校验店铺未逻辑删除 |
 
@@ -138,13 +143,19 @@ CREATE TABLE `biz_goods_category` (
 
 ---
 
-## 3. 接口设计（商家端）
+## 3. 接口设计（商家端 · 店铺商品分类）
 
-**路径：** `/agri/seller/category`  
-**权限：** `agri:seller:category:list|add|edit|remove`  
-**数据范围：** `shop_id = 当前店铺`（请求头 `X-Shop-Id`）；店铺已逻辑删除则拦截。
+> **路径：** `/agri/seller/shopCategory`（**非** `/agri/seller/category`）  
+> **权限：** `agri:seller:shopCategory:list|add|edit|remove`  
+> **数据范围：** `shop_id = 当前店铺`（请求头 `X-Shop-Id`）；店铺已逻辑删除则拦截。
 
-### 3.1 接口一览
+### 3.0 商家端 · 平台分类只读
+
+| 方法 | 路径 | 说明 |
+|------|------|------|
+| GET | `/agri/seller/category/platformLevel2Options` | 平台二级下拉（发品「商品分类」；与商品模块 `/agri/seller/goods/categoryOptions` 同源） |
+
+### 3.1 接口一览（店铺商品分类 CRUD）
 
 | 方法 | 路径 | 说明 |
 |------|------|------|
@@ -341,21 +352,22 @@ CREATE TABLE `biz_goods_category` (
 
 | 场景 | 接口 / Facade |
 |------|----------------|
-| 商家发品选类 | `GET /agri/seller/category/level2Options` 或 `ICategoryFacade.listLevel2ByShopId` |
+| 商家发品选「商品分类」 | **`GET /agri/seller/goods/categoryOptions`** 或 `IPlatformCategoryService.selectPlatformLevel2Options()` |
+| 同上（分类模块入口） | `GET /agri/seller/category/platformLevel2Options` |
+| 商家发品选「店铺商品分类」 | `GET /agri/seller/goods/shopCategoryOptions` 或 `IShopGoodsCategoryFacade.listOptionsByShopId` |
 | 平台商品列表展示路径 | `ICategoryFacade.getCategoryPath(categoryId)` |
-| 平台按店筛分类 | **`GET /agri/goods/categoryOptions?shopId=`**（只读，见 4.1.1） |
+| 平台商品列表筛分类 | **`GET /agri/goods/categoryOptions`**（只读，见 4.1.1） |
 | 删类前置 | `IGoodsFacade.existsByCategoryId`（见 §8.4） |
 
 #### 4.1.1 平台只读 `GET /agri/goods/categoryOptions`
 
-挂在 **商品模块** `GoodsController`（平台权限 `agri:goods:list`），**不** 提供分类 CRUD。
+挂在 **商品模块** `GoodsController`（平台权限 `agri:goods:query`），**不** 提供分类 CRUD。
 
 | Query | 说明 |
 |-------|------|
-| shopId | 必填 |
-| level | 可选：`2` 仅二级（默认）；`1` 仅一级 |
+| shopId | 必填（**当前实现保留参数，返回平台二级分类全量**；按店筛分类为后续扩展） |
 
-返回该店未删除分类，供平台商品列表「按分类筛选」下拉；展示 `label` = 全路径（二级）或名称（一级）。
+返回 **平台** 未删除二级分类，供平台商品列表「按分类筛选」下拉；展示 `label` = `一级 > 二级`。
 
 #### 4.1.2 `IGoodsFacade.existsByCategoryId`（商品模块实现，口径定稿）
 
@@ -554,4 +566,4 @@ List<CategoryVisibleVO> listVisibleByShopId(Long shopId);
 
 ---
 
-*文档版本：v1.2 · MySQL 5.7.39 · RuoYi v3.9.2-springboot2 · 关联《商品分类功能需求.md》v1.4、《商品分类测试用例.md》v1.0*
+*文档版本：v1.3 · MySQL 5.7.39 · RuoYi v3.9.2-springboot2 · 关联《商品分类功能需求.md》v1.5、《商品分类测试用例.md》v1.0*

doc/平台后台/商品管理/商品审核/商品审核技术方案.md

@@ -67,7 +67,7 @@ biz_shop_global_config（default_audit_pass）
 |------|--------|------|----------|
 | `IGoodsFacade` | 商品 | `hasBlockingGoodsForShopDelete(shopId)` | 删店：存在 status∈{1,2} 阻断 |
 | `IShopGlobalConfigFacade` | 店铺设置 | `getDefaultAuditPass()` | 商家 submit 时用 |
-| `ICategoryFacade` | 分类 | `listLevel2ByShopId` | 平台按店查分类筛选项 |
+| `ICategoryFacade` | 分类 | `listPlatformLevel2Options` | 检索联动分类下拉（平台二级；`shopId` 预留扩展） |
 
 ### 1.4 状态联动
 
@@ -230,13 +230,16 @@ WHERE g.del_flag = '0'
 
 ---
 
-### 4.4 按店查分类（检索联动）`GET /agri/goods/categoryOptions`
+### 4.4 分类筛选项（检索联动）`GET /agri/goodsAudit/categoryOptions`
 
 | 项 | 说明 |
 |----|------|
-| 权限 | `agri:goods:query` |
-| Query | `shopId` 必填 |
-| 响应 | 该店二级分类下拉 |
+| 权限 | `agri:goodsAudit:query` |
+| Query | `shopId` 必填（**当前实现**仍返回全平台二级，参数预留按店扩展） |
+| 响应 | 平台二级分类下拉（`label` = `一级 > 二级`） |
+| 实现 | `categoryFacade.listPlatformLevel2Options()` |
+
+> 平台商品管理列表（`/agri/goods`）若提供同类接口，口径与本节一致。
 
 ---
 
@@ -421,4 +424,4 @@ offShelfPlatform(dto, operator)
 
 ---
 
-*文档版本：v1.0 · MySQL 5.7.39 · RuoYi v3.9.2-springboot2 · 实现复用 `com.ruoyi.web.modules.goods` · 关联《商品审核功能需求.md》v1.0*
+*文档版本：v1.1 · MySQL 5.7.39 · RuoYi v3.9.2-springboot2 · 实现复用 `com.ruoyi.web.modules.goods` · 关联《商品审核功能需求.md》v1.0 · v1.1 对齐发品分类口径（平台二级）*

doc/平台后台/组织管理/店铺管理/店铺管理技术方案.md

@@ -46,11 +46,11 @@ sql/biz_shop.sql                                  # biz_merchant_account + biz_s
 biz_merchant
     └── biz_merchant_account（1 商户 1 套经营账号）
             └── biz_shop（1 商户多店，merchant_id 创建后不可改；本期不设店数上限）
-                    ├── biz_goods_category（shop_id = 本店 ID；店铺维度二级分类）
-                    ├── biz_goods（shop_id；category_id 指向本店二级类；submit 读 **全局** default_audit_pass）
+                    ├── biz_goods_category（shop_id = 本店 ID；店铺商品分类二级树）
+                    ├── biz_goods（shop_id；category_id 指向 **平台** 二级类；shop_category_id 可选指向本店二级类；submit 读 **全局** default_audit_pass）
                     └── biz_order（shop_id；删店校验）
 
-biz_goods_category（shop_id IS NULL）  ← 平台分类（与店铺无 FK；商品 **不** 引用）
+biz_goods_category（shop_id IS NULL）  ← 平台分类（商品 category_id 引用）
 ```
 
 | 模块 | 核心表 | 与店铺关系 |

doc/店铺后台/商品管理/商品列表/商品列表功能需求.md

@@ -66,7 +66,7 @@
 |----------|------|----------|
 | **店铺管理** | 上游 | 商品 **归属当前店铺**，创建后 **不可换店** |
 | **店铺设置** | 策略 | **商品默认审核通过** 决定提交上架后进入 **待审核** 或 **出售中** |
-| **商品分类（平台文档）** | 发品必选 | 商品须挂 **本店二级「商品分类」** |
+| **商品分类（平台文档）** | 发品必选 | 商品须挂 **平台二级「商品分类」**（`biz_goods_category`，`shop_id IS NULL`）；商家 **只选不维护** |
 | **店铺商品分类** | 发品可选/并列字段 | 发品时 **「店铺商品分类」** 数据源来自该模块 |
 | **商品服务管理** | 发品多选 | 勾选平台服务目录项；保存时生成 **展示快照** |
 | **商品审核（平台）** | 下游协作 | 待审核 → 平台审；出售中 → 平台/商家均可下架 |
@@ -99,7 +99,7 @@
 | **§5.1 开业流程** | 须 **先选当前店铺**，再维护分类并发品 |
 | **§5.4 五态** | 本模块与平台 **共用** 同一套状态机，**不得** 另立规则 |
 | **§6.2 S-P1～S-P5** | 默认审核策略、停业不自动下架、删店前置、商品不可换店 |
-| **§6.3 C-P1** | 商品 **仅挂本店二级商品分类** |
+| **§6.3 C-P1** | 商品 **仅挂平台二级「商品分类」**（`category_id`）；**店铺商品分类** 为并列可选字段 |
 | **§6.5 GS-P1～P9** | 服务目录全平台共用；保存写快照；改目录不追溯 |
 | **§8 不级联** | 店铺停业、分类隐藏、服务目录变更 **不自动** 改商品状态 |
 | **§9.1 经营账号** | 登录后 **切换当前店铺** 再操作本模块 |
@@ -118,9 +118,9 @@
 
 | 项 | 定稿 |
 |----|------|
-| 发品字段「商品分类」 | 必选 **本店二级分类**；不可挂一级 |
-| 分类下拉范围 | 仅 **当前店铺**、**未删除** 分类 |
-| 删分类 | 有关联商品则 **不可删**（分类模块规则）；商家须先改商品分类 |
+| 发品字段「商品分类」 | 必选 **平台二级分类**（`shop_id IS NULL`）；不可挂一级 |
+| 分类下拉范围 | 平台 **未删除** 二级分类；接口 `GET /agri/seller/goods/categoryOptions` |
+| 删分类 | 平台删类时，有关联商品则 **不可删**；商家须先改商品 `category_id` |
 
 ### 2.4 与《店铺商品分类功能需求》
 
@@ -169,7 +169,7 @@
 | **审核失败** | 平台驳回；须查看 **驳回原因** 后修改重提 |
 | **已下架** | 商家或平台将 **出售中** 商品下架后的状态 |
 | **提交上架** | 将未上架/审核失败/已下架商品 **送入** 审核或直接出售流程的 **独立动作**（非编辑保存） |
-| **商品分类** | 平台文档中的 **本店二级分类**；发品 **必选** |
+| **商品分类** | **平台二级分类**（`shop_id IS NULL`）；发品 **必选**；展示「一级 > 二级」 |
 | **店铺商品分类** | 本店 **店铺商品分类** 模块 **二级** 数据；发品 **可选**（是否必填以原型为准） |
 | **展示快照** | 商品已选 **商品服务** 项在保存时的名称、简介、图标副本 |
 
@@ -292,7 +292,7 @@
 | 基础 | 商品编号 | — | **系统生成**，创建后展示 |
 | 基础 | 商品图片 | 是 | **多张**；首张或指定一张为主图 |
 | 基础 | 商品名称 | 是 | — |
-| 分类 | 商品分类 | 是 | **本店二级分类** |
+| 分类 | 商品分类 | 是 | **平台二级分类**（`category_id`） |
 | 分类 | 店铺商品分类 | 视产品 | **本店二级**；来自 **店铺商品分类** 模块 |
 | 基础 | 商品重量 | 视产品 | — |
 | 基础 | 商品条码 | 否 | — |
@@ -319,7 +319,7 @@
 | 前置 | 说明 |
 |------|------|
 | 当前店铺有效 | 停业店仍可发品；**已逻辑删除** 店铺不可用 |
-| 商品分类 | 须已维护 **本店二级分类**（至少一条可选） |
+| 商品分类 | 平台已维护 **平台二级分类**（至少一条可选）；商家 **只选** |
 | 商品服务 | 平台已配置目录则可选；无目录时服务区域为空 |
 | 属性模版 | 若启用模版能力，须已有可选模版（**非本期** 则手工维护属性） |
 
@@ -550,8 +550,8 @@
 
 ```text
 【平台】配置商品服务目录（可选，建议先发品前完成）
-【平台】维护平台商品分类树；商家维护本店二级「商品分类」
-【商家】维护「店铺商品分类」（可选）
+【平台】维护平台商品分类树（`shop_id IS NULL`）
+【商家】维护「店铺商品分类」（可选，`/agri/seller/shopCategory`）
             ↓
 【商家】商品列表 → 添加商品 → 保存（未上架）
             ↓
@@ -593,7 +593,7 @@
 | **GL8** | 下架：仅 **出售中**；草稿要求 **无未完成订单**（O10）方可下架 |
 | **GL9** | 删除：仅 **未上架 / 审核失败 / 已下架**；**待审核、出售中不可删** |
 | **GL10** | 批量提交上架 / 下架 / 删除：**整批失败** 策略与平台一致 |
-| **GL11** | 商品 **仅挂本店二级商品分类**；**店铺商品分类** 为并列字段，**仅挂本店店铺商品二级** |
+| **GL11** | **商品分类**（`category_id`）**仅挂平台二级**；**店铺商品分类**（`shop_category_id`）为并列字段，**仅挂本店二级** |
 | **GL12** | 保存商品时写入 **服务展示快照**；改平台目录 **不追溯** |
 | **GL13** | 状态 **仅** 经提交上架、平台审核、下架变更（P17） |
 | **GL14** | 商户/店铺/分类/服务目录变更 **不自动** 改商品状态 |
@@ -661,7 +661,8 @@
 |------|------|
 | **v1.0** | 首版定稿：店铺商品列表/检索/发品/状态流转；对齐平台五态与关联分析；补店铺上下文与服务/分类协作 |
 | **v1.1** | 对齐《店铺商品分类功能需求》v1.1：店铺商品分类为 **两级**，发品 **仅挂二级** |
+| **v1.2** | 统一「商品分类 = 平台二级 / 店铺商品分类 = 本店二级」口径；与《店铺商品列表技术方案》v1.1 及实现对齐 |
 
 ---
 
-*文档版本：v1.1 · 关联《关联需求分析.md》v1.5、《商品审核功能需求.md》v1.0、《商品分类功能需求.md》v1.4、《商品服务管理功能需求.md》v1.0.1、《店铺商品分类功能需求.md》v1.1 · 草稿《商品列表功能需求-草稿.md》保持不变。*
+*文档版本：v1.2 · 关联《关联需求分析.md》v1.6、《商品审核功能需求.md》v1.0、《商品分类功能需求.md》v1.5、《商品服务管理功能需求.md》v1.0.1、《店铺商品分类功能需求.md》v1.1 · 草稿《商品列表功能需求-草稿.md》保持不变。*

doc/店铺后台/商品管理/商品列表/店铺商品列表技术方案.md

@@ -1,7 +1,7 @@
 # 店铺商品列表 — 技术方案
 
-> **依据：** 《商品列表功能需求.md》v1.0  
-> **关联：** 《关联需求分析.md》v1.5；平台《商品审核技术方案》v1.0、《商品分类技术方案》v1.2、《商品服务管理技术方案》v1.0.1；商家《店铺商品分类技术方案》（`biz_goods_category` 本店二级）  
+> **依据：** 《商品列表功能需求.md》v1.2  
+> **关联：** 《关联需求分析.md》v1.6；平台《商品审核技术方案》v1.1、《商品分类技术方案》v1.3、《商品服务管理技术方案》v1.0.1；商家《店铺商品分类技术方案》（`biz_goods_category` 本店二级）  
 > **范围：** 商家端 **当前店铺** 商品列表、检索、发品、编辑、提交上架、下架、删除；**复用** 平台商品主表与状态机，**不另建** 商家商品表。  
 > **原则：** `goods_status` 仅经 submit / audit / offShelf 变更（P17）；`X-Shop-Id` 店铺上下文；批量含非法状态 **整批失败**。
 
@@ -53,11 +53,11 @@ biz_goods_category
 | 关联模块 | 协作 |
 |----------|------|
 | **商品审核** | 商家 submit 后进入平台待审队列；驳回原因商家详情可读 |
-| **商品分类** | `category_id` ← `ICategoryFacade.listPlatformLevel2Options()` |
+| **商品分类** | `category_id` ← `IPlatformCategoryService.selectPlatformLevel2Options()` |
 | **店铺商品分类** | `shop_category_id` ← `IShopGoodsCategoryFacade.listOptionsByShopId()` |
 | **商品服务** | 发品多选 ← `IGoodsServiceFacade`；保存写快照 |
 | **店铺设置** | `IShopGlobalConfigFacade.getDefaultAuditPass()` 决定 submit 目标态 |
-| **订单管理** | 下架前校验 **O10 未完成订单**（待实现，`IOrderFacade`） |
+| **订单管理** | 下架前校验 **O10 未完成订单**（**待实现**，`IGoodsOrderFacade` 占位） |
 | **店铺管理** | `IGoodsFacade.hasBlockingGoodsForShopDelete` 删店前置 |
 
 ### 1.3 模块落位
@@ -71,9 +71,8 @@ baqing-shop/src/main/java/com/ruoyi/web/modules/goods/
 ├── service/impl/GoodsServiceImpl.java
 ├── domain/BizGoods.java
 ├── dto/GoodsSaveDTO.java
-├── dto/GoodsSubmitBatchDTO.java               # 待实现 · 批量提交
-├── dto/GoodsOffShelfDTO.java                  # 复用 · 批量下架
-├── dto/GoodsDeleteDTO.java                    # 待实现 · 批量删除
+├── dto/GoodsBatchIdsDTO.java                  # 批量提交 / 批量删除
+├── dto/GoodsOffShelfDTO.java                  # 批量下架
 ├── mapper/BizGoodsMapper.java
 ├── support/GoodsSnGenerator.java
 ├── support/GoodsStatusUtils.java
@@ -81,10 +80,8 @@ baqing-shop/src/main/java/com/ruoyi/web/modules/goods/
 └── constant/GoodsConstants.java
 
 resources/mapper/goods/BizGoodsMapper.xml
-sql/biz_goods.sql
+sql/biz_goods.sql                              # 含 shop_category_id 字段
 sql/biz_goods_service_snapshot.sql
-sql/biz_goods_shop_category_id.sql             # shop_category_id 增量 DDL
-sql/agri_seller_goods_menu.sql                 # 商家菜单
 ```
 
 **店铺上下文（已有）：** `com.ruoyi.web.modules.store` → `SellerShopContextController`（`/agri/seller/context`）。
@@ -201,10 +198,10 @@ WHERE g.del_flag = '0'
 | 审核通过 | `auditGoods` | 平台 | 1 | 2 |
 | 审核驳回 | `auditGoods` | 平台 | 1 | 3 |
 | 下架 | `offShelfSeller` / `offShelfPlatform` | 商家/平台 | 2 | 4 |
-| 删除 | `deleteSellerGoods`² | 商家 | 0/3/4 | del_flag=2 |
+| 删除 | `deleteSellerGoodsBatch` | 商家 | 0/3/4 | del_flag=2 |
 
 ¹ `default_audit_pass='1'` → **2**，否则 **1**。  
-² **待实现**；出售中/待审核 **阻断**。
+² 出售中/待审核 **阻断**；O10 订单校验 **待实现**。
 
 **禁止：** 请求体携带 `goodsStatus` 直接改态（`rejectGoodsStatusInBody`）。
 
@@ -216,7 +213,7 @@ WHERE g.del_flag = '0'
 
 | 接口 | 提供方 | 本模块用法 |
 |------|--------|------------|
-| `ICategoryFacade` | 分类 | `listPlatformLevel2Options()` — 发品「商品分类」 |
+| `IPlatformCategoryService` | 分类 | `selectPlatformLevel2Options()` — 发品「商品分类」 |
 | `IShopGoodsCategoryFacade` | 店铺商品分类 | `listOptionsByShopId(shopId, visibleOnly)` — 「店铺商品分类」 |
 | `IGoodsServiceFacade` | 商品服务 | `listAllEnabled` / `listDefaultShow`；删服务前 `existsByServiceId` |
 | `IShopGlobalConfigFacade` | 店铺设置 | `getDefaultAuditPass()` |
@@ -358,9 +355,9 @@ WHERE g.del_flag = '0'
 }
 ```
 
-#### 5.5.2 批量 `PUT /agri/seller/goods/submit`（待实现）
+#### 5.5.2 批量 `PUT /agri/seller/goods/submit`（已实现）
 
-**Body：** `{ "goodsIds": [10001, 10002] }`  
+**Body：** `{ "goodsIds": [10001, 10002] }`（`GoodsBatchIdsDTO`）  
 规则：含非 {0,3,4} → **整批失败**。
 
 ---
@@ -372,7 +369,7 @@ WHERE g.del_flag = '0'
 | 项 | 说明 |
 |----|------|
 | 权限 | `agri:seller:goods:offshelf` |
-| 前置 | status=2；**无 O10 未完成订单**（待实现） |
+| 前置 | status=2；**无 O10 未完成订单**（**待实现**，当前 `DefaultGoodsOrderFacade` 占位） |
 
 #### 5.6.2 批量 `PUT /agri/seller/goods/offShelf`
 
@@ -387,18 +384,15 @@ WHERE g.del_flag = '0'
 
 ### 5.7 删除
 
-#### 5.7.1 单独 `DELETE /agri/seller/goods/{goodsId}`（待实现）
+#### 5.7.1 单独 / 批量 `DELETE /agri/seller/goods/{goodsIds}`（已实现）
 
 | 项 | 说明 |
 |----|------|
 | 权限 | `agri:seller:goods:remove` |
 | 前置 | status ∈ {0, 3, 4} |
+| 路径 | 单条 `1001`；批量 `1001,1002` |
 
-逻辑删除：`del_flag='2'`；同步删快照（可选保留历史）。
-
-#### 5.7.2 批量 `DELETE /agri/seller/goods/{goodsIds}`（待实现）
-
-路径：`goodsIds=1,2,3`；含不可删状态 → **整批失败**。
+逻辑删除：`del_flag='2'`；含不可删状态 → **整批失败**（`GoodsBatchIdsDTO`）。
 
 ---
 
@@ -406,8 +400,9 @@ WHERE g.del_flag = '0'
 
 | 方法 | 路径 | 权限 | 说明 |
 |------|------|------|------|
-| GET | `/agri/seller/goods/categoryOptions` | `list` | 平台二级「商品分类」`ICategoryFacade.listPlatformLevel2Options()` |
-| GET | `/agri/seller/goods/shopCategoryOptions` | `list` | 本店二级「店铺商品分类」`IShopGoodsCategoryFacade.listOptionsByShopId(shopId, false)` **待加** |
+| GET | `/agri/seller/goods/categoryOptions` | `list` / `add` / `edit` | 平台二级「商品分类」`IPlatformCategoryService.selectPlatformLevel2Options()` |
+| GET | `/agri/seller/goods/shopCategoryOptions` | `list` | 本店二级「店铺商品分类」`IShopGoodsCategoryFacade.listOptionsByShopId(shopId, false)` |
+| GET | `/agri/seller/category/platformLevel2Options` | 同上 | 与上同源（分类模块只读入口，可选） |
 | GET | `/agri/seller/goods/serviceOptions` | `list` | `{ all: [], defaultShow: [] }` |
 
 ---
@@ -447,9 +442,10 @@ offShelfSeller
   → [待] orderFacade 校验 O10
   → status 2 → 4，写 off_shelf_time
 
-deleteSellerGoods [待]
+deleteSellerGoodsBatch
   → status in (0,3,4)
-  → logic delete
+  → logic delete + 整批失败策略
+  → [待] orderFacade 校验 O10（下架时）
 ```
 
 **分类校验口径：**
@@ -482,7 +478,8 @@ deleteSellerGoods [待]
 | 阶段 | 内容 | 状态 |
 |------|------|------|
 | **v1.0** | 列表/详情/单规格 CRUD/单独 submit·offShelf/服务快照/平台分类与服务下拉 | **已实现** |
-| **v1.0 补全** | `shop_category_id` 字段 + 店铺分类下拉 + 删除 + 批量 submit/offShelf/delete + 下架 O10 校验 | **待实现** |
+| **v1.0 补全** | `shop_category_id` + 店铺分类下拉 + 删除 + 批量 submit/offShelf/delete | **已实现** |
+| **v1.0 补全·O10** | 下架前未完成订单校验（`IGoodsOrderFacade`） | **待实现** |
 | **v1.x** | 多图、多规格 SKU、运费、属性模版引用、关键词检索扩展 | 规划 |
 
 ---
@@ -509,7 +506,8 @@ deleteSellerGoods [待]
 | 版本 | 说明 |
 |------|------|
 | **v1.0** | 首版：商家商品列表技术方案；复用 biz_goods 与平台状态机；接口/DDL 与实现对齐并标注待办 |
+| **v1.1** | 同步代码：v1.0 补全已实现；统一平台/店铺分类口径；O10 仍标待实现 |
 
 ---
 
-*文档版本：v1.0 · 关联《商品列表功能需求.md》v1.1、《商品审核技术方案.md》、《商品分类技术方案.md》v1.2、《商品服务管理技术方案.md》v1.0.1、《店铺商品分类技术方案.md》v1.1 · 技术栈 RuoYi v3.9.2-springboot2 + MySQL 5.7.39。*
+*文档版本：v1.1 · 关联《商品列表功能需求.md》v1.2、《商品审核技术方案.md》v1.1、《商品分类技术方案.md》v1.3、《商品服务管理技术方案.md》v1.0.1、《店铺商品分类技术方案.md》v1.1 · 技术栈 RuoYi v3.9.2-springboot2 + MySQL 5.7.39。*

doc/店铺后台/商品管理/商品列表/店铺商品列表测试用例.md

@@ -1,11 +1,11 @@
 # 店铺商品列表 — 测试用例
 
-> **依据：** 《商品列表功能需求.md》v1.1、《店铺商品列表技术方案.md》v1.0  
+> **依据：** 《商品列表功能需求.md》v1.2、《店铺商品列表技术方案.md》v1.1  
 > **关联：** 《商品审核功能需求.md》《商品分类功能需求.md》《店铺商品分类功能需求.md》v1.1、《角色管理测试用例.md》  
 > **范围：** 商家端 `/agri/seller/goods`；`GoodsServiceImpl`（商家 scope）/ `SellerGoodsController`；`IGoodsFacade` / 服务快照协作  
 > **排除：** 平台端审核/监管 UI E2E、C 端下单、多规格 SKU/运费模版完整表单、属性模版维护  
 > **环境：** RuoYi v3.9.2-springboot2；MySQL 5.7.39；请求头 **`X-Shop-Id`** 标识当前店铺  
-> **实现分期：** v1.0 已含列表/详情/单规格 CRUD/单独 submit·offShelf/服务快照；**v1.0 补全待实现** 项在用例中标注「待实现」
+> **实现分期：** v1.0 + v1.0 补全 **已实现**（含 shopCategoryId、删除、批量 submit/offShelf）；**O10 订单阻断仍待实现**
 
 ---
 
@@ -26,13 +26,13 @@
 | 商户 A | 店铺 **101**（张三农资店）、**102**（李四农资店）；经营账号 `13800001001` / 密码见环境 |
 | 全局配置 | `default_audit_pass=0`（关，提交上架进 **待审核**）；测试免审时临时改为 `1` |
 | 平台二级分类 | `categoryId=1002`（肥料>复合肥，`shop_id IS NULL`，level=2） |
-| 店铺商品分类 | `shopCategoryId=2005`（店内专区>热销，`shop_id=101`，level=2；**字段待实现**） |
+| 店铺商品分类 | `shopCategoryId=2005`（店内专区>热销，`shop_id=101`，level=2） |
 | 商品服务 | `serviceId=1`（24小时发货，默认显示）、`serviceId=3`（7天退换） |
 | 店铺 101 商品 | `1001` 未上架(G001)、`1002` 待审核(G002)、`1003` 出售中(G003)、`1004` 审核失败(G004, reject=资料不全)、`1005` 已下架(G005) |
 | 跨店商品 | `1006` 未上架，**shop_id=102** |
 | Token | 经营账号；`X-Shop-Id=101`；含 `agri:seller:goods:*` |
 | 员工 Token | 子管理员；默认 **无** 商品列表权限 |
-| 未完成订单 | `orderId=8001` 关联 `goodsId=1003`，状态待发货（O10 下架阻断用，**待实现**） |
+| 未完成订单 | `orderId=8001` 关联 `goodsId=1003`，状态待发货（O10 下架阻断用，**接口待实现**） |
 
 **状态码：** 0 未上架 / 1 待审核 / 2 出售中 / 3 审核失败 / 4 已下架
 
@@ -136,7 +136,7 @@
 | **测试目的** | 验证 GL11：仅挂平台二级分类 |
 | **前置条件** | categoryId=1001 为一级或不存在 |
 | **测试步骤** | insertSellerGoods |
-| **预期结果** | 失败；msg 含「请选择本店二级分类」 |
+| **预期结果** | 失败；msg 含「请选择平台二级分类」 |
 
 ### SGL-UT-008 新建必填项校验
 
@@ -306,7 +306,7 @@
 | **测试步骤** | insertSellerGoods |
 | **预期结果** | 失败；msg 含「存在无效的商品服务项」 |
 
-### SGL-UT-020 店铺商品分类校验（待实现）
+### SGL-UT-020 店铺商品分类校验
 
 | 要素 | 内容 |
 |------|------|
@@ -318,23 +318,23 @@
 | **测试目的** | 验证 GL11：shopCategoryId 须本店二级 |
 | **前置条件** | shopCategoryId=502 属 102；或传一级分类 ID |
 | **测试步骤** | insertSellerGoods(101, dto含shopCategoryId) |
-| **预期结果** | **待实现** 后失败；msg 提示分类无效 |
+| **预期结果** | 失败；msg 提示分类无效 |
 
-### SGL-UT-021 删除可删状态成功（待实现）
+### SGL-UT-021 删除可删状态成功
 
 | 要素 | 内容 |
 |------|------|
 | **用例编号** | SGL-UT-021 |
 | **测试模块** | 店铺商品列表 |
-| **测试项** | deleteSellerGoods |
+| **测试项** | deleteSellerGoodsBatch |
 | **测试类型** | 单元测试 |
 | **测试工具** | JUnit 5 + Mockito |
 | **测试目的** | 验证 GL9：0/3/4 可逻辑删除 |
 | **前置条件** | 1001 status=0 |
-| **测试步骤** | deleteSellerGoods(101, 1001) |
-| **预期结果** | **待实现**；del_flag=2；快照可同步清除 |
+| **测试步骤** | deleteSellerGoodsBatch(101, [1001]) |
+| **预期结果** | del_flag=2 |
 
-### SGL-UT-022 删除待审核/出售中失败（待实现）
+### SGL-UT-022 删除待审核/出售中失败
 
 | 要素 | 内容 |
 |------|------|
@@ -345,8 +345,8 @@
 | **测试工具** | JUnit 5 + Mockito |
 | **测试目的** | 验证 GL9 阻断 |
 | **前置条件** | 1002 status=1；1003 status=2 |
-| **测试步骤** | deleteSellerGoods |
-| **预期结果** | **待实现** 后失败；del_flag 不变 |
+| **测试步骤** | deleteSellerGoodsBatch |
+| **预期结果** | 失败；del_flag 不变 |
 
 ### SGL-UT-023 下架 O10 未完成订单阻断（待实现）
 
@@ -360,7 +360,7 @@
 | **测试目的** | 验证 GL8 订单约束 |
 | **前置条件** | 1003 出售中；`hasUnfinishedOrderByGoodsId(1003)=true` |
 | **测试步骤** | offShelfSeller |
-| **预期结果** | **待实现** 后失败；提示存在未完成订单 |
+| **预期结果** | **待实现**（`IGoodsOrderFacade` 接入后）失败；提示存在未完成订单 |
 
 ---
 
@@ -630,9 +630,9 @@
 | **测试目的** | 验证 GL8 订单阻断 |
 | **前置条件** | 1003 有 O10 未完成订单 |
 | **测试步骤** | PUT /1003/offShelf |
-| **预期结果** | **待实现** 后失败；明确提示订单未完成 |
+| **预期结果** | **待实现**（`IGoodsOrderFacade` 接入后）失败；明确提示订单未完成 |
 
-### SGL-API-020 删除未上架成功（待实现）
+### SGL-API-020 删除未上架成功
 
 | 要素 | 内容 |
 |------|------|
@@ -644,9 +644,9 @@
 | **测试目的** | 验证 GL9 正常删除 |
 | **前置条件** | 1001 status=0；`agri:seller:goods:remove` |
 | **测试步骤** | `DELETE /agri/seller/goods/1001` |
-| **预期结果** | **待实现**；code=200；列表不再返回 |
+| **预期结果** | code=200；列表不再返回 |
 
-### SGL-API-021 删除出售中失败（待实现）
+### SGL-API-021 删除出售中失败
 
 | 要素 | 内容 |
 |------|------|
@@ -658,9 +658,9 @@
 | **测试目的** | 验证 GL9 |
 | **前置条件** | 1003 status=2 |
 | **测试步骤** | DELETE /1003 |
-| **预期结果** | **待实现** 后失败；商品仍在列表 |
+| **预期结果** | 失败；商品仍在列表 |
 
-### SGL-API-022 批量提交含非法态整批失败（待实现）
+### SGL-API-022 批量提交含非法态整批失败
 
 | 要素 | 内容 |
 |------|------|
@@ -672,9 +672,9 @@
 | **测试目的** | 验证 GL10 |
 | **前置条件** | 勾选 1001(0) 与 1003(2) |
 | **测试步骤** | `PUT /agri/seller/goods/submit` body goodsIds |
-| **预期结果** | **待实现**；整批失败；data.reasons 非空；**均无** 状态变更 |
+| **预期结果** | 整批失败；data.reasons 非空；**均无** 状态变更 |
 
-### SGL-API-023 批量下架整批失败（待实现）
+### SGL-API-023 批量下架整批失败
 
 | 要素 | 内容 |
 |------|------|
@@ -685,7 +685,7 @@
 | **测试工具** | Apifox |
 | **测试目的** | 验证 GL10 下架批量 |
 | **前置条件** | goodsIds 含 1003(2) 与 1005(4) |
-| **测试步骤** | PUT /offShelf（商家批量接口 **待实现**） |
+| **测试步骤** | `PUT /agri/seller/goods/offShelf` |
 | **预期结果** | 整批失败；1003 **仍为** 出售中 |
 
 ### SGL-API-024 商品分类下拉
@@ -700,7 +700,7 @@
 | **测试目的** | 验证发品「商品分类」数据源 |
 | **前置条件** | 平台存在二级分类 |
 | **测试步骤** | GET /agri/seller/goods/categoryOptions |
-| **预期结果** | code=200；data **仅二级**；label 含「一级 > 二级」 |
+| **预期结果** | code=200；data **仅平台二级**（`shop_id IS NULL`）；label 含「一级 > 二级」 |
 
 ### SGL-API-025 商品服务下拉
 
@@ -716,7 +716,7 @@
 | **测试步骤** | GET /serviceOptions |
 | **预期结果** | data 含 all、defaultShow；defaultShow 为默认勾选项 |
 
-### SGL-API-026 店铺商品分类下拉（待实现）
+### SGL-API-026 店铺商品分类下拉
 
 | 要素 | 内容 |
 |------|------|
@@ -728,7 +728,7 @@
 | **测试目的** | 验证 GL11 店铺分类下拉 |
 | **前置条件** | 101 有店铺二级分类 2005 |
 | **测试步骤** | GET /shopCategoryOptions |
-| **预期结果** | **待实现**；仅本店二级；label=`一级 > 二级` |
+| **预期结果** | 仅本店二级；label=`一级 > 二级` |
 
 ### SGL-API-027 无 list 权限拒绝
 
@@ -927,10 +927,10 @@
 | **测试项** | 批量提交上架 |
 | **测试类型** | 界面测试 |
 | **测试工具** | Playwright |
-| **测试目的** | 验证 GL10（批量 **待实现** 时测 UI 拦截或提示） |
+| **测试目的** | 验证 GL10 |
 | **前置条件** | 勾选 1001(未上架) 与 1003(出售中) |
 | **测试步骤** | 点「批量提交上架」 |
-| **预期结果** | 提示含不可提交状态；**均不变**态（或批量 API 待实现前按钮 disabled） |
+| **预期结果** | 提示含不可提交状态；**均不变**态 |
 
 ### SGL-UI-013 切换店铺列表刷新
 
@@ -974,7 +974,7 @@
 | **测试步骤** | 进入商品列表 |
 | **预期结果** | 展示空态文案；引导「添加商品」按钮可点 |
 
-### SGL-UI-016 删除确认与状态限制（待实现）
+### SGL-UI-016 删除确认与状态限制
 
 | 要素 | 内容 |
 |------|------|
@@ -986,7 +986,7 @@
 | **测试目的** | 验证 GL9、§12 |
 | **前置条件** | 1001 未上架可删；1002 待审核不可删 |
 | **测试步骤** | 未上架点删除→确认；待审核行 **无** 删除或点击提示 |
-| **预期结果** | **待实现** 后：前者删除成功；后者不可删 |
+| **预期结果** | 前者删除成功；后者不可删 |
 
 ### SGL-UI-017 发品默认勾选服务项
 
@@ -1035,7 +1035,8 @@
 
 | 版本 | 说明 |
 |------|------|
-| **v1.0** | 首版：23 单元 + 28 接口 + 17 UI；覆盖 GL1～GL17 及状态机/检索/权限；标注 v1.0 补全待实现项 |
+| **v1.0** | 首版：23 单元 + 28 接口 + 17 UI；覆盖 GL1～GL17 及状态机/检索/权限 |
+| **v1.1** | 同步代码 v1.0 补全已实现；O10 仍标待实现；统一平台/店铺分类口径 |
 
 ---
 

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

@@ -25,7 +25,7 @@
 |------|-----------------|----------------------|
 | 表 | `biz_goods_category`（`shop_id IS NULL`） | **`biz_goods_category`（`shop_id = 当前店铺`）** |
 | 结构 | 一级 + 二级 | **一级 + 二级**（同表、同层级规则） |
-| 商家路径 | `/agri/seller/category` | **`/agri/seller/shopCategory`** |
+| 商家路径 | `/agri/seller/shopCategory` | **`/agri/category`**（平台维护）+ **`/agri/seller/category/platformLevel2Options`**（只读） |
 | 商品字段 | `biz_goods.category_id`（平台二级） | **`biz_goods.shop_category_id`（本店二级）** |
 | 平台端 | 可维护平台树 + 监管只读 | **不参与** |
 
@@ -36,7 +36,8 @@
 ```text
 baqing-shop/src/main/java/com/ruoyi/web/modules/category/
 ├── controller/SellerShopGoodsCategoryController.java   # /agri/seller/shopCategory
-├── controller/SellerCategoryController.java          # /agri/seller/category（商品分类，非本模块）
+├── controller/SellerPlatformCategoryController.java  # /agri/seller/category（平台分类只读，非本模块 CRUD）
+├── controller/PlatformCategoryController.java        # /agri/category（平台商品分类 CRUD）
 ├── service/IShopGoodsCategoryService.java
 ├── service/impl/CategoryServiceImpl.java               # 平台 + 店铺分类共用实现
 ├── domain/BizGoodsCategory.java