feat(fleet): enforce reviewed trips and original fee coverage for dispatch

lastleg-service/src/main/resources/openapi/overseas-pda-operations-v1.yaml

@@ -15,12 +15,13 @@ paths:
   /api/pda/v1/last-leg/dispatches/{dispatchNo}:
     get:
       summary: 查询绑定仓排车任务详情
-      description: 返回 canDepart 与 departBlockReason；PDA 必须以服务端门禁决定是否开放发车，不得仅按本地拣货数量推断。
+      description: 返回 tripNo、tripRecordVersion、tripDispatchCount、driverWarning、canDepart、departBlockReason、canPick 与 pickBlockReason；门禁反映整车所有客户单据、实际装载及当前司机资格，PDA 不得仅按当前子单拣货数量推断。canPick/pickBlockReason仅反映当前客户排车单调度审核，不以其他客户审核结果替代。未关联车次不可拣货或发车；列表按车次复用同次查询的门禁结果。证照30天内到期但覆盖任务时driverWarning提醒且仍允许，预计结束前过期则阻断。
       parameters: [{ name: dispatchNo, in: path, required: true, schema: { type: string } }]
       responses: { '200': { description: 排车托盘、目的仓与库存位置详情 }, '404': { description: 当前绑定仓无此排车任务 } }
   /api/pda/v1/last-leg/dispatches/{dispatchNo}/items/{itemId}/pick:
     post:
       summary: 扫码拣取排车托盘包裹
+      description: 新请求须当前排车调度审核通过；同键同内容重放已保存结果不重新扣库存。
       parameters:
         - { name: dispatchNo, in: path, required: true, schema: { type: string } }
         - { name: itemId, in: path, required: true, schema: { type: string, pattern: '^[0-9]+$' } }
@@ -29,17 +30,17 @@ paths:
   /api/pda/v1/last-leg/dispatches/{dispatchNo}/complete:
     post:
       summary: 完成排车拣货
-      description: 每个要求托盘及全部包裹必须精确完成；不允许部分完成。
+      description: 当前排车调度审核通过且每个要求托盘及全部包裹必须精确完成；不允许部分完成。
       parameters: [{ name: dispatchNo, in: path, required: true, schema: { type: string } }]
       requestBody: { required: true, content: { application/json: { schema: { $ref: '#/components/schemas/IdempotentAction' } } } }
       responses: { '200': { description: READY_TO_DEPART结果 }, '409': { description: 未全部拣货或幂等冲突 } }
   /api/pda/v1/last-leg/dispatches/{dispatchNo}/depart:
     post:
-      summary: 排车发车并完成出库门禁
-      description: 仅完整拣货且存在待出库单时发车；同事务推进出库与排车状态、订单归属并释放托盘锁，不重复扣减扫码时已扣库存。
+      summary: 从排车任务确认所属车次整车发车
+      description: 按Token绑定仓锁定车次，校验期望车次版本、车辆占用、全部调度审核、实际装载、整车理货审核及全部客户拣货和待出库单，重新核验司机证照、当前海外区域和身份；区域或身份变化与预览门禁一致阻断。一个事务推进所有子单，任一失败全车回滚。扫码阶段已扣库存不重复扣减；同键同内容重放整车结果，不同内容冲突。DEPARTING仅是同事务内部状态，不对外提交。
       parameters: [{ name: dispatchNo, in: path, required: true, schema: { type: string } }]
       requestBody: { required: true, content: { application/json: { schema: { $ref: '#/components/schemas/DepartAction' } } } }
-      responses: { '200': { description: DEPARTED结果；同键同请求返回既有结果 }, '409': { description: 拣货、出库或幂等门禁未满足 } }
+      responses: { '200': { description: '统一响应data包含tripNo、status=IN_TRANSIT、departedAt、shippedPackages、dispatches数组（dispatchNo/shippedPackages）和replayed；每张子排车状态均为DEPARTED' }, '409': { description: 车次版本、装载、资格、拣货、出库或幂等门禁未满足 } }
   /api/pda/v1/last-leg/outbound-tasks:
     get:
       summary: 查询Token绑定仓的一件代发出库任务
@@ -850,9 +851,10 @@ components:
       properties: { idempotencyKey: { type: string, minLength: 1, maxLength: 255 } }
     DepartAction:
       type: object
-      required: [idempotencyKey]
+      required: [recordVersion, idempotencyKey]
       properties:
-        idempotencyKey: { type: string, minLength: 1, maxLength: 255 }
+        recordVersion: { type: integer, format: int64, minimum: 0, description: 当前车次版本，来自tripRecordVersion}
+        idempotencyKey: { type: string, minLength: 8, maxLength: 128 }
         remark: { type: string, maxLength: 1000, nullable: true }
     DispatchPick:
       type: object