外部接口

baqing-admin/src/main/java/com/ruoyi/web/modules/industryservice/research/controller/ResearchOpenApiController.java

@@ -20,6 +20,7 @@ import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchDisposab
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchFamilyRanchVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchFarmerHouseholdVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchLargeLivestockFarmerVo;
+import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchLivestockOwnershipHouseholdVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchLivestockProductOutputVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchPastureVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchVaccinationDataVo;
@@ -344,4 +345,28 @@ public class ResearchOpenApiController
             return ResearchOpenApiSupport.error(code, ex.getMessage());
         }
     }
+
+    /**
+     * 有无畜户数据列表（村级汇总）。
+     */
+    @GetMapping("/livestock-ownership-households")
+    public OpenApiResponse<OpenApiPageResult<ResearchLivestockOwnershipHouseholdVo>> listLivestockOwnershipHouseholds(
+            @RequestParam(value = "pageNum", defaultValue = "1") int pageNum,
+            @RequestParam(value = "pageSize", defaultValue = "20") int pageSize,
+            @RequestParam(value = "statYear", required = false) Integer statYear,
+            @RequestParam(value = "statMonth", required = false) Integer statMonth,
+            @RequestParam(value = "townName", required = false) String townName,
+            @RequestParam(value = "villageName", required = false) String villageName)
+    {
+        try
+        {
+            return ResearchOpenApiSupport.success(researchOpenApiService.listLivestockOwnershipHouseholds(
+                    pageNum, pageSize, statYear, statMonth, townName, villageName));
+        }
+        catch (ServiceException ex)
+        {
+            int code = ex.getCode() != null ? ex.getCode() : 500;
+            return ResearchOpenApiSupport.error(code, ex.getMessage());
+        }
+    }
 }

baqing-admin/src/main/java/com/ruoyi/web/modules/industryservice/research/domain/vo/ResearchLivestockOwnershipHouseholdVo.java

