add company stamp upload functionality for contract signing

- Introduced StampUpload component for uploading company stamp images.
- Integrated stamp upload in contract signing modal, supporting PNG and JPG formats.
- Implemented validation for file type and size (max 5 MB).
- Added visual feedback for drag-and-drop functionality.
- Updated contract-related pages to handle duplicate contract alerts and pricing notices.
- Enhanced contract expiry management with a nightly sweep service.
- Added unit tests for new features and updated existing tests for contract handling.

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

@@ -12,7 +12,11 @@ import { ListRatesQueryDto } from '../dto/list-rule-engine-query.dto';
 import { UpdateRateDto } from '../dto/update-rate.dto';
 import { Rate } from '../entities/rate.entity';
 import { deriveRateType } from '../entities/rate-type.util';
-import { allowedRateUnits, isRateUnitAllowed } from '../entities/rate-unit.util';
+import { CargoUom, allowedRateUnits, isRateUnitAllowed } from '../entities/rate-unit.util';
+import {
+  CARGO_TYPES_REPOSITORY,
+  ICargoTypesRepository,
+} from '../interfaces/cargo-types.repository.interface';
 import { IRatesRepository, RATES_REPOSITORY } from '../interfaces/rates.repository.interface';
 import { IYardsRepository, YARDS_REPOSITORY } from '../interfaces/yards.repository.interface';
 
@@ -32,6 +36,8 @@ export class RatesService {
     private readonly repository: IRatesRepository,
     @Inject(YARDS_REPOSITORY)
     private readonly yardsRepository: IYardsRepository,
+    @Inject(CARGO_TYPES_REPOSITORY)
+    private readonly cargoTypesRepository: ICargoTypesRepository,
   ) {}
 
   /** List rates — standard paginated envelope with server-side search. */
@@ -63,25 +69,37 @@ export class RatesService {
    * Normalise + validate the weighting unit for a rate shape. Overweight is
    * always billed per excess ton, so its unit is forced to PER_TON regardless
    * of what the client sent. Every other shape must pick a unit the pricing
-   * engine can actually apply (see `allowedRateUnits`).
+   * engine can actually apply (see `allowedRateUnits`) — for a rate scoped to a
+   * bulk commodity that means the commodity's own unit of measure: a PER_ITEM
+   * commodity bills per item where a weighed one bills per ton.
    */
-  private resolveRateUnit(
+  private async resolveRateUnit(
     appliesTo: Rate['appliesTo'],
     trigger: Rate['trigger'],
     requestedUnit: Rate['rateUnit'] | undefined,
     cargoKind?: 'CONTAINER' | 'BULK' | null,
-  ): Rate['rateUnit'] {
+    cargoTypeId?: string | null,
+  ): Promise<Rate['rateUnit']> {
     // Overweight is per-ton, full stop — the admin form hides the unit field
     // for it and omits rateUnit from the payload entirely.
     if (trigger === 'OVERWEIGHT') return 'PER_TON';
 
-    const allowed = allowedRateUnits({ appliesTo, trigger, cargoKind });
+    const cargoUnitOfMeasure = await this.cargoUnitOfMeasure(cargoTypeId);
+    const allowed = allowedRateUnits({ appliesTo, trigger, cargoKind, cargoUnitOfMeasure });
     if (!requestedUnit) {
       throw new BadRequestException(
         `Pick a rate unit for this rate. Allowed: ${allowed.join(', ')}.`,
       );
     }
-    if (!isRateUnitAllowed({ appliesTo, trigger, cargoKind, unit: requestedUnit })) {
+    if (
+      !isRateUnitAllowed({
+        appliesTo,
+        trigger,
+        cargoKind,
+        cargoUnitOfMeasure,
+        unit: requestedUnit,
+      })
+    ) {
       throw new BadRequestException(
         `Rate unit "${requestedUnit}" is not valid for this rate. Allowed: ${allowed.join(', ')}.`,
       );
@@ -89,6 +107,13 @@ export class RatesService {
     return requestedUnit;
   }
 
+  /** Unit of measure of the bulk commodity a rate is scoped to; null when unscoped. */
+  private async cargoUnitOfMeasure(cargoTypeId?: string | null): Promise<CargoUom> {
+    if (!cargoTypeId) return null;
+    const cargo = await this.cargoTypesRepository.findById(cargoTypeId);
+    return cargo?.unitOfMeasure ?? null;
+  }
+
   /** Base rail freight is priced per leg; surcharges and truck legs are not. */
   private isBaseFreight(appliesTo: Rate['appliesTo'], trigger: Rate['trigger']): boolean {
     return trigger === 'ALWAYS' && BASE_FREIGHT_CATEGORIES.includes(appliesTo);
@@ -380,11 +405,12 @@ export class RatesService {
       tradeDirection,
       isBulk: this.resolvesToBulk(appliesTo, intercityKind),
     });
-    const rateUnit = this.resolveRateUnit(
+    const rateUnit = await this.resolveRateUnit(
       appliesTo,
       trigger,
       dto.rateUnit as Rate['rateUnit'] | undefined,
       cargoKind,
+      cargoTypeId,
     );
 
     await this.assertNoDuplicatePattern({
@@ -562,12 +588,19 @@ export class RatesService {
     // Re-validate the unit against the (possibly changed) shape; overweight is
     // forced to PER_TON.
     const requestedUnit = (dto.rateUnit as Rate['rateUnit']) ?? existing.rateUnit;
-    updates.rateUnit = this.resolveRateUnit(appliesTo, trigger, requestedUnit, cargoKind);
+    const rateUnit = await this.resolveRateUnit(
+      appliesTo,
+      trigger,
+      requestedUnit,
+      cargoKind,
+      updates.cargoTypeId,
+    );
+    updates.rateUnit = rateUnit;
 
     // Guard the pattern uniqueness for the new identity, ignoring this row.
     await this.assertNoDuplicatePattern({
       rateType,
-      rateUnit: updates.rateUnit,
+      rateUnit,
       containerTypeId: updates.containerTypeId,
       cargoTypeId: updates.cargoTypeId,
       tradeDirection: updates.tradeDirection,