外部接口

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

@@ -15,6 +15,7 @@ import com.ruoyi.web.modules.industryservice.domain.dto.OpenApiResponse;
 import com.ruoyi.web.modules.industryservice.research.domain.dto.ResearchTokenRequest;
 import com.ruoyi.web.modules.industryservice.research.domain.dto.ResearchTokenVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchCooperativeDevelopmentVo;
+import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchCommonProsperityProjectVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchDisposableIncomeVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchFamilyRanchVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchFarmerHouseholdVo;
@@ -269,4 +270,27 @@ public class ResearchOpenApiController
             return ResearchOpenApiSupport.error(code, ex.getMessage());
         }
     }
+
+    /**
+     * 共同富裕项目列表。
+     */
+    @GetMapping("/common-prosperity-projects")
+    public OpenApiResponse<OpenApiPageResult<ResearchCommonProsperityProjectVo>> listCommonProsperityProjects(
+            @RequestParam(value = "pageNum", defaultValue = "1") int pageNum,
+            @RequestParam(value = "pageSize", defaultValue = "20") int pageSize,
+            @RequestParam(value = "projectName", required = false) String projectName,
+            @RequestParam(value = "projectType", required = false) Integer projectType,
+            @RequestParam(value = "implYear", required = false) Integer implYear)
+    {
+        try
+        {
+            return ResearchOpenApiSupport.success(researchOpenApiService.listCommonProsperityProjects(
+                    pageNum, pageSize, projectName, projectType, implYear));
+        }
+        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/ResearchCommonProsperityProjectVo.java

@@ -0,0 +1,181 @@
+package com.ruoyi.web.modules.industryservice.research.domain.vo;
+
+import java.math.BigDecimal;
+import java.util.Date;
+import com.fasterxml.jackson.annotation.JsonFormat;
+
+/**
+ * 科研开放接口 — 共同富裕项目（不含本地文件路径 / 操作人 / 备注）。
+ */
+public class ResearchCommonProsperityProjectVo
+{
+    /** 项目 ID */
+    private Long projectId;
+
+    /** 项目名称 */
+    private String projectName;
+
+    /** 项目类型（1和美乡村建设 2人居环境整治提升 3其他项目投入） */
+    private Integer projectType;
+
+    /** 项目简介 */
+    private String introduction;
+
+    /** 建设规模及内容 */
+    private String projectContent;
+
+    /** 投资金额（万元） */
+    private BigDecimal investmentAmount;
+
+    /** 实施年限 */
+    private Integer implYear;
+
+    /** 实施情况 */
+    private String implStatus;
+
+    /** 宣传视频 URL */
+    private String videoFileUrl;
+
+    /** 封面图 URL */
+    private String coverFileUrl;
+
+    /** 发布状态（0未发布 1已发布） */
+    private Integer publishStatus;
+
+    /** 发布时间 */
+    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
+    private Date publishTime;
+
+    /** 运营图片数量 */
+    private Integer opImageCount;
+
+    public Long getProjectId()
+    {
+        return projectId;
+    }
+
+    public void setProjectId(Long projectId)
+    {
+        this.projectId = projectId;
+    }
+
+    public String getProjectName()
+    {
+        return projectName;
+    }
+
+    public void setProjectName(String projectName)
+    {
+        this.projectName = projectName;
+    }
+
+    public Integer getProjectType()
+    {
+        return projectType;
+    }
+
+    public void setProjectType(Integer projectType)
+    {
+        this.projectType = projectType;
+    }
+
+    public String getIntroduction()
+    {
+        return introduction;
+    }
+
+    public void setIntroduction(String introduction)
+    {
+        this.introduction = introduction;
+    }
+
+    public String getProjectContent()
+    {
+        return projectContent;
+    }
+
+    public void setProjectContent(String projectContent)
+    {
+        this.projectContent = projectContent;
+    }
+
+    public BigDecimal getInvestmentAmount()
+    {
+        return investmentAmount;
+    }
+
+    public void setInvestmentAmount(BigDecimal investmentAmount)
+    {
+        this.investmentAmount = investmentAmount;
+    }
+
+    public Integer getImplYear()
+    {
+        return implYear;
+    }
+
+    public void setImplYear(Integer implYear)
+    {
+        this.implYear = implYear;
+    }
+
+    public String getImplStatus()
+    {
+        return implStatus;
+    }
+
+    public void setImplStatus(String implStatus)
+    {
+        this.implStatus = implStatus;
+    }
+
+    public String getVideoFileUrl()
+    {
+        return videoFileUrl;
+    }
+
+    public void setVideoFileUrl(String videoFileUrl)
+    {
+        this.videoFileUrl = videoFileUrl;
+    }
+
+    public String getCoverFileUrl()
+    {
+        return coverFileUrl;
+    }
+
+    public void setCoverFileUrl(String coverFileUrl)
+    {
+        this.coverFileUrl = coverFileUrl;
+    }
+
+    public Integer getPublishStatus()
+    {
+        return publishStatus;
+    }
+
+    public void setPublishStatus(Integer publishStatus)
+    {
+        this.publishStatus = publishStatus;
+    }
+
+    public Date getPublishTime()
+    {
+        return publishTime;
+    }
+
+    public void setPublishTime(Date publishTime)
+    {
+        this.publishTime = publishTime;
+    }
+
+    public Integer getOpImageCount()
+    {
+        return opImageCount;
+    }
+
+    public void setOpImageCount(Integer opImageCount)
+    {
+        this.opImageCount = opImageCount;
+    }
+}

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

@@ -3,6 +3,7 @@ package com.ruoyi.web.modules.industryservice.research.service;
 import com.ruoyi.web.modules.industryservice.domain.dto.OpenApiPageResult;
 import com.ruoyi.web.modules.industryservice.research.domain.dto.ResearchTokenVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchCooperativeDevelopmentVo;
+import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchCommonProsperityProjectVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchDisposableIncomeVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchFamilyRanchVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchFarmerHouseholdVo;
@@ -86,4 +87,14 @@ public interface IResearchOpenApiService
      */
     OpenApiPageResult<ResearchFarmerHouseholdVo> listFarmerHouseholds(int pageNum, int pageSize,
             Integer statYear, Integer statMonth, String townName, String villageName);
+
+    /**
+     * 共同富裕项目列表。
+     *
+     * @param projectName 项目名称模糊匹配
+     * @param projectType 项目类型精确匹配
+     * @param implYear 实施年限精确匹配
+     */
+    OpenApiPageResult<ResearchCommonProsperityProjectVo> listCommonProsperityProjects(int pageNum, int pageSize,
+            String projectName, Integer projectType, Integer implYear);
 }

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

