feat: enhance train scheduling and contract management features

- Added StationWorkControls to manage loading/unloading phases in TrainScheduleV2DetailPage.
- Implemented API endpoints for recording station work and managing wagon detach requests.
- Updated contract templates to include Ethiopian customs handling options.
- Enhanced shipment forms to collect customs clearing agent details for without-customs bookings.
- Introduced NUMBER_OF_WAGONS as a unit of measure for bulk cargo, allowing customers to specify wagon counts.
- Improved validation for customs clearing agent information in shipment forms.
- Updated various components and services to accommodate new features and ensure data integrity.

packages/types/src/freight/contracts.ts

@@ -1018,8 +1018,18 @@ export interface CreateBookingUnderContractDto {
   equipmentReturn?: string;
   containers?: CreateBookingContainerLineDto[];
   bulkLines?: CreateBulkLineDto[];
+  /**
+   * NUMBER_OF_WAGONS bulk cargo only: how many wagons the shipment needs. The
+   * weight spreads evenly across them; a PER_WAGON rate bills this count.
+   * Required when the cargo type is measured by wagons, ignored otherwise.
+   */
+  requestedWagons?: number;
   /** What the containers carry — captured per booking (container freight). */
   cargoFreeText?: string;
+  /** Customer's own clearing agent — required at completion of a without-customs import/export booking. */
+  customsClearingAgent?: string;
+  customsClearingAgentEmail?: string;
+  customsClearingAgentPhone?: string;
   notes?: string;
 }
 

packages/types/src/freight/index.ts

@@ -73,6 +73,13 @@ export enum BookingType {
 export enum CargoUnitOfMeasure {
   PerTon = "PER_TON",
   PerItem = "PER_ITEM",
+  /**
+   * Wagon-request cargo: the customer states the wagon count the shipment
+   * needs alongside its weight (and an optional item count). Allocation uses
+   * the requested count verbatim, spreading the weight evenly; a PER_WAGON
+   * rate bills that count, a PER_TON rate bills the weight.
+   */
+  NumberOfWagons = "NUMBER_OF_WAGONS",
 }
 
 export enum BookingStatus {
@@ -704,6 +711,8 @@ export interface IBooking extends BaseEntity {
   // (multi-truck self-haul lives in ICustomerTruck[], fetched via the
   //  /customer-trucks endpoint; the fields above are the booking-level flag.)
   customsClearingAgent?: string | null;
+  customsClearingAgentEmail?: string | null;
+  customsClearingAgentPhone?: string | null;
 
   equipmentReturn: "WITH_RETURN" | "WITHOUT_RETURN";
   originYard?: IYard | null;