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-web/backoffice/src/pages/ruleEngine/RuleEngineResourcePage.tsx

@@ -59,6 +59,7 @@ import {
     RULE_ENGINE_CATEGORY_BASE_PATH,
     RULE_ENGINE_SELECT_NONE,
     getRuleEngineResource,
+    rateUnitOptions,
     type RuleEngineNavCategory,
 } from "@/pages/ruleEngine/config/resources";
 import type { RateChangeRequest } from "@/services/ruleEngine/ruleEngine.service";
@@ -344,6 +345,20 @@ const RuleEngineResourcePage = () => {
           options: cargoLeafOptions ?? [],
         };
       }
+      // Rate units follow the picked commodity: a per-item (break-bulk) cargo
+      // is priced per item where a weighed one is priced per ton.
+      if (field.name === "rateUnit" && field.optionsFromValues) {
+        return {
+          ...field,
+          optionsFromValues: (values: Record<string, unknown>) =>
+            rateUnitOptions(
+              values,
+              (cargoLeafOptions ?? []).find(
+                (o) => o.value === String(values.cargoTypeId ?? ""),
+              )?.unitOfMeasure ?? "",
+            ),
+        };
+      }
       if (field.name === "rateId") {
         return {
           ...field,

apps/edr-freight-web/backoffice/src/pages/ruleEngine/config/resources.ts

@@ -207,13 +207,27 @@ const unitOption = (value: string) => ({ label: value.replace(/_/g, " "), value
 /**
  * Valid weighting units for a rate shape — mirrors the API's
  * `allowedRateUnits`. The unit is driven by the *type* being billed: containers
- * bill per container, bulk per ton, overweight always per excess ton, etc. Kept
- * in sync with apps/edr-freight-api/.../entities/rate-unit.util.ts.
+ * bill per container, bulk per ton, overweight always per excess ton, etc. A
+ * rate scoped to a break-bulk commodity (unit of measure = PER_ITEM) offers
+ * PER_ITEM wherever a weighed one offers PER_TON. Kept in sync with
+ * apps/edr-freight-api/.../entities/rate-unit.util.ts.
  */
 const allowedRateUnits = (
   appliesTo: string,
   trigger: string,
   cargoKind = "",
+  cargoUnitOfMeasure = "",
+): string[] => {
+  const units = unitsForShape(appliesTo, trigger, cargoKind);
+  return cargoUnitOfMeasure === "PER_ITEM"
+    ? units.map((u) => (u === "PER_TON" ? "PER_ITEM" : u))
+    : units;
+};
+
+const unitsForShape = (
+  appliesTo: string,
+  trigger: string,
+  cargoKind = "",
 ): string[] => {
   if (appliesTo === "OTHER") {
     switch (trigger) {
@@ -259,7 +273,15 @@ const allowedRateUnits = (
   }
 };
 
-const rateUnitOptions = (values: Record<string, unknown>) => {
+/**
+ * Unit choices for the rate form. `cargoUnitOfMeasure` is how the bulk
+ * commodity picked in the form is counted (PER_TON / PER_ITEM) — injected by
+ * RuleEngineResourcePage, which is the layer that has the cargo type list.
+ */
+export const rateUnitOptions = (
+  values: Record<string, unknown>,
+  cargoUnitOfMeasure = "",
+) => {
   const appliesTo = String(values.appliesTo ?? "");
   const trigger = appliesTo === "OTHER" ? String(values.trigger ?? "") : "ALWAYS";
   if (!appliesTo) return [];
@@ -267,6 +289,7 @@ const rateUnitOptions = (values: Record<string, unknown>) => {
     appliesTo,
     trigger,
     String(values.cargoKind ?? ""),
+    cargoUnitOfMeasure,
   ).map(unitOption);
 };
 
@@ -889,7 +912,8 @@ export const RULE_ENGINE_RESOURCES: RuleEngineResourceConfig[] = [
         type: "select",
         required: true,
         optionsFromValues: rateUnitOptions,
-        description: "Weighting basis — options depend on what the rate applies to.",
+        description:
+          "Weighting basis — options depend on what the rate applies to, and for bulk on how the picked commodity is counted (per ton or per item).",
         hideWhen: { field: "trigger", equals: ["OVERWEIGHT"] },
       },
     ],