mirror of
https://github.com/Tria-plc/edr-platform.git
synced 2026-08-30 06:28:12 +00:00
feat: add poa to the changes approval
This commit is contained in:
@@ -153,6 +153,7 @@ export function ChangeRequestReview({ company }: { company: Company }) {
|
||||
: ([] as string[]);
|
||||
const docCount = pending?.documentFileIds?.length ?? 0;
|
||||
const licenseChanges = pending?.licenseChanges ?? [];
|
||||
const documentChanges = pending?.documentChanges ?? [];
|
||||
|
||||
const confirmReject = () => {
|
||||
if (!rejectId) return;
|
||||
@@ -210,11 +211,75 @@ export function ChangeRequestReview({ company }: { company: Company }) {
|
||||
</Text>
|
||||
)}
|
||||
|
||||
{documentChanges.length > 0 && (
|
||||
<Stack gap={8}>
|
||||
<Text size="sm" fw={600} c="edr-text">
|
||||
Document changes
|
||||
</Text>
|
||||
{documentChanges.map((c, i) => (
|
||||
<Group key={`${c.fileId}-${i}`} gap={8} wrap="nowrap">
|
||||
{c.op === "add" ? (
|
||||
<FilePlus2 size={15} className="text-edr-muted" />
|
||||
) : (
|
||||
<FileX2 size={15} className="text-edr-muted" />
|
||||
)}
|
||||
<Badge
|
||||
size="sm"
|
||||
radius="sm"
|
||||
variant="light"
|
||||
color={c.op === "add" ? "green" : "red"}
|
||||
>
|
||||
{c.op === "add" ? "Add" : "Remove"}
|
||||
</Badge>
|
||||
<Anchor
|
||||
component="button"
|
||||
type="button"
|
||||
size="sm"
|
||||
onClick={() =>
|
||||
view({
|
||||
name: c.fileName ?? humanize(c.code),
|
||||
url: fileViewUrl(c.fileId),
|
||||
})
|
||||
}
|
||||
style={{
|
||||
textDecoration:
|
||||
c.op === "remove" ? "line-through" : undefined,
|
||||
}}
|
||||
>
|
||||
{c.fileName ?? humanize(c.code)}
|
||||
</Anchor>
|
||||
<Text size="xs" c="dimmed">
|
||||
{humanize(c.code)}
|
||||
</Text>
|
||||
</Group>
|
||||
))}
|
||||
</Stack>
|
||||
)}
|
||||
|
||||
{docCount > 0 && (
|
||||
<Text size="sm" c="dimmed">
|
||||
{docCount} document{docCount === 1 ? "" : "s"} uploaded with this
|
||||
request — review them in the Documents tab.
|
||||
</Text>
|
||||
<Stack gap={8}>
|
||||
<Text size="sm" fw={600} c="edr-text">
|
||||
Documents uploaded with this request
|
||||
</Text>
|
||||
{pending!.documentFileIds.map((fileId, i) => (
|
||||
<Group key={fileId} gap={8} wrap="nowrap">
|
||||
<FilePlus2 size={15} className="text-edr-muted" />
|
||||
<Anchor
|
||||
component="button"
|
||||
type="button"
|
||||
size="sm"
|
||||
onClick={() =>
|
||||
view({
|
||||
name: `Document ${i + 1}`,
|
||||
url: fileViewUrl(fileId),
|
||||
})
|
||||
}
|
||||
>
|
||||
Document {i + 1}
|
||||
</Anchor>
|
||||
</Group>
|
||||
))}
|
||||
</Stack>
|
||||
)}
|
||||
|
||||
{licenseChanges.length > 0 && (
|
||||
|
||||
@@ -93,6 +93,8 @@ function tableStatus(query: { isLoading: boolean; isError: boolean }) {
|
||||
|
||||
/** Matches the fileKey seeded in the API's file-upload-settings seeder. */
|
||||
const POA_DELEGATION_CODE = "poa_delegation_letter";
|
||||
/** A letter uploaded by an approved customer, awaiting this reviewer's approval. */
|
||||
const POA_DELEGATION_PENDING_CODE = "poa_delegation_letter_pending";
|
||||
|
||||
export default function CustomerDetailPage() {
|
||||
const { id } = useParams<{ id: string }>();
|
||||
@@ -536,9 +538,15 @@ export default function CustomerDetailPage() {
|
||||
);
|
||||
|
||||
const poaDocuments = useMemo(
|
||||
() => documents.filter((d) => d.code === POA_DELEGATION_CODE),
|
||||
() =>
|
||||
documents.filter(
|
||||
(d) =>
|
||||
d.code === POA_DELEGATION_CODE ||
|
||||
d.code === POA_DELEGATION_PENDING_CODE,
|
||||
),
|
||||
[documents],
|
||||
);
|
||||
const poaLive = poaDocuments.filter((d) => d.code === POA_DELEGATION_CODE);
|
||||
const poaFields = [
|
||||
{ label: "PoA name", value: company?.poaName },
|
||||
{ label: "PoA email", value: company?.poaEmail },
|
||||
@@ -553,7 +561,7 @@ export default function CustomerDetailPage() {
|
||||
(p) => p.type === "freight_forwarder",
|
||||
);
|
||||
const delegationMissing =
|
||||
(hasPoaDetails || poaMandatory) && poaDocuments.length === 0;
|
||||
(hasPoaDetails || poaMandatory) && poaLive.length === 0;
|
||||
|
||||
if (isLoading) {
|
||||
return (
|
||||
@@ -713,7 +721,7 @@ export default function CustomerDetailPage() {
|
||||
<Badge size="sm" color="red" variant="light">
|
||||
Delegation letter missing
|
||||
</Badge>
|
||||
) : poaDocuments.length > 0 ? (
|
||||
) : poaLive.length > 0 ? (
|
||||
<Badge size="sm" color="edr-green" variant="light">
|
||||
Delegation letter on file
|
||||
</Badge>
|
||||
@@ -806,6 +814,16 @@ export default function CustomerDetailPage() {
|
||||
{formatBytes(doc.size)} ·{" "}
|
||||
{formatDate(doc.uploadedAt)}
|
||||
</Text>
|
||||
{doc.code === POA_DELEGATION_PENDING_CODE && (
|
||||
<Badge
|
||||
size="xs"
|
||||
color="yellow"
|
||||
variant="light"
|
||||
className="shrink-0"
|
||||
>
|
||||
Pending approval
|
||||
</Badge>
|
||||
)}
|
||||
</Group>
|
||||
<Group gap={4} wrap="nowrap">
|
||||
<ActionIcon
|
||||
|
||||
@@ -79,6 +79,15 @@ export interface LicenseChangeIntent {
|
||||
fileName?: string;
|
||||
}
|
||||
|
||||
/** A staged company-level document add/remove (e.g. the PoA delegation letter). */
|
||||
export interface DocumentChangeIntent {
|
||||
op: "add" | "remove";
|
||||
fileId: string;
|
||||
/** The live FileRecord code this op targets (the upload setting's fileKey). */
|
||||
code: string;
|
||||
fileName?: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* A staged profile-edit change request. The customer's settings edits land here
|
||||
* (pending) until a reviewer approves (applies them) or rejects (with a note).
|
||||
@@ -92,6 +101,8 @@ export interface CompanyChangeRequest {
|
||||
documentFileIds: string[];
|
||||
/** Staged business-license add/remove intents attached to this request. */
|
||||
licenseChanges: LicenseChangeIntent[];
|
||||
/** Staged company-document add/remove intents (e.g. the PoA letter). */
|
||||
documentChanges: DocumentChangeIntent[];
|
||||
note: string | null;
|
||||
submittedAt: string | null;
|
||||
reviewedAt: string | null;
|
||||
|
||||
@@ -102,6 +102,9 @@ export const URL_CONSTANTS = {
|
||||
`/api/companies/company-profiles/${profileId}/license/${fileId}`,
|
||||
PROFILE_LICENSE_REPLACE: (profileId: string, fileId: string) =>
|
||||
`/api/companies/company-profiles/${profileId}/license/${fileId}/replace`,
|
||||
POA_DELEGATION: "/api/companies/poa-delegation",
|
||||
POA_DELEGATION_FILE: (fileId: string) =>
|
||||
`/api/companies/poa-delegation/${fileId}`,
|
||||
PROFILE_CHANGE_REQUEST: "/api/companies/profile/change-request",
|
||||
PROFILE_REAPPLY: (profileId: string) =>
|
||||
`/api/companies/company-profiles/${profileId}/reapply`,
|
||||
|
||||
@@ -61,6 +61,13 @@ function documentSettingCode(nationality: string | null | undefined): string {
|
||||
: "company_onboarding_documents_ethiopian";
|
||||
}
|
||||
|
||||
/**
|
||||
* The delegation letter ships in the same nationality document set, but it is
|
||||
* edited on the Power of Attorney tab (where it is staged for review alongside
|
||||
* the PoA details), so it is excluded from this tab's uploader.
|
||||
*/
|
||||
const POA_DELEGATION_FILE_KEY = "poa_delegation_letter";
|
||||
|
||||
export default function TabDocuments({
|
||||
profile,
|
||||
mode = "edit",
|
||||
@@ -78,6 +85,17 @@ export default function TabDocuments({
|
||||
}),
|
||||
);
|
||||
|
||||
const docSetting = useMemo(() => {
|
||||
const setting = docSettingQuery.data;
|
||||
if (!setting) return setting;
|
||||
return {
|
||||
...setting,
|
||||
fields: setting.fields.filter(
|
||||
(f) => f.fileKey !== POA_DELEGATION_FILE_KEY,
|
||||
),
|
||||
};
|
||||
}, [docSettingQuery.data]);
|
||||
|
||||
const docsQuery = useQuery(
|
||||
api.companies.documents.queryOptions({
|
||||
input: { companyId: profile.companyId },
|
||||
@@ -139,7 +157,7 @@ export default function TabDocuments({
|
||||
|
||||
const validateRequired = (): Record<string, string> => {
|
||||
const errs: Record<string, string> = {};
|
||||
for (const field of docSettingQuery.data?.fields ?? []) {
|
||||
for (const field of docSetting?.fields ?? []) {
|
||||
const min = getMinFiles(field);
|
||||
if (min <= 0) continue;
|
||||
if (uploadedKeys.includes(field.fileKey)) continue;
|
||||
@@ -169,13 +187,13 @@ export default function TabDocuments({
|
||||
<Center py="xl">
|
||||
<Loader2 size={24} className="animate-spin" />
|
||||
</Center>
|
||||
) : !docSettingQuery.data ? (
|
||||
) : !docSetting ? (
|
||||
<Text c="edr-muted" size="sm" ta="center" py="md">
|
||||
No document requirements configured for your account.
|
||||
</Text>
|
||||
) : (
|
||||
<SmartFileInput
|
||||
file={docSettingQuery.data}
|
||||
file={docSetting}
|
||||
value={documentFiles}
|
||||
onChange={handleFilesChange}
|
||||
errors={fieldErrors}
|
||||
@@ -185,7 +203,7 @@ export default function TabDocuments({
|
||||
/>
|
||||
)}
|
||||
|
||||
{docSettingQuery.data && (
|
||||
{docSetting && (
|
||||
<Group
|
||||
justify="space-between"
|
||||
mt="lg"
|
||||
|
||||
@@ -1,20 +1,44 @@
|
||||
import { useMemo } from "react";
|
||||
import { useMutation, useQueryClient } from "@tanstack/react-query";
|
||||
import { useMemo, useRef, useState } from "react";
|
||||
import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
|
||||
import { useForm } from "react-hook-form";
|
||||
import { zodResolver } from "@hookform/resolvers/zod";
|
||||
import { z } from "zod";
|
||||
import { CheckCircle2, Save, UserCheck, XCircle } from "lucide-react";
|
||||
import {
|
||||
CheckCircle2,
|
||||
Clock,
|
||||
FileText,
|
||||
RefreshCw,
|
||||
Save,
|
||||
Trash2,
|
||||
Undo2,
|
||||
UploadCloud,
|
||||
UserCheck,
|
||||
XCircle,
|
||||
} from "lucide-react";
|
||||
import {
|
||||
ActionIcon,
|
||||
Alert,
|
||||
Anchor,
|
||||
Badge,
|
||||
Button,
|
||||
Card,
|
||||
Group,
|
||||
Loader,
|
||||
Stack,
|
||||
Title,
|
||||
Text,
|
||||
TextInput,
|
||||
Button,
|
||||
Tooltip,
|
||||
Grid,
|
||||
} from "@mantine/core";
|
||||
import { useFileViewer, type ViewableFile } from "@edr/ui-common";
|
||||
import { api } from "@/services/api";
|
||||
import { fileViewUrl } from "@/constants/apiConfig";
|
||||
import {
|
||||
companiesService,
|
||||
type LicenseFile,
|
||||
type LicenseFileStatus,
|
||||
} from "@/services/companies.service";
|
||||
import { ControlledPhoneField, isValidPhone } from "@/components/PhoneField";
|
||||
import type { ProfileResponse } from "@/types/profile";
|
||||
|
||||
@@ -31,6 +55,32 @@ const schema = z.object({
|
||||
|
||||
type FormData = z.infer<typeof schema>;
|
||||
|
||||
const LETTER_ACCEPT = ".pdf,.png,.jpg,.jpeg";
|
||||
|
||||
const STATUS_BADGE: Record<
|
||||
LicenseFileStatus,
|
||||
{ label: string; bg: string; fg: string } | null
|
||||
> = {
|
||||
live: null,
|
||||
pending_add: {
|
||||
label: "Pending approval",
|
||||
bg: "var(--mantine-color-edr-amber-soft-0)",
|
||||
fg: "var(--mantine-color-edr-amber-text-0)",
|
||||
},
|
||||
pending_remove: {
|
||||
label: "Removal pending",
|
||||
bg: "var(--mantine-color-edr-red-soft-0)",
|
||||
fg: "var(--mantine-color-edr-red-0)",
|
||||
},
|
||||
};
|
||||
|
||||
function formatBytes(bytes: number): string {
|
||||
if (!bytes) return "";
|
||||
const units = ["B", "KB", "MB", "GB"];
|
||||
const i = Math.floor(Math.log(bytes) / Math.log(1024));
|
||||
return `${parseFloat((bytes / Math.pow(1024, i)).toFixed(1))} ${units[i]}`;
|
||||
}
|
||||
|
||||
interface TabPowerOfAttorneyProps {
|
||||
profile: ProfileResponse;
|
||||
mode?: "edit" | "onboarding";
|
||||
@@ -43,6 +93,8 @@ export default function TabPowerOfAttorney({
|
||||
onContinue,
|
||||
}: TabPowerOfAttorneyProps) {
|
||||
const queryClient = useQueryClient();
|
||||
const { view, viewer } = useFileViewer();
|
||||
const uploadInputRef = useRef<HTMLInputElement>(null);
|
||||
|
||||
const defaultValues = useMemo((): FormData => {
|
||||
return {
|
||||
@@ -59,22 +111,75 @@ export default function TabPowerOfAttorney({
|
||||
control,
|
||||
handleSubmit,
|
||||
reset,
|
||||
watch,
|
||||
formState: { errors, isDirty },
|
||||
} = useForm<FormData>({
|
||||
resolver: zodResolver(schema),
|
||||
values: defaultValues,
|
||||
});
|
||||
|
||||
const letterQuery = useQuery(api.companies.poaDelegation.queryOptions({}));
|
||||
const letters = useMemo(() => letterQuery.data ?? [], [letterQuery.data]);
|
||||
|
||||
// The letter is staged locally, not uploaded on pick. Uploading immediately
|
||||
// would open a change request, which locks the whole settings page (see
|
||||
// SettingsPage's `locked` fieldset) before the text fields could be saved.
|
||||
// Save submits the file and the fields together, into one change request.
|
||||
const [pickedFile, setPickedFile] = useState<File | null>(null);
|
||||
const [removeIds, setRemoveIds] = useState<string[]>([]);
|
||||
const [letterError, setLetterError] = useState<string | null>(null);
|
||||
const [saveBlocked, setSaveBlocked] = useState(false);
|
||||
|
||||
/** Letters that will still be on file once the staged edits are applied. */
|
||||
const remainingLetters = letters.filter(
|
||||
(f) => f.status !== "pending_remove" && !removeIds.includes(f.id),
|
||||
);
|
||||
const hasLetterAfterSave = Boolean(pickedFile) || remainingLetters.length > 0;
|
||||
|
||||
// A freight forwarder signs on other companies' behalf, so its PoA — details
|
||||
// and delegation letter both — is mandatory rather than optional.
|
||||
const requirePoa = profile.companyProfiles.some(
|
||||
(p) => p.type === "freight_forwarder",
|
||||
);
|
||||
const poaValues = watch([
|
||||
"poaName",
|
||||
"poaEmail",
|
||||
"poaPhone",
|
||||
"poaLocation",
|
||||
"poaAddress",
|
||||
]);
|
||||
const poaProvided = poaValues.some((v) => v?.trim());
|
||||
const letterRequired = requirePoa || poaProvided;
|
||||
const letterMissing = letterRequired && !hasLetterAfterSave;
|
||||
|
||||
const fileDirty = Boolean(pickedFile) || removeIds.length > 0;
|
||||
|
||||
const mutation = useMutation({
|
||||
mutationFn: (data: FormData) =>
|
||||
api.companies.updateProfile.call({
|
||||
mutationFn: async (data: FormData) => {
|
||||
// A fresh upload already stages the removal of every live letter, so the
|
||||
// explicit removals only need applying when no replacement was picked.
|
||||
if (pickedFile) {
|
||||
await companiesService.uploadPoaDelegation(pickedFile);
|
||||
} else {
|
||||
for (const fileId of removeIds) {
|
||||
await companiesService.removePoaDelegation(fileId);
|
||||
}
|
||||
}
|
||||
return api.companies.updateProfile.call({
|
||||
poaName: data.poaName || undefined,
|
||||
poaPhone: data.poaPhone || undefined,
|
||||
poaEmail: data.poaEmail || undefined,
|
||||
poaLocation: data.poaLocation || undefined,
|
||||
poaAddress: data.poaAddress || undefined,
|
||||
}),
|
||||
});
|
||||
},
|
||||
onSuccess: () => {
|
||||
setPickedFile(null);
|
||||
setRemoveIds([]);
|
||||
setLetterError(null);
|
||||
queryClient.invalidateQueries({
|
||||
queryKey: api.companies.poaDelegation.queryKey(),
|
||||
});
|
||||
queryClient.invalidateQueries({
|
||||
queryKey: api.companies.getProfile.queryKey(),
|
||||
});
|
||||
@@ -82,112 +187,431 @@ export default function TabPowerOfAttorney({
|
||||
},
|
||||
});
|
||||
|
||||
const onSubmit = (data: FormData) => mutation.mutate(data);
|
||||
const onSubmit = (data: FormData) => {
|
||||
// The letter lives outside the form state, so it's gated here rather than
|
||||
// in the zod resolver.
|
||||
if (letterMissing) {
|
||||
setSaveBlocked(true);
|
||||
return;
|
||||
}
|
||||
setSaveBlocked(false);
|
||||
mutation.mutate(data);
|
||||
};
|
||||
|
||||
const resetAll = () => {
|
||||
reset();
|
||||
setPickedFile(null);
|
||||
setRemoveIds([]);
|
||||
setSaveBlocked(false);
|
||||
setLetterError(null);
|
||||
};
|
||||
|
||||
const pickFile = (file: File) => {
|
||||
setLetterError(null);
|
||||
setSaveBlocked(false);
|
||||
setPickedFile(file);
|
||||
};
|
||||
|
||||
const toggleRemove = (fileId: string) => {
|
||||
setSaveBlocked(false);
|
||||
setRemoveIds((prev) =>
|
||||
prev.includes(fileId)
|
||||
? prev.filter((id) => id !== fileId)
|
||||
: [...prev, fileId],
|
||||
);
|
||||
};
|
||||
|
||||
return (
|
||||
<Card padding="lg">
|
||||
<Group gap="sm" mb="xs">
|
||||
<UserCheck size={20} />
|
||||
<Title order={3}>Power of Attorney</Title>
|
||||
</Group>
|
||||
<Text c="edr-muted" size="sm" mb="lg">
|
||||
Power of Attorney details are optional. Fill them in if you have an
|
||||
authorized representative, or leave blank.
|
||||
</Text>
|
||||
<>
|
||||
<Card padding="lg">
|
||||
<Group gap="sm" mb="xs">
|
||||
<UserCheck size={20} />
|
||||
<Title order={3}>Power of Attorney</Title>
|
||||
{requirePoa && (
|
||||
<Badge size="sm" variant="light" color="blue">
|
||||
Required for freight forwarder
|
||||
</Badge>
|
||||
)}
|
||||
</Group>
|
||||
<Text c="edr-muted" size="sm" mb="lg">
|
||||
{requirePoa
|
||||
? "As a freight forwarder you act on other companies' behalf, so a Power of Attorney and its delegation letter are required."
|
||||
: "Power of Attorney details are optional. If you name a representative, upload the delegation letter authorising them."}
|
||||
</Text>
|
||||
|
||||
<form onSubmit={handleSubmit(onSubmit)}>
|
||||
<Stack gap="md">
|
||||
<TextInput
|
||||
label="PoA Full Name"
|
||||
placeholder="Authorized Representative Name"
|
||||
error={errors.poaName?.message}
|
||||
{...register("poaName")}
|
||||
/>
|
||||
<form onSubmit={handleSubmit(onSubmit)}>
|
||||
<Stack gap="md">
|
||||
<TextInput
|
||||
label="PoA Full Name"
|
||||
placeholder="Authorized Representative Name"
|
||||
error={errors.poaName?.message}
|
||||
{...register("poaName")}
|
||||
/>
|
||||
|
||||
<Grid>
|
||||
<Grid.Col span={6}>
|
||||
<TextInput
|
||||
label="PoA Email"
|
||||
type="email"
|
||||
placeholder="poa@company.com"
|
||||
error={errors.poaEmail?.message}
|
||||
{...register("poaEmail")}
|
||||
/>
|
||||
</Grid.Col>
|
||||
<Grid.Col span={6}>
|
||||
<ControlledPhoneField
|
||||
control={control}
|
||||
name="poaPhone"
|
||||
label="PoA Phone"
|
||||
/>
|
||||
</Grid.Col>
|
||||
</Grid>
|
||||
<Grid>
|
||||
<Grid.Col span={6}>
|
||||
<TextInput
|
||||
label="PoA Email"
|
||||
type="email"
|
||||
placeholder="poa@company.com"
|
||||
error={errors.poaEmail?.message}
|
||||
{...register("poaEmail")}
|
||||
/>
|
||||
</Grid.Col>
|
||||
<Grid.Col span={6}>
|
||||
<ControlledPhoneField
|
||||
control={control}
|
||||
name="poaPhone"
|
||||
label="PoA Phone"
|
||||
/>
|
||||
</Grid.Col>
|
||||
</Grid>
|
||||
|
||||
<Grid>
|
||||
<Grid.Col span={6}>
|
||||
<TextInput
|
||||
label="PoA Location"
|
||||
placeholder="City, Country"
|
||||
error={errors.poaLocation?.message}
|
||||
{...register("poaLocation")}
|
||||
/>
|
||||
</Grid.Col>
|
||||
<Grid.Col span={6}>
|
||||
<TextInput
|
||||
label="PoA Address"
|
||||
placeholder="Full Address"
|
||||
error={errors.poaAddress?.message}
|
||||
{...register("poaAddress")}
|
||||
/>
|
||||
</Grid.Col>
|
||||
</Grid>
|
||||
</Stack>
|
||||
<Grid>
|
||||
<Grid.Col span={6}>
|
||||
<TextInput
|
||||
label="PoA Location"
|
||||
placeholder="City, Country"
|
||||
error={errors.poaLocation?.message}
|
||||
{...register("poaLocation")}
|
||||
/>
|
||||
</Grid.Col>
|
||||
<Grid.Col span={6}>
|
||||
<TextInput
|
||||
label="PoA Address"
|
||||
placeholder="Full Address"
|
||||
error={errors.poaAddress?.message}
|
||||
{...register("poaAddress")}
|
||||
/>
|
||||
</Grid.Col>
|
||||
</Grid>
|
||||
</Stack>
|
||||
|
||||
<Group
|
||||
justify="space-between"
|
||||
mt="xl"
|
||||
pt="md"
|
||||
style={{ borderTop: "1px solid var(--mantine-color-edr-border-0)" }}
|
||||
>
|
||||
<Group gap="xs">
|
||||
{mutation.isSuccess && (
|
||||
<Group gap={6} c="green">
|
||||
<CheckCircle2 size={16} />
|
||||
<Text size="sm" fw={500}>
|
||||
Saved successfully
|
||||
{/* ------------------------ Delegation letter ------------------------ */}
|
||||
<Stack gap="sm" mt="xl">
|
||||
<Group justify="space-between" align="center">
|
||||
<Group gap="sm">
|
||||
<FileText size={18} />
|
||||
<Text fw={600} c="edr-text">
|
||||
Delegation letter
|
||||
</Text>
|
||||
</Group>
|
||||
)}
|
||||
{mutation.isError && (
|
||||
<Group gap={6} c="red">
|
||||
<XCircle size={16} />
|
||||
<Text size="sm" fw={500}>
|
||||
Save failed
|
||||
</Text>
|
||||
</Group>
|
||||
)}
|
||||
</Group>
|
||||
<Group gap="md">
|
||||
{mode === "edit" && (
|
||||
<Button
|
||||
type="button"
|
||||
variant="outline"
|
||||
disabled={mutation.isPending || !isDirty}
|
||||
onClick={() => reset()}
|
||||
variant="light"
|
||||
size="xs"
|
||||
leftSection={
|
||||
hasLetterAfterSave ? (
|
||||
<RefreshCw size={14} />
|
||||
) : (
|
||||
<UploadCloud size={14} />
|
||||
)
|
||||
}
|
||||
disabled={mutation.isPending}
|
||||
onClick={() => uploadInputRef.current?.click()}
|
||||
>
|
||||
Reset
|
||||
{hasLetterAfterSave ? "Replace letter" : "Upload letter"}
|
||||
</Button>
|
||||
</Group>
|
||||
|
||||
<Text c="edr-muted" size="xs">
|
||||
The signed letter in which the General Manager delegates the
|
||||
representative above. Submitted to EDR for review together with the
|
||||
details; it takes effect once approved.
|
||||
</Text>
|
||||
|
||||
{saveBlocked && letterMissing && (
|
||||
<Alert
|
||||
color="red"
|
||||
variant="light"
|
||||
icon={<XCircle size={18} />}
|
||||
>
|
||||
{requirePoa
|
||||
? "Upload the delegation letter before saving — it is required for freight forwarders."
|
||||
: "Upload the delegation letter for the representative you named, or clear the PoA details."}
|
||||
</Alert>
|
||||
)}
|
||||
<Button
|
||||
type="submit"
|
||||
leftSection={<Save size={16} />}
|
||||
loading={mutation.isPending}
|
||||
>
|
||||
{mode === "onboarding" ? "Continue" : "Save Changes"}
|
||||
</Button>
|
||||
|
||||
{letterQuery.isLoading ? (
|
||||
<Group justify="center" py="md">
|
||||
<Loader size="sm" color="edr-green" />
|
||||
</Group>
|
||||
) : letters.length === 0 && !pickedFile ? (
|
||||
<Card
|
||||
padding="md"
|
||||
radius="md"
|
||||
style={{
|
||||
borderStyle: "dashed",
|
||||
backgroundColor: "var(--mantine-color-edr-bg-0)",
|
||||
}}
|
||||
>
|
||||
<Text size="sm" c="edr-muted" ta="center">
|
||||
No delegation letter uploaded.
|
||||
</Text>
|
||||
</Card>
|
||||
) : (
|
||||
<Stack gap="xs">
|
||||
{letters.map((f) => (
|
||||
<LetterRow
|
||||
key={f.id}
|
||||
file={f}
|
||||
markedForRemoval={removeIds.includes(f.id)}
|
||||
supersededBy={pickedFile}
|
||||
disabled={mutation.isPending}
|
||||
onToggleRemove={() => toggleRemove(f.id)}
|
||||
onViewFile={view}
|
||||
/>
|
||||
))}
|
||||
{pickedFile && (
|
||||
<Card
|
||||
padding="sm"
|
||||
radius="md"
|
||||
withBorder
|
||||
style={{
|
||||
backgroundColor: "var(--mantine-color-edr-card-0)",
|
||||
}}
|
||||
>
|
||||
<Group gap="sm" wrap="nowrap">
|
||||
<FileText
|
||||
size={18}
|
||||
className="text-edr-muted"
|
||||
style={{ flexShrink: 0 }}
|
||||
/>
|
||||
<Stack gap={0} style={{ minWidth: 0, flex: 1 }}>
|
||||
<Text size="sm" fw={600} c="edr-text" lineClamp={1}>
|
||||
{pickedFile.name}
|
||||
</Text>
|
||||
<Text size="xs" c="edr-muted">
|
||||
{formatBytes(pickedFile.size)}
|
||||
</Text>
|
||||
</Stack>
|
||||
<Badge
|
||||
size="sm"
|
||||
radius="sm"
|
||||
variant="light"
|
||||
color="blue"
|
||||
style={{ flexShrink: 0 }}
|
||||
>
|
||||
Submitted on save
|
||||
</Badge>
|
||||
<Tooltip label="Discard" withArrow>
|
||||
<ActionIcon
|
||||
variant="subtle"
|
||||
color="red"
|
||||
aria-label="Discard selected letter"
|
||||
disabled={mutation.isPending}
|
||||
onClick={() => setPickedFile(null)}
|
||||
>
|
||||
<Trash2 size={15} />
|
||||
</ActionIcon>
|
||||
</Tooltip>
|
||||
</Group>
|
||||
</Card>
|
||||
)}
|
||||
</Stack>
|
||||
)}
|
||||
|
||||
{profile.reviewStatus === "pending" && (
|
||||
<Group gap={6} c="edr-amber-text">
|
||||
<Clock size={13} />
|
||||
<Text size="xs" fw={500}>
|
||||
Awaiting EDR review — this letter takes effect once approved.
|
||||
</Text>
|
||||
</Group>
|
||||
)}
|
||||
{letterError && (
|
||||
<Group gap={6} c="red">
|
||||
<XCircle size={13} />
|
||||
<Text size="xs" fw={500}>
|
||||
{letterError}
|
||||
</Text>
|
||||
</Group>
|
||||
)}
|
||||
|
||||
<input
|
||||
ref={uploadInputRef}
|
||||
type="file"
|
||||
accept={LETTER_ACCEPT}
|
||||
style={{ display: "none" }}
|
||||
onChange={(e) => {
|
||||
const file = e.target.files?.[0];
|
||||
if (file) pickFile(file);
|
||||
e.target.value = "";
|
||||
}}
|
||||
/>
|
||||
</Stack>
|
||||
|
||||
<Group
|
||||
justify="space-between"
|
||||
mt="xl"
|
||||
pt="md"
|
||||
style={{ borderTop: "1px solid var(--mantine-color-edr-border-0)" }}
|
||||
>
|
||||
<Group gap="xs">
|
||||
{mutation.isSuccess && (
|
||||
<Group gap={6} c="green">
|
||||
<CheckCircle2 size={16} />
|
||||
<Text size="sm" fw={500}>
|
||||
Saved successfully
|
||||
</Text>
|
||||
</Group>
|
||||
)}
|
||||
{mutation.isError && (
|
||||
<Group gap={6} c="red">
|
||||
<XCircle size={16} />
|
||||
<Text size="sm" fw={500}>
|
||||
Save failed
|
||||
</Text>
|
||||
</Group>
|
||||
)}
|
||||
</Group>
|
||||
<Group gap="md">
|
||||
{mode === "edit" && (
|
||||
<Button
|
||||
type="button"
|
||||
variant="outline"
|
||||
disabled={mutation.isPending || (!isDirty && !fileDirty)}
|
||||
onClick={resetAll}
|
||||
>
|
||||
Reset
|
||||
</Button>
|
||||
)}
|
||||
<Button
|
||||
type="submit"
|
||||
leftSection={<Save size={16} />}
|
||||
loading={mutation.isPending}
|
||||
>
|
||||
{mode === "onboarding" ? "Continue" : "Save Changes"}
|
||||
</Button>
|
||||
</Group>
|
||||
</Group>
|
||||
</Group>
|
||||
</form>
|
||||
</form>
|
||||
</Card>
|
||||
|
||||
{viewer}
|
||||
</>
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* One letter already on file. `pending_add` / `pending_remove` reflect a change
|
||||
* request the backoffice hasn't ruled on yet; `markedForRemoval` and
|
||||
* `supersededBy` are this session's unsaved edits.
|
||||
*/
|
||||
function LetterRow({
|
||||
file,
|
||||
markedForRemoval,
|
||||
supersededBy,
|
||||
disabled,
|
||||
onToggleRemove,
|
||||
onViewFile,
|
||||
}: {
|
||||
file: LicenseFile;
|
||||
markedForRemoval: boolean;
|
||||
supersededBy: File | null;
|
||||
disabled: boolean;
|
||||
onToggleRemove: () => void;
|
||||
onViewFile: (file: ViewableFile) => void;
|
||||
}) {
|
||||
const badge = STATUS_BADGE[file.status];
|
||||
const superseded = Boolean(supersededBy) && file.status !== "pending_remove";
|
||||
const struck =
|
||||
file.status === "pending_remove" || markedForRemoval || superseded;
|
||||
|
||||
return (
|
||||
<Card
|
||||
padding="sm"
|
||||
radius="md"
|
||||
withBorder
|
||||
style={{ backgroundColor: "var(--mantine-color-edr-card-0)" }}
|
||||
>
|
||||
<Group gap="sm" wrap="nowrap">
|
||||
<FileText
|
||||
size={18}
|
||||
className="text-edr-muted"
|
||||
style={{ flexShrink: 0 }}
|
||||
/>
|
||||
<Stack gap={0} style={{ minWidth: 0, flex: 1 }}>
|
||||
<Anchor
|
||||
component="button"
|
||||
type="button"
|
||||
size="sm"
|
||||
fw={600}
|
||||
onClick={() =>
|
||||
onViewFile({
|
||||
name: file.name,
|
||||
url: fileViewUrl(file.id),
|
||||
mimeType: file.mimeType,
|
||||
})
|
||||
}
|
||||
style={{
|
||||
textAlign: "left",
|
||||
textDecoration: struck ? "line-through" : undefined,
|
||||
}}
|
||||
lineClamp={1}
|
||||
>
|
||||
{file.name}
|
||||
</Anchor>
|
||||
{file.size > 0 && (
|
||||
<Text size="xs" c="edr-muted">
|
||||
{formatBytes(file.size)}
|
||||
</Text>
|
||||
)}
|
||||
</Stack>
|
||||
|
||||
{badge && (
|
||||
<Badge
|
||||
size="sm"
|
||||
radius="sm"
|
||||
variant="light"
|
||||
leftSection={<Clock size={11} />}
|
||||
style={{ backgroundColor: badge.bg, color: badge.fg, flexShrink: 0 }}
|
||||
>
|
||||
{badge.label}
|
||||
</Badge>
|
||||
)}
|
||||
{superseded && !markedForRemoval && (
|
||||
<Badge
|
||||
size="sm"
|
||||
radius="sm"
|
||||
variant="light"
|
||||
color="gray"
|
||||
style={{ flexShrink: 0 }}
|
||||
>
|
||||
Replaced on save
|
||||
</Badge>
|
||||
)}
|
||||
{markedForRemoval && (
|
||||
<Badge
|
||||
size="sm"
|
||||
radius="sm"
|
||||
variant="light"
|
||||
color="red"
|
||||
style={{ flexShrink: 0 }}
|
||||
>
|
||||
Removed on save
|
||||
</Badge>
|
||||
)}
|
||||
|
||||
{file.status !== "pending_remove" && !superseded && (
|
||||
<Tooltip
|
||||
label={markedForRemoval ? "Keep" : "Remove"}
|
||||
withArrow
|
||||
>
|
||||
<ActionIcon
|
||||
variant="subtle"
|
||||
color={markedForRemoval ? "gray" : "red"}
|
||||
aria-label={
|
||||
markedForRemoval ? `Keep ${file.name}` : `Remove ${file.name}`
|
||||
}
|
||||
disabled={disabled}
|
||||
onClick={onToggleRemove}
|
||||
>
|
||||
{markedForRemoval ? <Undo2 size={15} /> : <Trash2 size={15} />}
|
||||
</ActionIcon>
|
||||
</Tooltip>
|
||||
)}
|
||||
</Group>
|
||||
</Card>
|
||||
);
|
||||
}
|
||||
|
||||
@@ -59,6 +59,7 @@ import type {
|
||||
CompanyInfoResponse,
|
||||
CompanyNationality,
|
||||
CompanyProfileResponse,
|
||||
LicenseFile,
|
||||
CreateCompanyPayload,
|
||||
DashboardSummary,
|
||||
OnboardingRequirements,
|
||||
@@ -231,6 +232,12 @@ export const api = {
|
||||
({ companyId }) => companiesService.getDocuments(companyId),
|
||||
),
|
||||
|
||||
poaDelegation: endpoint<void, LicenseFile[]>(
|
||||
"companies",
|
||||
"poaDelegation",
|
||||
companiesService.getPoaDelegation,
|
||||
),
|
||||
|
||||
changeRequest: endpoint<void, ChangeRequestResponse | null>(
|
||||
"companies",
|
||||
"changeRequest",
|
||||
|
||||
@@ -412,6 +412,37 @@ export const companiesService = {
|
||||
return unwrap(response.data);
|
||||
},
|
||||
|
||||
/** The PoA delegation letter on file, with its review state. */
|
||||
getPoaDelegation: async (): Promise<LicenseFile[]> => {
|
||||
const response = await client.get<ApiResponse<LicenseFile[]>>(
|
||||
URL_CONSTANTS.COMPANIES_API.POA_DELEGATION,
|
||||
);
|
||||
return unwrap(response.data);
|
||||
},
|
||||
|
||||
/**
|
||||
* Upload the PoA delegation letter, replacing any existing one. On an approved
|
||||
* company the upload is staged for backoffice review; during onboarding it
|
||||
* goes live immediately.
|
||||
*/
|
||||
uploadPoaDelegation: async (file: File): Promise<LicenseFile[]> => {
|
||||
const formData = new FormData();
|
||||
formData.append("poa_delegation_letter", file);
|
||||
const response = await client.post<ApiResponse<LicenseFile[]>>(
|
||||
URL_CONSTANTS.COMPANIES_API.POA_DELEGATION,
|
||||
formData,
|
||||
);
|
||||
return unwrap(response.data);
|
||||
},
|
||||
|
||||
/** Remove the PoA delegation letter (staged for review on an approved company). */
|
||||
removePoaDelegation: async (fileId: string): Promise<LicenseFile[]> => {
|
||||
const response = await client.delete<ApiResponse<LicenseFile[]>>(
|
||||
URL_CONSTANTS.COMPANIES_API.POA_DELEGATION_FILE(fileId),
|
||||
);
|
||||
return unwrap(response.data);
|
||||
},
|
||||
|
||||
/** List business-license document(s) (with review state) for a company profile. */
|
||||
getProfileLicense: async (profileId: string): Promise<LicenseFile[]> => {
|
||||
const response = await client.get<ApiResponse<LicenseFile[]>>(
|
||||
|
||||
Reference in New Issue
Block a user