feat: Refactor general contract handling and introduce drawdown orders

- Updated ContractRouteLineView to clarify that routes carry no quantity and are pure origin-destination lanes.
- Modified GeneralContractService to reflect changes in route handling, removing quantity-related logic.
- Adjusted BookingsService to persist contracted routes without quantities, aligning with the new contract structure.
- Revised CreateBookingDto and CreateContractRouteDto to remove quantity fields, emphasizing shared pool usage.
- Added ContractOrdersPanel component to display drawdown orders and their associated pool.
- Implemented useContractOrders and useContractPool hooks for fetching order and pool data.
- Created booking-orders.service.ts to manage API interactions for drawdown orders and pool data.
- Updated BookingRequestDetailPage and PlaceOrderDialog to accommodate new order handling logic.

apps/edr-freight-api/src/modules/bookings/bookings.service.ts

@@ -485,8 +485,11 @@ export class BookingsService {
       warnings.push(`Estimated wagons required: ${wagonCount}`);
     }
 
-    // Multi-route general contracts: persist the contracted routes + quantities.
-    // Each drawdown order later draws from one of these route lines.
+    // Multi-route general contracts: persist the contracted routes (lanes). Routes
+    // carry NO quantity — the contract has a single shared pool (the cargo-step
+    // total / container quantities). Each drawdown order picks one lane for
+    // scheduling + road billing and draws from that shared pool. `quantity` on the
+    // route line is retained for legacy rows but is no longer meaningful (0).
     if (isGeneralContract && dto.routes?.length) {
       const routeRepo = this.dataSource.getRepository(ContractRouteLine);
       await routeRepo.save(
@@ -495,9 +498,8 @@ export class BookingsService {
             contractBookingId: booking.id,
             originYardId: r.originYardId,
             destinationYardId: r.destinationYardId,
-            containerTypeId:
-              dto.freightType === 'CONTAINER' ? (r.containerTypeId ?? null) : null,
-            quantity: r.quantity,
+            containerTypeId: null,
+            quantity: 0,
             km: r.km ?? null,
           }),
         ),

apps/edr-freight-api/src/modules/bookings/dto/create-booking.dto.ts

@@ -55,6 +55,12 @@ export class CreateBookingContainerDto {
   vgmPerUnitTons!: number;
 }
 
+/**
+ * A contracted route (lane) of a general contract — a pure origin→destination
+ * pair the contract covers. Routes carry NO quantity; the contract draws from a
+ * single shared pool (the container quantities / bulk total on the booking). An
+ * order picks one lane (for scheduling + road billing) and draws from that pool.
+ */
 export class CreateContractRouteDto {
   @ApiProperty({ format: 'uuid', description: 'FK to yards.id (origin)' })
   @IsUUID()
@@ -64,20 +70,6 @@ export class CreateContractRouteDto {
   @IsUUID()
   destinationYardId!: string;
 
-  @ApiPropertyOptional({
-    format: 'uuid',
-    description: 'Container type for CONTAINER contracts; omit for BULK',
-  })
-  @IsOptional()
-  @IsUUID()
-  containerTypeId?: string;
-
-  @ApiProperty({ description: 'Contracted quantity for this route', minimum: 1 })
-  @IsNumber()
-  @Min(0)
-  @Transform(({ value }) => Number(value))
-  quantity!: number;
-
   @ApiPropertyOptional({
     description: 'Road distance (km) for this route; used to bill road orders.',
     minimum: 0,