implement empty-container return service: add return quantity handling, update related DTOs, services, and UI components

apps/edr-freight-api/src/modules/rule-engine/entities/rate-unit.util.ts

@@ -28,6 +28,9 @@ export function allowedRateUnits(input: {
         return ['PER_CONTAINER', 'PER_TON'];
       case 'DEMURRAGE':
         return ['PER_CONTAINER', 'PER_TON'];
+      case 'WITH_RETURN':
+        // Container-only empty-return service — bills per returned container.
+        return ['PER_CONTAINER', 'FLAT'];
       case 'CANCELLATION':
         return ['FLAT', 'PER_INVOICE'];
       case 'CUSTOMS_CLEARANCE':

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

@@ -20,6 +20,7 @@ export const RATE_TYPES = [
   'OVERWEIGHT_PER_TON',
   'HAZARD_SURCHARGE',
   'REEFER_SURCHARGE',
+  'RETURN_SURCHARGE',
   'PIL_EXTRA_FEE',
   'CUSTOMS_CLEARANCE',
 ] as const;
@@ -71,6 +72,9 @@ export const RATE_TRIGGERS = [
   'HAZARDOUS',
   'OVERWEIGHT',
   'REEFER',
+  // Empty-container return service (container freight only) — fires when the
+  // booking ships WITH_RETURN, billed like hazard/reefer (usually PER_CONTAINER).
+  'WITH_RETURN',
   'SHIPPING_LINE',
   'CONSOLIDATION',
   'CANCELLATION',