@@ -0,0 +1,163 @@
+package com.ruoyi.web.modules.industryservice.research.domain.vo;
+
+/**
+ * 科研开放接口 — 有无畜户填报记录（村级汇总；不含部门 ID / 备注）。
+ */
+public class ResearchLivestockOwnershipHouseholdVo
+{
+    /** 有无畜户记录 ID */
+    private Long ownershipId;
+
+    /** 所属年份 */
+    private Integer statYear;
+
+    /** 所属月份（1～12） */
+    private Integer statMonth;
+
+    /** 所属乡镇名称 */
+    private String townName;
+
+    /** 所属村名称 */
+    private String villageName;
+
+    /** 有畜户户数 */
+    private Integer withLivestockHouseholdCount;
+
+    /** 有畜户人数 */
+    private Integer withLivestockPopulationCount;
+
+    /** 有畜户劳动力 */
+    private Integer withLivestockLaborCount;
+
+    /** 有畜户牲畜数 */
+    private Integer withLivestockAnimalCount;
+
+    /** 无畜户户数 */
+    private Integer withoutLivestockHouseholdCount;
+
+    /** 无畜户人数 */
+    private Integer withoutLivestockPopulationCount;
+
+    /** 无畜户劳动力 */
+    private Integer withoutLivestockLaborCount;
+
+    public Long getOwnershipId()
+    {
+        return ownershipId;
+    }
+
+    public void setOwnershipId(Long ownershipId)
+    {
+        this.ownershipId = ownershipId;
+    }
+
+    public Integer getStatYear()
+    {
+        return statYear;
+    }
+
+    public void setStatYear(Integer statYear)
+    {
+        this.statYear = statYear;
+    }
+
+    public Integer getStatMonth()
+    {
+        return statMonth;
+    }
+
+    public void setStatMonth(Integer statMonth)
+    {
+        this.statMonth = statMonth;
+    }
+
+    public String getTownName()
+    {
+        return townName;
+    }
+
+    public void setTownName(String townName)
+    {
+        this.townName = townName;
+    }
+
+    public String getVillageName()
+    {
+        return villageName;
+    }
+
+    public void setVillageName(String villageName)
+    {
+        this.villageName = villageName;
+    }
+
+    public Integer getWithLivestockHouseholdCount()
+    {
+        return withLivestockHouseholdCount;
+    }
+
+    public void setWithLivestockHouseholdCount(Integer withLivestockHouseholdCount)
+    {
+        this.withLivestockHouseholdCount = withLivestockHouseholdCount;
+    }
+
+    public Integer getWithLivestockPopulationCount()
+    {
+        return withLivestockPopulationCount;
+    }
+
+    public void setWithLivestockPopulationCount(Integer withLivestockPopulationCount)
+    {
+        this.withLivestockPopulationCount = withLivestockPopulationCount;
+    }
+
+    public Integer getWithLivestockLaborCount()
+    {
+        return withLivestockLaborCount;
+    }
+
+    public void setWithLivestockLaborCount(Integer withLivestockLaborCount)
+    {
+        this.withLivestockLaborCount = withLivestockLaborCount;
+    }
+
+    public Integer getWithLivestockAnimalCount()
+    {
+        return withLivestockAnimalCount;
+    }
+
+    public void setWithLivestockAnimalCount(Integer withLivestockAnimalCount)
+    {
+        this.withLivestockAnimalCount = withLivestockAnimalCount;
+    }
+
+    public Integer getWithoutLivestockHouseholdCount()
+    {
+        return withoutLivestockHouseholdCount;
+    }
+
+    public void setWithoutLivestockHouseholdCount(Integer withoutLivestockHouseholdCount)
+    {
+        this.withoutLivestockHouseholdCount = withoutLivestockHouseholdCount;
+    }
+
+    public Integer getWithoutLivestockPopulationCount()
+    {
+        return withoutLivestockPopulationCount;
+    }
+
+    public void setWithoutLivestockPopulationCount(Integer withoutLivestockPopulationCount)
+    {
+        this.withoutLivestockPopulationCount = withoutLivestockPopulationCount;
+    }
+
+    public Integer getWithoutLivestockLaborCount()
+    {
+        return withoutLivestockLaborCount;
+    }
+
+    public void setWithoutLivestockLaborCount(Integer withoutLivestockLaborCount)
+    {
+        this.withoutLivestockLaborCount = withoutLivestockLaborCount;
+    }
+}

baqing-admin/src/main/java/com/ruoyi/web/modules/industryservice/research/service/IResearchOpenApiService.java

@@ -8,6 +8,7 @@ import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchDisposab
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchFamilyRanchVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchFarmerHouseholdVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchLargeLivestockFarmerVo;
+import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchLivestockOwnershipHouseholdVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchLivestockProductOutputVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchPastureVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchVaccinationDataVo;
@@ -118,4 +119,13 @@ public interface IResearchOpenApiService
      */
     OpenApiPageResult<ResearchVaccinationDataVo> listVaccinationData(int pageNum, int pageSize,
             Integer statYear, Integer statMonth, String townName, String villageName);
+
+    /**
+     * 有无畜户填报列表。
+     *
+     * @param townName 所属乡镇名称模糊匹配
+     * @param villageName 所属村名称模糊匹配
+     */
+    OpenApiPageResult<ResearchLivestockOwnershipHouseholdVo> listLivestockOwnershipHouseholds(int pageNum, int pageSize,
+            Integer statYear, Integer statMonth, String townName, String villageName);
 }

baqing-admin/src/main/java/com/ruoyi/web/modules/industryservice/research/service/impl/ResearchOpenApiServiceImpl.java

@@ -13,6 +13,7 @@ import com.ruoyi.web.modules.industryservice.domain.BizDisposableIncome;
 import com.ruoyi.web.modules.industryservice.domain.BizFamilyRanch;
 import com.ruoyi.web.modules.industryservice.domain.BizFarmerHousehold;
 import com.ruoyi.web.modules.industryservice.domain.BizLargeLivestockFarmer;
+import com.ruoyi.web.modules.industryservice.domain.BizLivestockOwnershipHousehold;
 import com.ruoyi.web.modules.industryservice.domain.BizLivestockProductOutput;
 import com.ruoyi.web.modules.industryservice.domain.BizPasture;
 import com.ruoyi.web.modules.industryservice.domain.BizVaccinationData;
