牦牛出栏数据

baqing-admin/src/main/java/com/ruoyi/web/modules/screen/controller/HomeScreenController.java

@@ -53,4 +53,13 @@ public class HomeScreenController extends BaseController
         List<HomeScreenStandardListItemVo> list = homeScreenService.listStandards(statYear, category);
         return getDataTable(list);
     }
+
+    /**
+     * 地图标注：各乡镇牦牛存栏（上一年填报）与出栏（当年填报）。
+     */
+    @GetMapping("/townMapMarkers")
+    public AjaxResult townMapMarkers()
+    {
+        return success(homeScreenService.loadTownMapMarkers());
+    }
 }

baqing-admin/src/main/java/com/ruoyi/web/modules/screen/mapper/HomeScreenStatsMapper.java

@@ -7,6 +7,7 @@ import com.ruoyi.web.modules.screen.domain.dto.HomeScreenAppointmentStatDto;
 import com.ruoyi.web.modules.screen.domain.dto.HomeScreenMonthCountDto;
 import com.ruoyi.web.modules.screen.domain.dto.HomeScreenSubsidyTypeSumDto;
 import com.ruoyi.web.modules.screen.domain.dto.HomeScreenTrainingMonthDto;
+import com.ruoyi.web.modules.screen.domain.vo.HomeScreenTownMapMarkerVo;
 
 /**
  * 大屏首页聚合查询。
@@ -62,4 +63,11 @@ public interface HomeScreenStatsMapper
     List<Integer> selectDistinctTechPublishYears();
 
     List<Integer> selectDistinctTrainingYears();
+
+    /**
+     * 地图标注：全县填报乡镇 + 存栏（上一年）/出栏（当年）头数。
+     */
+    List<HomeScreenTownMapMarkerVo> selectTownMapMarkers(
+            @Param("herdStatYear") int herdStatYear,
+            @Param("outboundStatYear") int outboundStatYear);
 }

baqing-admin/src/main/java/com/ruoyi/web/modules/screen/service/IHomeScreenService.java

@@ -3,6 +3,7 @@ package com.ruoyi.web.modules.screen.service;
 import java.util.List;
 import com.ruoyi.web.modules.screen.domain.vo.HomeScreenDashboardVo;
 import com.ruoyi.web.modules.screen.domain.vo.HomeScreenStandardListItemVo;
+import com.ruoyi.web.modules.screen.domain.vo.HomeScreenTownMapVo;
 
 /**
  * 大屏首页统计服务。
@@ -24,4 +25,9 @@ public interface IHomeScreenService
      * @param category {@link com.ruoyi.web.modules.screen.support.HomeScreenStandardCategory} 枚举名
      */
     List<HomeScreenStandardListItemVo> listStandards(String statYear, String category);
+
+    /**
+     * 地图标注：各乡镇存栏（上一年填报）与出栏（当年填报）。
+     */
+    HomeScreenTownMapVo loadTownMapMarkers();
 }

baqing-admin/src/main/java/com/ruoyi/web/modules/screen/service/impl/HomeScreenServiceImpl.java

@@ -3,6 +3,7 @@ package com.ruoyi.web.modules.screen.service.impl;
 import java.math.BigDecimal;
 import java.math.RoundingMode;
 import java.time.LocalDate;
+import java.time.Year;
 import java.time.ZoneId;
 import java.util.Collections;
 import java.util.Date;
@@ -18,6 +19,8 @@ import com.ruoyi.web.modules.screen.domain.vo.HomeScreenDashboardVo;
 import com.ruoyi.web.modules.screen.domain.vo.HomeScreenIndustryOverviewVo;
 import com.ruoyi.web.modules.screen.domain.vo.HomeScreenInventoryChangeVo;
 import com.ruoyi.web.modules.screen.domain.vo.HomeScreenStandardListItemVo;
+import com.ruoyi.web.modules.screen.domain.vo.HomeScreenTownMapMarkerVo;
+import com.ruoyi.web.modules.screen.domain.vo.HomeScreenTownMapVo;
 import com.ruoyi.web.modules.screen.mapper.HomeScreenStandardMapper;
 import com.ruoyi.web.modules.screen.mapper.HomeScreenStatsMapper;
 import com.ruoyi.web.modules.screen.service.IHomeScreenService;
@@ -171,6 +174,20 @@ public class HomeScreenServiceImpl implements IHomeScreenService
         return rows;
     }
 
