可支配收入数据填报

baqing-admin/src/main/java/com/ruoyi/web/modules/industryservice/domain/BizDisposableIncome.java

@@ -22,10 +22,10 @@ public class BizDisposableIncome extends BaseEntity
     /** 脱贫人口人均纯收入（元） */
     private BigDecimal povertyNetIncome;
 
-    /** 增幅（元）= 本年可支配收入 - 上年可支配收入，非落库 */
+    /** 增幅（元），可选；公式=本年可支配收入-上年可支配收入 */
     private BigDecimal incomeIncrease;
 
-    /** 增速 = 增幅 / 上年可支配收入，非落库 */
+    /** 增速，可选；公式=增幅/上年可支配收入 */
     private BigDecimal incomeGrowthRate;
 
     public Long getId()

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

@@ -25,23 +25,13 @@ public class BizDisposableIncomeServiceImpl implements IBizDisposableIncomeServi
     @Override
     public BizDisposableIncome selectBizDisposableIncomeById(Long id)
     {
-        BizDisposableIncome row = bizDisposableIncomeMapper.selectBizDisposableIncomeById(id);
-        fillGrowth(row);
-        return row;
+        return bizDisposableIncomeMapper.selectBizDisposableIncomeById(id);
     }
 
     @Override
     public List<BizDisposableIncome> selectBizDisposableIncomeList(BizDisposableIncome query)
     {
-        List<BizDisposableIncome> list = bizDisposableIncomeMapper.selectBizDisposableIncomeList(query);
-        if (list != null)
-        {
-            for (BizDisposableIncome row : list)
-            {
-                fillGrowth(row);
-            }
-        }
-        return list;
+        return bizDisposableIncomeMapper.selectBizDisposableIncomeList(query);
     }
 
     @Override
@@ -50,6 +40,7 @@ public class BizDisposableIncomeServiceImpl implements IBizDisposableIncomeServi
     {
         DisposableIncomeValidation.validateRowForSave(row);
         assertUniqueYear(row.getStatYear(), null);
+        applyMissingGrowth(row);
         return bizDisposableIncomeMapper.insertBizDisposableIncome(row);
     }
 
@@ -64,6 +55,7 @@ public class BizDisposableIncomeServiceImpl implements IBizDisposableIncomeServi
         DisposableIncomeValidation.validateRowForSave(row);
         requireExistingRow(row.getId());
         assertUniqueYear(row.getStatYear(), row.getId());
+        applyMissingGrowth(row);
         return bizDisposableIncomeMapper.updateBizDisposableIncome(row);
     }
 
@@ -96,14 +88,15 @@ public class BizDisposableIncomeServiceImpl implements IBizDisposableIncomeServi
         return YakHerdInventoryYearSupport.resolveYearOptions();
     }
 
-    private void fillGrowth(BizDisposableIncome row)
+    /** 增幅、增速未填时，按上年可支配收入公式补齐 */
+    private void applyMissingGrowth(BizDisposableIncome row)
     {
         if (row == null || row.getStatYear() == null)
         {
             return;
         }
         BizDisposableIncome previous = bizDisposableIncomeMapper.selectByStatYear(row.getStatYear() - 1);
-        DisposableIncomeGrowthSupport.fillGrowth(row, previous);
+        DisposableIncomeGrowthSupport.fillMissingGrowth(row, previous);
     }
 
     private void assertUniqueYear(Integer statYear, Long excludeId)

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