@@ -25,6 +26,7 @@ import com.ruoyi.web.modules.industryservice.mapper.BizDisposableIncomeMapper;
 import com.ruoyi.web.modules.industryservice.mapper.BizFamilyRanchMapper;
 import com.ruoyi.web.modules.industryservice.mapper.BizFarmerHouseholdMapper;
 import com.ruoyi.web.modules.industryservice.mapper.BizLargeLivestockFarmerMapper;
+import com.ruoyi.web.modules.industryservice.mapper.BizLivestockOwnershipHouseholdMapper;
 import com.ruoyi.web.modules.industryservice.mapper.BizLivestockProductOutputMapper;
 import com.ruoyi.web.modules.industryservice.mapper.BizVaccinationDataMapper;
 import com.ruoyi.web.modules.industryservice.mapper.BizYakHerdInventoryMapper;
@@ -37,6 +39,7 @@ import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchDisposab
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchFamilyRanchVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchFarmerHouseholdVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchLargeLivestockFarmerVo;
+import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchLivestockOwnershipHouseholdVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchLivestockProductOutputVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchPastureVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchVaccinationDataVo;
@@ -96,6 +99,9 @@ public class ResearchOpenApiServiceImpl implements IResearchOpenApiService
     @Autowired
     private BizVaccinationDataMapper bizVaccinationDataMapper;
 
+    @Autowired
+    private BizLivestockOwnershipHouseholdMapper bizLivestockOwnershipHouseholdMapper;
+
     @Override
     public ResearchTokenVo authenticate(String appKey, String appSecret)
     {
@@ -403,6 +409,34 @@ public class ResearchOpenApiServiceImpl implements IResearchOpenApiService
                 rows.stream().map(ResearchOpenApiSupport::toVaccinationDataVo).collect(Collectors.toList()));
     }
 
+    @Override
+    public OpenApiPageResult<ResearchLivestockOwnershipHouseholdVo> listLivestockOwnershipHouseholds(int pageNum,
+            int pageSize, Integer statYear, Integer statMonth, String townName, String villageName)
+    {
+        tokenService.assertEnabled();
+        int safePageNum = normalizePageNum(pageNum);
+        int safePageSize = normalizePageSize(pageSize);
+        BizLivestockOwnershipHousehold query = new BizLivestockOwnershipHousehold();
+        query.setStatYear(statYear);
+        query.setStatMonth(statMonth);
+        if (StringUtils.isNotEmpty(townName))
+        {
+            query.setTownName(townName.trim());
+        }
+        if (StringUtils.isNotEmpty(villageName))
+        {
+            query.setVillageName(villageName.trim());
+        }
+        // 开放接口无登录上下文，清空 dataScope，避免走填报部门权限
+        query.getParams().put("dataScope", "");
+        PageHelper.startPage(safePageNum, safePageSize);
+        List<BizLivestockOwnershipHousehold> rows =
+                bizLivestockOwnershipHouseholdMapper.selectBizLivestockOwnershipHouseholdList(query);
+        PageInfo<BizLivestockOwnershipHousehold> page = new PageInfo<>(rows);
+        return toPageResult(safePageNum, safePageSize, page.getTotal(),
+                rows.stream().map(ResearchOpenApiSupport::toLivestockOwnershipHouseholdVo).collect(Collectors.toList()));
+    }
+
     private int normalizePageNum(int pageNum)
     {
         return pageNum > 0 ? pageNum : 1;

baqing-admin/src/main/java/com/ruoyi/web/modules/industryservice/research/support/ResearchOpenApiSupport.java

@@ -7,6 +7,7 @@ import com.ruoyi.web.modules.industryservice.domain.BizDisposableIncome;
 import com.ruoyi.web.modules.industryservice.domain.BizFamilyRanch;
 import com.ruoyi.web.modules.industryservice.domain.BizFarmerHousehold;
 import com.ruoyi.web.modules.industryservice.domain.BizLargeLivestockFarmer;
+import com.ruoyi.web.modules.industryservice.domain.BizLivestockOwnershipHousehold;
 import com.ruoyi.web.modules.industryservice.domain.BizLivestockProductOutput;
 import com.ruoyi.web.modules.industryservice.domain.BizPasture;
 import com.ruoyi.web.modules.industryservice.domain.BizVaccinationData;
@@ -20,6 +21,7 @@ import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchDisposab
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchFamilyRanchVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchFarmerHouseholdVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchLargeLivestockFarmerVo;
+import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchLivestockOwnershipHouseholdVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchLivestockProductOutputVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchPastureVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchVaccinationDataVo;
@@ -418,4 +420,27 @@ public final class ResearchOpenApiSupport
         vo.setImmunityRate(row.getImmunityRate());
         return vo;
     }