+    @Override
+    public HomeScreenTownMapVo loadTownMapMarkers()
+    {
+        int outboundStatYear = Year.now().getValue();
+        int herdStatYear = outboundStatYear - 1;
+        List<HomeScreenTownMapMarkerVo> markers = homeScreenStatsMapper.selectTownMapMarkers(herdStatYear,
+                outboundStatYear);
+        HomeScreenTownMapVo vo = new HomeScreenTownMapVo();
+        vo.setHerdStatYear(herdStatYear);
+        vo.setOutboundStatYear(outboundStatYear);
+        vo.setMarkers(markers != null ? markers : Collections.emptyList());
+        return vo;
+    }
+
     private List<Long> safeActivePastureIds()
     {
         List<Long> ids = breedingIndustryStatsMapper.selectActivePastureIds();

baqing-admin/src/main/resources/mapper/screen/HomeScreenStatsMapper.xml

@@ -145,4 +145,22 @@
         where del_flag = '0' and publish_status = 1
         order by 1 desc
     </select>
+
+    <select id="selectTownMapMarkers"
+            resultType="com.ruoyi.web.modules.screen.domain.vo.HomeScreenTownMapMarkerVo">
+        select d.dept_id as townDeptId,
+               d.dept_name as townName,
+               COALESCE(h.yak_total, 0) as yakInventoryCount,
+               COALESCE(o.yak_outbound_count, 0) as yakOutboundCount
+        from sys_dept d
+        left join biz_yak_herd_inventory h
+            on h.town_dept_id = d.dept_id and h.stat_year = #{herdStatYear}
+        left join biz_yak_outbound_report o
+            on o.town_dept_id = d.dept_id and o.stat_year = #{outboundStatYear}
+        where d.parent_id = 100
+          and d.order_num &gt; 12
+          and d.del_flag = '0'
+          and d.status = '0'
+        order by d.order_num asc, d.dept_id asc
+    </select>
 </mapper>

baqing-admin/src/test/java/com/ruoyi/web/modules/screen/controller/HomeScreenControllerApiTest.java

@@ -112,6 +112,38 @@ class HomeScreenControllerApiTest
                 .andExpect(jsonPath("$.code").value(200));
     }
 
+    @Test
+    @DisplayName("DP-SY-API-038 GET townMapMarkers 地图标注")
+    void api024_townMapMarkers() throws Exception
+    {
+        when(homeScreenService.loadTownMapMarkers()).thenReturn(sampleTownMap());
+        mockMvc.perform(get("/bigScreen/home/townMapMarkers"))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.code").value(200))
+                .andExpect(jsonPath("$.data.herdStatYear").value(2025))
+                .andExpect(jsonPath("$.data.outboundStatYear").value(2026))
+                .andExpect(jsonPath("$.data.markers[0].townDeptId").value(101))
+                .andExpect(jsonPath("$.data.markers[0].townName").value("巴青乡"))
+                .andExpect(jsonPath("$.data.markers[0].yakInventoryCount").value(21587))
+                .andExpect(jsonPath("$.data.markers[0].yakOutboundCount").value(1523));
+    }
+
+    private static com.ruoyi.web.modules.screen.domain.vo.HomeScreenTownMapVo sampleTownMap()
+    {
+        com.ruoyi.web.modules.screen.domain.vo.HomeScreenTownMapMarkerVo marker =
+                new com.ruoyi.web.modules.screen.domain.vo.HomeScreenTownMapMarkerVo();
+        marker.setTownDeptId(101L);
+        marker.setTownName("巴青乡");
+        marker.setYakInventoryCount(21587);
+        marker.setYakOutboundCount(1523);
+        com.ruoyi.web.modules.screen.domain.vo.HomeScreenTownMapVo vo =
+                new com.ruoyi.web.modules.screen.domain.vo.HomeScreenTownMapVo();
+        vo.setHerdStatYear(2025);
+        vo.setOutboundStatYear(2026);
+        vo.setMarkers(Collections.singletonList(marker));
+        return vo;
+    }
+
     private static HomeScreenDashboardVo sampleDashboard()
     {
         HomeScreenDashboardVo vo = new HomeScreenDashboardVo();

baqing-admin/src/test/java/com/ruoyi/web/modules/screen/mapper/HomeScreenStatsMapperXmlTest.java

@@ -24,6 +24,8 @@ class HomeScreenStatsMapperXmlTest
         assertTrue(xml.contains("biz_yak_asset"));
         assertTrue(xml.contains("biz_service_appointment"));
         assertTrue(xml.contains("biz_subsidy_grant_record"));
+        assertTrue(xml.contains("biz_yak_herd_inventory"));
+        assertTrue(xml.contains("biz_yak_outbound_report"));
         assertTrue(xml.contains("status not in (2, 3)"));
     }
 }