@@ -5,24 +5,27 @@ import java.math.RoundingMode;
 import com.ruoyi.web.modules.industryservice.domain.BizDisposableIncome;
 
 /**
- * 可支配收入增幅、增速计算：增幅=本年-上年；增速=增幅/上年
+ * 可支配收入增幅、增速：可选填；未填时按公式补齐。
+ * 增幅 = 本年人均可支配收入 - 上年人均可支配收入；
+ * 增速 = 增幅 / 上年人均可支配收入。
  */
 public final class DisposableIncomeGrowthSupport
 {
-    private static final int RATE_SCALE = 4;
+    private static final int RATE_SCALE = 6;
 
     private DisposableIncomeGrowthSupport()
     {
     }
 
-    public static void fillGrowth(BizDisposableIncome current, BizDisposableIncome previousYear)
+    /**
+     * 仅对未填写的增幅、增速按上年数据补齐；已填写的保留。
+     */
+    public static void fillMissingGrowth(BizDisposableIncome current, BizDisposableIncome previousYear)
     {
         if (current == null)
         {
             return;
         }
-        current.setIncomeIncrease(null);
-        current.setIncomeGrowthRate(null);
         if (current.getRuralDisposableIncome() == null || previousYear == null
                 || previousYear.getRuralDisposableIncome() == null)
         {
@@ -30,11 +33,17 @@ public final class DisposableIncomeGrowthSupport
         }
         BigDecimal prev = previousYear.getRuralDisposableIncome();
         BigDecimal increase = current.getRuralDisposableIncome().subtract(prev);
-        current.setIncomeIncrease(increase);
-        if (prev.compareTo(BigDecimal.ZERO) == 0)
+        if (current.getIncomeIncrease() == null)
         {
-            return;
+            current.setIncomeIncrease(increase);
+        }
+        if (current.getIncomeGrowthRate() == null)
+        {
+            BigDecimal usedIncrease = current.getIncomeIncrease() != null ? current.getIncomeIncrease() : increase;
+            if (prev.compareTo(BigDecimal.ZERO) != 0)
+            {
+                current.setIncomeGrowthRate(usedIncrease.divide(prev, RATE_SCALE, RoundingMode.HALF_UP));
+            }
         }
-        current.setIncomeGrowthRate(increase.divide(prev, RATE_SCALE, RoundingMode.HALF_UP));
     }
 }

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

@@ -44,6 +44,7 @@ public final class DisposableIncomeValidation
         {
             throw new ServiceException("脱贫人口人均纯收入不能为负数");
         }
