add booking request functionality for GENERAL customs contracts

- Create migration for booking_requests table with necessary fields and indexes.
- Implement BookingRequestRepository for database operations related to booking requests.
- Develop BookingRequestService to handle business logic for submitting, accepting, rejecting, and canceling booking requests.
- Create DTOs for creating booking requests and reviewing them.
- Define BookingRequest entity to map to the booking_requests table.
- Add UI components for managing shipment requests, including detail and list pages.
- Implement OperationDatePicker component for selecting available shipment days.

apps/edr-freight-api/src/modules/train-scheduling/train-scheduling.controller.ts

@@ -33,6 +33,7 @@ import { RecordCheckpointDto } from "./dto/record-checkpoint.dto";
 import { AvailableLocomotivesQueryDto } from "./dto/available-locomotives-query.dto";
 import { BookableSchedulesQueryDto } from "./dto/bookable-schedules-query.dto";
 import { AvailableDaysQueryDto } from "./dto/available-days-query.dto";
+import { AvailableDaysForCargoQueryDto } from "./dto/available-days-for-cargo-query.dto";
 import { UpdateTrainSchedulingGlobalRulesDto } from "./dto/update-train-scheduling-global-rules.dto";
 import { TrainSchedulingService } from "./train-scheduling.service";
 import { BookingBatchService } from "./booking-batch.service";
@@ -123,6 +124,24 @@ export class TrainSchedulingController {
     );
   }
 
+  @Get("available-days-for-cargo")
+  // No staff guard: customers (portal) and GL (backoffice) both hit this while
+  // creating a booking to find which DAYS are feasible for THIS cargo — i.e. the
+  // route has a train with remaining capacity AND enough matching-type wagons.
+  @ApiOperation({
+    summary: "Days bookable for a specific cargo (wagon + train capacity aware)",
+  })
+  getAvailableDaysForCargo(@Query() query: AvailableDaysForCargoQueryDto) {
+    return this.trainSchedulingService.getAvailableDaysForCargo({
+      originYardId: query.originYardId,
+      destinationYardId: query.destinationYardId,
+      freightType: query.freightType,
+      cargoTypeCode: query.cargoTypeCode,
+      totalWeightTons: query.totalWeightTons,
+      containers: query.containers,
+    });
+  }
+
   @Get("container/eligible-bookings")
   @TrainSchedulingView()
   @ApiOperation({ summary: "List eligible container bookings" })