优化

firstleg/src/main/resources/db/phase3-terminal-drayage-schema.sql

@@ -4,8 +4,8 @@ USE baiyue_firstleg;
 CREATE TABLE IF NOT EXISTS fl_terminal_drayage (
   id BIGINT UNSIGNED NOT NULL COMMENT '目的港码头拖车聚合ID',
   container_booking_id BIGINT UNSIGNED NOT NULL COMMENT '唯一归属物理货柜ID',
-  fleet_supplier_id BIGINT UNSIGNED NOT NULL COMMENT 'Warehouse ACTIVE/TRUCKING供应商ID快照',
-  fleet_supplier_name VARCHAR(128) NOT NULL COMMENT 'Warehouse供应商名称快照',
+  fleet_supplier_id BIGINT UNSIGNED NULL COMMENT 'Warehouse ACTIVE/TRUCKING供应商ID快照',
+  fleet_supplier_name VARCHAR(128) NULL COMMENT 'Warehouse供应商名称快照',
   pickup_appointment_at DATETIME(3) NULL COMMENT '预约提柜时间',
   actual_pickup_at DATETIME(3) NULL COMMENT '实际提柜时间',
   estimated_empty_return_at DATETIME(3) NULL COMMENT '服务端按卸柜完成时间加72小时计算的预计还柜时间',

firstleg/src/main/resources/openapi/terminal-drayage-v1.yaml

@@ -47,6 +47,7 @@ paths:
   /api/platform/v1/terminal-drayages/{containerBookingId}/empty-return:
     post:
       summary: 海外卸柜收货完成后确认实际还柜并推进EMPTY_RETURNED节点
+      description: 以海外卸柜完成事实开放还柜；无需已有车队、预约或实际提柜记录。无拖车记录时提交 expectedVersion=0，由命令创建记录，不补造提柜时间。实际还柜时间不得早于卸柜完成时间及已有实际提柜时间。
       x-permission: platform:firstleg:terminal-drayage:empty-return:confirm
       parameters: [{$ref: '#/components/parameters/ContainerBookingId'}, {$ref: '#/components/parameters/IdempotencyKey'}]
       requestBody: {required: true, content: {application/json: {schema: {$ref: '#/components/schemas/ActualTimeRequest'}}}}