train

apps/edr-freight-api/src/modules/wagons/entities/wagon-transfer-request.entity.ts

@@ -0,0 +1,62 @@
+import { BaseEntity } from '@edr/api-common';
+import { WagonTransferRequestStatus } from '@edr/types';
+import { Column, Entity, Index, JoinColumn, ManyToOne } from 'typeorm';
+
+import { Yard } from '../../rule-engine/entities/yard.entity';
+import { WagonType } from '../../wagon-types/entities/wagon-type.entity';
+
+/**
+ * A two-person wagon relocation request. A requester asks for `quantity` wagons
+ * of `wagonTypeId` to move from `fromYardId` to `toYardId` — specifying a count
+ * only, never the physical wagons. OCC staff later open the PENDING request,
+ * hand-pick the actual wagons in the source yard, and execute the transfer
+ * (which writes the `wagon_movements` ledger and marks this FULFILLED).
+ */
+@Entity({ schema: 'freight', name: 'wagon_transfer_requests' })
+@Index(['status', 'fromYardId'])
+export class WagonTransferRequest extends BaseEntity {
+  @Column({ name: 'from_yard_id', type: 'uuid' })
+  fromYardId!: string;
+
+  @ManyToOne(() => Yard)
+  @JoinColumn({ name: 'from_yard_id' })
+  fromYard?: Yard | null;
+
+  @Column({ name: 'to_yard_id', type: 'uuid' })
+  toYardId!: string;
+
+  @ManyToOne(() => Yard)
+  @JoinColumn({ name: 'to_yard_id' })
+  toYard?: Yard | null;
+
+  @Column({ name: 'wagon_type_id', type: 'uuid' })
+  wagonTypeId!: string;
+
+  @ManyToOne(() => WagonType)
+  @JoinColumn({ name: 'wagon_type_id' })
+  wagonType?: WagonType | null;
+
+  /** How many wagons of `wagonTypeId` to move out of `fromYardId`. */
+  @Column({ name: 'quantity', type: 'int' })
+  quantity!: number;
+
+  @Column({
+    name: 'status',
+    type: 'varchar',
+    length: 20,
+    default: WagonTransferRequestStatus.Pending,
+  })
+  status!: WagonTransferRequestStatus;
+
+  @Column({ name: 'requested_by_user_id', type: 'uuid', nullable: true })
+  requestedByUserId?: string | null;
+
+  @Column({ name: 'fulfilled_by_user_id', type: 'uuid', nullable: true })
+  fulfilledByUserId?: string | null;
+
+  @Column({ name: 'fulfilled_at', type: 'timestamptz', nullable: true })
+  fulfilledAt?: Date | null;
+
+  @Column({ name: 'note', type: 'text', nullable: true })
+  note?: string | null;
+}