会员管理代码

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

@@ -70,12 +70,15 @@
 └── 添加/编辑弹窗（720px · v1.0 单规格）
     ├── 商品分类 categoryId（必填，平台二级）
     ├── 店铺商品分类 shopCategoryId（选填，本店二级）
+    ├── 属性模版 attrTemplateId（选填；下拉 `/agri/seller/attrTemplate/options`）
     ├── 商品名称、主图、销售价、库存
     ├── 商品详情 detailContent（Editor 富文本）
     └── 服务说明 serviceIds（多选；新建默认勾选 defaultShow）
 ```
 
-**v1.0 未实现（后续扩展）：** 多图 gallery、多规格 SKU、运费模版、属性模版、独立 form 路由页。
+**v1.0 未实现（后续扩展）：** 多图 gallery、多规格 SKU、运费模版、属性/规格明细编辑（`biz_goods_attr`）、独立 form 路由页。
+
+**v1.0 后端已支持：** 保存/详情 `attrTemplateId`（模版引用 ID）；前端发品表单待接入下拉与回显。
 
 ---
 
@@ -98,6 +101,7 @@
 | `listSellerGoods` | GET | `/list` | 分页列表 |
 | `sellerGoodsCategoryOptions` | GET | `/categoryOptions` | 平台二级分类 |
 | `sellerGoodsShopCategoryOptions` | GET | `/shopCategoryOptions` | 本店二级店铺分类 |
+| `sellerAttrTemplateOptions` | GET | `/agri/seller/attrTemplate/options` | 本店属性模版（属性模版模块） |
 | `sellerGoodsServiceOptions` | GET | `/serviceOptions` | `{ all, defaultShow }` |
 | `getSellerGoods` | GET | `/{goodsId}` | 详情 |
 | `addSellerGoods` | POST | `/` | 新增 → status=0 |
@@ -135,6 +139,7 @@
 |------|------|------|------|
 | categoryId | 必填 | 必填 | 平台二级 |
 | shopCategoryId | 选填 | 选填 | 本店二级 |
+| attrTemplateId | 选填 | 选填 | 本店有效属性模版 |
 | goodsName | 必填 | 必填 | max 200 |
 | mainPic | 必填 | 必填 | image-upload |
 | detailContent | 必填 | 必填 | 富文本 |
@@ -164,6 +169,7 @@
 | rejectReason | 审核失败展示 |
 | services[] | 服务快照；编辑时回显 `serviceIds` |
 | shopCategoryPath | 店铺分类路径 |
+| attrTemplateId / attrTemplateName | 属性模版引用与名称 |
 
 ---
 
@@ -188,7 +194,8 @@
 - [ ] 添加 → 未上架 → 提交上架（免审开/关两种策略）
 - [ ] 出售中编辑保存后状态不变
 - [ ] 批量操作含非法状态时后端报错
-- [ ] 分类/店铺分类/服务下拉数据正确
+- [ ] 分类/店铺分类/属性模版/服务下拉数据正确
+- [ ] 保存带 attrTemplateId 后详情回显 attrTemplateName
 
 ---
 
@@ -197,7 +204,8 @@
 | 版本 | 说明 |
 |------|------|
 | v1.0 | 首版：列表 + v1.0 单规格发品弹窗 + 详情抽屉 + 状态流转操作 |
+| v1.1 | 对齐后端 `attrTemplateId`：保存体/详情字段；下拉走属性模版模块 |
 
 ---
 
-*文档版本：v1.0 · 关联《商品列表功能需求.md》v1.1、《店铺商品列表技术方案.md》v1.0*
+*文档版本：v1.1 · 关联《商品列表功能需求.md》v1.3、《店铺商品列表技术方案.md》v1.2*

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

@@ -26,7 +26,7 @@
 | **平台 · 商品审核** | 见平台 **商品审核**；平台对待审核商品通过/驳回、对出售中商品下架 |
 | **平台 · 商品分类 / 服务目录维护** | 见平台 **商品分类**、**商品服务管理**；商家 **只选** 不维护目录 |
 | **店铺商品分类维护** | 见 **店铺商品分类**；本模块 **消费** 其数据 |
-| **属性模版维护** | 模版配置 **非本期**（若后续单独立项）；发品时 **选用** 已有模版 |
+| **属性模版维护** | 见 **属性模版** 模块（已实现）；本模块发品时 **选用** 并保存引用 |
 | **C 端下单 / 订单履约** | 见 **订单管理**；本模块不处理发货、退款 |
 
 ### 1.2 与草稿的对应关系
@@ -266,7 +266,7 @@
 | 类别 | 内容 |
 |------|------|
 | 基础信息 | 编号、名称、主图/详情图、售价、库存、销量、重量、条码、关键词、简述等 |
-| 分类 | **商品分类**（一级 > 二级）、**店铺商品分类**（一级 > 二级，若有） |
+| 分类 | **商品分类**（一级 > 二级）、**店铺商品分类**（一级 > 二级，若有）、**属性模版**（名称，若选用） |
 | 规格与运费 | 销售规格（统一/多规格）、规格明细（市场价、库存）；快递运费（固定/模版） |
 | 属性 | 基于 **属性模版** 扩展的属性项、规格项及其值 |
 | 详情内容 | 图文详情（图片块 + 文本块） |
@@ -298,7 +298,7 @@
 | 基础 | 商品条码 | 否 | — |
 | 基础 | 搜索关键词 | 否 | — |
 | 基础 | 商品简述 | 视产品 | — |
-| 属性 | 属性模版 | 视产品 | 在模版基础上 **可增删** 属性项、属性值、规格项、规格值 |
+| 属性 | 属性模版 | 否 | 下拉选用本店模版（数据源见 **属性模版** 模块）；保存 **引用 ID**；属性/规格键值明细 **v1.x** |
 | 销售 | 销售规格 | 是 | **统一规格 / 多规格** |
 | 销售 | 规格明细 | 是 | 每种规格：**市场价、库存**（首期单规格时一行） |
 | 物流 | 快递运费 | 是 | **固定运费 / 运费模版** |
@@ -321,7 +321,7 @@
 | 当前店铺有效 | 停业店仍可发品；**已逻辑删除** 店铺不可用 |
 | 商品分类 | 平台已维护 **平台二级分类**（至少一条可选）；商家 **只选** |
 | 商品服务 | 平台已配置目录则可选；无目录时服务区域为空 |
-| 属性模版 | 若启用模版能力，须已有可选模版（**非本期** 则手工维护属性） |
+| 属性模版 | 可选；下拉来自 **属性模版** 模块 `/agri/seller/attrTemplate/options`；无模版时可不传 |
 
 ---
 
@@ -600,6 +600,7 @@
 | **GL15** | 须携带 **当前店铺上下文**；切换店铺后数据范围随之变化 |
 | **GL16** | 商品创建后 **不可换店** |
 | **GL17** | **任意状态** 均可 **查看详情**；审核失败须展示 **驳回原因** |
+| **GL18** | 发品可选 **属性模版**；若传须为 **当前店铺** 有效模版；保存写入引用；模版项/值快照 **biz_goods_attr** 另案（v1.x） |
 
 ---
 
@@ -624,7 +625,8 @@
 
 | 项 | 说明 |
 |----|------|
-| 属性模版 **维护** | 仅 **选用**；模版 CRUD 单独立项 |
+| 属性模版 **维护** | 见 **属性模版** 模块；本模块 **仅选用 + 保存引用** |
+| 属性/规格 **明细落库** | `biz_goods_attr` 写入 **v1.x**；当前仅 `attr_template_id` |
 | 运费模版 **维护** | 假定平台或它模块已提供可选模版 |
 | 多规格 SKU 完整能力 | 草稿含多规格字段；复杂 SKU 以商品管理全模块为准 |
 | 平台代商家改价/改库存 | 平台侧能力 |
@@ -662,7 +664,8 @@
 | **v1.0** | 首版定稿：店铺商品列表/检索/发品/状态流转；对齐平台五态与关联分析；补店铺上下文与服务/分类协作 |
 | **v1.1** | 对齐《店铺商品分类功能需求》v1.1：店铺商品分类为 **两级**，发品 **仅挂二级** |
 | **v1.2** | 统一「商品分类 = 平台二级 / 店铺商品分类 = 本店二级」口径；与《店铺商品列表技术方案》v1.1 及实现对齐 |
+| **v1.3** | 对齐属性模版协作：发品可选 `attrTemplateId` 并保存引用；属性/规格明细 `biz_goods_attr` 仍标 v1.x |
 
 ---
 
-*文档版本：v1.2 · 关联《关联需求分析.md》v1.6、《商品审核功能需求.md》v1.0、《商品分类功能需求.md》v1.5、《商品服务管理功能需求.md》v1.0.1、《店铺商品分类功能需求.md》v1.1 · 草稿《商品列表功能需求-草稿.md》保持不变。*
+*文档版本：v1.3 · 关联《关联需求分析.md》v1.6、《商品审核功能需求.md》v1.0、《商品分类功能需求.md》v1.5、《商品服务管理功能需求.md》v1.0.1、《店铺商品分类功能需求.md》v1.1、《属性模版功能需求.md》v1.0 · 草稿《商品列表功能需求-草稿.md》保持不变。*

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

@@ -1,7 +1,7 @@
 # 店铺商品列表 — 技术方案
 
-> **依据：** 《商品列表功能需求.md》v1.2  
-> **关联：** 《关联需求分析.md》v1.6；平台《商品审核技术方案》v1.1、《商品分类技术方案》v1.3、《商品服务管理技术方案》v1.0.1；商家《店铺商品分类技术方案》（`biz_goods_category` 本店二级）  
+> **依据：** 《商品列表功能需求.md》v1.3  
+> **关联：** 《关联需求分析.md》v1.6；平台《商品审核技术方案》v1.1、《商品分类技术方案》v1.3、《商品服务管理技术方案》v1.0.1；商家《店铺商品分类技术方案》v1.2、《属性模版技术方案》v1.2  
 > **范围：** 商家端 **当前店铺** 商品列表、检索、发品、编辑、提交上架、下架、删除；**复用** 平台商品主表与状态机，**不另建** 商家商品表。  
 > **原则：** `goods_status` 仅经 submit / audit / offShelf 变更（P17）；`X-Shop-Id` 店铺上下文；批量含非法状态 **整批失败**。
 
@@ -56,35 +56,78 @@ biz_goods_category
 | **商品分类** | `category_id` ← `IPlatformCategoryService.selectPlatformLevel2Options()` |
 | **店铺商品分类** | `shop_category_id` ← `IShopGoodsCategoryFacade.listOptionsByShopId()` |
 | **商品服务** | 发品多选 ← `IGoodsServiceFacade`；保存写快照 |
+| **属性模版** | `attr_template_id` ← 保存时 `assertAttrTemplateIfPresent`；下拉 ← `/agri/seller/attrTemplate/options` 或 `IAttrTemplateFacade` |
 | **店铺设置** | `IShopGlobalConfigFacade.getDefaultAuditPass()` 决定 submit 目标态 |
 | **订单管理** | 下架前校验 **O10 未完成订单**（**待实现**，`IGoodsOrderFacade` 占位） |
-| **店铺管理** | `IGoodsFacade.hasBlockingGoodsForShopDelete` 删店前置 |
+| **店铺管理** | `IGoodsShopFacade.hasBlockingGoodsForShopDelete`（`GoodsFacadeImpl`）删店前置 |
 
 ### 1.3 模块落位
 
+**本模块包：** `com.ruoyi.web.modules.goods`
+
 ```text
 baqing-shop/src/main/java/com/ruoyi/web/modules/goods/
