feat(bookings): add clearance review functionality and update UI components

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

@@ -32,6 +32,7 @@ export type BookingActionId =
   | "rejectApproval"
   | "viewContract"
   | "signContractStaff"
+  | "reviewClearance"
   | "allocateBooking"
   | "startTransit"
   | "complete"
@@ -69,6 +70,7 @@ export type BookingActionContext = Pick<
   | "approvalSteps"
   | "reference"
   | "schedulingStatus"
+  | "customsClearingEnabled"
 >;
 
 const ALLOCATABLE_SCHEDULING_STATUSES = new Set([
@@ -250,6 +252,20 @@ const SIGN_CONTRACT_STAFF_ACTION: BookingActionDef = {
   primary: true,
 };
 
+// Opens the booking detail straight on the Clearance tab so Marketing can
+// review the customer's clearance documents (non-customs bookings only).
+const REVIEW_CLEARANCE_ACTION: BookingActionDef = {
+  id: "reviewClearance",
+  label: "Review clearance",
+  shortLabel: "Clearance",
+  description: "Approve or query the customer's clearance documents",
+  confirmTitle: "",
+  confirmDescription: "",
+  variant: "default",
+  icon: ShieldCheck,
+  primary: true,
+};
+
 function withCancel(actions: BookingActionDef[]): BookingActionDef[] {
   return [...actions, CANCEL_ACTION];
 }
@@ -261,6 +277,7 @@ const ACTION_PERMISSION: Partial<Record<BookingActionId, string>> = {
   rejectApproval: FREIGHT_PERMS.bookings.rejectApproval,
   viewContract: FREIGHT_PERMS.bookings.view,
   signContractStaff: FREIGHT_PERMS.bookings.signStaff,
+  reviewClearance: FREIGHT_PERMS.bookings.reviewDocuments,
   startTransit: FREIGHT_PERMS.bookings.operations,
   complete: FREIGHT_PERMS.bookings.operations,
   operationAccept: FREIGHT_PERMS.bookings.operations,
@@ -359,6 +376,14 @@ export function getBookingActions(
         },
       ];
       break;
+    case "AWAITING_DOCUMENTS":
+    case "DOCUMENTS_UNDER_REVIEW":
+      // Marketing reviews non-customs clearance here; customs bookings are
+      // handled in the Global Logistics clearance queue, not the booking list.
+      actions = ctx.customsClearingEnabled
+        ? [CANCEL_ACTION]
+        : withCancel([REVIEW_CLEARANCE_ACTION]);
+      break;
     case "OPERATION_REQUEST_PENDING":
       actions = withCancel(OPERATION_REVIEW_ACTIONS);
       break;
@@ -446,11 +471,17 @@ export function isAllocateAction(id: BookingActionId): boolean {
   return id === "allocateBooking";
 }
 
+/** Opens the booking detail on the Clearance tab without a confirm dialog. */
+export function isClearanceNavAction(id: BookingActionId): boolean {
+  return id === "reviewClearance";
+}
+
 export function listRowHasActions(
   row: {
     status: BookingStatus;
     paymentCurrency: string;
     approvalSteps?: BookingApprovalStep[] | null;
+    customsClearingEnabled?: boolean;
   },
   user?: AuthUser | null,
 ): boolean {
@@ -461,6 +492,7 @@ export function listRowHasActions(
       reference: "",
       approvalSteps: row.approvalSteps ?? undefined,
       schedulingStatus: row.status,
+      customsClearingEnabled: row.customsClearingEnabled,
     },
     user,
   );

apps/edr-freight-web/backoffice/src/features/bookings/mapBookingListRow.ts

@@ -44,6 +44,7 @@ export function toBookingListRow(booking: BookingDetail): BookingListRow {
     governmentInstitution: booking.governmentInstitution ?? null,
     consolidationPartnerId: booking.consolidationPartnerId ?? null,
     consolidationPartnerReference: booking.consolidationPartner?.reference ?? null,
+    customsClearingEnabled: booking.customsClearingEnabled ?? false,
     createdAt: booking.createdAt,
   };
 }