contrat,booking,global logestic

apps/edr-freight-web/backoffice/src/services/contracts.service.ts

@@ -0,0 +1,233 @@
+import { api as client } from "../auth/http";
+import { unwrap } from "@/utils/endpoint";
+import { URL_CONSTANTS } from "@/constants/URLS";
+import type { Freight } from "@edr/types";
+
+const C = URL_CONSTANTS.CONTRACTS;
+
+export interface ContractListFilter {
+  status?: string;
+  /** Comma-separated statuses for grouped tabs. */
+  statuses?: string;
+  /** Tab key for React Query cache (not sent to API). */
+  tab?: string;
+  companyId?: string;
+  freightType?: string;
+  tradeDirection?: string;
+  contractKind?: string;
+  paymentCurrency?: string;
+  page?: number;
+  pageSize?: number;
+  sortBy?: string;
+  sortOrder?: "ASC" | "DESC";
+}
+
+export interface PaginatedContracts {
+  items: Freight.IContract[];
+  total: number;
+}
+
+export interface ContractListSummaryMetrics {
+  inQueue: number;
+  needsAction: number;
+  urgent: number;
+  completed: number;
+}
+
+export interface ContractListSummaryTabs {
+  all: number;
+  intake: number;
+  in_approval: number;
+  approved_contract: number;
+  clearance: number;
+  active: number;
+  closed: number;
+}
+
+export interface ContractListSummary {
+  metrics: ContractListSummaryMetrics;
+  tabs: ContractListSummaryTabs;
+}
+
+export interface ContractView {
+  contractId: string;
+  reference: string;
+  status: string;
+  templateKey: string;
+  title: string;
+  html: string;
+  canSignCustomer: boolean;
+  canSignStaff: boolean;
+  hasContractDocument: boolean;
+  signatures: Array<{
+    role: string;
+    signerDisplayName: string;
+    signedAt: string;
+    signatureImageUrl?: string | null;
+  }>;
+  savedSignature?: {
+    signerDisplayName: string;
+    signatureImageUrl?: string | null;
+  } | null;
+}
+
+export interface SignContractPayload {
+  role: "CUSTOMER" | "STAFF";
+  signatureImageBase64: string;
+  signerDisplayName: string;
+  consentText?: string;
+}
+
+async function postContract<T>(url: string, body?: unknown): Promise<T> {
+  const response = await client.post<T>(url, body ?? {});
+  return unwrap(response.data);
+}
+
+function buildListParams(filter?: ContractListFilter) {
+  const params: Record<string, string | number | boolean | undefined> = {};
+  if (filter) {
+    if (filter.statuses) params.statuses = filter.statuses;
+    else if (filter.status) params.status = filter.status;
+    if (filter.page != null) params.page = filter.page;
+    if (filter.pageSize != null) params.pageSize = filter.pageSize;
+    if (filter.sortBy) params.sortBy = filter.sortBy;
+    if (filter.sortOrder) params.sortOrder = filter.sortOrder;
+    if (filter.companyId) params.companyId = filter.companyId;
+    if (filter.freightType) params.freightType = filter.freightType;
+    if (filter.tradeDirection) params.tradeDirection = filter.tradeDirection;
+    if (filter.contractKind) params.contractKind = filter.contractKind;
+    if (filter.paymentCurrency) params.paymentCurrency = filter.paymentCurrency;
+  }
+  return params;
+}
+
+export const contractsService = {
+  getListSummary: async (
+    filter?: ContractListFilter,
+  ): Promise<ContractListSummary> => {
+    const response = await client.get<ContractListSummary>(C.LIST_SUMMARY, {
+      params: buildListParams(filter),
+    });
+    return unwrap(response.data) as ContractListSummary;
+  },
+
+  list: async (filter?: ContractListFilter): Promise<PaginatedContracts> => {
+    const response = await client.get<PaginatedContracts>(C.BASE, {
+      params: buildListParams(filter),
+    });
+    const data = unwrap(response.data);
+    return {
+      items: (data.items ?? []) as Freight.IContract[],
+      total: data.total ?? 0,
+    };
+  },
+
+  getById: async (id: string): Promise<Freight.IContract> => {
+    const response = await client.get<Freight.IContract>(C.BY_ID(id));
+    return unwrap(response.data) as Freight.IContract;
+  },
+
+  // ── Staff review ──
+  staffAccept: (id: string, validityDays: number) =>
+    postContract<Freight.IContract>(C.STAFF_ACCEPT(id), { validityDays }),
+
+  requestChanges: (id: string, note: string) =>
+    postContract<Freight.IContract>(C.STAFF_REQUEST_CHANGES(id), { note }),
+
+  reject: (id: string, reason: string) =>
+    postContract<Freight.IContract>(C.STAFF_REJECT(id), { reason }),
+
+  approveStep: ({
+    id,
+    stepId,
+    requiredRole,
+  }: {
+    id: string;
+    stepId: string;
+    requiredRole: string;
+  }) =>
+    postContract<Freight.IContract>(C.APPROVE_STEP(id, stepId), {
+      requiredRole,
+    }),
+
+  // ── Contract document ──
+  generateContract: (id: string) =>
+    postContract<Freight.IContract>(C.CONTRACT_GENERATE(id)),
+
+  getContractView: async (id: string): Promise<ContractView> => {
+    const response = await client.get<ContractView>(C.CONTRACT_VIEW(id));
+    return unwrap(response.data) as ContractView;
+  },
+
+  signContract: (id: string, payload: SignContractPayload) =>
+    postContract<Freight.IContract>(C.CONTRACT_SIGN(id), payload),
+
+  // ── Pre-booking clearance (Path B — GL ET) ──
+  getClearanceQueue: async (
+    region = "ET",
+  ): Promise<PaginatedContracts> => {
+    const response = await client.get<PaginatedContracts>(C.CLEARANCE_QUEUE, {
+      params: { region },
+    });
+    const data = unwrap(response.data);
+    return {
+      items: (data.items ?? []) as Freight.IContract[],
+      total: data.total ?? 0,
+    };
+  },
+
+  getClearance: async (id: string): Promise<Freight.ContractClearanceView> => {
+    const response = await client.get(C.CLEARANCE(id));
+    return unwrap(response.data) as Freight.ContractClearanceView;
+  },
+
+  reviewClearanceDocument: (
+    id: string,
+    payload: { fileKey: string; status: "APPROVED" | "QUERIED"; note?: string },
+  ) =>
+    postContract<Freight.IContract>(C.CLEARANCE_REVIEW(id), payload),
+
+  uploadClearanceOutput: async (
+    id: string,
+    files: Record<string, File | null>,
+  ): Promise<Freight.IContract> => {
+    const form = new FormData();
+    for (const [key, file] of Object.entries(files)) {
+      if (file) form.append(key, file);
+    }
+    const response = await client.post(C.CLEARANCE_OUTPUT_DOCUMENTS(id), form, {
+      headers: { "Content-Type": "multipart/form-data" },
+    });
+    return unwrap(response.data) as Freight.IContract;
+  },
+
+  finalizeClearance: (id: string) =>
+    postContract<Freight.IContract>(C.CLEARANCE_FINALIZE(id)),
+
+  // ── Booking under contract (GL ET — Path B) ──
+  createBookingUnderContract: (
+    id: string,
+    payload: Freight.CreateBookingUnderContractDto,
+  ) => postContract<{ id: string; reference: string }>(C.BOOKINGS(id), payload),
+
+  // ── Clearance milestones ──
+  listMilestonesForContract: async (
+    id: string,
+  ): Promise<Freight.IClearanceMilestone[]> => {
+    const response = await client.get(C.MILESTONES(id));
+    return (unwrap(response.data) ?? []) as Freight.IClearanceMilestone[];
+  },
+
+  listMilestonesForBooking: async (
+    bookingId: string,
+  ): Promise<Freight.IClearanceMilestone[]> => {
+    const response = await client.get(C.BOOKING_MILESTONES(bookingId));
+    return (unwrap(response.data) ?? []) as Freight.IClearanceMilestone[];
+  },
+
+  completeMilestone: (bookingId: string, code: string, note?: string) =>
+    postContract<Freight.IClearanceMilestone>(
+      C.COMPLETE_BOOKING_MILESTONE(bookingId, code),
+      { note },
+    ),
+};