+        // 增幅、增速可选填，无额外必填约束
         if (StringUtils.isNotEmpty(row.getRemark()) && row.getRemark().length() > 500)
         {
             throw new ServiceException("备注不能超过500字");

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

@@ -6,6 +6,8 @@
         <id property="id" column="id"/>
         <result property="statYear" column="stat_year"/>
         <result property="ruralDisposableIncome" column="rural_disposable_income"/>
+        <result property="incomeIncrease" column="income_increase"/>
+        <result property="incomeGrowthRate" column="income_growth_rate"/>
         <result property="povertyNetIncome" column="poverty_net_income"/>
         <result property="createBy" column="create_by"/>
         <result property="createTime" column="create_time"/>
@@ -15,7 +17,8 @@
     </resultMap>
 
     <sql id="selectVo">
-        select r.id, r.stat_year, r.rural_disposable_income, r.poverty_net_income,
+        select r.id, r.stat_year, r.rural_disposable_income, r.income_increase, r.income_growth_rate,
+               r.poverty_net_income,
                r.create_by, r.create_time, r.update_by, r.update_time, r.remark
         from biz_disposable_income r
     </sql>
@@ -49,9 +52,11 @@
     <insert id="insertBizDisposableIncome" parameterType="com.ruoyi.web.modules.industryservice.domain.BizDisposableIncome"
             useGeneratedKeys="true" keyProperty="id">
         insert into biz_disposable_income (
-            stat_year, rural_disposable_income, poverty_net_income, create_by, create_time, remark
+            stat_year, rural_disposable_income, income_increase, income_growth_rate, poverty_net_income,
+            create_by, create_time, remark
         ) values (
-            #{statYear}, #{ruralDisposableIncome}, #{povertyNetIncome}, #{createBy}, sysdate(), #{remark}
+            #{statYear}, #{ruralDisposableIncome}, #{incomeIncrease}, #{incomeGrowthRate}, #{povertyNetIncome},
+            #{createBy}, sysdate(), #{remark}
         )
     </insert>
 
@@ -59,6 +64,8 @@
         update biz_disposable_income set
             stat_year = #{statYear},
             rural_disposable_income = #{ruralDisposableIncome},
+            income_increase = #{incomeIncrease},
+            income_growth_rate = #{incomeGrowthRate},
             poverty_net_income = #{povertyNetIncome},
             update_by = #{updateBy},
             update_time = sysdate(),

baqing-admin/src/test/java/com/ruoyi/web/modules/industryservice/support/DisposableIncomeGrowthSupportTest.java

@@ -12,33 +12,58 @@ import com.ruoyi.web.modules.industryservice.domain.BizDisposableIncome;
 class DisposableIncomeGrowthSupportTest
 {
     @Test
-    @DisplayName("有上年数据时计算增幅与增速")
-    void fillGrowthWithPrevious()
+    @DisplayName("未填时按公式补齐增幅与增速")
+    void fillMissingWhenEmpty()
     {
         BizDisposableIncome current = row(2020, "13346");
         BizDisposableIncome previous = row(2019, "11886");
-        DisposableIncomeGrowthSupport.fillGrowth(current, previous);
+        DisposableIncomeGrowthSupport.fillMissingGrowth(current, previous);
+        assertEquals(0, new BigDecimal("1460").compareTo(current.getIncomeIncrease()));
+        assertEquals(0, new BigDecimal("0.122834").compareTo(current.getIncomeGrowthRate()));
+    }
+
+    @Test
+    @DisplayName("已填写时保留手工值")
+    void keepManualValues()
+    {
+        BizDisposableIncome current = row(2020, "13346");
+        current.setIncomeIncrease(new BigDecimal("1000"));
+        current.setIncomeGrowthRate(new BigDecimal("0.0800"));
+        BizDisposableIncome previous = row(2019, "11886");
+        DisposableIncomeGrowthSupport.fillMissingGrowth(current, previous);
+        assertEquals(new BigDecimal("1000"), current.getIncomeIncrease());
+        assertEquals(new BigDecimal("0.0800"), current.getIncomeGrowthRate());
+    }
+
+    @Test
+    @DisplayName("仅缺增速时用已填增幅计算")
+    void fillRateFromManualIncrease()
+    {
+        BizDisposableIncome current = row(2020, "13346");
+        current.setIncomeIncrease(new BigDecimal("1460"));
+        BizDisposableIncome previous = row(2019, "11886");
+        DisposableIncomeGrowthSupport.fillMissingGrowth(current, previous);
         assertEquals(new BigDecimal("1460"), current.getIncomeIncrease());
-        assertEquals(new BigDecimal("0.1228"), current.getIncomeGrowthRate());
+        assertEquals(0, new BigDecimal("0.122834").compareTo(current.getIncomeGrowthRate()));
     }
 
     @Test
-    @DisplayName("无上年数据时增幅增速为空")
-    void fillGrowthWithoutPrevious()
+    @DisplayName("无上年数据时不补齐")
+    void noPreviousKeepsNull()
     {
         BizDisposableIncome current = row(2019, "11886");
-        DisposableIncomeGrowthSupport.fillGrowth(current, null);
+        DisposableIncomeGrowthSupport.fillMissingGrowth(current, null);
         assertNull(current.getIncomeIncrease());
         assertNull(current.getIncomeGrowthRate());
     }
 
     @Test
-    @DisplayName("上年可支配收入为0时仅填增幅")
-    void fillGrowthWhenPreviousZero()
+    @DisplayName("上年可支配收入为0时仅补齐增幅")
+    void previousZeroOnlyIncrease()
     {
         BizDisposableIncome current = row(2021, "100");
         BizDisposableIncome previous = row(2020, "0");
-        DisposableIncomeGrowthSupport.fillGrowth(current, previous);
+        DisposableIncomeGrowthSupport.fillMissingGrowth(current, previous);
         assertEquals(new BigDecimal("100"), current.getIncomeIncrease());
         assertNull(current.getIncomeGrowthRate());
     }

doc/产业数据模型及服务/可支配收入数据填报/可支配收入数据填报功能需求.md

@@ -5,7 +5,7 @@
 | 项 | 说明 |
 | --- | --- |
 | 模块名称 | 可支配收入数据填报 |
-| 目标 | 按**所属年份**登记农村居民人均可支配收入、脱贫人口人均纯收入；列表展示增幅与增速 |
+| 目标 | 按**所属年份**登记农村居民人均可支配收入、脱贫人口人均纯收入；增幅/增速可选填 |
 | 关联系统 | 业务后台 |
 | 修订依据 | 交接表 `可支配收入数据填报.xlsx` |
 
@@ -15,7 +15,10 @@
 
 - 一条记录：某一自然年的县级收入快照（无乡镇/村维度）。
 - 唯一键：所属年份。
-- 增幅、增速不落库：增幅 = 本年可支配收入 − 上年可支配收入；增速 = 增幅 / 上年可支配收入。
+- **增幅、增速可选填并落库**：
+  - 增幅 = 人均可支配收入 − 去年人均可支配收入
+  - 增速 = 增幅 / 去年人均可支配收入
+  - 保存时若未填且存在上年数据，按公式自动补齐；已填则保留手工值。
 - 无导入 / 导出。
 
 ---
@@ -25,8 +28,8 @@
 | 能力 | 说明 |
 | --- | --- |
 | 分页列表 | 筛选：所属年份；列：年份、农村居民人均可支配收入、增幅、增速、脱贫人口人均纯收入 |
-| 新增 / 修改 | 年份、人均可支配收入、人均纯收入、备注；新增默认本年 |
-| 详情 | 全部字段含增幅、增速 |
+| 新增 / 修改 | 年份、人均可支配收入、增幅（选填）、增速（选填）、人均纯收入、备注；新增默认本年 |
+| 详情 | 全部字段 |
 | 删除 | 物理删除 |
 
 ---
@@ -41,4 +44,5 @@
 
 | 版本 | 说明 |
 | --- | --- |
-| 1.0 | 首版：县级年度 CRUD；增幅/增速计算展示 |
+| 1.0 | 首版：县级年度 CRUD |
+| 1.1 | 增幅、增速改为可选填落库；未填按公式补齐 |

doc/产业数据模型及服务/可支配收入数据填报/可支配收入数据填报技术方案.md

@@ -19,11 +19,11 @@
 | --- | --- |
 | stat_year | 所属年份，唯一 |
 | rural_disposable_income | 农村居民人均可支配收入（元） |
+| income_increase | 增幅（元），可选；未填时=本年−上年 |
+| income_growth_rate | 增速，可选；未填时=增幅/上年 |
 | poverty_net_income | 脱贫人口人均纯收入（元） |
 | remark | 备注 |
 
-非落库：`incomeIncrease`、`incomeGrowthRate`（列表/详情按上年记录计算）。
-
 ## 3. 前端
 
 - 页面：`ruoyi-ui/src/views/dataModel/disposableIncome/index.vue`

doc/产业数据模型及服务/可支配收入数据填报/可支配收入数据填报测试用例.md

@@ -12,14 +12,15 @@
 
 | 用例编号 | 测试模块 | 测试项 | 测试类型 | 测试工具 | 测试目的 | 前置条件 | 测试步骤 | 预期结果 |
 | --- | --- | --- | --- | --- | --- | --- | --- | --- |
-| ZCZX-KZPMSR-UT-001 | 增幅增速 | 有上年数据 | 单元测试 | JUnit5 | 计算逻辑 | 本年 13346、上年 11886 | `DisposableIncomeGrowthSupport.fillGrowth` | 增幅=1460；增速≈0.1228 |
-| ZCZX-KZPMSR-UT-002 | 增幅增速 | 无上年数据 | 单元测试 | JUnit5 | 首年无对比 | previous=null | `fillGrowth` | 增幅、增速均为 null |
-| ZCZX-KZPMSR-UT-003 | 增幅增速 | 上年为 0 | 单元测试 | JUnit5 | 除零保护 | 上年可支配收入=0 | `fillGrowth` | 增幅有值；增速为 null |
-| ZCZX-KZPMSR-UT-004 | 校验 | 必填年份 | 单元测试 | JUnit5 | 保存校验 | 缺 `statYear` | `validateRowForSave` | 抛 `ServiceException` |
-| ZCZX-KZPMSR-UT-005 | 校验 | 非法年份 | 单元测试 | JUnit5 | 年份范围 | `statYear=1999` | `validateRowForSave` | 抛「所属年份不在可选范围内」 |
-| ZCZX-KZPMSR-UT-006 | 校验 | 负收入拒绝 | 单元测试 | JUnit5 | 非负约束 | 可支配收入=-1 | `validateRowForSave` | 抛 `ServiceException` |
-| ZCZX-KZPMSR-UT-007 | 校验 | 备注超长 | 单元测试 | JUnit5 | 长度限制 | remark 长度>500 | `validateRowForSave` | 抛「备注不能超过500字」 |
-| ZCZX-KZPMSR-UT-008 | 校验 | 合法保存 | 单元测试 | JUnit5 | 正向 | 本年合法数据 | `validateRowForSave` | 不抛异常 |
+| ZCZX-KZPMSR-UT-001 | 增幅增速 | 未填时按公式补齐 | 单元测试 | JUnit5 | 可选填+公式 | 本年 13346、上年 11886 | `fillMissingGrowth` | 增幅=1460；增速≈0.1228 |
+| ZCZX-KZPMSR-UT-002 | 增幅增速 | 已填保留手工值 | 单元测试 | JUnit5 | 不覆盖 | 已填增幅/增速 | `fillMissingGrowth` | 仍为手工值 |
+| ZCZX-KZPMSR-UT-003 | 增幅增速 | 无上年数据 | 单元测试 | JUnit5 | 首年 | previous=null | `fillMissingGrowth` | 增幅、增速仍为 null |
+| ZCZX-KZPMSR-UT-004 | 增幅增速 | 上年为 0 | 单元测试 | JUnit5 | 除零保护 | 上年可支配收入=0 | `fillMissingGrowth` | 仅补齐增幅；增速仍 null |
+| ZCZX-KZPMSR-UT-005 | 校验 | 必填年份 | 单元测试 | JUnit5 | 保存校验 | 缺 `statYear` | `validateRowForSave` | 抛 `ServiceException` |
+| ZCZX-KZPMSR-UT-006 | 校验 | 非法年份 | 单元测试 | JUnit5 | 年份范围 | `statYear=1999` | `validateRowForSave` | 抛「所属年份不在可选范围内」 |
+| ZCZX-KZPMSR-UT-007 | 校验 | 负收入拒绝 | 单元测试 | JUnit5 | 非负约束 | 可支配收入=-1 | `validateRowForSave` | 抛 `ServiceException` |
+| ZCZX-KZPMSR-UT-008 | 校验 | 备注超长 | 单元测试 | JUnit5 | 长度限制 | remark 长度>500 | `validateRowForSave` | 抛「备注不能超过500字」 |
+| ZCZX-KZPMSR-UT-009 | 校验 | 合法保存 | 单元测试 | JUnit5 | 正向 | 本年合法数据 | `validateRowForSave` | 不抛异常 |
 
 对应代码：`DisposableIncomeGrowthSupportTest`、`DisposableIncomeValidationTest`
 
@@ -31,9 +32,10 @@
 | --- | --- | --- | --- | --- | --- | --- | --- | --- |
 | ZCZX-KZPMSR-API-001 | 列表 | 默认分页 | 接口测试 | Postman | 列表 | 有样本 | `GET /list` | `code=200`；含年份、可支配收入、增幅、增速、人均纯收入 |
 | ZCZX-KZPMSR-API-002 | 列表 | 按年份筛选 | 接口测试 | Postman | 搜索 | 多年数据 | `statYear=2025` | 仅 2025 |
-| ZCZX-KZPMSR-API-003 | 列表 | 增幅增速回填 | 接口测试 | Postman | 计算展示 | 连续两年有数据 | `GET /list` | 较新年份带增幅、增速；最早年可为空 |
+| ZCZX-KZPMSR-API-003 | 列表 | 展示落库增幅增速 | 接口测试 | Postman | 落库展示 | 记录已含增幅增速 | `GET /list` | 返回库中增幅、增速 |
 | ZCZX-KZPMSR-API-004 | 详情 | 全字段 | 接口测试 | Postman | 详情 | 有效 id | `GET /{id}` | 含收入字段与增幅、增速 |
-| ZCZX-KZPMSR-API-005 | 新增 | 必填成功 | 接口测试 | Postman | 新增 | 该年无记录 | `POST` 含年份+两项收入 | 成功 |
+| ZCZX-KZPMSR-API-005 | 新增 | 必填成功 | 接口测试 | Postman | 新增 | 该年无记录 | `POST` 含年份+两项收入 | 成功；有上年时自动补增幅增速 |
+| ZCZX-KZPMSR-API-005a | 新增 | 手工填增幅增速 | 接口测试 | Postman | 可选填 | 有上年 | `POST` 同时传自定义增幅增速 | 成功；保留手工值 |
 | ZCZX-KZPMSR-API-006 | 新增 | 缺年份 | 接口测试 | Postman | 校验 | 已登录 | 缺 `statYear` | 失败 |
 | ZCZX-KZPMSR-API-007 | 新增 | 缺可支配收入 | 接口测试 | Postman | 校验 | 已登录 | 缺 `ruralDisposableIncome` | 失败 |
 | ZCZX-KZPMSR-API-008 | 新增 | 重复年份 | 接口测试 | Postman | 唯一键 | 已有同年记录 | 再 `POST` 同年 | 失败「该年份数据已存在」 |
@@ -55,8 +57,9 @@
 | --- | --- | --- | --- | --- | --- | --- | --- | --- |
 | ZCZX-KZPMSR-UI-001 | 列表 | 列展示 | 界面测试 | Chrome | 列表 | 有数据 | 打开页面 | 显示年份、可支配收入、增幅、增速、人均纯收入 |
 | ZCZX-KZPMSR-UI-002 | 列表 | 年份筛选 | 界面测试 | Chrome | 搜索 | 有多年数据 | 选年份→搜索 | 仅该年 |
-| ZCZX-KZPMSR-UI-003 | 新增 | 默认本年 | 界面测试 | Chrome | 默认值 | 已登录 | 点新增 | 年份默认当前年 |
-| ZCZX-KZPMSR-UI-004 | 新增 | 保存成功 | 界面测试 | Chrome | 新增 | 该年无数据 | 填两项收入→确定 | 提示成功；列表出现 |
+| ZCZX-KZPMSR-UI-003 | 新增 | 默认本年 | 界面测试 | Chrome | 默认值 | 已登录 | 点新增 | 年份默认当前年；增幅、增速可空 |
+| ZCZX-KZPMSR-UI-004 | 新增 | 保存成功 | 界面测试 | Chrome | 新增 | 该年无数据 | 填两项收入→确定 | 提示成功；有上年则列表显示自动增幅增速 |
+| ZCZX-KZPMSR-UI-004a | 新增 | 手工填增幅增速 | 界面测试 | Chrome | 可选填 | 已登录 | 填写增幅、增速后保存 | 列表展示手工值 |
 | ZCZX-KZPMSR-UI-005 | 新增 | 必填校验 | 界面测试 | Chrome | 校验 | 打开新增 | 不填收入直接确定 | 表单校验提示 |
 | ZCZX-KZPMSR-UI-006 | 详情 | 只读含增幅增速 | 界面测试 | Chrome | 详情 | 有上年数据 | 点查看 | 展示增幅、增速（百分比） |
 | ZCZX-KZPMSR-UI-007 | 修改 | 编辑回填 | 界面测试 | Chrome | 修改 | 有效行 | 点编辑 | 表单回填；可保存 |
@@ -70,3 +73,4 @@
 | 版本 | 说明 |
 | --- | --- |
 | 1.0 | 首版：CRUD + 增幅/增速计算；无导入导出用例 |
+| 1.1 | 增幅、增速改为可选填落库；未填按公式补齐 |

sql/biz_disposable_income.sql

@@ -4,6 +4,8 @@ CREATE TABLE `biz_disposable_income` (
   `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '主键',
   `stat_year` int(11) NOT NULL COMMENT '所属年份',
   `rural_disposable_income` decimal(18,2) DEFAULT NULL COMMENT '农村居民人均可支配收入（元）',
+  `income_increase` decimal(18,2) DEFAULT NULL COMMENT '增幅（元），可选；公式=本年可支配收入-上年',
+  `income_growth_rate` decimal(18,6) DEFAULT NULL COMMENT '增速，可选；公式=增幅/上年可支配收入',
   `poverty_net_income` decimal(18,2) DEFAULT NULL COMMENT '脱贫人口人均纯收入（元）',
   `create_by` varchar(64) DEFAULT '' COMMENT '创建者',
   `create_time` datetime DEFAULT NULL COMMENT '创建时间',