优化

firstleg/AGENTS.md

@@ -86,7 +86,7 @@
 ## 国内货柜履约装柜与 PDA 资源结算
 
 - 新增模拟柜只保存智能装柜的 9 类计划渠道 channel_group_code；未关联已放舱订舱时 channel_code/channel_name 为空，关联后才冻结订舱的实际渠道。智能装柜全局工作台和订舱关联候选均按计划渠道组匹配；服务端把业务渠道分组映射为实际渠道，并分别分页查询候选与 `WAIT_LOADING/EDITING/LOADING` 柜次；候选支持按创建日期和预计到货日期闭区间筛选，状态筛选使用最多四项的 `orderStatuses`，未传表示 `PENDING_REVIEW/WAIT_MEASURE/WAIT_SPLIT/LOADING` 全部未完成状态。状态只用于搜索和展示，能否加入以响应 `canAssign` 为准，由有效柜次占用、剩余箱数、容量、组锁和版本等事实决定；人工加入允许订单国内仓及渠道与柜次不同，智能推荐允许跨国内仓但仍只选择柜次渠道。容积和重量均允许达到柜型额定值的 150%，超过即拒绝。待审核事实必须经 `PendingReviewOrderClient` 重新核验 Order 权威 `SUBMITTED` 订单，待审核或待测量可先占位，但确认预装和启动 PDA 前仍必须进入 `WAIT_SPLIT`。计划明细通过 `totalPackageCount/remainingPackageCount` 返回可调总量和余量：测量前取 Order 原始申报箱数，进入 `WAIT_SPLIT/LOADING` 后取最新已审核测量箱数；只读补充失败时保守回退当前已分配数，调整写入仍重新查询并校验权威数量。同柜不可拆组只有全部成员命中状态集合时才返回，且必须成员完整、满箱并作为单个分页与分配单元，不能跨页或拆分。一次性移除未拣明细时，普通未拣项直接移除；同柜组仅全组未拣时整组移除，任一成员已拣则整组保留，单事务只递增一次计划版本。推荐顺序按入库时间先进先出。装柜计划状态为 `EDITING -> LOADING -> COMPLETED`，PDA 全部明细处理完成后自动完成。
-- 预装进入 `CONFIRMING/CONFIRMED` 只固化确认快照，不得锁死尚未完成柜次的智能装柜分配；装柜计划仍处于 `EDITING/LOADING` 时可继续新增，未产生实物拣货的明细可调整或移除，已拣明细保持锁定。一件代发智能装柜候选以每个未被有效柜次占用的已封托托盘为独立分页、展示和分配单位；同一入仓单有多托时必须逐托返回，其中一托已分配不得隐藏其余未分配托盘。
+- 预装进入 `CONFIRMING/CONFIRMED` 只固化确认快照，不得锁死尚未完成柜次的智能装柜分配；装柜计划仍处于 `EDITING/LOADING` 时可继续新增，未产生实物拣货的明细可调整或移除，已拣明细保持锁定。一件代发智能装柜候选以每个未被有效柜次占用的已封托托盘为独立分页、展示和分配单位；同一入仓单有多托时必须逐托返回，其中一托已分配不得隐藏其余未分配托盘。装柜完成事件必须按计划项 `palletId` 精确冻结每托箱唛与 SKU 清单，不得仅按入仓单或货物明细关联而造成多托交叉重复。
 - 客户入库费用只在登录客户范围、测量审核通过、`feeStatus=SENT` 且存在已发布明细时可见；确认必须具备 `merchant:order:edit`，携带当前 `expectedFeeVersion` 与幂等键。成功后记录确认成员和时间；客户未确认或该票尚未装柜完成时，平台仍可修改箱规规则、生成新费用版本并重新发送，新版本必须清空旧版客户确认快照。仅当“客户已确认且该票已装柜完成”同时成立时最终冻结；装柜完成不得代替客户自动确认。旧版本、未发送或重复异参确认均返回冲突，不做兼容覆盖。
 - PDA 普通散箱拣货以 `fl_inbound_carton_label.box_code` 对应的稳定箱唛箱码为扫描身份；审核建单、重复打印、手工测量和墨家测量复用同一映射，版本字段只用于并发控制，不进入扫码文本。一个有效且未重复的箱码扫描表示拣出一箱，不得以 SKU、商品件数、入库单号或页面展示字段替代箱码。一件代发已封托的 `SEALED_PALLET` 是不可拆整托单元，PDA 可扫描计划快照中的 `palletNo`、用该托任一成员 `boxCode` 反查所属整托，也可在明细卡片手工确认整托；三种入口最终都必须携带权威 `palletNo` 以 `PICK_PALLET` 一次性提交，不能按成员箱逐箱累计、部分拣货或跳拣。PDA 首页从 Warehouse 主档选择启用国内仓，一件代发与装柜待办列表必须按所选 `warehouseId` 服务端过滤；装柜任务内部仍允许跨国内仓，仓库与渠道限制统一由上游装柜编排负责，PDA 只按已生成任务读取各入仓单自身的 `CONFIRMED` 库位资源，不得再用柜次仓库过滤任务明细、库存快照或拣货写入。任务下发与提交契约见 `src/main/resources/openapi/phase3-pda-convergence-v1.yaml`。
 - PDA 部分拣货生成二级子入库单时，数量必须守恒：`已拣数量 + 子单数量 = 拣货前主单可用数量`。子单只允许一层，不能继续拆分。

