edr-platform/apps/edr-freight-api/src/modules/train-schedules/entities/schedule-wagon-adjustment-log.entity.ts

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

export const WAGON_ADJUSTMENT_ACTIONS = ['ADD', 'REMOVE', 'SWITCH'] as const;
export type WagonAdjustmentAction = (typeof WAGON_ADJUSTMENT_ACTIONS)[number];

/**
 * History row for a consist adjustment made from a schedule: staff coupled a
 * wagon onto (ADD), detached one from (REMOVE), or swapped the physical wagon
 * under a loaded slot (SWITCH — wagonNumber reads "OLD → NEW") on the
 * schedule's built train. `yardId` records WHERE it happened: the origin yard
 * before departure, or the mid-route stop the train was standing at. Plain
 * columns (no FK relations) so the history survives the wagon or train being
 * deleted later.
 */
@Entity({ schema: 'freight', name: 'schedule_wagon_adjustment_logs' })
@Index(['trainScheduleId'])
@Index(['trainId'])
export class ScheduleWagonAdjustmentLog extends BaseEntity {
  @Column({ name: 'train_schedule_id', type: 'uuid' })
  trainScheduleId!: string;

  @Column({ name: 'train_id', type: 'uuid' })
  trainId!: string;

  @Column({ name: 'action', type: 'varchar', length: 10 })
  action!: WagonAdjustmentAction;

  @Column({ name: 'wagon_id', type: 'uuid' })
  wagonId!: string;

  @Column({ name: 'wagon_number', type: 'varchar', length: 50 })
  wagonNumber!: string;

  @Column({ name: 'adjusted_by_user_id', type: 'uuid', nullable: true })
  adjustedByUserId!: string | null;

  @Column({ name: 'yard_id', type: 'uuid', nullable: true })
  yardId!: string | null;

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