畜牧资源

baqing-admin/src/main/java/com/ruoyi/web/modules/prosperity/domain/BizCommonProsperityProject.java

@@ -29,8 +29,8 @@ public class BizCommonProsperityProject extends BaseEntity
     @Size(max = 50, message = "项目简介长度不能超过50个字符")
     private String introduction;
 
-    @NotBlank(message = "建设规模及内容不能为空")
-    @Size(min = 1, max = 500, message = "建设规模及内容长度为1到500个字符")
+    /** 选填 */
+    @Size(max = 500, message = "建设规模及内容长度不能超过500个字符")
     private String projectContent;
 
     /** 投资金额（万元） */

baqing-admin/src/main/java/com/ruoyi/web/modules/prosperity/support/CommonProsperityProjectRules.java

@@ -9,6 +9,9 @@ public final class CommonProsperityProjectRules
     {
     }
 
+    /** 实施年限可选：当前年向前回看年数（含当前年共 LOOKBACK+1=5 个自然年） */
+    public static final int IMPL_YEAR_LOOKBACK = 4;
+
     public static boolean canEdit(Integer publishStatus)
     {
         return publishStatus != null && publishStatus == 0;

baqing-admin/src/main/java/com/ruoyi/web/modules/prosperity/support/CommonProsperityProjectValidation.java

@@ -37,7 +37,8 @@ public final class CommonProsperityProjectValidation
         }
         if (row.getProjectContent() != null)
         {
-            row.setProjectContent(row.getProjectContent().trim());
+            String content = row.getProjectContent().trim();
+            row.setProjectContent(StringUtils.isEmpty(content) ? null : content);
         }
         if (row.getImplStatus() != null)
         {
@@ -109,11 +110,16 @@ public final class CommonProsperityProjectValidation
         }
     }
 
+    /** 选填；有值时长度不超过 500 */
     public static void validateProjectContent(String projectContent)
     {
-        if (StringUtils.isEmpty(projectContent) || projectContent.length() < 1 || projectContent.length() > 500)
+        if (StringUtils.isEmpty(projectContent))
         {
-            throw new ServiceException("建设规模及内容须为1～500个字符");
+            return;
+        }
+        if (projectContent.length() > 500)
+        {
+            throw new ServiceException("建设规模及内容不能超过500个字符");
         }
     }
 
@@ -140,9 +146,10 @@ public final class CommonProsperityProjectValidation
             throw new ServiceException("实施年限不能为空");
         }
         int current = Calendar.getInstance().get(Calendar.YEAR);
-        if (implYear < 2000 || implYear > current)
+        int minYear = current - CommonProsperityProjectRules.IMPL_YEAR_LOOKBACK;
+        if (implYear < minYear || implYear > current)
         {
-            throw new ServiceException("实施年限不合法");
+            throw new ServiceException("实施年限须为当前年及向前共5个自然年");
         }
     }
 

baqing-admin/src/test/java/com/ruoyi/web/modules/prosperity/support/CommonProsperityProjectValidationTest.java

@@ -50,7 +50,8 @@ class CommonProsperityProjectValidationTest
         assertDoesNotThrow(() -> CommonProsperityProjectValidation.validateIntroduction(null));
         assertDoesNotThrow(() -> CommonProsperityProjectValidation.validateIntroduction(""));
         assertThrows(ServiceException.class, () -> CommonProsperityProjectValidation.validateIntroduction(longStr(51)));
-        assertThrows(ServiceException.class, () -> CommonProsperityProjectValidation.validateProjectContent(""));
+        assertDoesNotThrow(() -> CommonProsperityProjectValidation.validateProjectContent(null));
+        assertDoesNotThrow(() -> CommonProsperityProjectValidation.validateProjectContent(""));
         assertThrows(ServiceException.class, () -> CommonProsperityProjectValidation.validateProjectContent(longStr(501)));
         assertDoesNotThrow(() -> CommonProsperityProjectValidation.validateIntroduction("简介"));
         assertDoesNotThrow(() -> CommonProsperityProjectValidation.validateProjectContent("内容"));
@@ -61,10 +62,12 @@ class CommonProsperityProjectValidationTest
     void ut008_implYear()
     {
         int current = Calendar.getInstance().get(Calendar.YEAR);
+        int minYear = current - CommonProsperityProjectRules.IMPL_YEAR_LOOKBACK;
         assertThrows(ServiceException.class, () -> CommonProsperityProjectValidation.validateImplYear(null));
-        assertThrows(ServiceException.class, () -> CommonProsperityProjectValidation.validateImplYear(1999));
+        assertThrows(ServiceException.class, () -> CommonProsperityProjectValidation.validateImplYear(minYear - 1));
         assertThrows(ServiceException.class, () -> CommonProsperityProjectValidation.validateImplYear(current + 1));
         assertDoesNotThrow(() -> CommonProsperityProjectValidation.validateImplYear(current));
+        assertDoesNotThrow(() -> CommonProsperityProjectValidation.validateImplYear(minYear));
     }
 
     @Test