@@ -28,6 +28,7 @@ import com.ruoyi.web.modules.industryservice.mapper.BizYakOutboundReportMapper;
 import com.ruoyi.web.modules.industryservice.research.config.ResearchOpenApiProperties;
 import com.ruoyi.web.modules.industryservice.research.domain.dto.ResearchTokenVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchCooperativeDevelopmentVo;
+import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchCommonProsperityProjectVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchDisposableIncomeVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchFamilyRanchVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchFarmerHouseholdVo;
@@ -41,6 +42,8 @@ import com.ruoyi.web.modules.industryservice.research.support.ResearchOpenApiSup
 import com.ruoyi.web.modules.industryservice.research.support.ResearchOpenApiTokenService;
 import com.ruoyi.web.modules.industryservice.service.IBizPastureService;
 import com.ruoyi.web.modules.industryservice.service.IBizYakAssetService;
+import com.ruoyi.web.modules.prosperity.domain.BizCommonProsperityProject;
+import com.ruoyi.web.modules.prosperity.mapper.BizCommonProsperityProjectMapper;
 
 @Service
 public class ResearchOpenApiServiceImpl implements IResearchOpenApiService
@@ -78,6 +81,9 @@ public class ResearchOpenApiServiceImpl implements IResearchOpenApiService
     @Autowired
     private BizFarmerHouseholdMapper bizFarmerHouseholdMapper;
 
