会员管理代码

baqing-shop/src/main/java/com/ruoyi/web/modules/content/controller/HomeBannerAppController.java

@@ -1,28 +0,0 @@
-package com.ruoyi.web.modules.content.controller;
-
-import org.springframework.beans.factory.annotation.Autowired;
-import org.springframework.web.bind.annotation.GetMapping;
-import org.springframework.web.bind.annotation.RequestMapping;
-import org.springframework.web.bind.annotation.RestController;
-import com.ruoyi.common.annotation.Anonymous;
-import com.ruoyi.common.core.controller.BaseController;
-import com.ruoyi.common.core.domain.AjaxResult;
-import com.ruoyi.web.modules.content.service.IBannerService;
-
-/**
- * C 端首页 Banner
- */
-@RestController
-@RequestMapping("/api/home")
-public class HomeBannerAppController extends BaseController
-{
-    @Autowired
-    private IBannerService bannerService;
-
-    @Anonymous
-    @GetMapping("/banners")
-    public AjaxResult banners()
-    {
-        return success(bannerService.listBannersForApp());
-    }
-}

baqing-shop/src/main/java/com/ruoyi/web/modules/home/constant/HomeConstants.java

@@ -11,4 +11,7 @@ public final class HomeConstants
 
     /** 热销商品展示条数上限 */
     public static final int HOT_GOODS_LIMIT = 6;
+
+    /** Banner 启用且未删记录查询上限 */
+    public static final int BANNER_LIST_LIMIT = 50;
 }

baqing-shop/src/main/java/com/ruoyi/web/modules/home/controller/HomeAppController.java

@@ -10,7 +10,7 @@ import com.ruoyi.common.core.domain.AjaxResult;
 import com.ruoyi.web.modules.home.service.IHomeAppService;
 
 /**
- * C 端商城首页（类目导航、热销商品）
+ * C 端商城首页（Banner、类目导航、热销商品）
  */
 @RestController
 @RequestMapping("/api/home")
@@ -19,6 +19,13 @@ public class HomeAppController extends BaseController
     @Autowired
     private IHomeAppService homeAppService;
 
+    @Anonymous
+    @GetMapping("/banners")
+    public AjaxResult banners()
+    {
+        return success(homeAppService.listBanners());
+    }
+
     @Anonymous
     @GetMapping("/categories")
     public AjaxResult categories()

baqing-shop/src/main/java/com/ruoyi/web/modules/home/mapper/HomeAppMapper.java

@@ -2,6 +2,7 @@ package com.ruoyi.web.modules.home.mapper;
 
 import java.util.List;
 import org.apache.ibatis.annotations.Param;
+import com.ruoyi.web.modules.home.vo.HomeBannerVO;
 import com.ruoyi.web.modules.home.vo.HomeCategoryNavVO;
 import com.ruoyi.web.modules.home.vo.HomeHotGoodsVO;
 
