优化

deploy/sql/头程数据库统一增量-MySQL8.sql

@@ -9287,10 +9287,18 @@ BEGIN
 END$$
 DELIMITER ;
 
+CALL phase3_truck_add_column(
+  'bill_of_lading_no',
+  'VARCHAR(128) NULL AFTER carrier_name'
+);
 CALL phase3_truck_add_column(
   'actual_arrived_warehouse_at',
   'DATETIME(3) NULL AFTER planned_loading_at'
 );
+CALL phase3_truck_add_column(
+  'actual_loading_at',
+  'DATETIME(3) NULL AFTER actual_arrived_warehouse_at'
+);
 CALL phase3_truck_add_column(
   'actual_departed_at',
   'DATETIME(3) NULL AFTER actual_loading_at'

firstleg/src/main/resources/db/phase3-truck-appointment-schema.sql

@@ -84,10 +84,18 @@ BEGIN
 END$$
 DELIMITER ;
 
+CALL phase3_truck_add_column(
+  'bill_of_lading_no',
+  'VARCHAR(128) NULL COMMENT ''派车提单号快照；关联RELEASED订舱时由订舱事实源冻结'' AFTER carrier_name'
+);
 CALL phase3_truck_add_column(
   'actual_arrived_warehouse_at',
   'DATETIME(3) NULL COMMENT ''车辆实际到达收货仓时间'' AFTER planned_loading_at'
 );
+CALL phase3_truck_add_column(
+  'actual_loading_at',
+  'DATETIME(3) NULL COMMENT ''实际开始装柜时间'' AFTER actual_arrived_warehouse_at'
+);
 CALL phase3_truck_add_column(
   'actual_departed_at',
   'DATETIME(3) NULL COMMENT ''车辆实际离仓时间；DEPARTED后供LOADED门禁使用'' AFTER actual_loading_at'

firstleg/src/test/java/com/baiyue/firstleg/controller/TruckAppointmentControllerContractTest.java

@@ -10,6 +10,8 @@ import org.springframework.web.bind.annotation.RequestHeader;
 
 import java.lang.reflect.Method;
 import java.nio.charset.StandardCharsets;
+import java.nio.file.Files;
+import java.nio.file.Path;
 import java.time.LocalDateTime;
 import java.util.Map;
 
@@ -18,6 +20,15 @@ import static org.assertj.core.api.Assertions.assertThat;
 class TruckAppointmentControllerContractTest {
  @Test void exposesDedicatedEndpointAndPermissions() {String p=PlatformTruckAppointmentController.class.getAnnotation(org.springframework.web.bind.annotation.RequestMapping.class).value()[0];assertThat(p).isEqualTo("/api/platform/v1/truck-appointments"); for(String n:new String[]{"page","detail","history","attachments","attach","upload","deleteAttachment","create","edit","action","reschedule"}) assertThat(java.util.Arrays.stream(PlatformTruckAppointmentController.class.getDeclaredMethods()).anyMatch(m->m.getName().equals(n))).isTrue();}
  @Test void schemaHasAggregateTablesStatesAndActualEventTimes() throws Exception {String s=new ClassPathResource("db/phase3-truck-appointment-schema.sql").getContentAsString(StandardCharsets.UTF_8);assertThat(s).contains("fl_truck_appointment","fl_truck_appointment_history","fl_truck_appointment_attachment","fl_truck_appointment_operation","bill_of_lading_no VARCHAR(128)","chk_truck_attachment_type","BILL_OF_LADING","PENDING_DISPATCH","PICKUP_IN_PROGRESS","ARRIVED_WAREHOUSE","RESCHEDULED","actual_arrived_warehouse_at","actual_loading_at","actual_departed_at","CALL phase3_truck_add_column");}
+ @Test void existingAppointmentTableReceivesAllLateColumns() throws Exception {
+   String moduleSql=new ClassPathResource("db/phase3-truck-appointment-schema.sql").getContentAsString(StandardCharsets.UTF_8);
+   Path direct=Path.of("deploy","sql","头程数据库统一增量-MySQL8.sql");
+   Path unifiedPath=Files.exists(direct)?direct:Path.of("..","deploy","sql","头程数据库统一增量-MySQL8.sql");
+   String unifiedSql=Files.readString(unifiedPath,StandardCharsets.UTF_8);
+   for(String sql:new String[]{moduleSql,unifiedSql}) {
+     assertThat(sql).contains("'bill_of_lading_no'","'actual_arrived_warehouse_at'","'actual_loading_at'","'actual_departed_at'");
+   }
+ }
  @Test void openApiDocumentsLifecycleIdempotencyAndActualTimes() throws Exception {String s=new ClassPathResource("openapi/truck-appointments-v1.yaml").getContentAsString(StandardCharsets.UTF_8);assertThat(s).contains("/api/platform/v1/truck-appointments/{id}/{action}:","/api/platform/v1/truck-appointments/{id}/reschedule:","name: Idempotency-Key","required: true","actual event timestamps");}
  @Test void openApiFreezesIndependentCreateAndOptionalAssociations() throws Exception {String s=new ClassPathResource("openapi/truck-appointments-v1.yaml").getContentAsString(StandardCharsets.UTF_8);assertThat(s).contains("required: [customerId, carrierId, plannedLoadingAt, expectedVersion]","independent operational records","no RELEASED-state prerequisite","It may be supplied only with containerBookingId","ACTIVE IAM customer","ACTIVE Warehouse supplier ID validated as TRUCKING","Fulfillment associations remain null");}
  @Test void openApiFreezesAttachmentRequestAndOwnershipContract() throws Exception {String s=new ClassPathResource("openapi/truck-appointments-v1.yaml").getContentAsString(StandardCharsets.UTF_8);assertThat(s).contains("AttachmentRequest:","required: [fileId, attachmentType]","required: [attachmentType, file]","BILL_OF_LADING","TRUCK_APPOINTMENT_ATTACHMENT","Deletes the appointment reference only","DetailStableReferences:","oceanBookingNo:","shippingCompanyName:","bookingAgentName:","cabinetNo:","billOfLadingNo:");}