+
+    public static ResearchLivestockOwnershipHouseholdVo toLivestockOwnershipHouseholdVo(
+            BizLivestockOwnershipHousehold row)
+    {
+        if (row == null)
+        {
+            return null;
+        }
+        ResearchLivestockOwnershipHouseholdVo vo = new ResearchLivestockOwnershipHouseholdVo();
+        vo.setOwnershipId(row.getId());
+        vo.setStatYear(row.getStatYear());
+        vo.setStatMonth(row.getStatMonth());
+        vo.setTownName(row.getTownName());
+        vo.setVillageName(row.getVillageName());
+        vo.setWithLivestockHouseholdCount(row.getWithLivestockHouseholdCount());
+        vo.setWithLivestockPopulationCount(row.getWithLivestockPopulationCount());
+        vo.setWithLivestockLaborCount(row.getWithLivestockLaborCount());
+        vo.setWithLivestockAnimalCount(row.getWithLivestockAnimalCount());
+        vo.setWithoutLivestockHouseholdCount(row.getWithoutLivestockHouseholdCount());
+        vo.setWithoutLivestockPopulationCount(row.getWithoutLivestockPopulationCount());
+        vo.setWithoutLivestockLaborCount(row.getWithoutLivestockLaborCount());
+        return vo;
+    }
 }

baqing-admin/src/main/resources/mapper/industryservice/BizLivestockOwnershipHouseholdMapper.xml

@@ -80,6 +80,12 @@
             <if test="villageDeptId != null">
                 and r.village_dept_id = #{villageDeptId}
             </if>
+            <if test="townName != null and townName != ''">
+                and r.town_name like concat('%', #{townName}, '%')
+            </if>
+            <if test="villageName != null and villageName != ''">
+                and r.village_name like concat('%', #{villageName}, '%')
+            </if>
             ${params.dataScope}
         </where>
         order by r.stat_year desc, r.stat_month desc, d.order_num asc, r.village_dept_id asc, r.id desc

baqing-admin/src/test/java/com/ruoyi/web/modules/industryservice/research/controller/ResearchOpenApiControllerApiTest.java

@@ -27,6 +27,7 @@ import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchDisposab
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchFamilyRanchVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchFarmerHouseholdVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchLargeLivestockFarmerVo;
+import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchLivestockOwnershipHouseholdVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchLivestockProductOutputVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchPastureVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchVaccinationDataVo;
@@ -372,4 +373,33 @@ class ResearchOpenApiControllerApiTest
                 .andExpect(jsonPath("$.data.records[0].townName").value("雅安镇"))
                 .andExpect(jsonPath("$.data.records[0].villageName").value("荣嘎村"));
     }
+
+    @Test
+    @DisplayName("GET /livestock-ownership-households 成功")
+    void listLivestockOwnershipHouseholds() throws Exception
+    {
+        ResearchLivestockOwnershipHouseholdVo row = new ResearchLivestockOwnershipHouseholdVo();
+        row.setOwnershipId(1L);
+        row.setStatYear(2026);
+        row.setStatMonth(5);
+        row.setTownName("雅安镇");
+        row.setVillageName("荣嘎村");
+        OpenApiPageResult<ResearchLivestockOwnershipHouseholdVo> page = new OpenApiPageResult<>();
+        page.setPageNum(1);
+        page.setPageSize(20);
+        page.setTotal(1L);
+        page.setRecords(Collections.singletonList(row));
+        when(researchOpenApiService.listLivestockOwnershipHouseholds(anyInt(), anyInt(), any(), any(), any(), any()))
+                .thenReturn(page);
+
+        mockMvc.perform(get("/open-api/v1/research/livestock-ownership-households")
+                .param("statYear", "2026")
+                .param("statMonth", "5")
+                .param("townName", "雅安")
+                .param("villageName", "荣嘎"))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.code").value(200))
+                .andExpect(jsonPath("$.data.records[0].townName").value("雅安镇"))
+                .andExpect(jsonPath("$.data.records[0].villageName").value("荣嘎村"));
+    }
 }