baqing-admin/src/test/java/com/ruoyi/web/modules/screen/service/impl/HomeScreenServiceImplTest.java

@@ -2,11 +2,13 @@ package com.ruoyi.web.modules.screen.service.impl;
 
 import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.mockito.ArgumentMatchers.eq;
 import static org.mockito.ArgumentMatchers.any;
 import static org.mockito.ArgumentMatchers.anyList;
 import static org.mockito.Mockito.when;
 
 import java.math.BigDecimal;
+import java.time.Year;
 import java.util.Arrays;
 import java.util.Collections;
 import java.util.List;
@@ -20,6 +22,8 @@ import com.ruoyi.web.modules.industryservice.domain.dto.BreedingIndustryYakSnaps
 import com.ruoyi.web.modules.industryservice.mapper.BreedingIndustryStatsMapper;
 import com.ruoyi.web.modules.industryservice.support.BreedingIndustryRules;
 import com.ruoyi.web.modules.screen.domain.vo.HomeScreenDashboardVo;
+import com.ruoyi.web.modules.screen.domain.vo.HomeScreenTownMapMarkerVo;
+import com.ruoyi.web.modules.screen.domain.vo.HomeScreenTownMapVo;
 import com.ruoyi.web.modules.screen.mapper.HomeScreenStandardMapper;
 import com.ruoyi.web.modules.screen.mapper.HomeScreenStatsMapper;
 
@@ -84,6 +88,27 @@ class HomeScreenServiceImplTest
         assertNotNull(vo.getTrainingTrend());
     }
 
