优化

2026-10-20 16:45:04 +08:00
parent 0ff1eefff6
commit 0dd9c8db07
44 changed files with 889 additions and 93 deletions
@@ -48,13 +48,14 @@ paths:
                        available: {type: boolean}
  /api/platform/v1/last-leg/fleet/trips/calendar:
    get:
-      summary: 读取美国车次用车日历来源
+      summary: 读取美国真实整车排车日历来源
      description: >-
-        仅PLATFORM且平台公共主体（tenantId=0），权限 platform:fleet:trip:list。from/to 是明确UTC时间点，已发车按实际发车时间、尚未发车按计划发车时间读取半开区间，最多44天；
+        仅PLATFORM且平台公共主体（tenantId=0），权限 platform:overseas-warehouse:dispatch:list，与排车列表及详情一致。from/to 是明确UTC时间点，已发车按实际发车时间、尚未发车按计划发车时间读取半开区间，最多44天；
        该保护性窗口供界面最多42个当地日历日加时区边界使用，不扩大界面范围。
        仅出库派送用途（DELIVERY）；上门取货入仓用途（PICKUP）不属于此日历排车来源。
        最多2000条候选，超限明确拒绝并要求缩小日期范围，不分页扫描、不静默截断。
-        一车一条，保留取消及完成状态；保留原计划与实际时间，已执行事实不随计划改期移动，不表示收货预约已确认。
+        仅关联ll_dispatch_order中ACTIVE真实主单，返回dispatchNo；独立旧车次和取消排车主单排除，一张排车主单一条。
+        保留原计划与实际时间，已执行事实不随计划改期移动，不表示收货预约已确认；日历跳排车详情，不使用内部车次号拼排车路径。
        已知非美国仓排除；未知仓库/国家/地理IANA时区进入unresolvedRecords，不落入美国当地日槽。
        一次车次查询加一次仓库批量资料请求，包含停用仓历史资料，资料服务失败返回错误而非空日历。
      parameters:
@@ -358,10 +359,10 @@ components:
  schemas:
    TripCalendarEntry:
      type: object
-      required: [sourceType, tripNo, status, plannedDepartureAt, expectedDriverEndAt, stops, incompleteReasons]
+      required: [sourceType, dispatchNo, status, plannedDepartureAt, expectedDriverEndAt, stops, incompleteReasons]
      properties:
-        sourceType: {type: string, enum: [TRIP_PLAN]}
-        tripNo: {type: string}
+        sourceType: {type: string, enum: [DISPATCH]}
+        dispatchNo: {type: string, description: 真实整车主单排车号，用于排车详情路由}
        status: {type: string, enum: [PLANNED, IN_TRANSIT, COMPLETED, CANCELLED]}
        originWarehouseId: {type: string, nullable: true}
        originWarehouseCode: {type: string, nullable: true}