Marshaling document Receive Export and import handover to customer

apps/edr-freight-web/backoffice/src/constants/QUERY_KEYS.ts

@@ -1,5 +1,6 @@
 import type { FleetResourceSlug } from "@/pages/fleet/config/resources";
 import type { BookingListFilter } from "@/services/bookings.service";
+import type { ContractListFilter } from "@/services/contracts.service";
 import type { RuleEngineListParams } from "@/services/ruleEngine/ruleEngine.service";
 import type { CompanyListFilter } from "@/types/customer";
 import type { RuleEngineResourceSlug } from "@/types/rule-engine";
@@ -45,6 +46,26 @@ export const QUERY_KEYS = {
     byId: (id: string) => ["bookings", "detail", id] as const,
   },
 
+  CONTRACTS: {
+    ROOT: ["contracts"] as const,
+    list: (filter?: ContractListFilter) =>
+      ["contracts", "list", filter ?? {}] as const,
+    listSummary: (filter?: ContractListFilter) =>
+      ["contracts", "list-summary", filter ?? {}] as const,
+    byId: (id: string) => ["contracts", "detail", id] as const,
+    clearance: (id: string) => ["contracts", "clearance", id] as const,
+    clearanceQueue: (region?: string) =>
+      ["contracts", "clearance-queue", region ?? "ET"] as const,
+    clearanceHistory: (region?: string) =>
+      ["contracts", "clearance-history", region ?? "ET"] as const,
+    milestones: (id: string) => ["contracts", "milestones", id] as const,
+    capacity: (id: string) => ["contracts", "capacity", id] as const,
+    bookingMilestones: (bookingId: string) =>
+      ["contracts", "booking-milestones", bookingId] as const,
+    bookingIncidents: (bookingId: string) =>
+      ["contracts", "booking-incidents", bookingId] as const,
+  },
+
   BOOKING_ORDERS: {
     ROOT: ["booking-orders"] as const,
     byContract: (contractBookingId: string) =>
@@ -108,6 +129,7 @@ export const QUERY_KEYS = {
     ROOT: ["overview"] as const,
     dashboard: (range?: string) => ["overview", "dashboard", range ?? "30d"] as const,
     bookingsTab: (range?: string) => ["overview", "bookings", range ?? "30d"] as const,
+    contractsTab: (range?: string) => ["overview", "contracts", range ?? "30d"] as const,
     billingTab: (range?: string) => ["overview", "billing", range ?? "30d"] as const,
     operationsTab: () => ["overview", "operations"] as const,
     customersTab: (range?: string) => ["overview", "customers", range ?? "30d"] as const,

apps/edr-freight-web/backoffice/src/constants/URLS.ts

@@ -88,6 +88,7 @@ export const URL_CONSTANTS = {
   OVERVIEW: {
     BASE: "/overview",
     BOOKINGS: "/overview/bookings",
+    CONTRACTS: "/overview/contracts",
     BILLING: "/overview/billing",
     OPERATIONS: "/overview/operations",
     CUSTOMERS: "/overview/customers",
@@ -124,6 +125,62 @@ export const URL_CONSTANTS = {
     CONSOLIDATION: (id: string) => `/bookings/${id}/consolidation`,
   },
 
+  CONTRACTS: {
+    BASE: "/contracts",
+    LIST_SUMMARY: "/contracts/list-summary",
+    BY_ID: (id: string) => `/contracts/${id}`,
+    STAFF_ACCEPT: (id: string) => `/contracts/${id}/staff/accept`,
+    STAFF_REQUEST_CHANGES: (id: string) =>
+      `/contracts/${id}/staff/request-changes`,
+    STAFF_REJECT: (id: string) => `/contracts/${id}/staff/reject`,
+    APPROVE_STEP: (id: string, stepId: string) =>
+      `/contracts/${id}/approval-steps/${stepId}/approve`,
+    CONTRACT_GENERATE: (id: string) => `/contracts/${id}/contract/generate`,
+    CONTRACT_VIEW: (id: string) => `/contracts/${id}/contract/view`,
+    CONTRACT_SIGN: (id: string) => `/contracts/${id}/contract/sign`,
+    CLEARANCE_QUEUE: "/contracts/clearance/queue",
+    CLEARANCE: (id: string) => `/contracts/${id}/clearance`,
+    CLEARANCE_REVIEW: (id: string) => `/contracts/${id}/clearance/review`,
+    CLEARANCE_OUTPUT_DOCUMENTS: (id: string) =>
+      `/contracts/${id}/clearance/output-documents`,
+    CLEARANCE_FINALIZE: (id: string) => `/contracts/${id}/clearance/finalize`,
+    // Path A self-clearance — Operations reviews the customer's own clearance docs.
+    OPS_CLEARANCE_QUEUE: "/contracts/clearance/ops-queue",
+    OPS_CLEARANCE_REVIEW: (id: string) =>
+      `/contracts/${id}/clearance/ops-review`,
+    OPS_CLEARANCE_FINALIZE: (id: string) =>
+      `/contracts/${id}/clearance/ops-finalize`,
+    CLEARANCE_HISTORY: "/contracts/clearance/history",
+    OPS_CLEARANCE_HISTORY: "/contracts/clearance/ops-history",
+    BOOKINGS: (id: string) => `/contracts/${id}/bookings`,
+    CAPACITY: (id: string) => `/contracts/${id}/capacity`,
+    // Shipment requests (GENERAL + customs, Path B): customer → GL queue → booking.
+    BOOKING_REQUEST_QUEUE: "/contracts/booking-requests/queue",
+    BOOKING_REQUEST_BY_ID: (reqId: string) =>
+      `/contracts/booking-requests/${reqId}`,
+    BOOKING_REQUESTS: (id: string) => `/contracts/${id}/booking-requests`,
+    BOOKING_REQUEST_ACCEPT: (reqId: string) =>
+      `/contracts/booking-requests/${reqId}/accept`,
+    BOOKING_REQUEST_REJECT: (reqId: string) =>
+      `/contracts/booking-requests/${reqId}/reject`,
+    MILESTONES: (id: string) => `/contracts/${id}/milestones`,
+    BOOKING_MILESTONES: (bookingId: string) =>
+      `/contracts/bookings/${bookingId}/milestones`,
+    COMPLETE_BOOKING_MILESTONE: (bookingId: string, code: string) =>
+      `/contracts/bookings/${bookingId}/milestones/${code}/complete`,
+    // ── GL post-booking operational actions ──
+    BOOKING_RISK: (bookingId: string) =>
+      `/contracts/bookings/${bookingId}/risk`,
+    BOOKING_DUTY: (bookingId: string) =>
+      `/contracts/bookings/${bookingId}/duty`,
+    BOOKING_STATION_ASSIGN: (bookingId: string) =>
+      `/contracts/bookings/${bookingId}/station-assign`,
+    BOOKING_GL_DOCUMENTS: (bookingId: string) =>
+      `/contracts/bookings/${bookingId}/documents`,
+    BOOKING_INCIDENTS: (bookingId: string) =>
+      `/contracts/bookings/${bookingId}/incidents`,
+  },
+
   OTP: {
     SEND: "/api/otp/send",
     VERIFY: "/api/otp/verify",
@@ -149,6 +206,7 @@ export const URL_CONSTANTS = {
     ELIGIBLE_BOOKINGS: "/train-scheduling/eligible-bookings",
     BOOKABLE_SCHEDULES: "/train-scheduling/bookable-schedules",
     AVAILABLE_DAYS: "/train-scheduling/available-days",
+    AVAILABLE_DAYS_FOR_CARGO: "/train-scheduling/available-days-for-cargo",
     AVAILABLE_LOCOMOTIVES: "/train-scheduling/available-locomotives",
     BATCH_BOARD: "/train-scheduling/batch-board",
     BATCH_BOARD_DETAIL: (scheduleId: string) =>

apps/edr-freight-web/backoffice/src/constants/apiConfig.ts

@@ -1,6 +1,15 @@
-export const API_BASE_URL =
-   import.meta.env.VITE_BASE_API_URL ||
-  import.meta.env.VITE_API_URL ||
- 'https://edrfreightapi.triaplc.com';
+export const API_BASE_URL = 'https://edrfreightapi.triaplc.com';
 
-//export const API_BASE_URL = 'http://localhost:3001';
+// export const API_BASE_URL = 'http://localhost:3001';
+
+/**
+ * URL that streams an uploaded file through the API by its UUID. Routes the
+ * bytes through `GET /api/files/:id` (served from MinIO with backend
+ * credentials) instead of a presigned MinIO URL — the latter is not reachable
+ * from the browser and breaks on the minio-js port-443 signature quirk. Serves
+ * inline for preview by default; pass `download` to force a save dialog.
+ */
+export function fileViewUrl(fileId: string, download = false): string {
+  const base = `${API_BASE_URL}/api/files/${fileId}`;
+  return download ? `${base}?download=1` : base;
+}