@@ -10,6 +11,11 @@ import com.ruoyi.web.modules.home.vo.HomeHotGoodsVO;
  */
 public interface HomeAppMapper
 {
+    /**
+     * C 端 Banner 列表（启用且未删）
+     */
+    List<HomeBannerVO> selectBannersForHome(@Param("limit") int limit);
+
     /**
      * 平台一级类目导航（show=1）
      */

baqing-shop/src/main/java/com/ruoyi/web/modules/home/service/IHomeAppService.java

@@ -1,6 +1,7 @@
 package com.ruoyi.web.modules.home.service;
 
 import java.util.List;
+import com.ruoyi.web.modules.home.vo.HomeBannerVO;
 import com.ruoyi.web.modules.home.vo.HomeCategoryNavVO;
 import com.ruoyi.web.modules.home.vo.HomeHotGoodsVO;
 
@@ -9,6 +10,11 @@ import com.ruoyi.web.modules.home.vo.HomeHotGoodsVO;
  */
 public interface IHomeAppService
 {
+    /**
+     * Banner 轮播列表
+     */
+    List<HomeBannerVO> listBanners();
+
     /**
      * 平台一级类目导航
      */

baqing-shop/src/main/java/com/ruoyi/web/modules/home/service/impl/HomeAppServiceImpl.java

@@ -7,6 +7,7 @@ import org.springframework.stereotype.Service;
 import com.ruoyi.web.modules.home.constant.HomeConstants;
 import com.ruoyi.web.modules.home.mapper.HomeAppMapper;
 import com.ruoyi.web.modules.home.service.IHomeAppService;
+import com.ruoyi.web.modules.home.vo.HomeBannerVO;
 import com.ruoyi.web.modules.home.vo.HomeCategoryNavVO;
 import com.ruoyi.web.modules.home.vo.HomeHotGoodsVO;
 
@@ -19,6 +20,13 @@ public class HomeAppServiceImpl implements IHomeAppService
     @Autowired
     private HomeAppMapper homeAppMapper;
 
+    @Override
+    public List<HomeBannerVO> listBanners()
+    {
+        List<HomeBannerVO> list = homeAppMapper.selectBannersForHome(HomeConstants.BANNER_LIST_LIMIT);
+        return list != null ? list : Collections.emptyList();
+    }
+
     @Override
     public List<HomeCategoryNavVO> listPlatformLevel1Nav()
     {

baqing-shop/src/main/resources/mapper/home/HomeAppMapper.xml

@@ -2,6 +2,17 @@
 <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
 <mapper namespace="com.ruoyi.web.modules.home.mapper.HomeAppMapper">
 
+    <select id="selectBannersForHome" resultType="com.ruoyi.web.modules.home.vo.HomeBannerVO">
+        select banner_id as bannerId,
+               banner_image as bannerImage,
+               sort_no as sortNo
+        from biz_home_banner
+        where del_flag = '0'
+          and enable_flag = '1'
+        order by sort_no asc, create_time asc
+        limit #{limit}
+    </select>
+
     <select id="selectPlatformLevel1Nav" resultType="com.ruoyi.web.modules.home.vo.HomeCategoryNavVO">
         select category_id as categoryId,
                category_name as categoryName,

baqing-shop/src/test/java/com/ruoyi/web/modules/content/controller/HomeBannerAppControllerTest.java

@@ -1,67 +0,0 @@
-package com.ruoyi.web.modules.content.controller;
-
-import static org.mockito.Mockito.when;
-import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
-import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath;
-import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
-import java.util.Collections;
-import org.junit.jupiter.api.BeforeEach;
-import org.junit.jupiter.api.Test;
-import org.junit.jupiter.api.extension.ExtendWith;
-import org.mockito.InjectMocks;
-import org.mockito.Mock;
-import org.mockito.junit.jupiter.MockitoExtension;
-import org.springframework.test.web.servlet.MockMvc;
-import org.springframework.test.web.servlet.setup.MockMvcBuilders;
-import com.ruoyi.web.modules.content.service.IBannerService;
-import com.ruoyi.web.modules.content.vo.HomeBannerAppVO;
-
-/**
- * C 端首页 Banner 接口测试（BAN-API-016～）
- */
-@ExtendWith(MockitoExtension.class)
-class HomeBannerAppControllerTest
-{
-    @Mock
-    private IBannerService bannerService;
-
-    @InjectMocks
-    private HomeBannerAppController controller;
-
-    private MockMvc mockMvc;
-
-    @BeforeEach
-    void setUp()
-    {
-        mockMvc = MockMvcBuilders.standaloneSetup(controller).build();
-    }
-
-    @Test
-    void banners_returns200() throws Exception
-    {
-        HomeBannerAppVO vo = new HomeBannerAppVO();
-        vo.setBannerId(1L);
-        vo.setBannerImage("/profile/upload/b1.jpg");
-        vo.setSortNo(0);
-        when(bannerService.listBannersForApp()).thenReturn(Collections.singletonList(vo));
-
-        mockMvc.perform(get("/api/home/banners"))
-                .andExpect(status().isOk())
-                .andExpect(jsonPath("$.code").value(200))
-                .andExpect(jsonPath("$.data[0].bannerId").value(1))
-                .andExpect(jsonPath("$.data[0].bannerImage").value("/profile/upload/b1.jpg"))
-                .andExpect(jsonPath("$.data[0].sortNo").value(0));
-    }
-
-    @Test
-    void banners_emptyList() throws Exception
-    {
-        when(bannerService.listBannersForApp()).thenReturn(Collections.emptyList());
-
-        mockMvc.perform(get("/api/home/banners"))
-                .andExpect(status().isOk())
-                .andExpect(jsonPath("$.code").value(200))
-                .andExpect(jsonPath("$.data").isArray())
-                .andExpect(jsonPath("$.data").isEmpty());
-    }
-}

baqing-shop/src/test/java/com/ruoyi/web/modules/home/controller/HomeAppControllerTest.java

@@ -16,6 +16,7 @@ import org.mockito.junit.jupiter.MockitoExtension;
 import org.springframework.test.web.servlet.MockMvc;
 import org.springframework.test.web.servlet.setup.MockMvcBuilders;
 import com.ruoyi.web.modules.home.service.IHomeAppService;
+import com.ruoyi.web.modules.home.vo.HomeBannerVO;
 import com.ruoyi.web.modules.home.vo.HomeCategoryNavVO;
 import com.ruoyi.web.modules.home.vo.HomeHotGoodsVO;
 
@@ -39,6 +40,35 @@ class HomeAppControllerTest
         mockMvc = MockMvcBuilders.standaloneSetup(controller).build();
     }
 
+    @Test
+    void banners_returns200WithoutToken() throws Exception
+    {
+        HomeBannerVO vo = new HomeBannerVO();
+        vo.setBannerId(1L);
+        vo.setBannerImage("/profile/upload/b1.jpg");
+        vo.setSortNo(0);
+        when(homeAppService.listBanners()).thenReturn(Collections.singletonList(vo));
+
+        mockMvc.perform(get("/api/home/banners"))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.code").value(200))
+                .andExpect(jsonPath("$.data[0].bannerId").value(1))
+                .andExpect(jsonPath("$.data[0].bannerImage").value("/profile/upload/b1.jpg"))
+                .andExpect(jsonPath("$.data[0].sortNo").value(0));
+    }
+
+    @Test
+    void banners_emptyList() throws Exception
+    {
+        when(homeAppService.listBanners()).thenReturn(Collections.emptyList());
+
+        mockMvc.perform(get("/api/home/banners"))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.code").value(200))
+                .andExpect(jsonPath("$.data").isArray())
+                .andExpect(jsonPath("$.data").isEmpty());
+    }
+
     @Test
     void categories_returns200WithoutToken() throws Exception
     {

baqing-shop/src/test/java/com/ruoyi/web/modules/home/service/HomeAppServiceImplTest.java

@@ -17,6 +17,7 @@ import org.mockito.junit.jupiter.MockitoExtension;
 import com.ruoyi.web.modules.home.constant.HomeConstants;
 import com.ruoyi.web.modules.home.mapper.HomeAppMapper;
 import com.ruoyi.web.modules.home.service.impl.HomeAppServiceImpl;
+import com.ruoyi.web.modules.home.vo.HomeBannerVO;
 import com.ruoyi.web.modules.home.vo.HomeCategoryNavVO;
 import com.ruoyi.web.modules.home.vo.HomeHotGoodsVO;
 
@@ -32,6 +33,43 @@ class HomeAppServiceImplTest
     @InjectMocks
     private HomeAppServiceImpl homeAppService;
 
+    @Test
+    void listBanners_delegatesWithLimit()
+    {
+        HomeBannerVO b1 = banner(1L, "/pic/b1.jpg", 0);
+        when(homeAppMapper.selectBannersForHome(HomeConstants.BANNER_LIST_LIMIT))
+                .thenReturn(Collections.singletonList(b1));
+
+        List<HomeBannerVO> result = homeAppService.listBanners();
+
+        verify(homeAppMapper).selectBannersForHome(HomeConstants.BANNER_LIST_LIMIT);
+        assertEquals(1, result.size());
+        assertEquals("/pic/b1.jpg", result.get(0).getBannerImage());
+    }
+
+    @Test
+    void listBanners_emptyListWhenNoData()
+    {
+        when(homeAppMapper.selectBannersForHome(HomeConstants.BANNER_LIST_LIMIT))
+                .thenReturn(Collections.emptyList());
+
+        List<HomeBannerVO> result = homeAppService.listBanners();
+
+        assertNotNull(result);
+        assertTrue(result.isEmpty());
+    }
+
+    @Test
+    void listBanners_nullMapperResultReturnsEmpty()
+    {
+        when(homeAppMapper.selectBannersForHome(HomeConstants.BANNER_LIST_LIMIT)).thenReturn(null);
+
+        List<HomeBannerVO> result = homeAppService.listBanners();
+
+        assertNotNull(result);
+        assertTrue(result.isEmpty());
+    }
+
     @Test
     void listPlatformLevel1Nav_returnsVisibleCategories()
     {
@@ -222,6 +260,15 @@ class HomeAppServiceImplTest
         return vo;
     }
 
+    private static HomeBannerVO banner(Long id, String image, int sortNo)
+    {
+        HomeBannerVO vo = new HomeBannerVO();
+        vo.setBannerId(id);
+        vo.setBannerImage(image);
+        vo.setSortNo(sortNo);
+        return vo;
+    }
+
     private static HomeHotGoodsVO hotGoods(Long goodsId, String goodsSn, int salesProxy)
     {
         HomeHotGoodsVO vo = new HomeHotGoodsVO();

doc/平台后台/内容管理/首页banner设置/首页banner设置技术方案.md

@@ -21,17 +21,20 @@
 
 ```text
 baqing-shop
-├── com.ruoyi.web.modules.banner.controller.BannerController          # 平台端
-└── com.ruoyi.web.modules.banner.controller.HomeBannerAppController   # C 端首页
-    ├── domain.BizHomeBanner
-    ├── mapper.BizHomeBannerMapper
-    ├── service.IBannerService
-    └── constant.BannerConstants
+├── com.ruoyi.web.modules.content
+│   ├── controller.BannerController              # 平台端 /agri/banner
+│   ├── domain.BizHomeBanner
+│   ├── mapper.BizHomeBannerMapper
+│   ├── service.IBannerService
+│   └── constant.BannerConstants
+├── com.ruoyi.web.modules.home
+│   └── controller.HomeAppController             # C 端 GET /api/home/banners
+│       └── mapper.HomeAppMapper                 # 直读 biz_home_banner（Anonymous）
 sql/
 └── biz_home_banner.sql
 ```
 
-> **无** Facade 对外暴露（BN8～BN10：与供给链/订单无耦合）；后续协议模块可并列 `com.ruoyi.web.modules.content`。
+> **无** Facade 对外暴露（BN8～BN10：与供给链/订单无耦合）。C 端 Banner **列表** 由 **home** 模块提供；平台 CRUD 仍走 **content** 模块 `IBannerService`。
 
 ### 1.2 业务链
 
@@ -40,7 +43,7 @@ biz_home_banner（本模块 · 平台维护）
         │
         ├── 平台 Web ── CRUD / 行内改序
         │
-        └── C 端首页 ── GET /api/home/banners（Anonymous）
+        └── C 端首页 ── GET /api/home/banners（Anonymous · `HomeAppController`）
                 └── 前端过滤无效图、零条隐藏轮播区（BN13，客户端）
 ```
 
@@ -56,7 +59,7 @@ biz_home_banner（本模块 · 平台维护）
 | 类型 | 说明 |
 |------|------|
 | **无 Java Facade** | 其他模块 **不依赖** Banner |
-| **C 端 HTTP** | 仅 `HomeBannerAppController` 提供首页列表 |
+| **C 端 HTTP** | `HomeAppController`（`com.ruoyi.web.modules.home`）提供 `GET /api/home/banners` |
 
 ### 1.4 状态联动
 
@@ -368,10 +371,20 @@ listForApp → enable_flag=1 AND del_flag=0 ORDER BY sort_no
 | 文档 | 版本 |
 |------|------|
 | 首页banner设置功能需求.md | v1.0.1 |
+| 商城首页技术方案.md | v1.1 |
 | 商品服务管理技术方案.md | v1.0.1 |
 | 会员管理技术方案.md | v1.0 |
 | 关联需求分析.md | v1.2 |
 
 ---
 
-*文档版本：v1.0 · MySQL 5.7.39 · RuoYi v3.9.2-springboot2 · 关联《首页banner设置功能需求.md》v1.0.1*
+## 11. 修订记录
+
+| 版本 | 说明 |
+|------|------|
+| **v1.0** | 首版 |
+| **v1.0.1** | C 端 `GET /api/home/banners` 落位 **`home.HomeAppController`**；平台 CRUD 仍 **content**；修正包路径 |
+
+---
+
+*文档版本：v1.0.1 · MySQL 5.7.39 · RuoYi v3.9.2-springboot2 · 关联《首页banner设置功能需求.md》v1.0.1*

doc/消费者APP/商城首页/商城首页技术方案.md

@@ -21,26 +21,31 @@
 
 ```text
 baqing-shop/src/main/java/com/ruoyi/web/modules/home/
-├── controller/HomeAppController.java       # /api/home/categories、/api/home/hot-goods
+├── controller/HomeAppController.java       # /api/home/banners、/categories、/hot-goods
 ├── service/IHomeAppService.java
 ├── service/impl/HomeAppServiceImpl.java
+├── mapper/HomeAppMapper.java
+├── vo/HomeBannerVO.java
 ├── vo/HomeCategoryNavVO.java
 ├── vo/HomeHotGoodsVO.java
 └── constant/HomeConstants.java
 
-已有（content 模块，保持不变）：
-└── com.ruoyi.web.modules.content.controller.HomeBannerAppController
-        GET /api/home/banners
+resources/mapper/home/
+└── HomeAppMapper.xml                         # biz_home_banner / biz_goods_category / biz_goods 只读 SQL
 
-resources/mapper/home/          # 可选：若 SQL 不扩展现有 Mapper，则新增 HomeGoodsMapper.xml
+平台 Banner CRUD（content 模块，保持不变）：
+└── com.ruoyi.web.modules.content
+        ├── controller/BannerController          # /agri/banner
+        ├── service/IBannerService               # 平台维护
+        └── mapper/BizHomeBannerMapper
 ```
 
-> **说明：** Banner **不迁入** home 包，继续由 `IBannerService.listBannersForApp()` 提供；home 模块仅 **类目导航 + 热销**。
+> **说明：** C 端首页 **三读接口** 均归 `home` 包；Banner 列表由 `HomeAppMapper.selectBannersForHome` 直读 `biz_home_banner`（**不经过** `IBannerService`）。平台 CRUD 仍走 content 模块。
 
 ### 1.2 协作链
 
 ```text
-biz_home_banner ──► GET /api/home/banners          （content · 已实现）
+biz_home_banner ──► GET /api/home/banners          （home · 已实现）
 biz_goods_category（shop_id IS NULL, level=1）──► GET /api/home/categories
 biz_goods + biz_shop ──► GET /api/home/hot-goods   （Top6）
 
@@ -63,8 +68,8 @@ biz_goods + biz_shop ──► GET /api/home/hot-goods   （Top6）
 
 | 接口 | 本模块用法 |
 |------|------------|
-| **`IBannerService`** | **不经过** home Service；独立 Controller |
-| **`IPlatformCategoryService`** | 可复用查询逻辑；C 端建议 **专用 SQL**（仅 `show_flag=1` 一级） |
+| **`IBannerService`** | **C 端不调用**；仅平台 `/agri/banner` CRUD 使用 |
+| **`IPlatformCategoryService`** | 可复用查询逻辑；C 端 **专用 SQL**（`HomeAppMapper`，仅 `show_flag=1` 一级） |
 | **`ICategoryFacade`** | 详情/下单用 `isCategoryVisible`；**首页类目 SQL 已过滤 show** |
 | **`IGoodsFacade` / 商品详情** | 首页 **不调用**；详情页可购校验 |
 
@@ -147,22 +152,23 @@ ALTER TABLE `biz_goods`
 
 | 方法 | 路径 | 提供方 | 说明 |
 |------|------|--------|------|
-| GET | `/banners` | `HomeBannerAppController`（**已有**） | Banner 列表 |
-| GET | `/categories` | `HomeAppController`（**新增**） | 平台一级类目导航 |
-| GET | `/hot-goods` | `HomeAppController`（**新增**） | 热销 Top6 |
+| GET | `/banners` | `HomeAppController`（**已实现**） | Banner 列表 |
+| GET | `/categories` | `HomeAppController`（**已实现**） | 平台一级类目导航 |
+| GET | `/hot-goods` | `HomeAppController`（**已实现**） | 热销 Top6 |
 
 **本期不提供：** `GET /api/home/index` 聚合接口、搜索 API、下拉刷新专用接口。
 
 ### 3.2 Banner `GET /api/home/banners`
 
-**已实现。** 详见《首页banner设置技术方案.md》§4.1。
+**已实现**（`home` 模块 · `HomeAppMapper.selectBannersForHome`）。平台维护规则见《首页banner设置技术方案.md》§4.1。
 
 | 项 | 说明 |
 |----|------|
-| SQL | `enable_flag=1 AND del_flag=0 ORDER BY sort_no, create_time` |
+| SQL | `enable_flag=1 AND del_flag=0 ORDER BY sort_no, create_time LIMIT 50` |
+| 常量 | `HomeConstants.BANNER_LIST_LIMIT = 50` |
 | 前端 | 无效图跳过、零条隐藏轮播区（BN13）；点击预览大图 |
 
-**`data` 元素：**
+**`data` 元素：** `HomeBannerVO[]`
 
 | 字段 | 类型 | 说明 |
 |------|------|------|
@@ -257,16 +263,19 @@ LIMIT 6
 
 ```text
 HomeAppController
+    → IHomeAppService.listBanners()
     → IHomeAppService.listPlatformLevel1Nav()
     → IHomeAppService.listHotGoods()
 
 HomeAppServiceImpl
-    → BizGoodsCategoryMapper.selectPlatformLevel1Visible()   # 新增方法
-    → BizGoodsMapper.selectHotGoodsForHome(6)                 # 新增方法
+    → HomeAppMapper.selectBannersForHome(50)
+    → HomeAppMapper.selectPlatformLevel1Nav()
+    → HomeAppMapper.selectHotGoodsForHome(6)
 ```
 
 | 方法 | 说明 |
 |------|------|
+| `listBanners()` | 转 `HomeBannerVO`；SQL 过滤启用且未删 |
 | `listPlatformLevel1Nav()` | 转 `HomeCategoryNavVO`；`categoryPic` 空时原样返回（前端占位图） |
 | `listHotGoods()` | 转 `HomeHotGoodsVO`；`shopName` 来自 JOIN |
 
@@ -293,7 +302,7 @@ HomeAppServiceImpl
 | HM1 | 热销 SQL **全平台**；无 `shop_id` 入参 |
 | HM2 | `@Anonymous` |
 | HM3～HM-S2 | 无搜索 API；前端占位 |
-| HM4 | `/banners` → BannerService |
+| HM4 | `/banners` → `HomeAppMapper` 直读 `biz_home_banner` |
 | HM5～HM6 | `/categories`：`shop_id IS NULL` + level=1 + show=1 |
 | HM7 | 跳转由 **C 端路由** 承担；本模块只出 `categoryId` |
 | HM8～HM12 | `/hot-goods`：LIMIT 6 + 排序 + 字段 VO |
@@ -321,10 +330,11 @@ HomeAppServiceImpl
 
 | 项 | 状态 |
 |----|------|
-| `GET /api/home/banners` | **已实现**（content 模块） |
-| `GET /api/home/categories` | **待实现** |
-| `GET /api/home/hot-goods` | **待实现** |
-| `com.ruoyi.web.modules.home` 包 | **待创建** |
+| `GET /api/home/banners` | **已实现**（`home` 模块） |
+| `GET /api/home/categories` | **已实现** |
+| `GET /api/home/hot-goods` | **已实现** |
+| `com.ruoyi.web.modules.home` 包 | **已创建** |
+| `HomeAppServiceImplTest` / `HomeAppControllerTest` | **已实现**（24 用例） |
 | 可选索引 `idx_home_hot` | **待评估** |
 | C 端首页前端 | **未实现** |
 
@@ -347,7 +357,8 @@ HomeAppServiceImpl
 | 版本 | 说明 |
 |------|------|
 | **v1.0** | 首版；无新建表；`/api/home` 三读接口；关联 Banner/分类/商品/店铺方案 |
+| **v1.1** | 三接口 **已实现**；Banner 迁入 `home` 包（`HomeAppMapper` 直读 `biz_home_banner`）；单测/接口测落地 |
 
 ---
 
-*文档版本：v1.0 · MySQL 5.7.39 · RuoYi v3.9.2-springboot2 · 关联《商城首页功能需求.md》v1.0.1、《首页banner设置技术方案.md》v1.0*
+*文档版本：v1.1 · MySQL 5.7.39 · RuoYi v3.9.2-springboot2 · 关联《商城首页功能需求.md》v1.0.1、《首页banner设置技术方案.md》v1.0.1*

doc/消费者APP/商城首页/商城首页测试用例.md

@@ -1,8 +1,9 @@
 # 商城首页 — 测试用例
 
-> **依据：** 《商城首页功能需求.md》v1.0.1、《商城首页技术方案.md》v1.0  
+> **依据：** 《商城首页功能需求.md》v1.0.1、《商城首页技术方案.md》v1.1  
 > **关联：** 平台《首页banner设置测试用例.md》BAN-API-018～020（同源 `/api/home/banners`）、平台《商品分类测试用例.md》、《关联需求分析.md》§11  
 > **范围：** C 端商城首页；`/api/home/banners`、`/api/home/categories`、`/api/home/hot-goods`；`HomeAppServiceImpl` / `HomeAppController`  
+> **代码落位：** `baqing-shop/src/main/java/com/ruoyi/web/modules/home/`  
 > **排除：** 搜索执行与结果页、商品详情可购四条件校验、Banner 平台 CRUD、下拉刷新、聚合 `/api/home/index`  
 > **环境：** RuoYi v3.9.2-springboot2；MySQL 5.7.39；C 端 **无需 Token**（`@Anonymous`）；UI 使用 Playwright **`channel: 'chrome'`**
 
@@ -727,24 +728,24 @@
 
 ---
 
-## 五、自动化映射（规划）
+## 五、自动化映射
 
-| 用例 | 建议代码位置 |
-|------|--------------|
-| MHP-UT-001～012 | `HomeAppServiceImplTest.java` |
-| MHP-API-001～018 | `HomeAppControllerTest.java`；Banner 部分复用 `HomeBannerAppControllerTest` |
-| MHP-UI-001～017 | `e2e/consumer/mall-home.spec.ts`（Playwright `channel: 'chrome'`） |
+| 用例 | 代码位置 | 状态 |
+|------|----------|------|
+| MHP-UT-001～012 + Banner | `HomeAppServiceImplTest.java` | **已实现**（17 用例） |
+| MHP-API-001～018 + Banner | `HomeAppControllerTest.java` | **已实现**（8 用例） |
+| MHP-UI-001～017 | `e2e/consumer/mall-home.spec.ts`（Playwright `channel: 'chrome'`） | **待实现** |
 
 ---
 
 ## 六、用例统计
 
-| 类型 | 数量 |
-|------|------|
-| 单元测试 MHP-UT | 12 |
-| 接口测试 MHP-API | 18 |
-| 界面测试 MHP-UI | 17 |
-| **合计** | **47** |
+| 类型 | 数量 | 自动化 |
+|------|------|--------|
+| 单元测试 MHP-UT | 12 | 17（含 Banner 3） |
+| 接口测试 MHP-API | 18 | 8（核心契约） |
+| 界面测试 MHP-UI | 17 | 待实现 |
+| **合计** | **47** | **25 已实现** |
 
 ---
 
@@ -753,7 +754,8 @@
 | 版本 | 说明 |
 |------|------|
 | **v1.0** | 首版；47 用例；覆盖 HM1～HM15、BN C 端协作、v1.0.1 排序/空态/不做下拉刷新 |
+| **v1.1** | 同步技术方案 v1.1；§5 自动化映射标注 **已实现**；Banner 测试归 `HomeApp*Test` |
 
 ---
 
-*文档版本：v1.0 · 关联《商城首页功能需求.md》v1.0.1、《商城首页技术方案.md》v1.0*
+*文档版本：v1.1 · 关联《商城首页功能需求.md》v1.0.1、《商城首页技术方案.md》v1.1*