会员管理代码

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

@@ -53,6 +53,16 @@ public final class GoodsConstants
 
     public static final String MSG_ATTR_TEMPLATE_INVALID = "请选择本店有效属性模版";
 
+    public static final String MSG_ATTR_ITEM_NAME_REQUIRED = "请输入属性项/规格项名称";
+
+    public static final String MSG_ATTR_ITEM_NAME_DUPLICATE = "属性项/规格项名称不可重复";
+
+    public static final String MSG_ATTR_CROSS_ITEM_NAME = "属性项与规格项名称不可相同";
+
+    public static final String MSG_ATTR_VALUE_REQUIRED = "请为每项至少添加一个属性值/规格值";
+
+    public static final String MSG_ATTR_VALUE_DUPLICATE = "同一项下属性值/规格值不可重复";
+
     public static final String MSG_DELETE_INVALID = "当前状态不可删除";
 
     public static final String MSG_UNFINISHED_ORDER = "该商品存在未完成订单，无法下架";

baqing-shop/src/main/java/com/ruoyi/web/modules/goods/controller/SellerGoodsController.java

@@ -28,6 +28,8 @@ import com.ruoyi.web.modules.goods.dto.GoodsOffShelfDTO;
 import com.ruoyi.web.modules.goods.dto.GoodsSaveDTO;
 import com.ruoyi.web.modules.goods.exception.GoodsBatchOperationException;
 import com.ruoyi.web.modules.goods.service.IGoodsService;
+import com.ruoyi.web.modules.template.facade.IAttrTemplateFacade;
+import com.ruoyi.web.modules.template.vo.AttrTemplateDetailVO;
 
 /**
  * 商家端商品管理
@@ -48,6 +50,9 @@ public class SellerGoodsController extends BaseController
     @Autowired
     private IGoodsServiceFacade goodsServiceFacade;
 
+    @Autowired
+    private IAttrTemplateFacade attrTemplateFacade;
+
     @PreAuthorize("@ss.hasPermi('agri:seller:goods:list')")
     @GetMapping("/list")
     public TableDataInfo list(BizGoods query)
@@ -81,6 +86,26 @@ public class SellerGoodsController extends BaseController
         return success(data);
     }
 
+    @PreAuthorize("@ss.hasPermi('agri:seller:goods:list') or @ss.hasPermi('agri:seller:goods:add') or @ss.hasPermi('agri:seller:goods:edit')")
+    @GetMapping("/attrTemplateOptions")
+    public AjaxResult attrTemplateOptions()
+    {
+        return success(attrTemplateFacade.listOptionsByShopId(SellerShopContext.getShopId()));
+    }
+
+    @PreAuthorize("@ss.hasPermi('agri:seller:goods:list') or @ss.hasPermi('agri:seller:goods:add') or @ss.hasPermi('agri:seller:goods:edit')")
+    @GetMapping("/attrTemplate/{templateId}")
+    public AjaxResult attrTemplateDetail(@PathVariable("templateId") Long templateId)
+    {
+        AttrTemplateDetailVO detail = attrTemplateFacade.getDetailForGoods(templateId, SellerShopContext.getShopId());
+        Map<String, Object> data = new HashMap<>();
+        data.put("templateId", detail.getTemplateId());
+        data.put("templateName", detail.getTemplateName());
+        data.put("attributes", detail.getAttributes());
+        data.put("specs", detail.getSpecs());
+        return success(data);
+    }
+
     @PreAuthorize("@ss.hasPermi('agri:seller:goods:query')")
     @GetMapping("/{goodsId}")
     public AjaxResult getInfo(@PathVariable("goodsId") Long goodsId)

baqing-shop/src/main/java/com/ruoyi/web/modules/goods/dto/GoodsSaveDTO.java

@@ -30,6 +30,12 @@ public class GoodsSaveDTO
 
     private List<Long> serviceIds;
 
+    /** 商品属性项（可选；选用模版后可修改） */
+    private List<GoodsAttrItemDTO> attributes;
+
+    /** 商品规格项（可选；选用模版后可修改） */
+    private List<GoodsAttrItemDTO> specs;
+
     /** 禁止通过保存接口修改，传入则拒收 */
     private String goodsStatus;
 
@@ -133,6 +139,26 @@ public class GoodsSaveDTO
         this.serviceIds = serviceIds;
     }
 
+    public List<GoodsAttrItemDTO> getAttributes()
+    {
+        return attributes;
+    }
+
+    public void setAttributes(List<GoodsAttrItemDTO> attributes)
+    {
+        this.attributes = attributes;
+    }
+
+    public List<GoodsAttrItemDTO> getSpecs()
+    {
+        return specs;
+    }
+
+    public void setSpecs(List<GoodsAttrItemDTO> specs)
+    {
+        this.specs = specs;
+    }
+
     public String getGoodsStatus()
     {
         return goodsStatus;

baqing-shop/src/main/java/com/ruoyi/web/modules/goods/service/impl/GoodsServiceImpl.java

@@ -23,16 +23,20 @@ import com.ruoyi.web.modules.goodsservice.facade.IGoodsServiceFacade;
 import com.ruoyi.web.modules.goodsservice.mapper.BizGoodsServiceMapper;
 import com.ruoyi.web.modules.goods.constant.GoodsConstants;
 import com.ruoyi.web.modules.goods.domain.BizGoods;
+import com.ruoyi.web.modules.goods.domain.BizGoodsAttr;
 import com.ruoyi.web.modules.goods.domain.BizGoodsServiceSnapshot;
 import com.ruoyi.web.modules.goods.dto.GoodsAuditDTO;
+import com.ruoyi.web.modules.goods.dto.GoodsAttrItemDTO;
 import com.ruoyi.web.modules.goods.dto.GoodsBatchIdsDTO;
 import com.ruoyi.web.modules.goods.dto.GoodsOffShelfDTO;
 import com.ruoyi.web.modules.goods.dto.GoodsSaveDTO;
 import com.ruoyi.web.modules.goods.exception.GoodsBatchOperationException;
 import com.ruoyi.web.modules.goods.facade.IGoodsOrderFacade;
+import com.ruoyi.web.modules.goods.mapper.BizGoodsAttrMapper;
 import com.ruoyi.web.modules.goods.mapper.BizGoodsMapper;
 import com.ruoyi.web.modules.goods.mapper.BizGoodsServiceSnapshotMapper;
 import com.ruoyi.web.modules.goods.service.IGoodsService;
+import com.ruoyi.web.modules.goods.support.GoodsAttrSupport;
 import com.ruoyi.web.modules.goods.support.GoodsSnGenerator;
 import com.ruoyi.web.modules.goods.support.GoodsStatusUtils;
 import com.ruoyi.web.modules.goods.vo.GoodsDetailVO;
@@ -45,6 +49,7 @@ import com.ruoyi.web.modules.store.constant.ShopConstants;
 import com.ruoyi.web.modules.store.domain.BizShop;
 import com.ruoyi.web.modules.store.facade.IShopGlobalConfigFacade;
 import com.ruoyi.web.modules.store.mapper.BizShopMapper;
+import com.ruoyi.web.modules.template.constant.AttrTemplateConstants;
 import com.ruoyi.web.modules.template.domain.BizGoodsAttrTemplate;
 import com.ruoyi.web.modules.template.mapper.BizGoodsAttrTemplateMapper;
 
@@ -87,6 +92,9 @@ public class GoodsServiceImpl implements IGoodsService
     @Autowired
     private BizGoodsAttrTemplateMapper attrTemplateMapper;
 
+    @Autowired
+    private BizGoodsAttrMapper goodsAttrMapper;
+
     @Override
     public List<GoodsListVO> selectPlatformList(BizGoods query)
     {
@@ -150,6 +158,7 @@ public class GoodsServiceImpl implements IGoodsService
         goods.setCreateBy(operator);
         goodsMapper.insert(goods);
         saveServiceSnapshots(goods.getGoodsId(), dto.getServiceIds());
+        saveGoodsAttrs(goods.getGoodsId(), dto.getAttributes(), dto.getSpecs());
         return goods.getGoodsId();
     }
 
@@ -176,6 +185,7 @@ public class GoodsServiceImpl implements IGoodsService
         update.setUpdateBy(operator);
         goodsMapper.updateSeller(update);
         saveServiceSnapshots(dto.getGoodsId(), dto.getServiceIds());
+        saveGoodsAttrs(dto.getGoodsId(), dto.getAttributes(), dto.getSpecs());
     }
 
     @Override