-├── controller/SellerGoodsController.java      # /agri/seller/goods（本方案）
-├── controller/GoodsController.java            # 平台监管（已实现）
-├── controller/GoodsAuditController.java       # 平台审核菜单（可选薄封装）
-├── service/IGoodsService.java
-├── service/impl/GoodsServiceImpl.java
-├── domain/BizGoods.java
-├── dto/GoodsSaveDTO.java
-├── dto/GoodsBatchIdsDTO.java                  # 批量提交 / 批量删除
-├── dto/GoodsOffShelfDTO.java                  # 批量下架
-├── mapper/BizGoodsMapper.java
-├── support/GoodsSnGenerator.java
-├── support/GoodsStatusUtils.java
-├── facade/IGoodsFacade.java                   # 删店/分类删校验
+├── controller/
+│   ├── SellerGoodsController.java           # /agri/seller/goods（本方案）
+│   ├── GoodsController.java                 # /agri/goods（平台监管）
+│   └── GoodsAuditController.java            # /agri/goodsAudit（平台审核菜单薄封装）
+├── service/
+│   ├── IGoodsService.java
+│   └── impl/GoodsServiceImpl.java           # 商家 + 平台共用；注入 template 模块 Mapper 校验 attrTemplateId
+├── domain/
+│   ├── BizGoods.java
+│   └── BizGoodsServiceSnapshot.java
+├── dto/
+│   ├── GoodsSaveDTO.java
+│   ├── GoodsAuditDTO.java
+│   ├── GoodsBatchIdsDTO.java                # 批量提交 / 批量删除
+│   └── GoodsOffShelfDTO.java                # 批量下架
+├── vo/
+│   ├── GoodsListVO.java
+│   ├── GoodsDetailVO.java
+│   ├── GoodsServiceSnapshotVO.java
+│   └── GoodsPurchaseVO.java                 # C 端/采购 Facade 用
+├── mapper/
+│   ├── BizGoodsMapper.java
+│   └── BizGoodsServiceSnapshotMapper.java
+├── facade/
+│   ├── IGoodsOrderFacade.java               # 下架 O10（DefaultGoodsOrderFacade 占位）
+│   ├── IGoodsPurchaseFacade.java
+│   └── impl/
+│       ├── GoodsFacadeImpl.java             # 实现 category.IGoodsFacade、store.IGoodsShopFacade
+│       ├── DefaultGoodsOrderFacade.java
+│       ├── GoodsPurchaseFacadeImpl.java
+│       └── GoodsSnapshotFacadeImpl.java
+├── support/
+│   ├── GoodsSnGenerator.java
+│   ├── GoodsStatusUtils.java
+│   └── GoodsBatchResponseSupport.java
+├── exception/GoodsBatchOperationException.java
 └── constant/GoodsConstants.java
 