doc/产业数据模型及服务/科研开放数据接口/科研开放数据接口功能需求.md

@@ -38,6 +38,7 @@
 | 共同富裕项目列表 | 分页返回共同富裕项目 |
 | 养殖大户数据列表 | 分页返回养殖大户填报；法人姓名脱敏 |
 | 疫苗接种数据列表 | 分页返回村级疫苗接种填报 |
+| 有无畜户数据列表 | 分页返回村级有无畜户填报 |
 
 **本期不实现：**
 
@@ -264,6 +265,20 @@ sequenceDiagram
 
 **不返回**：部门 ID、创建人、备注等内部字段。
 
+### 6.14 有无畜户数据列表
+
+| 项 | 说明 |
+| --- | --- |
+| 方法 | GET |
+| 路径 | `/livestock-ownership-households` |
+| 鉴权 | Bearer Token |
+| 分页 | 同 §6.2 |
+| 筛选 | `statYear`、`statMonth`、`townName`（乡镇模糊）、`villageName`（村模糊） |
+
+**返回字段**：`ownershipId`、年月、乡镇村、有畜户/无畜户户数人数劳动力及有畜户牲畜数。
+
+**不返回**：部门 ID、创建人、备注等内部字段。
+
 ---
 
 ## 7. 脱敏规则摘要
@@ -311,6 +326,7 @@ sequenceDiagram
 | 共同富裕项目管理 | 数据源 `biz_common_prosperity_project` |
 | 养殖大户数据填报 | 数据源 `biz_large_livestock_farmer` |
 | 疫苗接种数据填报 | 数据源 `biz_vaccination_data` |
+| 有无畜户数据填报 | 数据源 `biz_livestock_ownership_household` |
 | 若依权限体系 | **无**关联；开放接口走独立 Token |
 
 ---
@@ -332,5 +348,6 @@ sequenceDiagram
 | 共同富裕项目列表 | §6.11 |
 | 养殖大户列表 | §6.12 |
 | 疫苗接种列表 | §6.13 |
+| 有无畜户列表 | §6.14 |
 | 脱敏合规 | §7 |
 | 本期不实现 | §3 |

doc/产业数据模型及服务/科研开放数据接口/科研开放数据接口技术方案.md

@@ -9,7 +9,7 @@
 | 项 | 说明 |
 | --- | --- |
 | **后端** | RuoYi **v3.9.2**（**springboot2** 分支）：JDK 8、Spring MVC、MyBatis |
-| **数据库** | 只读查询既有表 `biz_pasture`、`biz_yak_asset`、`biz_yak_herd_inventory`、`biz_yak_outbound_report`、`biz_cooperative_development`、`biz_livestock_product_output`、`biz_family_ranch`、`biz_disposable_income`、`biz_farmer_household`、`biz_common_prosperity_project`、`biz_large_livestock_farmer`、`biz_vaccination_data` |
+| **数据库** | 只读查询既有表 `biz_pasture`、`biz_yak_asset`、`biz_yak_herd_inventory`、`biz_yak_outbound_report`、`biz_cooperative_development`、`biz_livestock_product_output`、`biz_family_ranch`、`biz_disposable_income`、`biz_farmer_household`、`biz_common_prosperity_project`、`biz_large_livestock_farmer`、`biz_vaccination_data`、`biz_livestock_ownership_household` |
 | **鉴权** | 独立 JWT + Servlet Filter；`@Anonymous` 绕过若依登录，Filter 校验 Bearer Token |
 | **响应** | `OpenApiResponse<T>` + `OpenApiPageResult<T>`（与第三方 farming OpenAPI 同结构） |
 
