train

packages/types/src/freight/index.ts

@@ -331,6 +331,33 @@ export interface IWagonMovement extends BaseEntity {
   note?: string | null;
 }
 
+/**
+ * Lifecycle of a two-person wagon-transfer request. A requester asks for N
+ * wagons of a type to move from one yard to another (count only, no specific
+ * wagons); OCC staff later pick the physical wagons and execute the move.
+ */
+export enum WagonTransferRequestStatus {
+  /** Awaiting OCC fulfilment. */
+  Pending = "PENDING",
+  /** OCC picked the wagons and executed the transfer. */
+  Fulfilled = "FULFILLED",
+  /** Requester or OCC withdrew it before fulfilment. */
+  Cancelled = "CANCELLED",
+}
+
+export interface IWagonTransferRequest extends BaseEntity {
+  fromYardId: string;
+  toYardId: string;
+  wagonTypeId: string;
+  /** How many wagons of `wagonTypeId` to move out of `fromYardId`. */
+  quantity: number;
+  status: WagonTransferRequestStatus;
+  requestedByUserId?: string | null;
+  fulfilledByUserId?: string | null;
+  fulfilledAt?: string | null;
+  note?: string | null;
+}
+
 export enum BulkPricingUnit {
   PerWagon = "PER_WAGON",
   PerTon = "PER_TON",