-resources/mapper/goods/BizGoodsMapper.xml
-sql/biz_goods.sql                              # 含 shop_category_id 字段
+baqing-shop/src/main/resources/mapper/goods/
+├── BizGoodsMapper.xml
+└── BizGoodsServiceSnapshotMapper.xml
+
+sql/biz_goods.sql                              # 含 shop_category_id、attr_template_id
 sql/biz_goods_service_snapshot.sql
 ```
 
-**店铺上下文（已有）：** `com.ruoyi.web.modules.store` → `SellerShopContextController`（`/agri/seller/context`）。
+**跨模块依赖（接口与实现分离）：**
+
+| 能力 | 接口位置 | 实现 / 调用 |
+|------|----------|-------------|
+| 删分类/模版/店前校验 | `category/facade/IGoodsFacade.java` | `goods/facade/impl/GoodsFacadeImpl.java` |
+| 店铺商品分类下拉 | `category/facade/IShopGoodsCategoryFacade.java` | `category/facade/impl/ShopGoodsCategoryFacadeImpl.java` |
+| 平台二级分类下拉 | `category/service/IPlatformCategoryService.java` | `SellerGoodsController` 或 `SellerPlatformCategoryController` |
+| 分类路径 | `category/facade/ICategoryFacade.java` | `CategoryFacadeImpl` |
+| 属性模版校验 | `template/mapper/BizGoodsAttrTemplateMapper.java` | `GoodsServiceImpl` 直接注入 |
+| 属性模版下拉 | `template/facade/IAttrTemplateFacade.java` | 前端亦可调 `/agri/seller/attrTemplate/options` |
+| 商品服务目录 | `goodsservice/facade/IGoodsServiceFacade.java` | 发品 `serviceOptions` |
+| 店铺上下文 | `category/support/SellerShopContext.java` | 拦截器 `SellerShopContextInterceptor` |
+| 店铺上下文 API | `store/controller/SellerShopContextController.java` | `GET /agri/seller/context` |
+
+**关联模块（并列包，非本模块源码）：** `modules/category`、`modules/template`、`modules/goodsservice`、`modules/store`。
 
 ---
 
@@ -110,6 +153,7 @@ sql/biz_goods_service_snapshot.sql
 | shop_id | bigint NOT NULL | **创建时写入当前店铺**；不可 UPDATE 换店 |
 | category_id | bigint NOT NULL | **平台二级分类**（`biz_goods_category`，`shop_id IS NULL`） |
 | shop_category_id | bigint NULL | **店铺商品分类**（`biz_goods_category` 本店二级）；可空 |
+| attr_template_id | bigint NULL | **属性模版**（`biz_goods_attr_template` 本店）；可空；删模版校验 |
 | goods_sn | varchar(32) UK | Redis 生成，全平台唯一 |
 | goods_name | varchar(200) | |
 | main_pic | varchar(512) | 主图 URL |
@@ -125,7 +169,7 @@ sql/biz_goods_service_snapshot.sql
 | del_flag | char(1) | 0 存在 2 逻辑删除 |
 | create_by / create_time / update_by / update_time | | 审计 |
 
-**首期未落库、后续扩展（需求 §8 完整表单）：** 多图、重量、条码、关键词、简述、多规格 SKU、运费模版、属性项等 → 见 §2.5，**不阻塞 v1.0 列表/单规格发品**。
+**首期未落库、后续扩展（需求 §8 完整表单）：** 多图、重量、条码、关键词、简述、多规格 SKU、运费模版、**属性/规格键值（`biz_goods_attr`）** 等 → 见 §2.5；**`attr_template_id` 引用已实现**，不阻塞 v1.0 列表/单规格发品。
 
 ### 2.3 增量 DDL
 
@@ -134,6 +178,11 @@ sql/biz_goods_service_snapshot.sql
 ALTER TABLE `biz_goods`
   ADD COLUMN `shop_category_id` bigint(20) DEFAULT NULL COMMENT '店铺商品分类ID（本店二级 biz_goods_category）' AFTER `category_id`,
   ADD KEY `idx_shop_category_id` (`shop_category_id`, `del_flag`);
+
+-- sql/biz_goods_attr_template.sql（商品侧扩展）
+ALTER TABLE `biz_goods`
+  ADD COLUMN `attr_template_id` bigint(20) DEFAULT NULL COMMENT '属性模版ID' AFTER `shop_category_id`,
+  ADD KEY `idx_attr_template_id` (`attr_template_id`, `del_flag`);
 ```
 
 完整建表见 `sql/biz_goods.sql`。