@@ -260,6 +260,19 @@ Authorization: Bearer <accessToken>
 
 实现说明：直接查 `BizVaccinationDataMapper`（清空 `params.dataScope`）。
 
+### 3.14 有无畜户数据列表
+
+```
+GET /open-api/v1/research/livestock-ownership-households?pageNum=1&pageSize=20&statYear=2026&statMonth=5&townName=&villageName=
+Authorization: Bearer <accessToken>
+```
+
+**查询参数：** `statYear` / `statMonth`（精确）；`townName` / `villageName`（模糊）；分页同前。
+
+**`records[]` 元素（ResearchLivestockOwnershipHouseholdVo）：** 有畜户/无畜户统计字段；**不含**部门 ID、操作人、备注。
+
+实现说明：直接查 `BizLivestockOwnershipHouseholdMapper`（清空 `params.dataScope`）。
+
 ---
 
 ## 4. 鉴权流程
@@ -291,8 +304,9 @@ Token 申请：`appKey`/`appSecret` 与配置项精确匹配后签发 JWT（HS51
 | 共同富裕项目列表 | `BizCommonProsperityProjectMapper.selectBizCommonProsperityProjectList` | `biz_common_prosperity_project` | 项目名模糊；类型/实施年限精确 |
 | 养殖大户列表 | `BizLargeLivestockFarmerMapper.selectBizLargeLivestockFarmerList` | `biz_large_livestock_farmer` | 年/月精确；乡镇/村/企业名模糊；清空 `params.dataScope` |
 | 疫苗接种列表 | `BizVaccinationDataMapper.selectBizVaccinationDataList` | `biz_vaccination_data` | 年/月精确；乡镇/村名模糊；清空 `params.dataScope` |
+| 有无畜户列表 | `BizLivestockOwnershipHouseholdMapper.selectBizLivestockOwnershipHouseholdList` | `biz_livestock_ownership_household` | 年/月精确；乡镇/村名模糊；清空 `params.dataScope` |
 
-实体 → VO：`ResearchOpenApiSupport.toPastureVo` / `toYakAssetVo` / `toYakHerdInventoryVo` / `toYakOutboundReportVo` / `toCooperativeDevelopmentVo` / `toLivestockProductOutputVo` / `toFamilyRanchVo` / `toDisposableIncomeVo` / `toFarmerHouseholdVo` / `toCommonProsperityProjectVo` / `toLargeLivestockFarmerVo` / `toVaccinationDataVo`。
+实体 → VO：`ResearchOpenApiSupport.toPastureVo` / `toYakAssetVo` / `toYakHerdInventoryVo` / `toYakOutboundReportVo` / `toCooperativeDevelopmentVo` / `toLivestockProductOutputVo` / `toFamilyRanchVo` / `toDisposableIncomeVo` / `toFarmerHouseholdVo` / `toCommonProsperityProjectVo` / `toLargeLivestockFarmerVo` / `toVaccinationDataVo` / `toLivestockOwnershipHouseholdVo`。
 
 ---
 
@@ -377,6 +391,10 @@ curl "http://localhost:8010/open-api/v1/research/large-livestock-farmers?pageNum
 # 13. 疫苗接种
 curl "http://localhost:8010/open-api/v1/research/vaccination-data?pageNum=1&pageSize=10&statYear=2026&townName=雅安" \
   -H "Authorization: Bearer <accessToken>"
