优化

2026-08-17 15:41:42 +08:00
parent 4abcb2b80f
commit 5f79616623
60 changed files with 1457 additions and 270 deletions
@@ -155,11 +155,11 @@ components:
        reason: {type: string, maxLength: 500}
    SaveRequest:
      type: object
-      required: [oceanBookingId, plannedLoadingAt, expectedVersion]
+      required: [oceanBookingId, containerBookingId, plannedLoadingAt, expectedVersion]
      properties:
        oceanBookingId: {type: integer, format: int64, minimum: 1}
        containerBookingId: {type: integer, format: int64, minimum: 1}
-        loadingPlanId: {type: integer, format: int64, minimum: 1}
+        loadingPlanId: {type: integer, format: int64, minimum: 1, nullable: true, description: Optional consistency hint; the server resolves and freezes the current loadingPlanId from containerBookingId and rejects a mismatch.}
        carrierId: {type: integer, format: int64, minimum: 1, nullable: true, description: Optional ACTIVE Warehouse supplier ID validated as TRUCKING.}
        carrierName: {type: string, maxLength: 128, nullable: true, description: Optional consistency hint only; the persisted snapshot comes from Warehouse and cannot be supplied without carrierId.}
        plannedLoadingAt: {type: string, format: date-time}