@@ -357,6 +367,7 @@ public class GoodsServiceImpl implements IGoodsService
         for (Long goodsId : dto.getGoodsIds())
         {
             snapshotMapper.deleteByGoodsId(goodsId);
+            goodsAttrMapper.deleteByGoodsId(goodsId);
         }
     }
 
@@ -444,6 +455,9 @@ public class GoodsServiceImpl implements IGoodsService
         vo.setCanEdit(true);
         List<GoodsServiceSnapshotVO> services = snapshotMapper.selectVisibleByGoodsId(goods.getGoodsId());
         vo.setServices(services);
+        List<BizGoodsAttr> attrRows = goodsAttrMapper.selectByGoodsId(goods.getGoodsId());
+        vo.setAttributes(GoodsAttrSupport.groupByItem(attrRows, AttrTemplateConstants.ITEM_TYPE_ATTR));
+        vo.setSpecs(GoodsAttrSupport.groupByItem(attrRows, AttrTemplateConstants.ITEM_TYPE_SPEC));
         if (platform)
         {
             fillShopMerchantName(vo, goods.getShopId());
@@ -524,6 +538,20 @@ public class GoodsServiceImpl implements IGoodsService
         }
     }
 
+    private void saveGoodsAttrs(Long goodsId, List<GoodsAttrItemDTO> attributes, List<GoodsAttrItemDTO> specs)
+    {
+        goodsAttrMapper.deleteByGoodsId(goodsId);
+        if ((attributes == null || attributes.isEmpty()) && (specs == null || specs.isEmpty()))
+        {
+            return;
+        }
+        List<BizGoodsAttr> rows = GoodsAttrSupport.flatten(goodsId, attributes, specs);
+        if (!rows.isEmpty())
+        {
+            goodsAttrMapper.batchInsert(rows);
+        }
+    }
+
     private BizGoods buildGoodsFromDto(GoodsSaveDTO dto)
     {
         BizGoods goods = new BizGoods();

baqing-shop/src/main/java/com/ruoyi/web/modules/goods/vo/GoodsDetailVO.java

@@ -4,6 +4,7 @@ import java.math.BigDecimal;
 import java.util.ArrayList;
 import java.util.Date;
 import java.util.List;
+import com.ruoyi.web.modules.goods.dto.GoodsAttrItemDTO;
 
 /**
  * 商品详情
@@ -44,6 +45,10 @@ public class GoodsDetailVO extends GoodsListVO
 
     private List<GoodsServiceSnapshotVO> services = new ArrayList<>();
 
+    private List<GoodsAttrItemDTO> attributes = new ArrayList<>();
+
+    private List<GoodsAttrItemDTO> specs = new ArrayList<>();
+
     public Long getShopId()
     {
         return shopId;
@@ -213,4 +218,24 @@ public class GoodsDetailVO extends GoodsListVO
     {
         this.services = services;
     }
+
+    public List<GoodsAttrItemDTO> getAttributes()
+    {
+        return attributes;
+    }
+
+    public void setAttributes(List<GoodsAttrItemDTO> attributes)
+    {
+        this.attributes = attributes;
+    }
+
+    public List<GoodsAttrItemDTO> getSpecs()
+    {
+        return specs;
+    }
+
+    public void setSpecs(List<GoodsAttrItemDTO> specs)
+    {
+        this.specs = specs;
+    }
 }

baqing-shop/src/test/java/com/ruoyi/web/modules/goods/controller/SellerGoodsControllerTest.java

@@ -42,6 +42,10 @@ import com.ruoyi.web.modules.goods.exception.GoodsBatchOperationException;
 import com.ruoyi.web.modules.goods.service.IGoodsService;
 import com.ruoyi.web.modules.goods.vo.GoodsDetailVO;
 import com.ruoyi.web.modules.goods.vo.GoodsListVO;
+import com.ruoyi.web.modules.template.dto.AttrTemplateItemDTO;
+import com.ruoyi.web.modules.template.facade.IAttrTemplateFacade;
+import com.ruoyi.web.modules.template.vo.AttrTemplateDetailVO;
+import com.ruoyi.web.modules.template.vo.AttrTemplateOptionVO;
 
 @ExtendWith(MockitoExtension.class)
 class SellerGoodsControllerTest
@@ -58,6 +62,9 @@ class SellerGoodsControllerTest
     @Mock
     private IGoodsServiceFacade goodsServiceFacade;
 
+    @Mock
+    private IAttrTemplateFacade attrTemplateFacade;
+
     @Spy
     @InjectMocks
     private SellerGoodsController controller;
@@ -195,6 +202,40 @@ class SellerGoodsControllerTest
                 .andExpect(jsonPath("$.data[0].label").value("肥料 > 复合肥"));
     }
 
+    @Test
+    void attrTemplateDetail_returnsPrefillData() throws Exception
+    {
+        AttrTemplateItemDTO attr = new AttrTemplateItemDTO();
+        attr.setItemName("品牌");
+        attr.setValues(Collections.singletonList("华为"));
+        AttrTemplateDetailVO detail = new AttrTemplateDetailVO();
+        detail.setTemplateId(4L);
+        detail.setTemplateName("手机");
+        detail.setAttributes(Collections.singletonList(attr));
+        detail.setSpecs(Collections.emptyList());
+        when(attrTemplateFacade.getDetailForGoods(4L, 101L)).thenReturn(detail);
+
+        mockMvc.perform(get("/agri/seller/goods/attrTemplate/4"))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.code").value(200))
+                .andExpect(jsonPath("$.data.templateName").value("手机"))
+                .andExpect(jsonPath("$.data.attributes[0].itemName").value("品牌"));
+    }
+
+    @Test
+    void attrTemplateOptions_returnsList() throws Exception
+    {
+        AttrTemplateOptionVO option = new AttrTemplateOptionVO();
+        option.setTemplateId(4L);
+        option.setTemplateName("手机");
+        when(attrTemplateFacade.listOptionsByShopId(101L)).thenReturn(Collections.singletonList(option));
+
+        mockMvc.perform(get("/agri/seller/goods/attrTemplateOptions"))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.code").value(200))
+                .andExpect(jsonPath("$.data[0].templateName").value("手机"));
+    }
+
     private GoodsSaveDTO buildSaveDto()
     {
         GoodsSaveDTO dto = new GoodsSaveDTO();

baqing-shop/src/test/java/com/ruoyi/web/modules/goods/service/GoodsServiceImplTest.java

@@ -29,11 +29,13 @@ import com.ruoyi.web.modules.goodsservice.mapper.BizGoodsServiceMapper;
 import com.ruoyi.web.modules.goods.constant.GoodsConstants;
 import com.ruoyi.web.modules.goods.domain.BizGoods;
 import com.ruoyi.web.modules.goods.dto.GoodsAuditDTO;
+import com.ruoyi.web.modules.goods.dto.GoodsAttrItemDTO;
 import com.ruoyi.web.modules.goods.dto.GoodsBatchIdsDTO;
 import com.ruoyi.web.modules.goods.dto.GoodsOffShelfDTO;
 import com.ruoyi.web.modules.goods.dto.GoodsSaveDTO;
 import com.ruoyi.web.modules.goods.exception.GoodsBatchOperationException;
 import com.ruoyi.web.modules.goods.facade.IGoodsOrderFacade;
+import com.ruoyi.web.modules.goods.mapper.BizGoodsAttrMapper;
 import com.ruoyi.web.modules.goods.mapper.BizGoodsMapper;
 import com.ruoyi.web.modules.goods.mapper.BizGoodsServiceSnapshotMapper;
 import com.ruoyi.web.modules.goods.service.impl.GoodsServiceImpl;
@@ -85,6 +87,9 @@ class GoodsServiceImplTest
     @Mock
     private BizGoodsAttrTemplateMapper attrTemplateMapper;
 
+    @Mock
+    private BizGoodsAttrMapper goodsAttrMapper;
+
     @InjectMocks
     private GoodsServiceImpl goodsService;
 
@@ -439,6 +444,42 @@ class GoodsServiceImplTest
         verify(goodsMapper, never()).insert(any());
     }
 
+    @Test
+    void insert_withAttributes_persistsGoodsAttrRows()
+    {
+        when(goodsSnGenerator.nextSn()).thenReturn("G20260526000004");
+        BizGoodsCategory platformCat = new BizGoodsCategory();
+        platformCat.setCategoryLevel(CategoryConstants.LEVEL_TWO);
+        when(categoryMapper.selectById(100L, null)).thenReturn(platformCat);
+        when(goodsMapper.insert(any())).thenAnswer(inv -> {
+            BizGoods g = inv.getArgument(0);
+            g.setGoodsId(102L);
+            return 1;
+        });
+
+        GoodsAttrItemDTO attr = new GoodsAttrItemDTO();
+        attr.setItemName("品牌");
+        attr.setValues(Collections.singletonList("华为"));
+        GoodsAttrItemDTO spec = new GoodsAttrItemDTO();
+        spec.setItemName("内存");
+        spec.setValues(Arrays.asList("8G", "16G"));
+
+        GoodsSaveDTO dto = new GoodsSaveDTO();
+        dto.setCategoryId(100L);
+        dto.setGoodsName("手机");
+        dto.setMainPic("/a.jpg");
+        dto.setDetailContent("detail");
+        dto.setSalePrice(new BigDecimal("1999"));
+        dto.setStock(10);
+        dto.setAttributes(Collections.singletonList(attr));
+        dto.setSpecs(Collections.singletonList(spec));
+
+        goodsService.insertSellerGoods(10L, dto, "seller");
+
+        verify(goodsAttrMapper).deleteByGoodsId(102L);
+        verify(goodsAttrMapper).batchInsert(any());
+    }
+
     @Test
     void delete_draft_success()
     {
@@ -450,6 +491,7 @@ class GoodsServiceImplTest
 
         verify(goodsMapper).logicDeleteByIds(any(), eq(10L), eq("seller"));
         verify(snapshotMapper).deleteByGoodsId(7L);
+        verify(goodsAttrMapper).deleteByGoodsId(7L);
     }
 
     @Test

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

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

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

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

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

@@ -1,7 +1,7 @@
 # 店铺商品列表 — 技术方案
 
-> **依据：** 《商品列表功能需求.md》v1.3  
-> **关联：** 《关联需求分析.md》v1.6；平台《商品审核技术方案》v1.1、《商品分类技术方案》v1.3、《商品服务管理技术方案》v1.0.1；商家《店铺商品分类技术方案》v1.2、《属性模版技术方案》v1.2  
+> **依据：** 《商品列表功能需求.md》v1.4  
+> **关联：** 《关联需求分析.md》v1.6；平台《商品审核技术方案》v1.1、《商品分类技术方案》v1.3、《商品服务管理技术方案》v1.0.1；商家《店铺商品分类技术方案》v1.2、《属性模版技术方案》v1.3  
 > **范围：** 商家端 **当前店铺** 商品列表、检索、发品、编辑、提交上架、下架、删除；**复用** 平台商品主表与状态机，**不另建** 商家商品表。  
 > **原则：** `goods_status` 仅经 submit / audit / offShelf 变更（P17）；`X-Shop-Id` 店铺上下文；批量含非法状态 **整批失败**。
 
@@ -56,7 +56,7 @@ biz_goods_category
 | **商品分类** | `category_id` ← `IPlatformCategoryService.selectPlatformLevel2Options()` |
 | **店铺商品分类** | `shop_category_id` ← `IShopGoodsCategoryFacade.listOptionsByShopId()` |
 | **商品服务** | 发品多选 ← `IGoodsServiceFacade`；保存写快照 |
-| **属性模版** | `attr_template_id` ← 保存时 `assertAttrTemplateIfPresent`；下拉 ← `/agri/seller/attrTemplate/options` 或 `IAttrTemplateFacade` |
+| **属性模版** | 选用模版预填 `attributes`/`specs`；保存 `attr_template_id` + **先删后插** `biz_goods_attr` |
 | **店铺设置** | `IShopGlobalConfigFacade.getDefaultAuditPass()` 决定 submit 目标态 |
 | **订单管理** | 下架前校验 **O10 未完成订单**（**待实现**，`IGoodsOrderFacade` 占位） |
 | **店铺管理** | `IGoodsShopFacade.hasBlockingGoodsForShopDelete`（`GoodsFacadeImpl`）删店前置 |
@@ -73,12 +73,14 @@ baqing-shop/src/main/java/com/ruoyi/web/modules/goods/
 │   └── GoodsAuditController.java            # /agri/goodsAudit（平台审核菜单薄封装）
 ├── service/
 │   ├── IGoodsService.java
-│   └── impl/GoodsServiceImpl.java           # 商家 + 平台共用；注入 template 模块 Mapper 校验 attrTemplateId
+│   └── impl/GoodsServiceImpl.java           # saveServiceSnapshots + saveGoodsAttrs
 ├── domain/
 │   ├── BizGoods.java
-│   └── BizGoodsServiceSnapshot.java
+│   ├── BizGoodsServiceSnapshot.java
+│   └── BizGoodsAttr.java
 ├── dto/
 │   ├── GoodsSaveDTO.java
+│   ├── GoodsAttrItemDTO.java                # attributes[] / specs[] 项
 │   ├── GoodsAuditDTO.java
 │   ├── GoodsBatchIdsDTO.java                # 批量提交 / 批量删除
 │   └── GoodsOffShelfDTO.java                # 批量下架
@@ -89,7 +91,8 @@ baqing-shop/src/main/java/com/ruoyi/web/modules/goods/
 │   └── GoodsPurchaseVO.java                 # C 端/采购 Facade 用
 ├── mapper/
 │   ├── BizGoodsMapper.java
-│   └── BizGoodsServiceSnapshotMapper.java
+│   ├── BizGoodsServiceSnapshotMapper.java
+│   └── BizGoodsAttrMapper.java
 ├── facade/
 │   ├── IGoodsOrderFacade.java               # 下架 O10（DefaultGoodsOrderFacade 占位）
 │   ├── IGoodsPurchaseFacade.java
@@ -101,16 +104,19 @@ baqing-shop/src/main/java/com/ruoyi/web/modules/goods/
 ├── support/
 │   ├── GoodsSnGenerator.java
 │   ├── GoodsStatusUtils.java
+│   ├── GoodsAttrSupport.java                # 属性/规格校验与扁平化/聚合
 │   └── GoodsBatchResponseSupport.java
 ├── exception/GoodsBatchOperationException.java
 └── constant/GoodsConstants.java
 
 baqing-shop/src/main/resources/mapper/goods/
 ├── BizGoodsMapper.xml
-└── BizGoodsServiceSnapshotMapper.xml
+├── BizGoodsServiceSnapshotMapper.xml
+└── BizGoodsAttrMapper.xml
 
 sql/biz_goods.sql                              # 含 shop_category_id、attr_template_id
 sql/biz_goods_service_snapshot.sql
+sql/biz_goods_attr.sql
 ```
 
 **跨模块依赖（接口与实现分离）：**
@@ -121,8 +127,7 @@ sql/biz_goods_service_snapshot.sql
 | 店铺商品分类下拉 | `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` |
+| 属性模版校验/预填 | `template/facade/IAttrTemplateFacade.java` | `SellerGoodsController` `/attrTemplateOptions`、`/attrTemplate/{id}`；亦可调 `/agri/seller/attrTemplate/*` |
 | 商品服务目录 | `goodsservice/facade/IGoodsServiceFacade.java` | 发品 `serviceOptions` |
 | 店铺上下文 | `category/support/SellerShopContext.java` | 拦截器 `SellerShopContextInterceptor` |
 | 店铺上下文 API | `store/controller/SellerShopContextController.java` | `GET /agri/seller/context` |
@@ -139,6 +144,7 @@ sql/biz_goods_service_snapshot.sql
 |------|------------|
 | **`biz_goods`** | 商品主表；商家 CRUD + 状态字段 |
 | **`biz_goods_service_snapshot`** | 发品勾选服务的 **展示快照** |
+| **`biz_goods_attr`** | 发品属性/规格 **展示快照**（选用模版后可改） |
 | `biz_goods_category` | join 分类路径；**不** 由本模块维护 |
 | `biz_shop` | 店铺上下文、删店 join |
 | `biz_shop_global_config` | 全局默认审核开关 |
@@ -169,7 +175,7 @@ sql/biz_goods_service_snapshot.sql
 | del_flag | char(1) | 0 存在 2 逻辑删除 |
 | create_by / create_time / update_by / update_time | | 审计 |
 
-**首期未落库、后续扩展（需求 §8 完整表单）：** 多图、重量、条码、关键词、简述、多规格 SKU、运费模版、**属性/规格键值（`biz_goods_attr`）** 等 → 见 §2.5；**`attr_template_id` 引用已实现**，不阻塞 v1.0 列表/单规格发品。
+**首期未落库、后续扩展（需求 §8 完整表单）：** 多图、重量、条码、关键词、简述、多规格 SKU、运费模版等 → 见 §2.5；**`attr_template_id` + `biz_goods_attr` 已实现**。
 
 ### 2.3 增量 DDL
 
@@ -187,7 +193,20 @@ ALTER TABLE `biz_goods`
 
 完整建表见 `sql/biz_goods.sql`。
 
-### 2.4 `biz_goods_service_snapshot`
+### 2.4 `biz_goods_attr`
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| attr_id | bigint PK | |
+| goods_id | bigint NOT NULL | 商品 ID |
+| attr_type | char(1) | **1** 属性项 **2** 规格项 |
+| item_name | varchar(64) | 项名称 |
+| value_text | varchar(128) | 单值一行；多项多行 |
+| sort_no | int | 展示顺序 |
+
+保存商品时 **先删后插** 该商品全部属性行；删除商品时物理删除关联行。模版编辑 **不追溯** 已保存商品（AT8）。
+
+### 2.5 `biz_goods_service_snapshot`
 
 | 字段 | 说明 |
 |------|------|
@@ -198,18 +217,17 @@ ALTER TABLE `biz_goods`
 
 保存商品时 **先删后插** 该商品全部快照行。
 
-### 2.5 扩展表（非 v1.0 · 概要）
+### 2.6 扩展表（非 v1.0 · 概要）
 
 | 表（规划） | 用途 |
 |------------|------|
 | `biz_goods_pic` | 多图 gallery |
 | `biz_goods_sku` | 多规格 SKU（市场价、库存） |
 | `biz_goods_freight` | 固定运费 / 运费模版 ID |
-| `biz_goods_attr` | 属性项/规格项键值 |
 
-v1.0 **仅** 使用主表 `sale_price`/`stock`/`main_pic`/`detail_content`。
+v1.0 **使用** 主表 `sale_price`/`stock`/`main_pic`/`detail_content` + 服务快照 + **属性/规格快照**。
 
-### 2.6 索引
+### 2.7 索引
 
 | 索引 | 字段 | 用途 |
 |------|------|------|
@@ -218,9 +236,10 @@ v1.0 **仅** 使用主表 `sale_price`/`stock`/`main_pic`/`detail_content`。
 | 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_goods_attr | goods_id, attr_type, sort_no | 详情聚合属性/规格 |
 | idx_submit_time | submit_time | 待审核排序（平台侧） |
 
-### 2.7 商家列表 SQL 约定
+### 2.8 商家列表 SQL 约定
 
 ```sql
 WHERE g.del_flag = '0'
@@ -228,7 +247,7 @@ WHERE g.del_flag = '0'
   -- 含 goods_status='0'，与平台列表不同
 ```
 
-### 2.8 字典
+### 2.9 字典
 
 | dict_type | 说明 |
 |-----------|------|
@@ -337,6 +356,7 @@ WHERE g.del_flag = '0'
 | 列表字段 | 同 §5.1 |
 | shopId, categoryId, shopCategoryId | |
 | attrTemplateId, attrTemplateName | 选用模版 ID 与名称（详情回显） |
+| attributes[], specs[] | 属性/规格快照（`GoodsAttrItemDTO`：`itemName` + `values[]`） |
 | detailContent, stock | |
 | rejectReason, submitTime, auditTime, offShelfTime | |
 | services[] | 服务快照列表 |
@@ -351,7 +371,7 @@ WHERE g.del_flag = '0'
 | 权限 | `agri:seller:goods:add` |
 | 日志 | title=商家商品 |
 
-**Body（GoodsSaveDTO · v1.0）：**
+**Body（GoodsSaveDTO）：**
 
 ```json
 {
@@ -363,7 +383,13 @@ WHERE g.del_flag = '0'
   "detailContent": "<p>详情</p>",
   "salePrice": 128.00,
   "stock": 500,
-  "serviceIds": [1, 3]
+  "serviceIds": [1, 3],
+  "attributes": [
+    { "itemName": "品牌", "values": ["华为"] }
+  ],
+  "specs": [
+    { "itemName": "内存", "values": ["8G", "16G"] }
+  ]
 }
 ```
 
@@ -372,6 +398,7 @@ WHERE g.del_flag = '0'
 | categoryId | 须为 **平台二级** 有效分类 |
 | shopCategoryId | 若传，须属 **当前店** 二级分类 |
 | attrTemplateId | 若传，须属 **当前店** 有效属性模版 |
+| attributes / specs | 可选；若传则项名非空、每项至少一值、同段项名/值不重复、属性与规格项名不可相同 |
 | serviceIds | 须全部存在于未删除服务目录 |
 | goodsStatus | **禁止** 传入 |
 
@@ -387,7 +414,7 @@ WHERE g.del_flag = '0'
 | Body | 同 §5.3 + **goodsId** 必填 |
 
 - **不修改** `goods_status`、`shop_id`、`goods_sn`。  
-- 各状态均可编辑（P14）；保存后刷新服务快照。
+- 各状态均可编辑（P14）；保存后刷新服务快照与 **属性/规格快照**。
 
 ---
 
@@ -459,9 +486,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`，与上同源。
+| GET | `/agri/seller/goods/attrTemplateOptions` | `list` / `add` / `edit` | 本店属性模版下拉；委托 `IAttrTemplateFacade.listOptionsByShopId` |
+| GET | `/agri/seller/goods/attrTemplate/{templateId}` | 同上 | 选用模版预填；返回 `attributes`、`specs`（委托 `getDetailForGoods`） |
+| GET | `/agri/seller/attrTemplate/options` | 属性模版模块 | 与 `attrTemplateOptions` **同源**（亦可直调） |
 
 ---
 
@@ -490,6 +517,11 @@ insertSellerGoods
   → goodsSn = GoodsSnGenerator.next()
   → insert status=0（含 attr_template_id）
   → saveServiceSnapshots
+  → saveGoodsAttrs（先删后插 biz_goods_attr）
+
+updateSellerGoods
+  → 同上校验（goodsId 属当前店）
+  → updateSeller + saveServiceSnapshots + saveGoodsAttrs
 
 submitGoods
   → status in (0,3,4)
@@ -504,6 +536,7 @@ offShelfSeller
 deleteSellerGoodsBatch
   → status in (0,3,4)
   → logic delete + 整批失败策略
+  → delete service snapshot + goods_attr rows
   → [待] orderFacade 校验 O10（下架时）
 ```
 
@@ -515,6 +548,8 @@ deleteSellerGoodsBatch
 | 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_*`。
+
 **错误 msg（属性模版）：** 无效或非本店模版 → `请选择本店有效属性模版`（`GoodsConstants.MSG_ATTR_TEMPLATE_INVALID`）。
 
 ---
@@ -542,9 +577,9 @@ deleteSellerGoodsBatch
 | **v1.0** | 列表/详情/单规格 CRUD/单独 submit·offShelf/服务快照/平台分类与服务下拉 | **已实现** |
 | **v1.0 补全** | `shop_category_id` + 店铺分类下拉 + 删除 + 批量 submit/offShelf/delete | **已实现** |
 | **v1.0 补全·模版引用** | `attr_template_id` 保存/详情回显 + 本店模版校验 | **已实现** |
+| **v1.0 补全·属性快照** | `biz_goods_attr` 写入/详情回显；预填接口；`GoodsAttrSupport` | **已实现** |
 | **v1.0 补全·O10** | 下架前未完成订单校验（`IGoodsOrderFacade`） | **待实现** |
-| **v1.x** | 多图、多规格 SKU、运费、`biz_goods_attr` 写入、关键词检索扩展 | 规划 |
-| **v1.x·可选** | `/agri/seller/goods/attrTemplateOptions` 挂载 | 规划 |
+| **v1.x** | 多图、多规格 SKU、运费、关键词检索扩展 | 规划 |
 
 ---
 
@@ -563,6 +598,7 @@ deleteSellerGoodsBatch
 | T9 | 跨店 goodsId → MSG_NOT_OWNER |
 | T10 | 服务快照：保存后详情与目录变更隔离 |
 | T11 | attrTemplateId：本店有效模版写入；跨店/无效 ID → 失败 |
+| T12 | attributes/specs：保存后详情回显；校验项名/值 |
 
 ---
 
@@ -574,7 +610,8 @@ deleteSellerGoodsBatch
 | **v1.1** | 同步代码：v1.0 补全已实现；统一平台/店铺分类口径；O10 仍标待实现 |
 | **v1.2** | 同步 `attr_template_id`：GoodsSaveDTO/详情/Mapper/校验；下拉走属性模版模块 `/options` |
 | **v1.3** | §1.3 模块落位与代码对齐：`IGoodsFacade` 跨包、`template` 依赖、快照/订单 Facade |
+| **v1.4** | `biz_goods_attr` 保存/回显；`attributes`/`specs` 请求体；`/goods/attrTemplateOptions` 与预填接口 |
 
 ---
 
-*文档版本：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。*
+*文档版本：v1.4 · 关联《商品列表功能需求.md》v1.4、《属性模版技术方案.md》v1.3 · 技术栈 RuoYi v3.9.2-springboot2 + MySQL 5.7.39。*

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

@@ -1,11 +1,11 @@
 # 店铺商品列表 — 测试用例
 
-> **依据：** 《商品列表功能需求.md》v1.3、《店铺商品列表技术方案.md》v1.2  
+> **依据：** 《商品列表功能需求.md》v1.4、《店铺商品列表技术方案.md》v1.4  
 > **关联：** 《商品审核功能需求.md》《商品分类功能需求.md》《店铺商品分类功能需求.md》v1.1、《属性模版功能需求.md》、《角色管理测试用例.md》  
-> **范围：** 商家端 `/agri/seller/goods`；`GoodsServiceImpl`（商家 scope）/ `SellerGoodsController`；`IGoodsFacade` / 服务快照 / 属性模版引用协作  
-> **排除：** 平台端审核/监管 UI E2E、C 端下单、多规格 SKU/运费模版完整表单、属性模版 **维护** UI、**biz_goods_attr** 明细写入  
+> **范围：** 商家端 `/agri/seller/goods`；`GoodsServiceImpl`（商家 scope）/ `SellerGoodsController`；`IGoodsFacade` / 服务快照 / 属性模版与 **biz_goods_attr** 协作  
+> **排除：** 平台端审核/监管 UI E2E、C 端下单、多规格 SKU/运费模版完整表单、属性模版 **维护** UI  
 > **环境：** RuoYi v3.9.2-springboot2；MySQL 5.7.39；请求头 **`X-Shop-Id`** 标识当前店铺  
-> **实现分期：** v1.0 + v1.0 补全 **已实现**（含 shopCategoryId、attrTemplateId、删除、批量 submit/offShelf）；**O10 订单阻断仍待实现**
+> **实现分期：** v1.0 补全 **已实现**（含 shopCategoryId、attrTemplateId、**biz_goods_attr**、删除、批量 submit/offShelf）；**O10 仍待实现**
 
 ---
 
@@ -349,6 +349,34 @@
 | **测试步骤** | insertSellerGoods(101, dto含attrTemplateId) |
 | **预期结果** | 失败；msg 含「属性模版」；不调用 insert |
 
+### SGL-UT-026 保存写入 biz_goods_attr
+
+| 要素 | 内容 |
+|------|------|
+| **用例编号** | SGL-UT-026 |
+| **测试模块** | 店铺商品列表 |
+| **测试项** | saveGoodsAttrs |
+| **测试类型** | 单元测试 |
+| **测试工具** | JUnit 5 + Mockito |
+| **测试目的** | 验证 GL18：attributes/specs 先删后插 |
+| **前置条件** | 合法 GoodsSaveDTO；attributes 含「品牌」→「华为」；specs 含「内存」→「8G」「16G」 |
+| **测试步骤** | insertSellerGoods(101, dto) |
+| **预期结果** | `goodsAttrMapper.deleteByGoodsId` + `batchInsert` 被调用 |
+
+### SGL-UT-027 属性项校验失败
+
+| 要素 | 内容 |
+|------|------|
+| **用例编号** | SGL-UT-027 |
+| **测试模块** | 店铺商品列表 |
+| **测试项** | GoodsAttrSupport 校验 |
+| **测试类型** | 单元测试 |
+| **测试工具** | JUnit 5 |
+| **测试目的** | 属性与规格项名相同拒绝 |
+| **前置条件** | attributes 与 specs 均含 itemName=「内存」 |
+| **测试步骤** | insertSellerGoods |
+| **预期结果** | 失败；msg 含「不可相同」 |
+
 ### SGL-UT-021 删除可删状态成功
 
 | 要素 | 内容 |
@@ -787,6 +815,34 @@
 | **测试步骤** | 商家 GET /1002 |
 | **预期结果** | goods_status=3；rejectReason 非空 |
 
+### SGL-API-029 属性模版预填
+
+| 要素 | 内容 |
+|------|------|
+| **用例编号** | SGL-API-029 |
+| **测试模块** | 店铺商品列表 |
+| **测试项** | GET /attrTemplate/{templateId} |
+| **测试类型** | 接口测试 |
+| **测试工具** | MockMvc |
+| **测试目的** | 验证选用模版预填 attributes/specs |
+| **前置条件** | templateId=4 属 shop 101 |
+| **测试步骤** | GET /agri/seller/goods/attrTemplate/4 |
+| **预期结果** | code=200；data.attributes / data.specs 结构与模版详情一致 |
+
+### SGL-API-030 保存带 attributes 后详情回显
+
+| 要素 | 内容 |
+|------|------|
+| **用例编号** | SGL-API-030 |
+| **测试模块** | 店铺商品列表 |
+| **测试项** | POST + GET 详情 |
+| **测试类型** | 接口测试 |
+| **测试工具** | Apifox |
+| **测试目的** | 验证 biz_goods_attr 写入与聚合回显 |
+| **前置条件** | 新建商品 body 含 attributes/specs |
+| **测试步骤** | POST 保存 → GET 详情 |
+| **预期结果** | 详情 attributes/specs 与保存体一致 |
+
 ---
 
 ## 三、界面测试（Playwright）
@@ -1048,7 +1104,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 | — | — |
+| GL18 属性模版引用 | UT-024,025,026,027 | API-029,030 | — |
 | GL12 服务快照 | UT-018,019 | API-025 | UI-017 |
 | GL13 保存不可改态 | UT-006 | API-010 | — |
 | GL14 外部变更不级联 | — | API-028 | — |
@@ -1068,7 +1124,8 @@
 | **v1.0** | 首版：23 单元 + 28 接口 + 17 UI；覆盖 GL1～GL17 及状态机/检索/权限 |
 | **v1.1** | 同步代码 v1.0 补全已实现；O10 仍标待实现；统一平台/店铺分类口径 |
 | **v1.2** | 新增 GL18 / UT-024、025：attrTemplateId 保存与校验 |
+| **v1.3** | 新增 UT-026/027、API-029/030：biz_goods_attr 保存与预填 |
 
 ---
 
-*文档版本：v1.2 · 关联《商品列表功能需求.md》v1.3、《店铺商品列表技术方案.md》v1.2*
+*文档版本：v1.3 · 关联《商品列表功能需求.md》v1.4、《店铺商品列表技术方案.md》v1.4*

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

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

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

@@ -1,7 +1,7 @@
 # 属性模版 — 技术方案
 
 > **依据：** 《属性模版功能需求.md》v1.0  
-> **关联：** 《关联需求分析.md》v1.6；平台《商品服务管理技术方案》v1.0.1、《商品分类技术方案》v1.3、《商品审核技术方案》v1.1；商家《店铺商品列表技术方案》v1.3、《店铺商品分类技术方案》v1.2  
+> **关联：** 《关联需求分析.md》v1.6；平台《商品服务管理技术方案》v1.0.1、《商品分类技术方案》v1.3、《商品审核技术方案》v1.1；商家《店铺商品列表技术方案》v1.4、《店铺商品分类技术方案》v1.2  
 > **范围：** 商家端 **当前店铺** 属性模版 CRUD；为 **商品列表 · 属性模版** 字段提供下拉与详情预填；**平台不参与** 模版维护。  
 > **原则：** `shop_id` 店铺隔离；逻辑删除；批量删除 **整批失败**；编辑模版 **不 UPDATE** 已有商品属性/规格（快照原则）。
 
@@ -40,7 +40,7 @@ biz_goods_attr_template（shop_id = 当前店铺）
         ↓
 【商品列表】选用模版 → 预填表单 → 保存
         ├── biz_goods.attr_template_id（引用关系，删模版校验）
-        └── biz_goods_attr（商品侧属性/规格快照，v1.x 落库）
+        └── biz_goods_attr（商品侧属性/规格快照，**已实现**）
         ↓
 【平台审核/监管】读 biz_goods + biz_goods_attr，不读模版表
 ```
@@ -102,6 +102,7 @@ sql/agri_seller_attr_template_menu.sql             # 菜单（待补）
 | 场景 | 商品模块代码 |
 |------|--------------|
 | 保存校验 `attrTemplateId` | `goods/service/impl/GoodsServiceImpl` 注入 `BizGoodsAttrTemplateMapper` |
+| 保存属性/规格快照 | `goods/mapper/BizGoodsAttrMapper` + `GoodsAttrSupport` + `saveGoodsAttrs` |
 | 删模版引用校验 | `category/facade/IGoodsFacade.existsByAttrTemplateId` ← `goods/facade/impl/GoodsFacadeImpl` |
 
 ### 1.4 跨模块 Facade
@@ -170,7 +171,7 @@ sql/agri_seller_attr_template_menu.sql             # 菜单（待补）
 | `biz_goods` | `attr_template_id` bigint **NULL** | 发品选用模版 ID；**删模版校验** |
 | `biz_goods_attr` | 商品属性/规格 **快照** | 保存商品时写入；**不随模版编辑追溯** |
 
-**`biz_goods_attr`（v1.x 与发品完整表单同步落库）：**
+**`biz_goods_attr`（商品列表协作 · 已实现）：**
 
 | 字段 | 类型 | 说明 |
 |------|------|------|
@@ -181,7 +182,7 @@ sql/agri_seller_attr_template_menu.sql             # 菜单（待补）
 | value_text | varchar(128) | 单值一行；多值多行 |
 | sort_no | int | |
 
-> **v1.0 本模块：** 可先完成模版 CRUD + `attr_template_id` + Facade；`biz_goods_attr` 写入随商品列表 v1.x 一并实现。
+> **说明：** 建表见 `sql/biz_goods_attr.sql`；写入逻辑在 **商品模块** `GoodsServiceImpl.saveGoodsAttrs`。
 
 ### 2.6 索引
 
@@ -390,13 +391,15 @@ INSERT 新 item/value（sort_no 按数组顺序 0,1,2…）
 
 商品模块亦可调用 `IAttrTemplateFacade.listOptionsByShopId(shopId)`；选用后 `getDetailForGoods(templateId, shopId)` 预填表单。
 
-**商品侧挂载（规划）：**
+**商品侧挂载（已实现）：**
 
 | 方法 | 路径 | 说明 |
 |------|------|------|
 | GET | `/agri/seller/goods/attrTemplateOptions` | 委托 `IAttrTemplateFacade.listOptionsByShopId` |
 | GET | `/agri/seller/goods/attrTemplate/{templateId}` | 委托 `getDetailForGoods`（选用预填） |
 
+保存商品时在 `GoodsSaveDTO` 携带 `attributes` / `specs`，商品模块 **先删后插** `biz_goods_attr`。
+
 ---
 
 ## 4. 对外协作
@@ -407,7 +410,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`（**已实现**） |
 | 删模版校验 | `IGoodsFacade.existsByAttrTemplateId` |
 
 **`existsByAttrTemplateId` SQL：**
@@ -543,7 +546,7 @@ buildNameList(templateId)      // 列表聚合列
 |------|------|------|
 | **v1.0** | 模版三表 CRUD；`/options`；`IGoodsFacade.existsByAttrTemplateId`；菜单权限 | **已实现** |
 | **v1.0·商品协作** | 商品保存/详情 `attr_template_id`；`assertAttrTemplateIfPresent` | **已实现** |
-| **v1.x** | `biz_goods_attr` 写入；`/agri/seller/goods/attrTemplateOptions` 挂载 | 规划 |
+| **v1.0·属性快照** | `biz_goods_attr` 写入/回显；商品侧预填/下拉 API | **已实现** |
 | **非本期** | 模版导入导出、版本历史、平台代维、与分类自动绑定 | — |
 
 ---
@@ -555,7 +558,8 @@ buildNameList(templateId)      // 列表聚合列
 | **v1.0** | 首版：三表模型；`/agri/seller/attrTemplate`；与商品列表/平台审核协作；对齐《属性模版功能需求》v1.0 |
 | **v1.1** | 同步实现：模版 CRUD + 删引用校验；商品侧 `attr_template_id` 保存/回显已实现 |
 | **v1.2** | §1.3 模块落位与代码对齐：包名 `template`、Mapper XML 路径、跨模块 Facade 说明 |
+| **v1.3** | 商品协作：`biz_goods_attr`、预填/下拉 API、保存体 attributes/specs |
 
 ---
 
-*文档版本：v1.2 · 关联《属性模版功能需求.md》v1.1 · 技术栈 RuoYi v3.9.2-springboot2 + MySQL 5.7.39*
+*文档版本：v1.3 · 关联《属性模版功能需求.md》v1.1、《店铺商品列表技术方案.md》v1.4*

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

@@ -684,19 +684,19 @@
 | **测试步骤** | GET /list |
 | **预期结果** | HTTP 403 |
 
-### SAT-API-019 GET /goods/attrTemplateOptions 协作（v1.x）
+### SAT-API-019 GET /goods/attrTemplateOptions 协作（已实现）
 
 | 要素 | 内容 |
 |------|------|
 | **用例编号** | SAT-API-019 |
 | **测试模块** | 属性模版 |
-| **测试项** | 商品侧下拉 |
+| **测试项** | 商品侧下拉 + 预填 |
 | **测试类型** | 接口测试 |
-| **测试工具** | Apifox |
-| **测试目的** | 验证技术方案 §3.6 商品挂载 |
-| **前置条件** | 商品模块已实现 `/agri/seller/goods/attrTemplateOptions` |
-| **测试步骤** | GET 该路径，X-Shop-Id=101 |
-| **预期结果** | 与 GET /attrTemplate/options **数据一致** |
+| **测试工具** | Apifox / MockMvc |
+| **测试目的** | 验证 AT9：商品发品下拉与预填 API |
+| **前置条件** | shop 101 有模版；`X-Shop-Id=101` |
+| **测试步骤** | GET `/agri/seller/goods/attrTemplateOptions`；GET `/agri/seller/goods/attrTemplate/4` |
+| **预期结果** | options 与 `/attrTemplate/options` 一致；预填含 attributes/specs |
 
 ---
 
@@ -968,8 +968,9 @@
 | 版本 | 说明 |
 |------|------|
 | **v1.0** | 首版：28 单元 + 19 接口 + 17 UI；覆盖 AT1～AT12 及正常/异常/协作流程 |
-| **v1.1** | 商品协作：`attr_template_id` 保存/回显已实现；`biz_goods_attr` 仍标 v1.x |
+| **v1.1** | 商品协作：`attr_template_id` 保存/回显已实现 |
+| **v1.2** | `biz_goods_attr` 与商品侧预填 API 已实现；SAT-API-019 标已实现 |
 
 ---
 
-*文档版本：v1.1 · 关联《属性模版功能需求.md》v1.1、《属性模版技术方案.md》v1.1*
+*文档版本：v1.2 · 关联《属性模版功能需求.md》v1.1、《属性模版技术方案.md》v1.3*

sql/biz_goods.sql

@@ -44,3 +44,15 @@ CREATE TABLE IF NOT EXISTS `biz_goods_service_snapshot` (
   PRIMARY KEY (`snapshot_id`),
   KEY `idx_goods_id` (`goods_id`)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='商品服务展示快照';
+
+-- 商品属性/规格快照
+CREATE TABLE IF NOT EXISTS `biz_goods_attr` (
+  `attr_id`    bigint(20)  NOT NULL AUTO_INCREMENT,
+  `goods_id`   bigint(20)  NOT NULL COMMENT '商品ID',
+  `attr_type`  char(1)     NOT NULL COMMENT '1属性2规格',
+  `item_name`  varchar(64) NOT NULL COMMENT '属性项/规格项名称',
+  `value_text` varchar(128) NOT NULL COMMENT '属性值/规格值',
+  `sort_no`    int(11)     NOT NULL DEFAULT '0' COMMENT '展示顺序',
+  PRIMARY KEY (`attr_id`),
+  KEY `idx_goods_id` (`goods_id`,`attr_type`,`sort_no`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='商品属性规格快照';

sql/biz_goods_attr.sql

@@ -0,0 +1,11 @@
+-- 商品属性/规格快照（发品保存；不随属性模版编辑追溯）
+CREATE TABLE IF NOT EXISTS `biz_goods_attr` (
+  `attr_id`    bigint(20)  NOT NULL AUTO_INCREMENT,
+  `goods_id`   bigint(20)  NOT NULL COMMENT '商品ID',
+  `attr_type`  char(1)     NOT NULL COMMENT '1属性2规格',
+  `item_name`  varchar(64) NOT NULL COMMENT '属性项/规格项名称',
+  `value_text` varchar(128) NOT NULL COMMENT '属性值/规格值',
+  `sort_no`    int(11)     NOT NULL DEFAULT '0' COMMENT '展示顺序',
+  PRIMARY KEY (`attr_id`),
+  KEY `idx_goods_id` (`goods_id`,`attr_type`,`sort_no`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='商品属性规格快照';