+
+# 14. 有无畜户
+curl "http://localhost:8010/open-api/v1/research/livestock-ownership-households?pageNum=1&pageSize=10&statYear=2026&townName=雅安" \
+  -H "Authorization: Bearer <accessToken>"
 ```
 
 ---
@@ -408,6 +426,7 @@ curl "http://localhost:8010/open-api/v1/research/vaccination-data?pageNum=1&page
 | §6.11 共同富裕项目 | **§3.11**、**§5** BizCommonProsperityProject |
 | §6.12 养殖大户 | **§3.12**、**§5** BizLargeLivestockFarmer |
 | §6.13 疫苗接种 | **§3.13**、**§5** BizVaccinationData |
+| §6.14 有无畜户 | **§3.14**、**§5** BizLivestockOwnershipHousehold |
 | §7 脱敏 | **§6** Masking |
 | §3 不实现机构区分 | 单一 app-key/secret，JWT 无 clientId |
 
@@ -417,6 +436,7 @@ curl "http://localhost:8010/open-api/v1/research/vaccination-data?pageNum=1&page
 
 | 版本 | 日期 | 说明 |
 | --- | --- | --- |
+| 1.11 | 2026-07-22 | 新增有无畜户开放列表（年/月/乡镇村模糊+分页） |
 | 1.10 | 2026-07-22 | 新增疫苗接种开放列表（年/月/乡镇村模糊+分页） |
 | 1.9 | 2026-07-22 | 新增养殖大户开放列表（年/月/乡镇村/企业名模糊+分页；法人脱敏） |
 | 1.8 | 2026-07-22 | 新增共同富裕项目开放列表（项目名模糊/类型与实施年限精确+分页） |

doc/产业数据模型及服务/科研开放数据接口/科研开放数据接口测试用例.md

@@ -63,6 +63,8 @@
 | KYKF-API-030 | 养殖大户 | 年/月/乡镇村/企业名筛选 | 接口测试 | curl | §6.12 | 已知企业名片段 | GET 带筛选参数 | 条件生效；名称模糊匹配 |
 | KYKF-API-031 | 疫苗接种 | 分页列表 | 接口测试 | curl | §6.13 | 有效 Token；库有接种数据 | GET `/vaccination-data?pageNum=1&pageSize=10` | `code=200`；无部门 ID |
 | KYKF-API-032 | 疫苗接种 | 年/月/乡镇村筛选 | 接口测试 | curl | §6.13 | 已知年月与乡镇名片段 | GET 带筛选参数 | 条件生效；名称模糊匹配 |
+| KYKF-API-033 | 有无畜户 | 分页列表 | 接口测试 | curl | §6.14 | 有效 Token；库有畜户数据 | GET `/livestock-ownership-households?pageNum=1&pageSize=10` | `code=200`；无部门 ID |
+| KYKF-API-034 | 有无畜户 | 年/月/乡镇村筛选 | 接口测试 | curl | §6.14 | 已知年月与乡镇名片段 | GET 带筛选参数 | 条件生效；名称模糊匹配 |
 
 ---
 
@@ -83,11 +85,12 @@
 | §6.11 共同富裕项目列表 | — | API-027～028 |
 | §6.12 养殖大户列表 | — | API-029～030 |
 | §6.13 疫苗接种列表 | — | API-031～032 |
+| §6.14 有无畜户列表 | — | API-033～034 |
 | §7 脱敏 | UT-001～004 | API-012 |
 | §2 分页 | — | API-010 |
 | §3 无机构区分 | UT-005 | API-001（单一凭证） |
 
-**用例统计**：单元 **6**、接口 **32**，合计 **38** 条。
+**用例统计**：单元 **6**、接口 **34**，合计 **40** 条。
 
 ---
 
@@ -112,6 +115,7 @@ curl -s "$BASE/farmer-households?pageNum=1&pageSize=5&statYear=2026" -H "Authori
 curl -s "$BASE/common-prosperity-projects?pageNum=1&pageSize=5&implYear=2025" -H "Authorization: Bearer $TOKEN"
 curl -s "$BASE/large-livestock-farmers?pageNum=1&pageSize=5&statYear=2026" -H "Authorization: Bearer $TOKEN"
 curl -s "$BASE/vaccination-data?pageNum=1&pageSize=5&statYear=2026" -H "Authorization: Bearer $TOKEN"
+curl -s "$BASE/livestock-ownership-households?pageNum=1&pageSize=5&statYear=2026" -H "Authorization: Bearer $TOKEN"
 ```
 
 （Windows 环境可用 PowerShell `Invoke-RestMethod`，见技术方案 **§8**。）