implement update train details feature: add DTO, service method, and UI modal for editing train name and run numbers

apps/edr-freight-web/backoffice/src/features/bookings/booking-status.config.ts

@@ -285,7 +285,12 @@ export const BOOKING_LIST_TABS = [
   {
     key: "clearance",
     label: "Clearance",
-    statuses: ["AWAITING_DOCUMENTS", "DOCUMENTS_UNDER_REVIEW", "CLEARANCE_READY"],
+    statuses: [
+      "AWAITING_CLEARANCE_PAYMENT",
+      "AWAITING_DOCUMENTS",
+      "DOCUMENTS_UNDER_REVIEW",
+      "CLEARANCE_READY",
+    ],
   },
   {
     key: "payment",

apps/edr-freight-web/backoffice/src/features/contracts/contract-status.config.ts

@@ -51,6 +51,10 @@ export const CONTRACT_STATUS_STYLES: Record<string, StatusStyle> = {
     label: "Active",
     color: "bg-[color:var(--freight-brand-muted)] text-[color:var(--freight-brand)] border-[color:var(--freight-brand-border)]",
   },
+  AWAITING_CLEARANCE_PAYMENT: {
+    label: "Clearance Fee Due",
+    color: "bg-orange-50 text-orange-700 border-orange-200",
+  },
   AWAITING_CLEARANCE_DOCUMENTS: {
     label: "Awaiting Documents",
     color: "bg-amber-50 text-amber-700 border-amber-200",
@@ -118,6 +122,7 @@ export const CONTRACT_STATUS_COLOR: Record<string, string> = {
   SIGNED_CUSTOMER: "cyan",
   FULLY_EXECUTED: "indigo",
   CONTRACT_ACTIVE: "edr-green",
+  AWAITING_CLEARANCE_PAYMENT: "orange",
   AWAITING_CLEARANCE_DOCUMENTS: "yellow",
   CLEARANCE_UNDER_REVIEW: "yellow",
   CLEARANCE_READY_FOR_BOOKING: "edr-green",
@@ -207,6 +212,13 @@ export const CONTRACT_STATUS_META: Record<string, StatusMeta> = {
     color: "text-[color:var(--freight-brand)]",
     stage: 3,
   },
+  AWAITING_CLEARANCE_PAYMENT: {
+    title: "Clearance Fee Due",
+    description:
+      "Customer must pay the prepaid clearance service fee before uploading documents.",
+    color: "text-orange-600",
+    stage: 3,
+  },
   AWAITING_CLEARANCE_DOCUMENTS: {
     title: "Awaiting Documents",
     description: "Customer is uploading pre-booking clearance documents.",