doc/共同富裕/共同富裕项目/共同富裕项目前端技术方案.md

@@ -8,10 +8,10 @@
 
 ## 表单
 
-- 必填：名称、类型、建设规模及内容、实施年限、运营图片 1～3
-- 选填：简介、投资金额、实施情况、视频、封面
+- 必填：名称、类型、实施年限、运营图片 1～3
+- 选填：简介、建设规模及内容、投资金额、实施情况、视频、封面
 - 新增默认 `implYear = 当前年`
-- 年份下拉：`[当前年-5, 当前年]`（**上限为当前年**，不含未来年）
+- 年份下拉：当前年及向前共 5 年（`[当前年-4, 当前年]`，不含未来年）
 
 ## 筛选 / 列表
 

doc/共同富裕/共同富裕项目/共同富裕项目功能需求.md

@@ -29,9 +29,9 @@
 | 项目名称 | 必填；1～20 字 |
 | 项目类型 | 必填；上表三类 |
 | 项目简介 | **选填**；≤50 字 |
-| 建设规模及内容 | 必填；1～500 字（原「项目内容」更名） |
+| 建设规模及内容 | **选填**；≤500 字（原「项目内容」更名） |
 | 投资金额 | 选填；万元；≥0 |
-| 实施年限 | 必填；自然年；**新增默认本年**；可选范围上限为**当前年**（不可选未来年） |
+| 实施年限 | 必填；自然年；**新增默认本年**；可选范围为**当前年及向前共 5 个自然年**（不可选未来年） |
 | 实施情况 | 选填；≤500 字 |
 | 运营图片 | 必填；1～3 张；jpg/jpeg/png |
 | 运营视频 | 选填；mp4 |
@@ -50,5 +50,6 @@
 
 | 版本 | 说明 |
 | --- | --- |
+| 2.2 | 建设规模及内容改选填；实施年限可选为当前年向前共 5 年 |
 | 2.1 | 实施年限可选上限改为当前年（不可选未来年） |
 | 2.0 | 全量覆盖：类型枚举更换；简介改选填；实施起止日→实施年限；新增投资金额、实施情况 |

doc/共同富裕/共同富裕项目/共同富裕项目技术方案.md

@@ -10,9 +10,9 @@
 | --- | --- |
 | `project_type` | 1 和美乡村建设 / 2 人居环境整治提升 / 3 其他项目投入 |
 | `introduction` | 选填 |
-| `project_content` | 建设规模及内容 |
+| `project_content` | 建设规模及内容（选填） |
 | `investment_amount` | 投资金额（万元） |
-| `impl_year` | 实施年限（校验：≥2000 且 ≤当前年） |
+| `impl_year` | 实施年限（校验：当前年及向前共 5 个自然年） |
 | `impl_status` | 实施情况 |
 
 运营图片子表不变：`biz_common_prosperity_project_op_image`。

doc/共同富裕/共同富裕项目/共同富裕项目管理测试用例.md

@@ -7,7 +7,7 @@
 | UT-005 | 项目名称长度 | 空/超 20 失败；1～20 通过 |
 | UT-006 | 项目类型 | 仅 1～3 |
 | UT-007 | 简介选填 / 内容必填 | 简介可空；内容 1～500 |
-| UT-008 | 实施年限 | 必填；`<2000` 或 `>当前年` 失败；当前年通过 |
+| UT-008 | 实施年限 | 必填；`<当前年-4` 或 `>当前年` 失败；边界通过 |
 | UT-008b | 投资金额 | 可空；负数失败 |
 | UT-009 | 运营图片 | 1～3 张 |
 | API-001 | 列表筛选 | 支持 `implYear` |

sql/biz_common_prosperity_project.sql

@@ -6,7 +6,7 @@ CREATE TABLE `biz_common_prosperity_project` (
   `project_name` varchar(64) NOT NULL COMMENT '项目名称',
   `project_type` tinyint(4) NOT NULL COMMENT '1和美乡村建设 2人居环境整治提升 3其他项目投入',
   `introduction` varchar(200) DEFAULT NULL COMMENT '项目简介(选填)',
-  `project_content` varchar(600) NOT NULL COMMENT '建设规模及内容',
+  `project_content` varchar(600) DEFAULT NULL COMMENT '建设规模及内容(选填)',
   `investment_amount` decimal(18,4) DEFAULT NULL COMMENT '投资金额(万元)',
   `impl_year` int(11) NOT NULL COMMENT '实施年限(年)',
   `impl_status` varchar(500) DEFAULT NULL COMMENT '实施情况',