对接牦牛资产档案

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

@@ -48,8 +48,6 @@ public class BizYakHerdInventory extends BaseEntity
 
     private Integer cowOver12Count;
 
-    private String delFlag;
-
     public Long getId()
     {
         return id;
@@ -219,14 +217,4 @@ public class BizYakHerdInventory extends BaseEntity
     {
         this.cowOver12Count = cowOver12Count;
     }
-
-    public String getDelFlag()
-    {
-        return delFlag;
-    }
-
-    public void setDelFlag(String delFlag)
-    {
-        this.delFlag = delFlag;
-    }
 }

baqing-admin/src/main/java/com/ruoyi/web/modules/industryservice/mapper/BizYakHerdInventoryMapper.java

@@ -11,10 +11,10 @@ public interface BizYakHerdInventoryMapper
 {
     BizYakHerdInventory selectBizYakHerdInventoryById(Long id);
 
-    BizYakHerdInventory selectActiveByYearAndTown(@Param("statYear") Integer statYear,
+    BizYakHerdInventory selectByYearAndTown(@Param("statYear") Integer statYear,
             @Param("townDeptId") Long townDeptId);
 
-    int countActiveByYearAndTownExcludeId(@Param("statYear") Integer statYear,
+    int countByYearAndTownExcludeId(@Param("statYear") Integer statYear,
             @Param("townDeptId") Long townDeptId, @Param("excludeId") Long excludeId);
 
     List<BizYakHerdInventory> selectBizYakHerdInventoryList(BizYakHerdInventory query);
@@ -23,5 +23,5 @@ public interface BizYakHerdInventoryMapper
 
     int updateBizYakHerdInventory(BizYakHerdInventory row);
 
-    int logicDeleteBizYakHerdInventoryByIds(@Param("ids") Long[] ids, @Param("updateBy") String updateBy);
+    int deleteBizYakHerdInventoryByIds(@Param("ids") Long[] ids);
 }

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

@@ -17,7 +17,6 @@ import com.ruoyi.web.modules.industryservice.support.TownDeptSupport;
 import com.ruoyi.web.modules.industryservice.support.YakHerdInventoryExcelExporter;
 import com.ruoyi.web.modules.industryservice.support.YakHerdInventoryExcelParser;
 import com.ruoyi.web.modules.industryservice.support.YakHerdInventoryExcelParser.ParsedRow;
-import com.ruoyi.web.modules.industryservice.support.YakHerdInventoryRules;
 import com.ruoyi.web.modules.industryservice.support.YakHerdInventoryValidation;
 import com.ruoyi.web.modules.industryservice.support.YakHerdInventoryYearSupport;
 
@@ -55,7 +54,6 @@ public class BizYakHerdInventoryServiceImpl implements IBizYakHerdInventoryServi
         YakHerdInventoryValidation.validateRowForSave(row, townDeptSupport);
         fillTownName(row);
         assertUniqueYearTown(row.getStatYear(), row.getTownDeptId(), null);
-        row.setDelFlag(YakHerdInventoryRules.DEL_FLAG_NORMAL);
         return bizYakHerdInventoryMapper.insertBizYakHerdInventory(row);
     }
 
@@ -68,10 +66,9 @@ public class BizYakHerdInventoryServiceImpl implements IBizYakHerdInventoryServi
             throw new ServiceException("主键不能为空");
         }
         YakHerdInventoryValidation.validateRowForSave(row, townDeptSupport);
-        requireActiveRow(row.getId());
+        requireExistingRow(row.getId());
         fillTownName(row);
         assertUniqueYearTown(row.getStatYear(), row.getTownDeptId(), row.getId());
-        row.setDelFlag(YakHerdInventoryRules.DEL_FLAG_NORMAL);
         return bizYakHerdInventoryMapper.updateBizYakHerdInventory(row);
     }
 
@@ -95,7 +92,7 @@ public class BizYakHerdInventoryServiceImpl implements IBizYakHerdInventoryServi
         {
             return 0;
         }