+    @Autowired
+    private BizCommonProsperityProjectMapper bizCommonProsperityProjectMapper;
+
     @Override
     public ResearchTokenVo authenticate(String appKey, String appSecret)
     {
@@ -305,6 +311,28 @@ public class ResearchOpenApiServiceImpl implements IResearchOpenApiService
                 rows.stream().map(ResearchOpenApiSupport::toFarmerHouseholdVo).collect(Collectors.toList()));
     }
 
+    @Override
+    public OpenApiPageResult<ResearchCommonProsperityProjectVo> listCommonProsperityProjects(int pageNum, int pageSize,
+            String projectName, Integer projectType, Integer implYear)
+    {
+        tokenService.assertEnabled();
+        int safePageNum = normalizePageNum(pageNum);
+        int safePageSize = normalizePageSize(pageSize);
+        BizCommonProsperityProject query = new BizCommonProsperityProject();
+        if (StringUtils.isNotEmpty(projectName))
+        {
+            query.setProjectName(projectName.trim());
+        }
+        query.setProjectType(projectType);
+        query.setImplYear(implYear);
+        PageHelper.startPage(safePageNum, safePageSize);
+        List<BizCommonProsperityProject> rows =
+                bizCommonProsperityProjectMapper.selectBizCommonProsperityProjectList(query);
+        PageInfo<BizCommonProsperityProject> page = new PageInfo<>(rows);
+        return toPageResult(safePageNum, safePageSize, page.getTotal(),
+                rows.stream().map(ResearchOpenApiSupport::toCommonProsperityProjectVo).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

@@ -13,6 +13,7 @@ import com.ruoyi.web.modules.industryservice.domain.BizYakHerdInventory;
 import com.ruoyi.web.modules.industryservice.domain.BizYakOutboundReport;
 import com.ruoyi.web.modules.industryservice.domain.dto.OpenApiResponse;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchCooperativeDevelopmentVo;
+import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchCommonProsperityProjectVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchDisposableIncomeVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchFamilyRanchVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchFarmerHouseholdVo;
@@ -21,6 +22,7 @@ import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchPastureV
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchYakAssetVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchYakHerdInventoryVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchYakOutboundReportVo;
+import com.ruoyi.web.modules.prosperity.domain.BizCommonProsperityProject;
 
 /**
  * 科研开放接口响应组装与实体脱敏转换。
@@ -326,4 +328,27 @@ public final class ResearchOpenApiSupport
         vo.setSubsidyTotal(row.getSubsidyTotal());
         return vo;
     }
+
+    public static ResearchCommonProsperityProjectVo toCommonProsperityProjectVo(BizCommonProsperityProject row)
+    {
+        if (row == null)
+        {
+            return null;
+        }
+        ResearchCommonProsperityProjectVo vo = new ResearchCommonProsperityProjectVo();
+        vo.setProjectId(row.getId());
+        vo.setProjectName(row.getProjectName());
+        vo.setProjectType(row.getProjectType());
+        vo.setIntroduction(row.getIntroduction());
+        vo.setProjectContent(row.getProjectContent());
+        vo.setInvestmentAmount(row.getInvestmentAmount());
+        vo.setImplYear(row.getImplYear());
+        vo.setImplStatus(row.getImplStatus());
+        vo.setVideoFileUrl(row.getVideoFileUrl());
+        vo.setCoverFileUrl(row.getCoverFileUrl());
+        vo.setPublishStatus(row.getPublishStatus());
+        vo.setPublishTime(row.getPublishTime());
+        vo.setOpImageCount(row.getOpImageCount());
+        return vo;
+    }
 }

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

@@ -22,6 +22,7 @@ import org.springframework.test.web.servlet.setup.MockMvcBuilders;
 import com.ruoyi.web.modules.industryservice.domain.dto.OpenApiPageResult;
 import com.ruoyi.web.modules.industryservice.research.domain.dto.ResearchTokenVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchCooperativeDevelopmentVo;
+import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchCommonProsperityProjectVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchDisposableIncomeVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchFamilyRanchVo;
 import com.ruoyi.web.modules.industryservice.research.domain.vo.ResearchFarmerHouseholdVo;
@@ -283,4 +284,31 @@ class ResearchOpenApiControllerApiTest
                 .andExpect(jsonPath("$.data.records[0].townName").value("雅安镇"))
                 .andExpect(jsonPath("$.data.records[0].villageName").value("荣嘎村"));
     }
+
+    @Test
+    @DisplayName("GET /common-prosperity-projects 成功")
+    void listCommonProsperityProjects() throws Exception
+    {
+        ResearchCommonProsperityProjectVo row = new ResearchCommonProsperityProjectVo();
+        row.setProjectId(1L);
+        row.setProjectName("和美乡村示范项目");
+        row.setProjectType(1);
+        row.setImplYear(2025);
+        OpenApiPageResult<ResearchCommonProsperityProjectVo> page = new OpenApiPageResult<>();
+        page.setPageNum(1);
+        page.setPageSize(20);
+        page.setTotal(1L);
+        page.setRecords(Collections.singletonList(row));
+        when(researchOpenApiService.listCommonProsperityProjects(anyInt(), anyInt(), any(), any(), any()))
+                .thenReturn(page);
+
+        mockMvc.perform(get("/open-api/v1/research/common-prosperity-projects")
+                .param("projectName", "和美")
+                .param("projectType", "1")
+                .param("implYear", "2025"))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.code").value(200))
+                .andExpect(jsonPath("$.data.records[0].projectName").value("和美乡村示范项目"))
+                .andExpect(jsonPath("$.data.records[0].implYear").value(2025));
+    }
 }

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

@@ -35,6 +35,7 @@
 | 家庭牧场数据列表 | 分页返回家庭牧场填报；法人姓名脱敏 |
 | 可支配收入数据列表 | 分页返回县级年度可支配收入填报 |
 | 农牧户数据列表 | 分页返回村级农牧户填报 |
+| 共同富裕项目列表 | 分页返回共同富裕项目 |
 
 **本期不实现：**
 
@@ -219,6 +220,20 @@ sequenceDiagram
 
 **不返回**：部门 ID、创建人、备注等内部字段。
 
+### 6.11 共同富裕项目列表
+
+| 项 | 说明 |
+| --- | --- |
+| 方法 | GET |
+| 路径 | `/common-prosperity-projects` |
+| 鉴权 | Bearer Token |
+| 分页 | 同 §6.2 |
+| 筛选 | `projectName`（项目名称模糊）、`projectType`（项目类型精确，1～3）、`implYear`（实施年限精确） |
+
+**返回字段**：`projectId`、`projectName`、`projectType`、简介与内容、投资金额、实施年限与情况、媒体 URL、发布状态、运营图片数量等。
+
+**不返回**：本地文件路径、创建人、备注等内部字段。
+
 ---
 
 ## 7. 脱敏规则摘要
@@ -263,6 +278,7 @@ sequenceDiagram
 | 家庭牧场数据填报 | 数据源 `biz_family_ranch` |
 | 可支配收入数据填报 | 数据源 `biz_disposable_income` |
 | 农牧户数据填报 | 数据源 `biz_farmer_household` |
+| 共同富裕项目管理 | 数据源 `biz_common_prosperity_project` |
 | 若依权限体系 | **无**关联；开放接口走独立 Token |
 
 ---
@@ -281,5 +297,6 @@ sequenceDiagram
 | 家庭牧场列表 | §6.8 |
 | 可支配收入列表 | §6.9 |
 | 农牧户列表 | §6.10 |
+| 共同富裕项目列表 | §6.11 |
 | 脱敏合规 | §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_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` |
 | **鉴权** | 独立 JWT + Servlet Filter；`@Anonymous` 绕过若依登录，Filter 校验 Bearer Token |
 | **响应** | `OpenApiResponse<T>` + `OpenApiPageResult<T>`（与第三方 farming OpenAPI 同结构） |
 
@@ -221,6 +221,19 @@ Authorization: Bearer <accessToken>
 
 实现说明：直接查 `BizFarmerHouseholdMapper`（清空 `params.dataScope`）。
 
+### 3.11 共同富裕项目列表
+
+```
+GET /open-api/v1/research/common-prosperity-projects?pageNum=1&pageSize=20&projectName=&projectType=1&implYear=2025
+Authorization: Bearer <accessToken>
+```
+
+**查询参数：** `projectName`（模糊）；`projectType` / `implYear`（精确）；分页同前。
+
+**`records[]` 元素（ResearchCommonProsperityProjectVo）：** 项目业务字段与媒体 URL；**不含**本地文件路径、操作人、备注。
+
+实现说明：直接查 `BizCommonProsperityProjectMapper.selectBizCommonProsperityProjectList`。
+
 ---
 
 ## 4. 鉴权流程
@@ -249,8 +262,9 @@ Token 申请：`appKey`/`appSecret` 与配置项精确匹配后签发 JWT（HS51
 | 家庭牧场列表 | `BizFamilyRanchMapper.selectBizFamilyRanchList` | `biz_family_ranch` | 年/月精确；乡镇/村/企业名模糊；清空 `params.dataScope` |
 | 可支配收入列表 | `BizDisposableIncomeMapper.selectBizDisposableIncomeList` | `biz_disposable_income` | 年份精确 |
 | 农牧户列表 | `BizFarmerHouseholdMapper.selectBizFarmerHouseholdList` | `biz_farmer_household` | 年/月精确；乡镇/村名模糊；清空 `params.dataScope` |
+| 共同富裕项目列表 | `BizCommonProsperityProjectMapper.selectBizCommonProsperityProjectList` | `biz_common_prosperity_project` | 项目名模糊；类型/实施年限精确 |
 
-实体 → VO：`ResearchOpenApiSupport.toPastureVo` / `toYakAssetVo` / `toYakHerdInventoryVo` / `toYakOutboundReportVo` / `toCooperativeDevelopmentVo` / `toLivestockProductOutputVo` / `toFamilyRanchVo` / `toDisposableIncomeVo` / `toFarmerHouseholdVo`。
+实体 → VO：`ResearchOpenApiSupport.toPastureVo` / `toYakAssetVo` / `toYakHerdInventoryVo` / `toYakOutboundReportVo` / `toCooperativeDevelopmentVo` / `toLivestockProductOutputVo` / `toFamilyRanchVo` / `toDisposableIncomeVo` / `toFarmerHouseholdVo` / `toCommonProsperityProjectVo`。
 
 ---
 
@@ -323,6 +337,10 @@ curl "http://localhost:8010/open-api/v1/research/disposable-incomes?pageNum=1&pa
 # 10. 农牧户
 curl "http://localhost:8010/open-api/v1/research/farmer-households?pageNum=1&pageSize=10&statYear=2026&townName=雅安" \
   -H "Authorization: Bearer <accessToken>"
+
+# 11. 共同富裕项目
+curl "http://localhost:8010/open-api/v1/research/common-prosperity-projects?pageNum=1&pageSize=10&projectName=和美&implYear=2025" \
+  -H "Authorization: Bearer <accessToken>"
 ```
 
 ---
@@ -351,6 +369,7 @@ curl "http://localhost:8010/open-api/v1/research/farmer-households?pageNum=1&pag
 | §6.8 家庭牧场 | **§3.8**、**§5** BizFamilyRanch |
 | §6.9 可支配收入 | **§3.9**、**§5** BizDisposableIncome |
 | §6.10 农牧户 | **§3.10**、**§5** BizFarmerHousehold |
+| §6.11 共同富裕项目 | **§3.11**、**§5** BizCommonProsperityProject |
 | §7 脱敏 | **§6** Masking |
 | §3 不实现机构区分 | 单一 app-key/secret，JWT 无 clientId |
 
@@ -360,6 +379,7 @@ curl "http://localhost:8010/open-api/v1/research/farmer-households?pageNum=1&pag
 
 | 版本 | 日期 | 说明 |
 | --- | --- | --- |
+| 1.8 | 2026-07-22 | 新增共同富裕项目开放列表（项目名模糊/类型与实施年限精确+分页） |
 | 1.7 | 2026-07-22 | 新增农牧户开放列表（年/月/乡镇村模糊+分页） |
 | 1.6 | 2026-07-22 | 新增可支配收入开放列表（年份精确+分页） |
 | 1.5 | 2026-07-22 | 新增家庭牧场开放列表（年/月/乡镇村/企业名模糊+分页；法人脱敏） |

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

@@ -57,6 +57,8 @@
 | KYKF-API-024 | 可支配收入 | 年份筛选 | 接口测试 | curl | §6.9 | 已知年份 | GET 带 `statYear` | 仅返回该年记录 |
 | KYKF-API-025 | 农牧户 | 分页列表 | 接口测试 | curl | §6.10 | 有效 Token；库有农牧户数据 | GET `/farmer-households?pageNum=1&pageSize=10` | `code=200`；无部门 ID |
 | KYKF-API-026 | 农牧户 | 年/月/乡镇村筛选 | 接口测试 | curl | §6.10 | 已知年月与乡镇名片段 | GET 带筛选参数 | 条件生效；名称模糊匹配 |
+| KYKF-API-027 | 共同富裕项目 | 分页列表 | 接口测试 | curl | §6.11 | 有效 Token；库有项目数据 | GET `/common-prosperity-projects?pageNum=1&pageSize=10` | `code=200`；无本地路径/操作人 |
+| KYKF-API-028 | 共同富裕项目 | 名称/类型/年限筛选 | 接口测试 | curl | §6.11 | 已知项目名片段与类型 | GET 带筛选参数 | 条件生效；名称模糊、类型与年限精确 |
 
 ---
 
@@ -74,11 +76,12 @@
 | §6.8 家庭牧场列表 | — | API-021～022 |
 | §6.9 可支配收入列表 | — | API-023～024 |
 | §6.10 农牧户列表 | — | API-025～026 |
+| §6.11 共同富裕项目列表 | — | API-027～028 |
 | §7 脱敏 | UT-001～004 | API-012 |
 | §2 分页 | — | API-010 |
 | §3 无机构区分 | UT-005 | API-001（单一凭证） |
 
-**用例统计**：单元 **6**、接口 **26**，合计 **32** 条。
+**用例统计**：单元 **6**、接口 **28**，合计 **34** 条。
 
 ---
 
@@ -100,6 +103,7 @@ curl -s "$BASE/livestock-product-outputs?pageNum=1&pageSize=5&statYear=2026" -H
 curl -s "$BASE/family-ranches?pageNum=1&pageSize=5&statYear=2026" -H "Authorization: Bearer $TOKEN"
 curl -s "$BASE/disposable-incomes?pageNum=1&pageSize=5&statYear=2025" -H "Authorization: Bearer $TOKEN"
 curl -s "$BASE/farmer-households?pageNum=1&pageSize=5&statYear=2026" -H "Authorization: Bearer $TOKEN"
+curl -s "$BASE/common-prosperity-projects?pageNum=1&pageSize=5&implYear=2025" -H "Authorization: Bearer $TOKEN"
 ```
 
 （Windows 环境可用 PowerShell `Invoke-RestMethod`，见技术方案 **§8**。）