@@ -168,6 +217,7 @@ v1.0 **仅** 使用主表 `sale_price`/`stock`/`main_pic`/`detail_content`。
 | idx_shop_status | shop_id, goods_status, del_flag | 商家列表 + 状态 Tab |
 | idx_category_id | category_id, del_flag | 分类检索 |
 | idx_shop_category_id | shop_category_id, del_flag | 店铺分类删校验 |
+| idx_attr_template_id | attr_template_id, del_flag | 属性模版删校验 |
 | idx_submit_time | submit_time | 待审核排序（平台侧） |
 
 ### 2.7 商家列表 SQL 约定
@@ -215,10 +265,12 @@ WHERE g.del_flag = '0'
 |------|--------|------------|
 | `IPlatformCategoryService` | 分类 | `selectPlatformLevel2Options()` — 发品「商品分类」 |
 | `IShopGoodsCategoryFacade` | 店铺商品分类 | `listOptionsByShopId(shopId, visibleOnly)` — 「店铺商品分类」 |
+| `IAttrTemplateFacade` | 属性模版 | 发品下拉 `listOptionsByShopId`；删模版时 `IGoodsFacade.existsByAttrTemplateId` |
 | `IGoodsServiceFacade` | 商品服务 | `listAllEnabled` / `listDefaultShow`；删服务前 `existsByServiceId` |
 | `IShopGlobalConfigFacade` | 店铺设置 | `getDefaultAuditPass()` |
 | `IShopFacade` | 店铺 | 删店时 `assertShopMaintable` |
-| `IGoodsFacade` | 商品 | `hasBlockingGoodsForShopDelete`；`existsByShopCategoryId` |
+| `IGoodsFacade` | 商品 | `existsByShopCategoryId`；`existsByAttrTemplateId`（接口在 **category**，实现在 **goods**） |
+| `IGoodsShopFacade` | 商品 | `hasBlockingGoodsForShopDelete`（`GoodsFacadeImpl`） |
 | `IOrderFacade`³ | 订单 | `hasUnfinishedOrderByGoodsId(goodsId)` — 下架前置 |
 
 ³ 订单模块 Facade，下架 O10 校验 **待对接**。
@@ -284,6 +336,7 @@ WHERE g.del_flag = '0'
 |------|------|
 | 列表字段 | 同 §5.1 |
 | shopId, categoryId, shopCategoryId | |
+| attrTemplateId, attrTemplateName | 选用模版 ID 与名称（详情回显） |
 | detailContent, stock | |
 | rejectReason, submitTime, auditTime, offShelfTime | |
 | services[] | 服务快照列表 |