firstleg/src/main/java/com/baiyue/firstleg/mapper/LoadingCompletedEventMapper.java

@@ -91,7 +91,8 @@ public interface LoadingCompletedEventMapper {
           JOIN fl_dropship_pallet_carton carton ON carton.pallet_id=pallet.id
           JOIN fl_loading_plan_item item ON item.loading_plan_id=#{planId}
            AND item.account_id=carton.tenant_id AND item.inbound_id=carton.inbound_id
-           AND item.inbound_detail_id=carton.inbound_detail_id AND item.deleted=0
+           AND item.inbound_detail_id=carton.inbound_detail_id
+           AND item.pallet_id=pallet.id AND item.deleted=0
          WHERE pallet.pallet_status='SEALED'
          ORDER BY carton.tenant_id,carton.inbound_id,pallet.id,item.inbound_detail_id,carton.id
         """)
@@ -101,7 +102,8 @@ public interface LoadingCompletedEventMapper {
         SELECT COUNT(DISTINCT p.id) FROM fl_dropship_pallet p
         JOIN fl_dropship_pallet_carton c ON c.pallet_id=p.id
         JOIN fl_loading_plan_item i ON i.loading_plan_id=#{planId} AND i.account_id=c.tenant_id
-          AND i.inbound_id=c.inbound_id AND i.deleted=0 WHERE p.pallet_status='SEALED'
+          AND i.inbound_id=c.inbound_id AND i.pallet_id=p.id AND i.deleted=0
+        WHERE p.pallet_status='SEALED'
         """)
     int workPalletCount(@Param("planId") long planId);
 
@@ -109,7 +111,8 @@ public interface LoadingCompletedEventMapper {
         SELECT COUNT(DISTINCT p.id) FROM fl_dropship_pallet p
         JOIN fl_dropship_pallet_carton c ON c.pallet_id=p.id
         JOIN fl_loading_plan_item i ON i.loading_plan_id=#{planId} AND i.account_id=c.tenant_id
-          AND i.inbound_id=c.inbound_id AND i.deleted=0 WHERE p.pallet_status='OPEN'
+          AND i.inbound_id=c.inbound_id AND i.pallet_id=p.id AND i.deleted=0
+        WHERE p.pallet_status='OPEN'
         """)
     int openWorkPalletCount(@Param("planId") long planId);
 

firstleg/src/test/java/com/baiyue/firstleg/service/LoadingCompletedOutboxServiceTest.java

@@ -248,6 +248,12 @@ class LoadingCompletedOutboxServiceTest {
         String actualPalletsSql = String.join(" ", LoadingCompletedEventMapper.class
             .getMethod("actualPalletRows", long.class).getAnnotation(Select.class).value())
             .replaceAll("\\s+", " ");
+        String workPalletCountSql = String.join(" ", LoadingCompletedEventMapper.class
+            .getMethod("workPalletCount", long.class).getAnnotation(Select.class).value())
+            .replaceAll("\\s+", " ");
+        String openWorkPalletCountSql = String.join(" ", LoadingCompletedEventMapper.class
+            .getMethod("openWorkPalletCount", long.class).getAnnotation(Select.class).value())
+            .replaceAll("\\s+", " ");
 
         assertThat(rowsSql).doesNotContain("p.plan_status = 'COMPLETED'")
             .doesNotContain("o.process_status = 'LOADED'")
@@ -276,7 +282,10 @@ class LoadingCompletedOutboxServiceTest {
             .doesNotContain("label.inbound_id = i.inbound_id");
         assertThat(actualPalletsSql)
             .contains("pallet.pallet_no AS pallet_code")
+            .contains("item.pallet_id=pallet.id")
             .doesNotContain("pallet.pallet_code");
+        assertThat(workPalletCountSql).contains("i.pallet_id=p.id");
+        assertThat(openWorkPalletCountSql).contains("i.pallet_id=p.id");
     }
 
     @org.junit.jupiter.params.ParameterizedTest