implement intercity booking management and booking window websocket integration

apps/edr-freight-api/src/modules/routes/entities/route.entity.ts

@@ -1,4 +1,5 @@
 import { BaseEntity } from '@edr/api-common';
+import type { ScheduleTradeDirection } from '@edr/types';
 import { Column, Entity, Index, JoinColumn, ManyToOne, OneToMany } from 'typeorm';
 
 import { Yard } from '../../rule-engine/entities/yard.entity';
@@ -26,6 +27,14 @@ export class Route extends BaseEntity {
   @Column({ name: 'status', type: 'varchar', length: 32, default: 'AVAILABLE' })
   status!: RouteStatus;
 
+  /**
+   * Trade direction frozen from the yard countries at create/update
+   * (ET→DJ = EXPORT, DJ→ET = IMPORT, same country = DOMESTIC/"Intercity").
+   * Consumers (scheduling, booking windows) read this instead of re-deriving.
+   */
+  @Column({ name: 'direction', type: 'varchar', length: 10 })
+  direction!: ScheduleTradeDirection;
+
   @OneToMany(() => RouteMilestone, (milestone) => milestone.route, { cascade: false })
   milestones?: RouteMilestone[];
 }

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

@@ -1,6 +1,7 @@
 import { BadRequestException, Injectable, NotFoundException } from '@nestjs/common';
 import { DataSource } from 'typeorm';
 
+import { deriveTradeDirection } from '../../common/derive-trade-direction.util';
 import { Yard } from '../rule-engine/entities/yard.entity';
 import { CreateRouteDto } from './dto/create-route.dto';
 import { FilterRoutesDto } from './dto/filter-routes.dto';
@@ -83,6 +84,7 @@ export class RoutesService {
           originYardId: validated.originYardId,
           destinationYardId: validated.destinationYardId,
           status: dto.status ?? 'AVAILABLE',
+          direction: validated.direction,
         }),
       );
 
@@ -115,6 +117,7 @@ export class RoutesService {
         originYardId: milestoneInput?.originYardId ?? existing.originYardId,
         destinationYardId:
           milestoneInput?.destinationYardId ?? existing.destinationYardId,
+        ...(milestoneInput ? { direction: milestoneInput.direction } : {}),
         ...(dto.status !== undefined ? { status: dto.status } : {}),
       });
 
@@ -187,9 +190,18 @@ export class RoutesService {
       throw new BadRequestException('Origin and destination yards must be different');
     }
 
+    const originYardId = normalized[0].yardId;
+    const destinationYardId = normalized[normalized.length - 1].yardId;
+    const yardById = new Map(yards.map((yard) => [yard.id, yard]));
+    const direction = deriveTradeDirection(
+      yardById.get(originYardId) ?? { country: null },
+      yardById.get(destinationYardId) ?? { country: null },
+    );
+
     return {
-      originYardId: normalized[0].yardId,
-      destinationYardId: normalized[normalized.length - 1].yardId,
+      originYardId,
+      destinationYardId,
+      direction,
       milestones: normalized,
     };
   }