feat(appointment): integrate work calendar and stable cargo batches

lastleg-service/src/main/resources/openapi/appointment-planning-v1.yaml

@@ -6,6 +6,37 @@ info:
 security:
   - bearerAuth: []
 paths:
+  /api/platform/v1/last-leg/appointment-planning/sources/resolve-order:
+    get:
+      operationId: resolveOrderAppointmentSource
+      summary: 从实际订单读取规范原货源及预约覆盖
+      description: >-
+        仅平台；同时要求platform:appointment:list与platform:overseas-warehouse:last-mile-order:list。
+        入仓列表只知道订单时使用此只读入口；服务端保留外接登记BOOKING键，其他来源返回ORDER键，核对客户、订单关联及目的地。
+        前端后续核实和预约命令必须使用返回的source.sourceKey，不将外接来货改写为ORDER别名。
+      parameters:
+        - {name: orderId, in: query, required: true, schema: {type: integer, format: int64, minimum: 1}}
+        - {name: customerId, in: query, required: true, schema: {type: string, minLength: 1, maxLength: 128}}
+        - {name: destinationKey, in: query, schema: {type: string}}
+      responses:
+        '200':
+          description: 真实原来源和当前活动预约覆盖
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  code: {type: string}
+                  data:
+                    type: object
+                    properties:
+                      source: {$ref: '#/components/schemas/PlanningSource'}
+                      coverage: {$ref: '#/components/schemas/Coverage'}
+        '400': {description: 订单、客户或目的地参数无效}
+        '403': {description: 非平台或缺少任一读取权限}
+        '404': {description: 当前客户下来源不存在}
+        '409': {description: 订单与原来源关联变化}
+        '503': {description: 权威目录不可用}
   /api/platform/v1/last-leg/appointment-planning/external-candidates:
     get:
       operationId: listExternalAppointmentCandidates
@@ -52,7 +83,7 @@ paths:
         仅平台；同时需要platform:appointment:list、platform:overseas-warehouse:last-mile-order:list及platform:overseas-warehouse:inbound-order:fba-appointment。
         与入仓明细入口共用同一FBA预约聚合；系统生成AP单号，不创建入仓计划、库存或车次。
         PENDING允许日期、时段、外部约号及箱数暂缺。SUCCESS必须有权威目的仓时区、真实货件材料、确定箱数及外部约号和确认时段。
-        实际客户、起运仓、目的仓及原BOOKING由服务端核对；活动来源与已形成订单均唯一占用，取消后释放并保留历史。
+        实际客户、起运仓、目的仓及原BOOKING由服务端核对；锁原来源后按剩余未分配箱数建立新安排，分批总量不能超过独立核实或原来源总量。取消只释放本批数量并保留历史。
         命令与主单、明细同事务；同键同操作人同内容重试返回原快照，不受后来编辑影响。异内容或来源占用冲突拒绝。
       requestBody:
         required: true
@@ -117,7 +148,7 @@ paths:
       description: >-
         只读核对，不保存预约安排、不占货、不确认预约。仅平台，同时要求platform:appointment:list与platform:overseas-warehouse:last-mile-order:list。
         最多100票，批量查询货源、实际开船节点和美国仓目录，支持ORDER与已确认承运BOOKING混合；同一订单重复别名拒绝。
-        必须同美国起运仓及同美国FBA目的仓；暂扣、多目的地、已有有效预约或已取消完成货源拒绝；未知箱数保留待核实，不填0。
+        必须同美国起运仓及同美国FBA目的仓；暂扣、多目的地、已分配完或已取消完成货源拒绝；部分分配后仍可选择剩余量。未知箱数保留待核实，不填0。
         未建入仓计划及尚未来货的已确认BOOKING不伪造计划、库存或入仓码；正式确认前必须核实箱数。
         未接入权威备妥窗口时返回readinessIncomplete及READY_WINDOW_UNVERIFIED，不拿到港/到仓预测代替。
       requestBody:
@@ -156,6 +187,7 @@ paths:
                       destinationWarehouseCode: {type: string}
                       destinationTimezone: {type: string, nullable: true, description: 当前目的仓主档IANA时区；主档为空时为null，读取失败返回错误，不使用历史预约快照}
                       sources: {type: array, items: {$ref: '#/components/schemas/PlanningSource'}}
+                      cargoVerification: {type: array, items: {$ref: './appointment-cargo-verification-v1.yaml#/components/schemas/CargoContext'}, description: 各原来源当前独立核实及剩余分配量，sources本身仍保留原事实}
                       missingFields: {type: array, items: {type: string}}
                       group:
                         type: object