@@ -304,6 +357,7 @@ WHERE g.del_flag = '0'
 {
   "categoryId": 1002,
   "shopCategoryId": 2005,
+  "attrTemplateId": 4,
   "goodsName": "复合肥 50kg",
   "mainPic": "/profile/upload/2026/05/01/a.jpg",
   "detailContent": "<p>详情</p>",
@@ -317,6 +371,7 @@ WHERE g.del_flag = '0'
 |------|------|
 | categoryId | 须为 **平台二级** 有效分类 |
 | shopCategoryId | 若传，须属 **当前店** 二级分类 |
+| attrTemplateId | 若传，须属 **当前店** 有效属性模版 |
 | serviceIds | 须全部存在于未删除服务目录 |
 | goodsStatus | **禁止** 传入 |
 
@@ -404,6 +459,9 @@ WHERE g.del_flag = '0'
 | GET | `/agri/seller/goods/shopCategoryOptions` | `list` | 本店二级「店铺商品分类」`IShopGoodsCategoryFacade.listOptionsByShopId(shopId, false)` |
 | GET | `/agri/seller/category/platformLevel2Options` | 同上 | 与上同源（分类模块只读入口，可选） |
 | GET | `/agri/seller/goods/serviceOptions` | `list` | `{ all: [], defaultShow: [] }` |
+| GET | `/agri/seller/attrTemplate/options` | 属性模版模块 | 本店属性模版下拉（**非** goods 子路径；见《属性模版技术方案》§3.6） |
+
+> **规划（可选挂载）：** `GET /agri/seller/goods/attrTemplateOptions` 委托 `IAttrTemplateFacade`，与上同源。
 
 ---
 
@@ -428,8 +486,9 @@ insertSellerGoods
   → requireShopId
   → validateSaveFields + assertPlatformCategoryLevel2(categoryId)
   → assertShopCategoryIfPresent(shopCategoryId)
+  → assertAttrTemplateIfPresent(attrTemplateId)
   → goodsSn = GoodsSnGenerator.next()
-  → insert status=0
+  → insert status=0（含 attr_template_id）
   → saveServiceSnapshots
 
 submitGoods
@@ -454,6 +513,9 @@ deleteSellerGoodsBatch
 |------|----------|
 | category_id | `biz_goods_category.category_id`，`shop_id IS NULL`，`parent_id > 0` |
 | shop_category_id | `biz_goods_category.category_id`，`shop_id = #{shopId}`，`parent_id > 0` |
+| attr_template_id | `biz_goods_attr_template.template_id`，`shop_id = #{shopId}`，`del_flag = '0'` |
+
+**错误 msg（属性模版）：** 无效或非本店模版 → `请选择本店有效属性模版`（`GoodsConstants.MSG_ATTR_TEMPLATE_INVALID`）。
 
 ---
 
@@ -479,8 +541,10 @@ deleteSellerGoodsBatch
 |------|------|------|
 | **v1.0** | 列表/详情/单规格 CRUD/单独 submit·offShelf/服务快照/平台分类与服务下拉 | **已实现** |
 | **v1.0 补全** | `shop_category_id` + 店铺分类下拉 + 删除 + 批量 submit/offShelf/delete | **已实现** |
+| **v1.0 补全·模版引用** | `attr_template_id` 保存/详情回显 + 本店模版校验 | **已实现** |
 | **v1.0 补全·O10** | 下架前未完成订单校验（`IGoodsOrderFacade`） | **待实现** |
-| **v1.x** | 多图、多规格 SKU、运费、属性模版引用、关键词检索扩展 | 规划 |
+| **v1.x** | 多图、多规格 SKU、运费、`biz_goods_attr` 写入、关键词检索扩展 | 规划 |
+| **v1.x·可选** | `/agri/seller/goods/attrTemplateOptions` 挂载 | 规划 |
 
 ---
 
@@ -498,6 +562,7 @@ deleteSellerGoodsBatch
 | T8 | 删除出售中 → 失败 |
 | T9 | 跨店 goodsId → MSG_NOT_OWNER |
 | T10 | 服务快照：保存后详情与目录变更隔离 |
+| T11 | attrTemplateId：本店有效模版写入；跨店/无效 ID → 失败 |
 
 ---
 
@@ -507,7 +572,9 @@ deleteSellerGoodsBatch
 |------|------|
 | **v1.0** | 首版：商家商品列表技术方案；复用 biz_goods 与平台状态机；接口/DDL 与实现对齐并标注待办 |
 | **v1.1** | 同步代码：v1.0 补全已实现；统一平台/店铺分类口径；O10 仍标待实现 |
+| **v1.2** | 同步 `attr_template_id`：GoodsSaveDTO/详情/Mapper/校验；下拉走属性模版模块 `/options` |
+| **v1.3** | §1.3 模块落位与代码对齐：`IGoodsFacade` 跨包、`template` 依赖、快照/订单 Facade |
 
 ---
 
-*文档版本：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。*
+*文档版本：v1.3 · 关联《商品列表功能需求.md》v1.3、《商品审核技术方案.md》v1.1、《商品分类技术方案.md》v1.3、《商品服务管理技术方案.md》v1.0.1、《店铺商品分类技术方案.md》v1.2、《属性模版技术方案.md》v1.2 · 技术栈 RuoYi v3.9.2-springboot2 + MySQL 5.7.39。*

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

@@ -1,11 +1,11 @@
 # 店铺商品列表 — 测试用例
 
-> **依据：** 《商品列表功能需求.md》v1.2、《店铺商品列表技术方案.md》v1.1  
-> **关联：** 《商品审核功能需求.md》《商品分类功能需求.md》《店铺商品分类功能需求.md》v1.1、《角色管理测试用例.md》  
-> **范围：** 商家端 `/agri/seller/goods`；`GoodsServiceImpl`（商家 scope）/ `SellerGoodsController`；`IGoodsFacade` / 服务快照协作  
-> **排除：** 平台端审核/监管 UI E2E、C 端下单、多规格 SKU/运费模版完整表单、属性模版维护  
+> **依据：** 《商品列表功能需求.md》v1.3、《店铺商品列表技术方案.md》v1.2  
+> **关联：** 《商品审核功能需求.md》《商品分类功能需求.md》《店铺商品分类功能需求.md》v1.1、《属性模版功能需求.md》、《角色管理测试用例.md》  
+> **范围：** 商家端 `/agri/seller/goods`；`GoodsServiceImpl`（商家 scope）/ `SellerGoodsController`；`IGoodsFacade` / 服务快照 / 属性模版引用协作  
+> **排除：** 平台端审核/监管 UI E2E、C 端下单、多规格 SKU/运费模版完整表单、属性模版 **维护** UI、**biz_goods_attr** 明细写入  
 > **环境：** RuoYi v3.9.2-springboot2；MySQL 5.7.39；请求头 **`X-Shop-Id`** 标识当前店铺  
-> **实现分期：** v1.0 + v1.0 补全 **已实现**（含 shopCategoryId、删除、批量 submit/offShelf）；**O10 订单阻断仍待实现**
+> **实现分期：** v1.0 + v1.0 补全 **已实现**（含 shopCategoryId、attrTemplateId、删除、批量 submit/offShelf）；**O10 订单阻断仍待实现**
 
 ---
 
@@ -27,6 +27,7 @@
 | 全局配置 | `default_audit_pass=0`（关，提交上架进 **待审核**）；测试免审时临时改为 `1` |
 | 平台二级分类 | `categoryId=1002`（肥料>复合肥，`shop_id IS NULL`，level=2） |
 | 店铺商品分类 | `shopCategoryId=2005`（店内专区>热销，`shop_id=101`，level=2） |
+| 属性模版 | `attrTemplateId=4`（「手机」，`shop_id=101`）；跨店模版 `templateId=99`（`shop_id=102`） |
 | 商品服务 | `serviceId=1`（24小时发货，默认显示）、`serviceId=3`（7天退换） |
 | 店铺 101 商品 | `1001` 未上架(G001)、`1002` 待审核(G002)、`1003` 出售中(G003)、`1004` 审核失败(G004, reject=资料不全)、`1005` 已下架(G005) |
 | 跨店商品 | `1006` 未上架，**shop_id=102** |
@@ -320,6 +321,34 @@
 | **测试步骤** | insertSellerGoods(101, dto含shopCategoryId) |
 | **预期结果** | 失败；msg 提示分类无效 |
 
+### SGL-UT-024 保存写入 attrTemplateId
+
+| 要素 | 内容 |
+|------|------|
+| **用例编号** | SGL-UT-024 |
+| **测试模块** | 店铺商品列表 |
+| **测试项** | assertAttrTemplateIfPresent + insert |
+| **测试类型** | 单元测试 |
+| **测试工具** | JUnit 5 + Mockito |
+| **测试目的** | 验证 GL18：合法 attrTemplateId 写入 biz_goods |
+| **前置条件** | attrTemplateId=4 属 shop 101；categoryId=1002 有效 |
+| **测试步骤** | insertSellerGoods(101, dto含attrTemplateId=4) |
+| **预期结果** | insert 成功；BizGoods.attrTemplateId=4 |
+
+### SGL-UT-025 无效 attrTemplateId 拒绝保存
+
+| 要素 | 内容 |
+|------|------|
+| **用例编号** | SGL-UT-025 |
+| **测试模块** | 店铺商品列表 |
+| **测试项** | assertAttrTemplateIfPresent |
+| **测试类型** | 单元测试 |
+| **测试工具** | JUnit 5 + Mockito |
+| **测试目的** | 验证 GL18：跨店或不存在模版拒绝 |
+| **前置条件** | attrTemplateId=99 属 102 或不存在 |
+| **测试步骤** | insertSellerGoods(101, dto含attrTemplateId) |
+| **预期结果** | 失败；msg 含「属性模版」；不调用 insert |
+
 ### SGL-UT-021 删除可删状态成功
 
 | 要素 | 内容 |
@@ -1019,6 +1048,7 @@
 | GL9 删除状态限制 | UT-021,022 | API-020,021 | UI-016 |
 | GL10 批量整批失败 | — | API-022,023 | UI-012 |
 | GL11 分类二级/店铺分类 | UT-007,020 | API-024,026 | UI-004 |
+| GL18 属性模版引用 | UT-024,025 | — | — |
 | GL12 服务快照 | UT-018,019 | API-025 | UI-017 |
 | GL13 保存不可改态 | UT-006 | API-010 | — |
 | GL14 外部变更不级联 | — | API-028 | — |
@@ -1037,7 +1067,8 @@
 |------|------|
 | **v1.0** | 首版：23 单元 + 28 接口 + 17 UI；覆盖 GL1～GL17 及状态机/检索/权限 |
 | **v1.1** | 同步代码 v1.0 补全已实现；O10 仍标待实现；统一平台/店铺分类口径 |
+| **v1.2** | 新增 GL18 / UT-024、025：attrTemplateId 保存与校验 |
 
 ---
 
-*文档版本：v1.0 · 关联《商品列表功能需求.md》v1.1、《店铺商品列表技术方案.md》v1.0*
+*文档版本：v1.2 · 关联《商品列表功能需求.md》v1.3、《店铺商品列表技术方案.md》v1.2*

doc/店铺后台/商品管理/属性模版/属性模版功能需求.md

@@ -540,7 +540,8 @@
 | 版本 | 说明 |
 |------|------|
 | **v1.0** | 首版定稿：对齐草稿 §1～§6 及原型；关联《关联需求分析》《店铺管理》《商品列表》及平台商品相关需求 |
+| **v1.1** | 对齐商品列表协作：发品保存 `attr_template_id` 已实现（见《店铺商品列表技术方案》v1.2） |
 
 ---
 
-*文档版本：v1.0 · 关联《属性模版功能需求-草稿》· 平台侧见《关联需求分析.md》《商品分类功能需求.md》《商品服务管理功能需求.md》《商品审核功能需求.md》· 商家侧见《商品列表功能需求.md》《店铺商品分类功能需求.md》*
+*文档版本：v1.1 · 关联《属性模版功能需求-草稿》· 平台侧见《关联需求分析.md》《商品分类功能需求.md》《商品服务管理功能需求.md》《商品审核功能需求.md》· 商家侧见《商品列表功能需求.md》v1.3、《店铺商品分类功能需求.md》*

doc/店铺后台/商品管理/属性模版/属性模版技术方案.md

@@ -1,7 +1,7 @@
 # 属性模版 — 技术方案
 
 > **依据：** 《属性模版功能需求.md》v1.0  
-> **关联：** 《关联需求分析.md》v1.6；平台《商品服务管理技术方案》v1.0.1、《商品分类技术方案》v1.3、《商品审核技术方案》v1.1；商家《店铺商品列表技术方案》v1.1、《店铺商品分类技术方案》v1.1  
+> **关联：** 《关联需求分析.md》v1.6；平台《商品服务管理技术方案》v1.0.1、《商品分类技术方案》v1.3、《商品审核技术方案》v1.1；商家《店铺商品列表技术方案》v1.3、《店铺商品分类技术方案》v1.2  
 > **范围：** 商家端 **当前店铺** 属性模版 CRUD；为 **商品列表 · 属性模版** 字段提供下拉与详情预填；**平台不参与** 模版维护。  
 > **原则：** `shop_id` 店铺隔离；逻辑删除；批量删除 **整批失败**；编辑模版 **不 UPDATE** 已有商品属性/规格（快照原则）。
 
@@ -55,41 +55,62 @@ biz_goods_attr_template（shop_id = 当前店铺）
 
 ### 1.3 模块落位
 
+> **包名说明：** Java 包为 **`template`**（非 `attrtemplate`），与 URL 路径 `/attrTemplate` 区分。
+
+**本模块包：** `com.ruoyi.web.modules.template`
+
 ```text
-baqing-shop/src/main/java/com/ruoyi/web/modules/attrtemplate/
+baqing-shop/src/main/java/com/ruoyi/web/modules/template/
 ├── controller/SellerAttrTemplateController.java    # /agri/seller/attrTemplate
-├── service/IAttrTemplateService.java
-├── service/impl/AttrTemplateServiceImpl.java
-├── domain/BizGoodsAttrTemplate.java
-├── domain/BizGoodsAttrTemplateItem.java
-├── domain/BizGoodsAttrTemplateValue.java
-├── dto/AttrTemplateSaveDTO.java
-├── vo/AttrTemplateListVO.java
-├── vo/AttrTemplateDetailVO.java
-├── vo/AttrTemplateOptionVO.java
-├── mapper/BizGoodsAttrTemplateMapper.java
-├── mapper/BizGoodsAttrTemplateItemMapper.java
-├── mapper/BizGoodsAttrTemplateValueMapper.java
-├── facade/IAttrTemplateFacade.java
-├── facade/impl/AttrTemplateFacadeImpl.java
+├── service/
+│   ├── IAttrTemplateService.java
+│   └── impl/AttrTemplateServiceImpl.java
+├── domain/
+│   ├── BizGoodsAttrTemplate.java
+│   ├── BizGoodsAttrTemplateItem.java
+│   └── BizGoodsAttrTemplateValue.java
+├── dto/
+│   ├── AttrTemplateSaveDTO.java
+│   └── AttrTemplateItemDTO.java
+├── vo/
+│   ├── AttrTemplateListVO.java
+│   ├── AttrTemplateDetailVO.java
+│   └── AttrTemplateOptionVO.java
+├── mapper/
+│   ├── BizGoodsAttrTemplateMapper.java
+│   ├── BizGoodsAttrTemplateItemMapper.java
+│   └── BizGoodsAttrTemplateValueMapper.java
+├── facade/
+│   ├── IAttrTemplateFacade.java
+│   └── impl/AttrTemplateFacadeImpl.java
 ├── exception/AttrTemplateBatchDeleteException.java
 └── constant/AttrTemplateConstants.java
 
-resources/mapper/attrtemplate/*.xml
-sql/biz_goods_attr_template.sql
-sql/biz_goods_attr_template_goods.sql          # biz_goods 扩展 + biz_goods_attr
-sql/agri_seller_attr_template_menu.sql
+baqing-shop/src/main/resources/mapper/template/
+├── BizGoodsAttrTemplateMapper.xml
+├── BizGoodsAttrTemplateItemMapper.xml
+└── BizGoodsAttrTemplateValueMapper.xml
+
+sql/biz_goods_attr_template.sql                  # 模版三表 + biz_goods.attr_template_id 扩展
+sql/agri_seller_attr_template_menu.sql             # 菜单（待补）
 ```
 
 **前端页面：** `agri/seller/attrTemplate/index`（列表 + 添加/编辑弹窗，对齐原型）。
 
+**跨模块协作（商品侧）：**
+
+| 场景 | 商品模块代码 |
+|------|--------------|
+| 保存校验 `attrTemplateId` | `goods/service/impl/GoodsServiceImpl` 注入 `BizGoodsAttrTemplateMapper` |
+| 删模版引用校验 | `category/facade/IGoodsFacade.existsByAttrTemplateId` ← `goods/facade/impl/GoodsFacadeImpl` |
+
 ### 1.4 跨模块 Facade
 
 | 接口 | 提供方 | 调用方 | 方法 |
 |------|--------|--------|------|
 | **`IAttrTemplateFacade`** | **本模块** | 商品 | `listOptionsByShopId(shopId)` — 发品下拉 |
 | | | | `getDetailForGoods(templateId, shopId)` — 选用后预填 |
-| **`IGoodsFacade`** | 商品 | **本模块** | `existsByAttrTemplateId(templateId)` — 删模版前置 |
+| **`IGoodsFacade`** | 商品（`category/facade/IGoodsFacade` + `goods/facade/impl/GoodsFacadeImpl`） | **本模块** | `existsByAttrTemplateId(templateId)` — 删模版前置 |
 | **`IShopFacade`** | 店铺 | 本模块 | `assertShopMaintable` / `getShopName` |
 
 ---
@@ -386,7 +407,7 @@ INSERT 新 item/value（sort_no 按数组顺序 0,1,2…）
 |------|------|
 | 发品下拉 | `GET /options` 或 Facade |
 | 选用预填 | `GET /{templateId}` / `getDetailForGoods` |
-| 保存商品 | 写 `biz_goods.attr_template_id`；**先删后插** `biz_goods_attr`（v1.x） |
+| 保存商品 | 写 `biz_goods.attr_template_id`（**已实现**）；**先删后插** `biz_goods_attr`（v1.x） |
 | 删模版校验 | `IGoodsFacade.existsByAttrTemplateId` |
 
 **`existsByAttrTemplateId` SQL：**
@@ -520,8 +541,9 @@ buildNameList(templateId)      // 列表聚合列
 
 | 阶段 | 内容 | 状态 |
 |------|------|------|
-| **v1.0** | 模版三表 CRUD；`/options`；`IGoodsFacade.existsByAttrTemplateId`；菜单权限 | **待实现** |
-| **v1.x** | 商品列表：`attr_template_id`、`biz_goods_attr` 写入；`/goods/attrTemplateOptions` | 规划 |
+| **v1.0** | 模版三表 CRUD；`/options`；`IGoodsFacade.existsByAttrTemplateId`；菜单权限 | **已实现** |
+| **v1.0·商品协作** | 商品保存/详情 `attr_template_id`；`assertAttrTemplateIfPresent` | **已实现** |
+| **v1.x** | `biz_goods_attr` 写入；`/agri/seller/goods/attrTemplateOptions` 挂载 | 规划 |
 | **非本期** | 模版导入导出、版本历史、平台代维、与分类自动绑定 | — |
 
 ---
@@ -531,7 +553,9 @@ buildNameList(templateId)      // 列表聚合列
 | 版本 | 说明 |
 |------|------|
 | **v1.0** | 首版：三表模型；`/agri/seller/attrTemplate`；与商品列表/平台审核协作；对齐《属性模版功能需求》v1.0 |
+| **v1.1** | 同步实现：模版 CRUD + 删引用校验；商品侧 `attr_template_id` 保存/回显已实现 |
+| **v1.2** | §1.3 模块落位与代码对齐：包名 `template`、Mapper XML 路径、跨模块 Facade 说明 |
 
 ---
 
-*文档版本：v1.0 · 关联《属性模版功能需求.md》v1.0 · 技术栈 RuoYi v3.9.2-springboot2 + MySQL 5.7.39*
+*文档版本：v1.2 · 关联《属性模版功能需求.md》v1.1 · 技术栈 RuoYi v3.9.2-springboot2 + MySQL 5.7.39*

doc/店铺后台/商品管理/属性模版/属性模版测试用例.md

@@ -968,7 +968,8 @@
 | 版本 | 说明 |
 |------|------|
 | **v1.0** | 首版：28 单元 + 19 接口 + 17 UI；覆盖 AT1～AT12 及正常/异常/协作流程 |
+| **v1.1** | 商品协作：`attr_template_id` 保存/回显已实现；`biz_goods_attr` 仍标 v1.x |
 
 ---
 
-*文档版本：v1.0 · 关联《属性模版功能需求.md》v1.0、《属性模版技术方案.md》v1.0*
+*文档版本：v1.1 · 关联《属性模版功能需求.md》v1.1、《属性模版技术方案.md》v1.1*

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

@@ -33,23 +33,55 @@
 
 ### 1.2 模块落位
 
+> **说明：** 平台分类与店铺商品分类 **共用** `category` 包；本方案 CRUD 入口为 `SellerShopGoodsCategoryController`。
+
+**本模块包：** `com.ruoyi.web.modules.category`（店铺分类相关子集）
+
 ```text
 baqing-shop/src/main/java/com/ruoyi/web/modules/category/
-├── controller/SellerShopGoodsCategoryController.java   # /agri/seller/shopCategory
-├── controller/SellerPlatformCategoryController.java  # /agri/seller/category（平台分类只读，非本模块 CRUD）
-├── controller/PlatformCategoryController.java        # /agri/category（平台商品分类 CRUD）
-├── service/IShopGoodsCategoryService.java
-├── service/impl/CategoryServiceImpl.java               # 平台 + 店铺分类共用实现
+├── controller/
+│   ├── SellerShopGoodsCategoryController.java    # /agri/seller/shopCategory（本方案 CRUD）
+│   ├── SellerPlatformCategoryController.java     # /agri/seller/category（平台分类只读）
+│   └── PlatformCategoryController.java           # /agri/category（平台商品分类 CRUD）
+├── service/
+│   ├── IShopGoodsCategoryService.java              # 店铺商品分类 Service 接口
+│   ├── ICategoryService.java                       # 平台分类 Service 接口
+│   ├── IPlatformCategoryService.java               # 平台二级下拉
+│   └── impl/CategoryServiceImpl.java               # 平台 + 店铺分类共用实现
 ├── domain/BizGoodsCategory.java
 ├── mapper/BizGoodsCategoryMapper.java
-├── facade/ShopGoodsCategoryFacadeImpl.java             # IShopGoodsCategoryFacade
-└── vo/CategoryRowVO、CategoryTreeVO、CategoryLevel2OptionVO 等
-
-resources/mapper/category/BizGoodsCategoryMapper.xml
+├── facade/
+│   ├── IShopGoodsCategoryFacade.java
+│   ├── ICategoryFacade.java                        # 分类路径（商品详情 join）
+│   ├── IGoodsFacade.java                           # 删分类前商品引用校验（实现在 goods 模块）
+│   ├── IShopFacade.java
+│   └── impl/
+│       ├── ShopGoodsCategoryFacadeImpl.java        # IShopGoodsCategoryFacade 实现
+│       ├── CategoryFacadeImpl.java
+│       ├── DefaultShopFacade.java
+│       └── DefaultGoodsFacade.java                 # IGoodsFacade 占位（可被 GoodsFacadeImpl 覆盖）
+├── support/
+│   ├── SellerShopContext.java
+│   └── SellerShopContextInterceptor.java           # X-Shop-Id 拦截
+├── config/CategoryWebConfig.java                   # 注册店铺上下文拦截器
+├── exception/CategoryBatchDeleteException.java
+├── constant/CategoryConstants.java
+└── vo/
+    ├── CategoryRowVO.java、CategoryTreeVO.java、CategoryLevel2OptionVO.java
+    └── ShopGoodsCategoryOptionVO.java              # 商品发品下拉
+
+baqing-shop/src/main/resources/mapper/category/BizGoodsCategoryMapper.xml
 sql/biz_goods_category.sql
 sql/agri_seller_shop_category_menu.sql
 ```
 
+**关联包（非本模块 CRUD，但协作）：**
+
+| 包 | 协作 |
+|----|------|
+| `modules/goods` | `GoodsFacadeImpl` 实现 `IGoodsFacade.existsByShopCategoryId` |
+| `modules/store` | `SellerShopContextController` — `GET /agri/seller/context` |
+
 **前端页面：** `agri/seller/shopCategory/index`
 
 ### 1.3 关联协作链
@@ -412,7 +444,8 @@ logicDeleteByIds()
 |------|------|
 | **v1.0** | 首版：独立表 `biz_shop_goods_category` 单层方案（已废弃） |
 | **v1.1** | **与实现对齐**：复用 `biz_goods_category`（`shop_id` 非空）；两级结构；`/agri/seller/shopCategory`；批量删除；商品挂二级 |
+| **v1.2** | §1.2 模块落位与代码对齐：Facade 在 `impl/`、店铺上下文 support、跨包 `IGoodsFacade` |
 
 ---
 
-*文档版本：v1.1 · 关联《店铺商品分类功能需求.md》v1.1 · 技术栈 RuoYi v3.9.2-springboot2 + MySQL 5.7.39。*
+*文档版本：v1.2 · 关联《店铺商品分类功能需求.md》v1.1 · 技术栈 RuoYi v3.9.2-springboot2 + MySQL 5.7.39。*