feat: Implement general contract booking orders functionality

- Add DTOs for creating booking orders and viewing contract quantities.
- Create entities for booking orders and booking order lines.
- Implement service for managing general contract operations, including activation after payment and retrieving quantity lines.
- Develop UI components for contract detail and list pages, including order placement dialog.
- Integrate API service for booking orders, enabling listing and creating orders against contracts.
- Enhance contract status display and quantity pool visualization in the UI.

apps/edr-freight-api/src/modules/rule-engine/dto/create-cargo-type.dto.ts

@@ -1,5 +1,6 @@
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-import { IsBoolean, IsInt, IsOptional, IsString, IsUUID, MaxLength, Min } from 'class-validator';
+import { CargoUnitOfMeasure } from '@edr/types';
+import { IsBoolean, IsEnum, IsInt, IsOptional, IsString, IsUUID, MaxLength, Min } from 'class-validator';
 
 export class CreateCargoTypeDto {
   @ApiProperty({ description: 'Cargo type display name', maxLength: 255 })
@@ -7,6 +8,14 @@ export class CreateCargoTypeDto {
   @MaxLength(255)
   cargoTypeName!: string;
 
+  @ApiPropertyOptional({
+    enum: CargoUnitOfMeasure,
+    description: 'How this cargo is measured (PER_TON for bulk, PER_ITEM for break-bulk)',
+  })
+  @IsOptional()
+  @IsEnum(CargoUnitOfMeasure)
+  unitOfMeasure?: CargoUnitOfMeasure;
+
   @ApiPropertyOptional({ description: 'Parent group ID for hierarchical cargo types' })
   @IsOptional()
   @IsUUID()

apps/edr-freight-api/src/modules/rule-engine/entities/cargo-type.entity.ts

@@ -1,4 +1,5 @@
 import { BaseEntity } from '@edr/api-common';
+import { CargoUnitOfMeasure } from '@edr/types';
 import { Column, Entity, Index, JoinColumn, ManyToOne, OneToMany } from 'typeorm';
 
 @Entity({ schema: 'freight', name: 'cargo_types' })
@@ -19,6 +20,14 @@ export class CargoType extends BaseEntity {
   @Column({ name: 'show_free_text_box', type: 'boolean', default: false })
   showFreeTextBox!: boolean;
 
+  /**
+   * How this cargo's quantity is measured: PER_TON (bulk) or PER_ITEM
+   * (break-bulk). Nullable for container/legacy cargo, which is counted by
+   * container. Drives the unit shown when ordering against a general contract.
+   */
+  @Column({ name: 'unit_of_measure', type: 'varchar', length: 16, nullable: true })
+  unitOfMeasure?: CargoUnitOfMeasure | null;
+
   @Column({ name: 'requires_director_approval', type: 'boolean', default: false })
   requiresDirectorApproval!: boolean;
 

apps/edr-freight-api/src/modules/rule-engine/services/cargo-types.service.ts

@@ -82,6 +82,7 @@ export class CargoTypesService {
       showFreeTextBox: dto.showFreeTextBox ?? false,
       requiresDirectorApproval: dto.requiresDirectorApproval ?? false,
       isActive: dto.isActive ?? true,
+      unitOfMeasure: dto.unitOfMeasure ?? null,
       displayOrder,
     });
   }