-        return bizYakHerdInventoryMapper.logicDeleteBizYakHerdInventoryByIds(cleaned.toArray(new Long[0]), updateBy);
+        return bizYakHerdInventoryMapper.deleteBizYakHerdInventoryByIds(cleaned.toArray(new Long[0]));
     }
 
     @Override
@@ -190,14 +187,18 @@ public class BizYakHerdInventoryServiceImpl implements IBizYakHerdInventoryServi
                 YakHerdInventoryExcelExporter.toTownMap(list));
     }
 
+    /**
+     * 导入 upsert：唯一键为「所属年份 + 所属乡镇（town_dept_id）」；已存在则全量覆盖更新，否则新增。
+     *
+     * @return true 更新，false 新增
+     */
     private boolean upsertImportRow(BizYakHerdInventory row, String username)
     {
-        BizYakHerdInventory existing = bizYakHerdInventoryMapper.selectActiveByYearAndTown(row.getStatYear(),
+        BizYakHerdInventory existing = bizYakHerdInventoryMapper.selectByYearAndTown(row.getStatYear(),
                 row.getTownDeptId());
         if (existing == null)
         {
             row.setCreateBy(username);
-            row.setDelFlag(YakHerdInventoryRules.DEL_FLAG_NORMAL);
             bizYakHerdInventoryMapper.insertBizYakHerdInventory(row);
             return false;
         }
@@ -218,18 +219,18 @@ public class BizYakHerdInventoryServiceImpl implements IBizYakHerdInventoryServi
 
     private void assertUniqueYearTown(Integer statYear, Long townDeptId, Long excludeId)
     {
-        if (bizYakHerdInventoryMapper.countActiveByYearAndTownExcludeId(statYear, townDeptId, excludeId) > 0)
+        if (bizYakHerdInventoryMapper.countByYearAndTownExcludeId(statYear, townDeptId, excludeId) > 0)
         {
             throw new ServiceException("该年份该乡镇已填报");
         }
     }
 
-    private BizYakHerdInventory requireActiveRow(Long id)
+    private BizYakHerdInventory requireExistingRow(Long id)
     {
         BizYakHerdInventory row = bizYakHerdInventoryMapper.selectBizYakHerdInventoryById(id);
         if (row == null)
         {
-            throw new ServiceException("记录不存在或已删除");
+            throw new ServiceException("记录不存在");
         }
         return row;
     }

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

@@ -5,10 +5,6 @@ package com.ruoyi.web.modules.industryservice.support;
  */
 public final class YakHerdInventoryRules
 {
-    public static final String DEL_FLAG_NORMAL = "0";
-
-    public static final String DEL_FLAG_DELETED = "2";
-
     public static final long TOWN_PARENT_ID = 100L;
 
     public static final int TOWN_MIN_ORDER_NUM = 12;

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

@@ -20,7 +20,6 @@
         <result property="cow13Count"             column="cow_1_3_count"/>
         <result property="cow312Count"            column="cow_3_12_count"/>
         <result property="cowOver12Count"         column="cow_over_12_count"/>
-        <result property="delFlag"                column="del_flag"/>
         <result property="createBy"               column="create_by"/>
         <result property="createTime"             column="create_time"/>
         <result property="updateBy"               column="update_by"/>
@@ -35,29 +34,27 @@
                h.yak_total, h.bull_total, h.cow_total,
                h.breeding_bull_count, h.bull_castrated_count,
                h.cow_under_1_count, h.cow_1_3_count, h.cow_3_12_count, h.cow_over_12_count,
-               h.del_flag, h.create_by, h.create_time, h.update_by, h.update_time, h.remark
+               h.create_by, h.create_time, h.update_by, h.update_time, h.remark
         from biz_yak_herd_inventory h
     </sql>
 
     <select id="selectBizYakHerdInventoryById" parameterType="long" resultMap="BizYakHerdInventoryResult">
         <include refid="selectVo"/>
-        where h.id = #{id} and h.del_flag = '0'
+        where h.id = #{id}
     </select>
 
-    <select id="selectActiveByYearAndTown" resultMap="BizYakHerdInventoryResult">
+    <select id="selectByYearAndTown" resultMap="BizYakHerdInventoryResult">
         <include refid="selectVo"/>
         where h.stat_year = #{statYear}
           and h.town_dept_id = #{townDeptId}
-          and h.del_flag = '0'
         limit 1
     </select>
 
-    <select id="countActiveByYearAndTownExcludeId" resultType="int">
+    <select id="countByYearAndTownExcludeId" resultType="int">
         select count(1)
         from biz_yak_herd_inventory
         where stat_year = #{statYear}
           and town_dept_id = #{townDeptId}
-          and del_flag = '0'
         <if test="excludeId != null">
             and id != #{excludeId}
         </if>
@@ -68,7 +65,6 @@
         <include refid="selectVo"/>
         left join sys_dept d on h.town_dept_id = d.dept_id
         <where>
-            h.del_flag = '0'
             <if test="statYear != null">
                 and h.stat_year = #{statYear}
             </if>
@@ -88,7 +84,7 @@
             yak_total, bull_total, cow_total,
             breeding_bull_count, bull_castrated_count,
             cow_under_1_count, cow_1_3_count, cow_3_12_count, cow_over_12_count,
-            del_flag, create_by, create_time, remark
+            create_by, create_time, remark
         ) values (
             #{statYear}, #{townDeptId}, #{townName},
             #{villageDeptId}, #{villageName},
@@ -96,7 +92,7 @@
             #{yakTotal}, #{bullTotal}, #{cowTotal},
             #{breedingBullCount}, #{bullCastratedCount},
             #{cowUnder1Count}, #{cow13Count}, #{cow312Count}, #{cowOver12Count},
-            #{delFlag}, #{createBy}, sysdate(), #{remark}
+            #{createBy}, sysdate(), #{remark}
         )
     </insert>
 
@@ -121,14 +117,13 @@
             update_by = #{updateBy},
             update_time = sysdate(),
             remark = #{remark}
-        where id = #{id} and del_flag = '0'
+        where id = #{id}
     </update>
 
-    <update id="logicDeleteBizYakHerdInventoryByIds">
-        update biz_yak_herd_inventory set del_flag = '2', update_by = #{updateBy}, update_time = sysdate()
-        where del_flag = '0' and id in
+    <delete id="deleteBizYakHerdInventoryByIds">
+        delete from biz_yak_herd_inventory where id in
         <foreach collection="ids" item="id" open="(" separator="," close=")">
             #{id}
         </foreach>
-    </update>
+    </delete>
 </mapper>

baqing-admin/src/test/java/com/ruoyi/web/modules/industryservice/service/impl/BizYakHerdInventoryServiceImplTest.java

@@ -3,7 +3,6 @@ package com.ruoyi.web.modules.industryservice.service.impl;
 import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertThrows;
 import static org.mockito.ArgumentMatchers.any;
-import static org.mockito.ArgumentMatchers.eq;
 import static org.mockito.Mockito.never;
 import static org.mockito.Mockito.verify;
 import static org.mockito.Mockito.when;
@@ -20,7 +19,6 @@ import com.ruoyi.common.exception.ServiceException;
 import com.ruoyi.web.modules.industryservice.domain.BizYakHerdInventory;
 import com.ruoyi.web.modules.industryservice.mapper.BizYakHerdInventoryMapper;
 import com.ruoyi.web.modules.industryservice.support.TownDeptSupport;
-import com.ruoyi.web.modules.industryservice.support.YakHerdInventoryRules;
 import com.ruoyi.web.modules.industryservice.support.YakHerdInventoryYearSupport;
 
 @ExtendWith(MockitoExtension.class)
@@ -61,7 +59,7 @@ class BizYakHerdInventoryServiceImplTest
     void ut005_duplicateYearTown()
     {
         mockTown();
-        when(mapper.countActiveByYearAndTownExcludeId(2026, 101L, null)).thenReturn(1);
+        when(mapper.countByYearAndTownExcludeId(2026, 101L, null)).thenReturn(1);
         assertThrows(ServiceException.class, () -> service.insertBizYakHerdInventory(sampleRow()));
         verify(mapper, never()).insertBizYakHerdInventory(any());
     }
@@ -71,7 +69,7 @@ class BizYakHerdInventoryServiceImplTest
     void ut006_insertSuccess()
     {
         mockTown();
-        when(mapper.countActiveByYearAndTownExcludeId(2026, 101L, null)).thenReturn(0);
+        when(mapper.countByYearAndTownExcludeId(2026, 101L, null)).thenReturn(0);
         when(mapper.insertBizYakHerdInventory(any())).thenReturn(1);
         assertEquals(1, service.insertBizYakHerdInventory(sampleRow()));
         verify(mapper).insertBizYakHerdInventory(any());
@@ -88,11 +86,12 @@ class BizYakHerdInventoryServiceImplTest
     }
 
     @Test
-    @DisplayName("ZCZX-MYCLTB-UT-014 逻辑删除")
+    @DisplayName("ZCZX-MYCLTB-UT-014 物理删除")
     void ut014_delete()
     {
-        when(mapper.logicDeleteBizYakHerdInventoryByIds(any(), eq("tester"))).thenReturn(1);
+        when(mapper.deleteBizYakHerdInventoryByIds(any())).thenReturn(1);
         assertEquals(1, service.deleteBizYakHerdInventoryByIds(new Long[] { 1L }, "tester"));
+        verify(mapper).deleteBizYakHerdInventoryByIds(any());
     }
 
     @Test
@@ -100,7 +99,7 @@ class BizYakHerdInventoryServiceImplTest
     void ut016_villageDeptOptional()
     {
         mockTown();
-        when(mapper.countActiveByYearAndTownExcludeId(2026, 101L, null)).thenReturn(0);
+        when(mapper.countByYearAndTownExcludeId(2026, 101L, null)).thenReturn(0);
         when(mapper.insertBizYakHerdInventory(any())).thenReturn(1);
         BizYakHerdInventory row = sampleRow();
         row.setVillageDeptId(null);
@@ -133,7 +132,6 @@ class BizYakHerdInventoryServiceImplTest
         row.setTownDeptId(101L);
         row.setTownName("巴青乡");
         row.setYakTotal(100);
-        row.setDelFlag(YakHerdInventoryRules.DEL_FLAG_NORMAL);
         return row;
     }
 }

doc/产业数据模型及服务/牦牛存栏数据填报/牦牛存栏数据填报功能需求.md

@@ -19,7 +19,7 @@
 
 - 一条记录表示：**某一自然年、某一乡镇**的牦牛存栏汇总数据（**不按村居拆行**）。  
 - **所属村居**（`village_name`、`village_dept_id`）为预留字段，**非必填**，本期可空；后续若按村居下钻再扩展。  
-- 同一「所属年份 + 所属乡镇」在系统中**仅允许一条有效记录**（逻辑删除后可重新填报）。
+- 同一「所属年份 + 所属乡镇」在系统中**仅允许一条记录**（物理删除后可重新填报）。
 
 ### 2.2 所属年份
 
@@ -80,7 +80,7 @@
 | 分页列表 | 按所属年份、所属乡镇筛选；见 **§5.1** |
 | 新增 | 手工填报一条乡镇年度数据；见 **§5.2** |
 | 修改 | 编辑已有记录；见 **§5.3** |
-| 删除 | 逻辑删除；见 **§5.4** |
+| 删除 | 物理删除；见 **§5.4** |
 | 详情 | 查看全部字段；见 **§5.5** |
 | Excel 导入 | 按模板批量导入**指定填报年份**下所有乡镇数据；见 **§5.6** |
 | Excel 导出 | 按**指定所属年份**导出巴青县**全部乡镇**存栏数据；见 **§5.7** |
@@ -128,7 +128,6 @@ flowchart TD
 **列表规则**
 
 - 默认每页 **20** 条；排序：**所属年份倒序**，同年内按乡镇 `order_num` 升序（或乡镇名称拼音）。  
-- 仅展示 `del_flag = '0'` 的有效记录。  
 - 支持**重置**筛选。
 
 **列表展示列**
@@ -172,9 +171,9 @@ flowchart TD
 
 | 项 | 要求 |
 | --- | --- |
-| 方式 | 逻辑删除（`del_flag = '2'`） |
+| 方式 | **物理删除**（`DELETE FROM biz_yak_herd_inventory`） |
 | 确认 | 删除前二次确认 |
-| 效果 | 列表不再展示；同年同乡镇可重新新增或导入 |
+| 效果 | 记录从库中移除；同年同乡镇可重新新增或导入 |
 
 ---
 
@@ -196,8 +195,10 @@ flowchart TD
 | 填报年份 | 导入前用户**必须选择**「填报年份」（范围 **§2.2**）；文件中**不写年份**时以所选年份为准 |
 | 解析范围 | 从数据区首行（乡镇列有值）起，至乡镇为空的行结束；**跳过**表头、标题、填表单位等说明行 |
 | 乡镇匹配 | Excel「乡镇」列文本与 `sys_dept.dept_name` **精确匹配**（trim 后）；仅接受 **§2.3** 范围内部门 |
-| 合并策略 | 同年同乡镇已存在 → **更新**；不存在 → **新增** |
-| 结果反馈 | 返回成功/失败条数及失败明细（行号、乡镇、原因） |
+| 唯一键 | **所属年份（填报年份）+ 所属乡镇（`town_dept_id`）**；同一键在库中仅保留一条有效业务数据 |
+| 合并策略 | 按「年份 + 乡镇」**upsert**：该键**已存在** → **全量覆盖更新**；**不存在** → **新增** |
+| 重复导入 | **允许**对同一 `牦牛存栏数据.xlsx` 多次导入；第二次及以后 `updateCount` 增加、`insertCount` 为 0（乡镇均有数据时） |
+| 结果反馈 | 返回 `insertCount`、`updateCount`、失败条数及失败明细（行号、乡镇、原因） |
 | 文件限制 | `.xlsx`；大小上限与项目统一上传限制一致 |
 | 列映射 | 与模板列顺序一致，见技术方案 **§3.8** |
 
@@ -299,3 +300,5 @@ flowchart TD
 | 1.0 | 初稿 |
 | 1.1 | 增加 `village_dept_id` 预留字段；列表列「乡镇」「存栏数」 |
 | 1.2 | 增加 **§5.7 按年份导出** 全县乡镇 Excel；权限 `export` |
+| 1.3 | 明确导入 upsert：唯一键「年份+乡镇」；重复导入更新 |
+| 1.4 | 取消逻辑删除：表无 `del_flag`，删除为物理删除；唯一约束 `uk_year_town` |

doc/产业数据模型及服务/牦牛存栏数据填报/牦牛存栏数据填报技术方案.md

@@ -45,17 +45,17 @@
 | `cow_1_3_count` | `int(11)` | N | 1～3 岁母牛存栏数 |
 | `cow_3_12_count` | `int(11)` | N | 3～12 岁母牛存栏数 |
 | `cow_over_12_count` | `int(11)` | N | 12 岁以上母牛存栏数 |
-| `del_flag` | `char(1)` | Y | `0` 正常 `2` 删除 |
 | `create_by` / `create_time` | — | — | 审计 |
 | `update_by` / `update_time` | — | — | 审计 |
 | `remark` | `varchar(500)` | N | 备注 |
 
+**说明**：本表**不使用逻辑删除**，无 `del_flag` 字段；删除操作为物理删除。
+
 **索引与约束**
 
-- 应用层校验：同年同乡镇仅一条 `del_flag='0'` 有效记录（`countActiveByYearAndTownExcludeId`）。  
+- `UNIQUE uk_year_town (stat_year, town_dept_id)` — 年份+乡镇唯一，支撑导入 upsert。  
 - `KEY idx_stat_year (stat_year)`  
-- `KEY idx_town_dept_id (town_dept_id)`  
-- `KEY idx_del_flag (del_flag)`
+- `KEY idx_town_dept_id (town_dept_id)`
 
 **DDL 文件**：`sql/biz_yak_herd_inventory.sql`
 
@@ -137,7 +137,7 @@ for (int y = current; y >= current - 5; y--) { ... }
 | 各 `*Count` | N | `>= 0` 整数 |
 | `id` | 修改必填 | — |
 
-**唯一性**：`existsActive(statYear, townDeptId, excludeId)` 为 true 则拒绝。
+**唯一性**：`countByYearAndTownExcludeId(statYear, townDeptId, excludeId) > 0` 则拒绝（**手工新增/修改**）；**导入**走 upsert，不受此限。
 
 #### 3.8 导入
 
@@ -145,8 +145,18 @@ for (int y = current; y >= current - 5; y--) { ... }
 
 | 参数 | 必填 | 说明 |
 | --- | --- | --- |
-| `file` | Y | `.xlsx` |
-| `statYear` | Y | 填报年份 |
+| `file` | Y | `.xlsx`（如 `牦牛存栏数据.xlsx`） |
+| `statYear` | Y | 填报年份（所属年份） |
+
+**Upsert 规则**（`BizYakHerdInventoryServiceImpl.upsertImportRow`）：
+
+| 步骤 | 说明 |
+| --- | --- |
+| 1 | 按 `statYear` + `townDeptId` 查询 `selectByYearAndTown` |
+| 2 | 无记录 → `insert`；`insertCount++` |
+| 3 | 有记录 → `updateBizYakHerdInventory` 全字段覆盖；`updateCount++` |
+
+同一文件对**同一 `statYear`** 多次导入：各乡镇行均为更新，不产生重复有效记录。
 
 **响应 `data`**
 
@@ -202,7 +212,7 @@ for (int y = current; y >= current - 5; y--) { ... }
 
 1. 加载 classpath 模板 `YakHerdInventoryExcelExporter.TEMPLATE_CLASSPATH`  
 2. 替换表头中的四位年份为 `statYear`  
-3. 查询 `stat_year = statYear` 且 `del_flag='0'` 的全部记录，按 `town_dept_id` 建 Map  
+3. 查询 `stat_year = statYear` 的全部记录，按 `town_dept_id` 建 Map  
 4. 遍历 `TownDeptSupport.listReportTowns()`，逐乡镇写行；无数据则仅写乡镇名  
 5. 末行写「合计」，对已填报乡镇数值列求和  
 
@@ -265,3 +275,5 @@ for (int y = current; y >= current - 5; y--) { ... }
 | 1.0 | 初稿：表结构、CRUD、导入、sys_dept 乡镇、年份前推 5 年 |
 | 1.1 | 增加预留字段 `village_dept_id`（非必填） |
 | 1.2 | 实现按年份导出全县乡镇 Excel；列映射与代码对齐；交付清单勾选 |
+| 1.3 | 导入 upsert：`selectByYearAndTown` + `updateBizYakHerdInventory`；支持重复导入 |
+| 1.4 | 取消逻辑删除：无 `del_flag`；`deleteBizYakHerdInventoryByIds` 物理删除；`uk_year_town` 唯一约束 |

doc/产业数据模型及服务/牦牛存栏数据填报/牦牛存栏数据填报测试用例.md

@@ -18,15 +18,15 @@
 | ZCZX-MYCLTB-UT-003 | 校验 | 必填年份乡镇 | 单元测试 | JUnit5 | §5.2 | 无 | `validate(row)` 缺 `statYear` | 抛 `ServiceException` |
 | ZCZX-MYCLTB-UT-004 | 校验 | 负数拒绝 | 单元测试 | JUnit5 | §2.5 | 无 | `yakTotal=-1` | 校验失败 |
 | ZCZX-MYCLTB-UT-005 | 唯一性 | 同年同乡镇 | 单元测试 | JUnit5+Mockito | §5.2 | 已存在 2026+巴青乡 | `insert` 同键 | 失败「已填报」 |
-| ZCZX-MYCLTB-UT-006 | 唯一性 | 删除后可新增 | 单元测试 | JUnit5+Mockito | §5.4 | 同年同乡镇 `del_flag=2` | `insert` | 成功 |
+| ZCZX-MYCLTB-UT-006 | 新增 | 新增成功 | 单元测试 | JUnit5+Mockito | §5.2 | 无同年同乡镇记录 | `insert` | 成功 |
 | ZCZX-MYCLTB-UT-007 | 导入解析 | 识别表头行 | 单元测试 | JUnit5 | §3.8.1 | `2026年.xlsx` | `detectHeaderRow(sheet)` | 定位含「乡镇」表头 |
 | ZCZX-MYCLTB-UT-008 | 导入解析 | 乡镇名匹配 | 单元测试 | JUnit5 | §5.6 | 行「杂色镇」 | `resolveTownDeptId` | 返回对应 `dept_id` |
 | ZCZX-MYCLTB-UT-009 | 导入解析 | 未知乡镇 | 单元测试 | JUnit5 | §5.6 | 行「不存在乡」 | 解析 | 记入 `failMessages` |
 | ZCZX-MYCLTB-UT-010 | 导入解析 | 空行终止 | 单元测试 | JUnit5 | §5.6 | 数据后空行 | `parseRows` | 仅 10 乡镇行 |
 | ZCZX-MYCLTB-UT-011 | 导入 | upsert 新增 | 单元测试 | JUnit5+Mockito | §5.6 | DB 无 2025+本塔乡 | `importYear(2025,file)` | `insertCount>=1` |
-| ZCZX-MYCLTB-UT-012 | 导入 | upsert 更新 | 单元测试 | JUnit5+Mockito | §5.6 | 已有 2026+杂色镇 | 改 `yakTotal` 再导入 | `updateCount>=1`；值更新 |
-| ZCZX-MYCLTB-UT-013 | 警告 | 母牛分龄不等 | 单元测试 | JUnit5 | §2.5 | 分龄和≠母牛合计 | 保存/导入 | 成功；`warnMessages` 非空（若启用） |
-| ZCZX-MYCLTB-UT-014 | Mapper | 列表排序 | 单元测试 | JUnit5 | §5.1 | 多年多条 | 查 XML | `stat_year DESC`；乡镇 `order_num` |
+| ZCZX-MYCLTB-UT-012 | 导入 | upsert 更新 | 单元测试 | JUnit5+Mockito | §5.6 | 已有 2026+各乡镇 | 同一 xlsx 再导入 | `updateCount=10`；`insertCount=0` |
+| ZCZX-MYCLTB-UT-013 | 修改 | 记录不存在 | 单元测试 | JUnit5+Mockito | §5.3 | id 不存在 | `update` | 抛 `ServiceException` |
+| ZCZX-MYCLTB-UT-014 | 删除 | 物理删除 | 单元测试 | JUnit5+Mockito | §5.4 | 有效 id | `deleteBizYakHerdInventoryByIds` | 调用 Mapper 物理删除 |
 | ZCZX-MYCLTB-UT-015 | 数据权限 | 乡镇账号过滤 | 单元测试 | JUnit5+Mockito | §6 | 用户 dept=杂色镇 | `selectList` | 仅本乡镇 |
 | ZCZX-MYCLTB-UT-016 | 预留字段 | village_dept_id 可空 | 单元测试 | JUnit5 | §2.4 | 无 | `insert` 不传 `villageDeptId` | 成功 |
 | ZCZX-MYCLTB-UT-017 | 预留字段 | village_dept_id 父子校验 | 单元测试 | JUnit5+Mockito | §2.4 | 乡镇 A、村居 B 非子节点 | `insert` 带错误 `villageDeptId` | 失败（若启用校验）或成功仅存 id |
@@ -49,7 +49,7 @@
 | ZCZX-MYCLTB-API-008 | 新增 | 缺乡镇 | 接口测试 | Postman | §5.2 | 已登录 | 缺 `townDeptId` | 失败 |
 | ZCZX-MYCLTB-API-009 | 新增 | 重复同年乡镇 | 接口测试 | Postman | §5.2 | 已有记录 | 再 `POST` 同键 | 失败 |
 | ZCZX-MYCLTB-API-010 | 修改 | 更新指标 | 接口测试 | Postman | §5.3 | 有效 id | `PUT` 改 `yakTotal` | 成功；详情为新值 |
-| ZCZX-MYCLTB-API-011 | 删除 | 逻辑删除 | 接口测试 | Postman | §5.4 | 有效 id | `DELETE /{id}` | 成功；列表不可见 |
+| ZCZX-MYCLTB-API-011 | 删除 | 物理删除 | 接口测试 | Postman | §5.4 | 有效 id | `DELETE /{id}` | 成功；记录从库中移除 |
 | ZCZX-MYCLTB-API-012 | 下拉 | 年份选项 | 接口测试 | Postman | §2.2 | 已登录 | `GET /yearOptions` | 6 个年份 |
 | ZCZX-MYCLTB-API-013 | 下拉 | 乡镇选项 | 接口测试 | Postman | §2.3 | 已登录 | `GET /townOptions` | 10 个乡镇；`order_num>12` |
 | ZCZX-MYCLTB-API-014 | 导入 | 全量乡镇 | 接口测试 | Postman | §5.6 | 空库 2026 | `POST /importData`+`2026年.xlsx`+`statYear=2026` | `insertCount=10`；`failCount=0` |
@@ -99,7 +99,7 @@
 | §2.2 年份 | 向前 5 年 | UT-001；API-012；UI-005 |
 | §2.3 乡镇 | sys_dept 二级 order_num>12 | UT-002；API-013；UI-006 |
 | §5.1 列表 | 7 数据列+操作；详情全字段 | API-001～004、005；UI-001～003、009 |
-| §5.2～5.4 CRUD | 必填、唯一、删除 | UT-003～006；API-006～011 |
+| §5.2～5.4 CRUD | 必填、唯一、删除 | UT-003～006、013～014；API-006～011 |
 | §5.5 详情 | 全字段 | API-005；UI-009 |
 | §5.6 导入 | 2026年.xlsx | UT-007～012；API-014～017；UI-010～011 |
 | §5.7 导出 | 按年全县乡镇 | UT-018～019；API-021～025；UI-014～015 |
@@ -114,3 +114,5 @@
 | 1.0 | 初版：单元 15、接口 20、UI 13；编号前缀 **ZCZX-MYCLTB** |
 | 1.1 | 补充 `village_dept_id` 预留字段用例 UT-016～017 |
 | 1.2 | 补充按年份导出用例 UT-018～019、API-021～025、UI-014～016 |
+| 1.3 | 补充重复导入 upsert 用例 UT-011～012 |
+| 1.4 | 取消逻辑删除：UT-014 改为物理删除；移除 UT-020 |

sql/biz_yak_herd_inventory.sql

@@ -1,4 +1,4 @@
+-- 牦牛存栏数据填报（物理删除，无 del_flag）
 CREATE TABLE IF NOT EXISTS `biz_yak_herd_inventory` (
   `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '主键',
   `stat_year` int(11) NOT NULL COMMENT '所属年份',
@@ -17,14 +17,13 @@ CREATE TABLE IF NOT EXISTS `biz_yak_herd_inventory` (
   `cow_1_3_count` int(11) DEFAULT NULL COMMENT '1-3岁母牛存栏数',
   `cow_3_12_count` int(11) DEFAULT NULL COMMENT '3-12岁母牛存栏数',
   `cow_over_12_count` int(11) DEFAULT NULL COMMENT '12岁以上母牛存栏数',
-  `del_flag` char(1) NOT NULL DEFAULT '0' COMMENT '0存在 2删除',
   `create_by` varchar(64) DEFAULT '' COMMENT '创建者',
   `create_time` datetime DEFAULT NULL COMMENT '创建时间',
   `update_by` varchar(64) DEFAULT '' COMMENT '更新者',
   `update_time` datetime DEFAULT NULL COMMENT '更新时间',
   `remark` varchar(500) DEFAULT NULL COMMENT '备注',
   PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_year_town` (`stat_year`, `town_dept_id`),
   KEY `idx_stat_year` (`stat_year`),
-  KEY `idx_town_dept_id` (`town_dept_id`),
-  KEY `idx_del_flag` (`del_flag`)
+  KEY `idx_town_dept_id` (`town_dept_id`)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='牦牛存栏数据填报';