fix(warehouses): detention groups by canonical truck type

Join truck_types via vehicles.truck_type_id (normalized legacy
vehicle_type only as fallback) so type renames can't unmatch detention
rules and FK-less vehicles keep billing.

apps/edr-freight-api/src/modules/vehicles/entities/vehicle.entity.ts

@@ -1,6 +1,17 @@
 import { Entity, Column } from 'typeorm';
 import { BaseEntity } from '@edr/api-common';
 
+/**
+ * Legacy classification. Truck configurations are now back-office data in
+ * `freight.truck_types` — register a vehicle with `truckTypeId`, not this.
+ *
+ * The `vehicle_type` COLUMN survives as a denormalised copy of the truck type's
+ * code because truck-detention billing groups by it in raw SQL and matches it
+ * against `warehouse_fee_rules.vehicle_type`. The service writes it through on
+ * every save; nothing should set it by hand.
+ *
+ * @deprecated use `truckTypeId` / `freight.truck_types`
+ */
 export enum VehicleType {
   TRUCK = 'TRUCK',
   VAN = 'VAN',
@@ -11,6 +22,12 @@ export enum VehicleType {
   FLATBED = 'FLATBED',
 }
 
+/** Who supplies the truck. Supplier selection is deferred until EDR commits to outsourcing. */
+export enum VehicleOwnership {
+  OWNED = 'OWNED',
+  OUTSOURCED = 'OUTSOURCED',
+}
+
 export enum FuelType {
   PETROL = 'PETROL',
   DIESEL = 'DIESEL',
@@ -47,8 +64,12 @@ export class Vehicle extends BaseEntity {
   @Column({ name: 'registration_number', unique: true, nullable: true })
   registrationNumber?: string;
 
+  /** Denormalised `truck_types.code` — written through by the service, never set by hand. */
   @Column({ name: 'vehicle_type', type: 'varchar', nullable: true })
-  vehicleType?: VehicleType;
+  vehicleType?: string;
+
+  @Column({ name: 'truck_type_id', type: 'uuid', nullable: true })
+  truckTypeId?: string | null;
 
   @Column({ nullable: true })
   manufacturer?: string;
@@ -101,7 +122,7 @@ export class Vehicle extends BaseEntity {
   @Column({ name: 'vin', type: 'varchar', nullable: true })
   vin?: string;
 
-  /** Owned | Leased | Rented */
+  /** OWNED | OUTSOURCED — see {@link VehicleOwnership}. */
   @Column({ name: 'ownership', type: 'varchar', nullable: true })
   ownership?: string;