edr-platform/apps/edr-freight-api/src/modules/warehouses/entities/booking-handover.entity.ts

import { BaseEntity } from '@edr/api-common';
import { Column, Entity, Index } from 'typeorm';

export const HANDOVER_MILE_TYPES = ['SELF_HAUL', 'EDR_LAST_MILE'] as const;
export type HandoverMileType = (typeof HANDOVER_MILE_TYPES)[number];

/**
 * One import handover. A booking has a single handover when one truck takes the
 * whole booking (`truckAssignmentId` null = per-booking), or one per truck when
 * multiple trucks are used. Self-haul handovers are generated on truck arrival
 * and signed before the truck leaves; EDR last-mile handovers are generated at
 * delivery (after exit).
 */
@Entity({ schema: 'freight', name: 'booking_handovers' })
@Index(['bookingId'])
export class BookingHandover extends BaseEntity {
  @Column({ name: 'booking_id', type: 'uuid' })
  bookingId!: string;

  /** Customer self-haul truck this handover belongs to; null = per-booking. */
  @Column({ name: 'truck_assignment_id', type: 'uuid', nullable: true })
  truckAssignmentId?: string | null;

  /** Denormalised plate for display / EDR trucks (which aren't customer trucks). */
  @Column({ name: 'truck_plate', type: 'varchar', length: 32, nullable: true })
  truckPlate?: string | null;

  @Column({ name: 'mile_type', type: 'varchar', length: 20 })
  mileType!: HandoverMileType;

  @Column({ name: 'reference', type: 'varchar', length: 100 })
  reference!: string;

  @Column({ name: 'generated_at', type: 'timestamptz', default: () => 'now()' })
  generatedAt!: Date;

  @Column({ name: 'signed_at', type: 'timestamptz', nullable: true })
  signedAt?: Date | null;

  @Column({ name: 'signed_by_user_id', type: 'uuid', nullable: true })
  signedByUserId?: string | null;

  /** EDR last-mile: when the goods were delivered to the customer. */
  @Column({ name: 'delivered_at', type: 'timestamptz', nullable: true })
  deliveredAt?: Date | null;
}