+    @Test
+    @DisplayName("DP-SY-UT-026 地图标注年份与字段")
+    void ut011_townMapMarkers()
+    {
+        int currentYear = Year.now().getValue();
+        HomeScreenTownMapMarkerVo marker = new HomeScreenTownMapMarkerVo();
+        marker.setTownDeptId(101L);
+        marker.setTownName("巴青乡");
+        marker.setYakInventoryCount(100);
+        marker.setYakOutboundCount(50);
+        when(homeScreenStatsMapper.selectTownMapMarkers(eq(currentYear - 1), eq(currentYear)))
+                .thenReturn(Collections.singletonList(marker));
+
+        HomeScreenTownMapVo vo = service.loadTownMapMarkers();
+        assertEquals(currentYear - 1, vo.getHerdStatYear().intValue());
+        assertEquals(currentYear, vo.getOutboundStatYear().intValue());
+        assertEquals(1, vo.getMarkers().size());
+        assertEquals(100, vo.getMarkers().get(0).getYakInventoryCount().intValue());
+        assertEquals(50, vo.getMarkers().get(0).getYakOutboundCount().intValue());
+    }
+
     private void stubBreedingEmpty()
     {
         when(breedingIndustryStatsMapper.selectActivePastureIds()).thenReturn(Collections.singletonList(1L));

doc/大屏/首页/大屏首页功能需求.md

@@ -182,12 +182,13 @@
 - **养殖标准**（分类 Tab + 分页列表，行内查阅）；
 - **农技课堂**（课程视频、实战培训、培训内容合计）；
 - **实战培训报名**（按月活动数与报名人数双曲线）；
+- **地图标注**（全县乡镇牦牛存栏/出栏头数，供首页地图展示）；
 - 无数据、加载中、加载失败等状态展示。
 
 ### 3.2 范围外
 
 - 各业务模块台账的增删改、发布下架、预约受理、补贴登记、标准维护；
-- 导出、打印；地图标点、下钻后台菜单（若后续增加外链须单独评审）；
+- 导出、打印；地图下钻后台菜单（若后续增加外链须单独评审）；
 - 按牧场、区域、自定义日期段筛选（见 **§8**）；
 - 气象、疫病风险专页、共同富裕专页等**其他大屏子页**（各自独立需求）；
 - 大屏端权限与网关策略（由部署约定，本文档不展开）。
@@ -377,6 +378,20 @@ flowchart TB
 
 ---
 
+### 5.12 区块十一：地图标注
+
+| 项 | 规则 |
+| --- | --- |
+| 展示位置 | 首页地图各乡镇标注（以原型为准） |
+| 乡镇范围 | `sys_dept` 中 `parent_id=100` 且 `order_num>12` 的有效乡镇 |
+| 标注字段 | **所属乡镇** `dept_id`、**乡镇名称**、**牦牛存栏数**（头）、**牦牛出栏数**（头） |
+| 存栏口径 | `biz_yak_herd_inventory.yak_total`；统计年 = **当前自然年 − 1** |
+| 出栏口径 | `biz_yak_outbound_report.yak_outbound_count`；统计年 = **当前自然年** |
+| 无填报 | 对应乡镇该年未填报时展示 **0** |
+| 与看板年份 | **不**随页面「统计年份 **Y**」切换；始终按服务器当前自然年取上一年存栏、当年出栏 |
+
+---
+
 ## 6. 图表与列表通用规则
 
 | 项 | 规则 |
@@ -401,6 +416,7 @@ flowchart TB
 | 某标准分类无已发布标准 | 该 Tab 列表空态 |
 | **Y** 年无视频课程且无实战培训 | 农技课堂空态 |
 | **Y** 年无已发布实战培训 | 实战培训报名趋势空态 |
+| 某乡镇无存栏/出栏填报 | 地图标注该乡镇对应头数为 **0** |
 
 ### 7.2 加载与失败
 

doc/大屏/首页/大屏首页技术方案.md

@@ -36,6 +36,9 @@
 | `biz_breeding_standard` 等 5 张标准表 | 养殖标准分页列表 |
 | `biz_tech_resource` | 视频课程（`004008`） |
 | `biz_practical_training` | 实战培训场次与报名趋势 |
+| `biz_yak_herd_inventory` | 地图标注 — 乡镇牦牛存栏（**上一年** `yak_total`） |
+| `biz_yak_outbound_report` | 地图标注 — 乡镇牦牛出栏（**当年** `yak_outbound_count`） |
+| `sys_dept` | 地图标注 — 乡镇列表（`parent_id=100` 且 `order_num>12`） |
 
 ---
 
@@ -183,8 +186,9 @@
 | --- | --- | --- | --- | --- |
 | 3.1 | 看板主数据（除标准分页外全部区块） | GET | `/bigScreen/home/dashboard` | `bigScreen:home:query` |
 | 3.2 | 养殖标准分页列表 | GET | `/bigScreen/home/standards` | 同上 |
+| 3.3 | 地图标注（乡镇存栏/出栏） | GET | `/bigScreen/home/townMapMarkers` | 同上 |
 
-前端：切换 `statYear` → **3.1** + **3.2**（`pageNum=1`）；仅翻页 / 切 Tab → **3.2**。
+前端：切换 `statYear` → **3.1** + **3.2**（`pageNum=1`）；仅翻页 / 切 Tab → **3.2**；进入首页 / 地图刷新 → **3.3**（**不**随 `statYear` 参数变化，按服务器当前自然年计算）。
 
 ---
 
@@ -380,6 +384,48 @@
 
 ---
 
+### 3.3 地图标注
+
+#### Query
+
+无参数。统计年份由服务器当前自然年 `Y` 推导：
+
+| 字段 | 年份 |
+| --- | --- |
+| `herdStatYear` | `Y - 1`（存栏取 `biz_yak_herd_inventory.stat_year`） |
+| `outboundStatYear` | `Y`（出栏取 `biz_yak_outbound_report.stat_year`） |
+
+#### 响应 `data`
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `herdStatYear` | int | 存栏数据年份（上一年） |
+| `outboundStatYear` | int | 出栏数据年份（当年） |
+| `markers` | array | 乡镇标注列表，见下表 |
+
+`markers[]`：
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `townDeptId` | long | 所属乡镇 `dept_id`（`sys_dept`） |
+| `townName` | string | 乡镇名称 |
+| `yakInventoryCount` | int | 牦牛存栏数（头），`biz_yak_herd_inventory.yak_total`；无填报为 **0** |
+| `yakOutboundCount` | int | 牦牛出栏数（头），`biz_yak_outbound_report.yak_outbound_count`；无填报为 **0** |
+
+#### 乡镇范围
+
+与牦牛存栏/出栏填报模块一致：`sys_dept` 中 `parent_id = 100`、`order_num > 12`、`del_flag = '0'`、`status = '0'`，按 `order_num`、`dept_id` 升序。
+
+#### 服务端逻辑（摘要）
+
+```
+1. outboundStatYear = Year.now(); herdStatYear = outboundStatYear - 1
+2. markers = HomeScreenStatsMapper.selectTownMapMarkers(herdStatYear, outboundStatYear)
+3. return AjaxResult.success(vo)
+```
+
+---
+
 ## 4. 菜单与权限（示例）
 
 | 类型 | 名称 | 权限标识 |
@@ -396,7 +442,7 @@ SQL 示例：`sql/big_screen_home_perm.sql`（挂载「大屏」父菜单下）
 - [ ] 复用 `BreedingIndustryStatsMapper` / `BreedingIndustryCalculator`（按 **Y** 与全县牧场）
 - [ ] 预约、补贴、标准、科技资源、实战培训 Mapper 扩展（**§2.6**）
 - [ ] 单元测试：历史年 `statDate`、12 月补 0、主数据不随 **Y** 变、补贴万元、无培训空态、标准 Tab 路由
-- [ ] 接口测试：`/bigScreen/home/dashboard`、`/standards`
+- [ ] 接口测试：`/bigScreen/home/dashboard`、`/standards`、`/townMapMarkers`
 - [ ] 菜单权限 SQL；依赖各业务表 DDL 已执行
 
 ---

doc/大屏/首页/大屏首页测试用例.md

@@ -73,9 +73,10 @@
 | DP-SY-UT-020 | 养殖标准 | 纳入条件 | 单元测试 | JUnit5 | SY-10 | `STD-PUB`+`STD-DRAFT`+`STD-OUT` | `filterStandards(2026)` | 仅 `STD-PUB` 通过 |
 | DP-SY-UT-021 | 可选年份 | 并集含当前年 | 单元测试 | JUnit5 | §2.1 | Mock 出栏年 `[2025]`，其余空；当前 2026 | `buildAvailableYears` | 含 `2026`；降序 |
 | DP-SY-UT-022 | 约束 | 复用 Calculator | 单元测试 | JUnit5 | 技术§2.6 | 检查 HomeScreenService | 月末存栏调用 `BreedingIndustryCalculator` | 无重复实现月末判定 |
-| DP-SY-UT-023 | 约束 | 只读无写 | 单元测试 | JUnit5 | §3.2、SY-14 | 检查 Controller/Service | 无 insert/update/delete | 仅 `dashboard`、`standards` 查询 |
+| DP-SY-UT-023 | 约束 | 只读无写 | 单元测试 | JUnit5 | §3.2、SY-14 | 检查 Controller/Service | 无 insert/update/delete | 仅 `dashboard`、`standards`、`townMapMarkers` 查询 |
 | DP-SY-UT-024 | 约束 | 无标准详情接口 | 单元测试 | JUnit5 | §5.9 | 检查 Controller 映射 | 无 `GET .../standards/{id}` | 仅列表分页 |
 | DP-SY-UT-025 | 缓存 | forceRefresh | 单元测试 | JUnit5 | 技术§2.3 | 启用缓存未过期 | `loadDashboard(2026,true)` | 跳过缓存重新聚合 |
+| DP-SY-UT-026 | 地图标注 | 年份与字段 | 单元测试 | JUnit5 | §5.12 | Mock Mapper 返回 1 乡镇 | `loadTownMapMarkers()` | `herdStatYear=当前年-1`；`outboundStatYear=当前年`；含 `townDeptId`/`townName`/存栏/出栏 |
 
 ---
 
@@ -120,6 +121,7 @@
 | DP-SY-API-035 | 权限 | 无大屏权限 | 接口测试 | Postman | 越权 | 无 `bigScreen:home:query` | `GET dashboard`、`GET standards` | 403 或无权限 |
 | DP-SY-API-036 | 权限 | 有大屏无台账写 | 接口测试 | Postman | 只读 SY-14 | 仅有 query | `GET` 成功；`POST` 牦牛/标准维护接口 | 大屏可读；台账写权限独立 |
 | DP-SY-API-037 | 一致性 | 切年双请求 | 接口测试 | Postman | 技术§3 | 已登录 | 模拟前端切年同时调 `dashboard`+`standards` | 两接口 `statYear` 一致；列表为新年 `pageNum=1` |
+| DP-SY-API-038 | 地图标注 | 乡镇存栏出栏 | 接口测试 | Postman/curl | §5.12 | 乡镇填报表有样本 | `GET .../townMapMarkers` | `code` 成功；含 `herdStatYear`、`outboundStatYear`、`markers[]`；字段与 SQL 一致；无填报为 0 |
 
 ---