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'] 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) or detached one from (REMOVE) the schedule's built train —
 * e.g. trimming free wagons whose tare pushed gross weight over the
 * locomotives' pull limit. 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: 'occurred_at', type: 'timestamptz', default: () => 'now()' })
  occurredAt!: Date;
}