feat: synchronize order status with child booking and enhance contract status labels

apps/edr-freight-api/src/modules/booking-orders/booking-orders.service.ts

@@ -41,12 +41,54 @@ export class BookingOrdersService {
   ) {}
 
   /** Orders placed against a contract, with their lines and child booking. */
-  listByContract(contractBookingId: string): Promise<BookingOrder[]> {
-    return this.ordersRepository.findByContract(contractBookingId);
+  async listByContract(contractBookingId: string): Promise<BookingOrder[]> {
+    const orders = await this.ordersRepository.findByContract(contractBookingId);
+    await Promise.all(orders.map((o) => this.syncOrderFromChild(o)));
+    return orders;
   }
 
-  findById(id: string): Promise<BookingOrder | null> {
-    return this.ordersRepository.findById(id);
+  async findById(id: string): Promise<BookingOrder | null> {
+    const order = await this.ordersRepository.findById(id);
+    if (order) await this.syncOrderFromChild(order);
+    return order;
+  }
+
+  /**
+   * The order is a ledger row; the spawned child ONE_TIME booking is what
+   * actually moves through the workflow (clearance → marketing/ops accept →
+   * pay → allocate), exactly like a one-time booking. Nothing writes the order
+   * row after creation, so its stored status would stay 'PENDING' forever.
+   *
+   * Mirror the child onto the order whenever it is read: copy the child's
+   * status, schedulingStatus and trainScheduleId onto the order (mutating the
+   * in-memory instance the caller gets back), and persist that snapshot when it
+   * has drifted so list/detail views and any stored reporting stay in sync.
+   */
+  private async syncOrderFromChild(order: BookingOrder): Promise<void> {
+    const child = order.booking;
+    if (!child) return;
+
+    const nextStatus = child.status;
+    const nextScheduling = child.schedulingStatus;
+    const nextTrainScheduleId = child.trainScheduleId ?? null;
+
+    const drifted =
+      order.status !== nextStatus ||
+      order.schedulingStatus !== nextScheduling ||
+      (order.trainScheduleId ?? null) !== nextTrainScheduleId;
+
+    // Reflect the child onto the instance returned to the caller.
+    order.status = nextStatus;
+    order.schedulingStatus = nextScheduling;
+    order.trainScheduleId = nextTrainScheduleId;
+
+    if (drifted) {
+      await this.ordersRepository.update(order.id, {
+        status: nextStatus,
+        schedulingStatus: nextScheduling,
+        trainScheduleId: nextTrainScheduleId,
+      });
+    }
   }
 
   /**