feat(uat-batch-6): external-EOI structured signatories + X/Y signed counter

Replace the freetext CSV signer-names field with a structured recipient
editor (name / email / role per row). Service now persists each
non-CC signatory as a `document_signers` row pre-stamped
`status='signed'` so the document-detail "X / Y signed" badge counts
correctly for manually-uploaded EOIs.

- ExternalEoiInput gains a structured `signatories` field; legacy
  `signerNames` retained for back-compat. Role enum:
  `client | developer | rep | witness | cc`.
- uploadExternallySignedEoi inserts `document_signers` rows for every
  non-CC entry inside the existing transaction.
- documentEvents.completed event records both shapes for full audit
  fidelity.
- POST /api/v1/interests/[id]/external-eoi parses the `signatories`
  JSON multipart field defensively; malformed payloads fall back to
  signerNames.
- Dialog UI: per-row Name / Email / Role inputs with add / remove.
  Seeds from interest's clientName + clientPrimaryEmail via a
  signatoriesOverride/null pattern (React-Compiler safe — no
  setState-in-effect).

tsc clean. 1419/1419 vitest pass.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-05-21 17:34:59 +02:00
parent 7cdfed27fa
commit 301375a3c3
3 changed files with 217 additions and 22 deletions

View File

@@ -2,7 +2,7 @@
import { useMemo, useState } from 'react';
import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
import { Loader2, Upload } from 'lucide-react';
import { Loader2, Plus, Trash2, Upload } from 'lucide-react';
import { toast } from 'sonner';
import { Button } from '@/components/ui/button';
@@ -10,10 +10,33 @@ import { DatePicker } from '@/components/ui/date-picker';
import { FileInputButton } from '@/components/ui/file-input-button';
import { Input } from '@/components/ui/input';
import { Label } from '@/components/ui/label';
import {
Select,
SelectContent,
SelectItem,
SelectTrigger,
SelectValue,
} from '@/components/ui/select';
import { Textarea } from '@/components/ui/textarea';
import { apiFetch } from '@/lib/api/client';
import { toastError } from '@/lib/api/toast-error';
import { formatBerthRange } from '@/lib/templates/berth-range';
type SignatoryRole = 'client' | 'developer' | 'rep' | 'witness' | 'cc';
interface SignatoryRow {
name: string;
email: string;
role: SignatoryRole;
}
const ROLE_LABELS: Record<SignatoryRole, string> = {
client: 'Client',
developer: 'Developer',
rep: 'Rep',
witness: 'Witness',
cc: 'CC (no signing)',
};
import {
Dialog,
DialogContent,
@@ -35,21 +58,45 @@ export function ExternalEoiUploadDialog({ open, onOpenChange, interestId, onSucc
const [file, setFile] = useState<File | null>(null);
const [title, setTitle] = useState('');
const [signedAt, setSignedAt] = useState(() => new Date().toISOString().slice(0, 10));
const [signerNames, setSignerNames] = useState('');
// `null` means "rep hasn't touched the list yet — show the
// derived-from-interest seed". Once edited (add/remove/change),
// the explicit array takes over. Avoids a setState-in-effect that
// the React Compiler bans.
const [signatoriesOverride, setSignatoriesOverride] = useState<SignatoryRow[] | null>(null);
const [notes, setNotes] = useState('');
// Fetched on open to power the default title:
// "External EOI — <Client> — <berth range> — YYYY-MM-DD". Without
// this the file lands as just "External EOI - <date>" which is
// unscannable in any list when a port has multiple deals closing on
// the same day.
const { data: interestData } = useQuery<{ data: { clientName: string | null } }>({
// the same day. Also drives auto-fill on signatory rows tagged
// role=client.
const { data: interestData } = useQuery<{
data: { clientName: string | null; clientPrimaryEmail: string | null };
}>({
queryKey: ['interests', interestId],
queryFn: () =>
apiFetch<{ data: { clientName: string | null } }>(`/api/v1/interests/${interestId}`),
apiFetch<{ data: { clientName: string | null; clientPrimaryEmail: string | null } }>(
`/api/v1/interests/${interestId}`,
),
enabled: open,
staleTime: 60_000,
});
// Compute the effective signatory list — when the rep hasn't touched
// anything, seed from the interest's client. Once they edit, the
// explicit override takes over.
const signatories: SignatoryRow[] = useMemo(() => {
if (signatoriesOverride !== null) return signatoriesOverride;
if (!interestData?.data) return [];
return [
{
name: interestData.data.clientName ?? '',
email: interestData.data.clientPrimaryEmail ?? '',
role: 'client' as const,
},
];
}, [signatoriesOverride, interestData]);
const { data: berthsData } = useQuery<{ data: Array<{ mooringNumber: string | null }> }>({
queryKey: ['interests', interestId, 'berths'],
queryFn: () =>
@@ -82,7 +129,14 @@ export function ExternalEoiUploadDialog({ open, onOpenChange, interestId, onSucc
const effectiveTitle = title.trim() || defaultTitle;
if (effectiveTitle) form.append('title', effectiveTitle);
if (signedAt) form.append('signedAt', signedAt);
if (signerNames) form.append('signerNames', signerNames);
const cleanSignatories = signatories
.map((s) => ({ name: s.name.trim(), email: s.email.trim(), role: s.role }))
.filter((s) => s.name && s.email);
if (cleanSignatories.length > 0) {
form.append('signatories', JSON.stringify(cleanSignatories));
// Back-compat for any consumer that still reads signerNames.
form.append('signerNames', cleanSignatories.map((s) => s.name).join(', '));
}
if (notes) form.append('notes', notes);
const res = await fetch(`/api/v1/interests/${interestId}/external-eoi`, {
method: 'POST',
@@ -109,7 +163,7 @@ export function ExternalEoiUploadDialog({ open, onOpenChange, interestId, onSucc
qc.invalidateQueries({ queryKey: ['documents'] });
setFile(null);
setTitle('');
setSignerNames('');
setSignatoriesOverride(null);
setNotes('');
onOpenChange(false);
onSuccess?.();
@@ -160,16 +214,86 @@ export function ExternalEoiUploadDialog({ open, onOpenChange, interestId, onSucc
<DatePicker value={signedAt} onChange={setSignedAt} toDate={new Date()} />
</div>
</div>
<div>
<Label>Signer names (comma-separated)</Label>
<Input
value={signerNames}
onChange={(e) => setSignerNames(e.target.value)}
placeholder="e.g. John Smith, Marina Director"
className="mt-1"
/>
<p className="text-xs text-muted-foreground mt-1">
Recorded in the audit trail alongside the document.
<div className="space-y-2">
<Label>Signatories</Label>
<div className="space-y-2">
{signatories.map((s, i) => (
<div key={i} className="flex gap-2 items-center">
<Input
placeholder="Name"
value={s.name}
onChange={(e) =>
setSignatoriesOverride(
signatories.map((row, idx) =>
idx === i ? { ...row, name: e.target.value } : row,
),
)
}
className="flex-1 min-w-0"
/>
<Input
type="email"
placeholder="email@example.com"
value={s.email}
onChange={(e) =>
setSignatoriesOverride(
signatories.map((row, idx) =>
idx === i ? { ...row, email: e.target.value } : row,
),
)
}
className="flex-[2] min-w-0"
/>
<Select
value={s.role}
onValueChange={(v) =>
setSignatoriesOverride(
signatories.map((row, idx) =>
idx === i ? { ...row, role: v as SignatoryRole } : row,
),
)
}
>
<SelectTrigger className="w-36 shrink-0">
<SelectValue />
</SelectTrigger>
<SelectContent>
{(Object.keys(ROLE_LABELS) as SignatoryRole[]).map((r) => (
<SelectItem key={r} value={r}>
{ROLE_LABELS[r]}
</SelectItem>
))}
</SelectContent>
</Select>
<Button
type="button"
variant="ghost"
size="icon"
onClick={() =>
setSignatoriesOverride(signatories.filter((_, idx) => idx !== i))
}
aria-label="Remove signatory"
className="shrink-0"
>
<Trash2 className="size-4" aria-hidden />
</Button>
</div>
))}
</div>
<Button
type="button"
variant="outline"
size="sm"
onClick={() =>
setSignatoriesOverride([...signatories, { name: '', email: '', role: 'client' }])
}
>
<Plus className="size-4 mr-1.5" aria-hidden />
Add signatory
</Button>
<p className="text-xs text-muted-foreground">
Recorded against the document for the audit trail and the signed-count badge. CC
recipients aren&apos;t counted as signatories.
</p>
</div>
<div>