Files
pn-new-crm/src/components/documents/documents-hub.tsx

325 lines
11 KiB
TypeScript
Raw Normal View History

'use client';
import { useMemo, useState } from 'react';
import Link from 'next/link';
import { ChevronDown, ChevronRight, FileText, Plus } from 'lucide-react';
import { Button } from '@/components/ui/button';
import { Input } from '@/components/ui/input';
import { cn } from '@/lib/utils';
import { StatusPill, type StatusPillStatus } from '@/components/ui/status-pill';
import { EmptyState } from '@/components/ui/empty-state';
import { PageHeader } from '@/components/shared/page-header';
import { PermissionGate } from '@/components/shared/permission-gate';
import { usePaginatedQuery } from '@/hooks/use-paginated-query';
import { useRealtimeInvalidation } from '@/hooks/use-realtime-invalidation';
import { useDocumentFolders, type FolderNode } from '@/hooks/use-document-folders';
import { FolderActionsMenu } from './folder-actions-menu';
import { FolderBreadcrumb } from './folder-breadcrumb';
import { FolderTreeSidebar } from './folder-tree-sidebar';
import { HubRootView } from './hub-root-view';
import { EntityFolderView } from './entity-folder-view';
interface HubDoc {
id: string;
documentType: string;
title: string;
status: string;
createdAt: string;
signers?: Array<{ id: string; signerEmail: string; signerName: string; status: string }>;
}
const TYPE_LABELS: Record<string, string> = {
eoi: 'EOI',
contract: 'Contract',
nda: 'NDA',
reservation_agreement: 'Reservation Agreement',
welcome_letter: 'Welcome Letter',
handover_checklist: 'Handover',
acknowledgment: 'Acknowledgment',
correspondence: 'Correspondence',
other: 'Other',
};
const STATUS_PILL_MAP: Record<string, StatusPillStatus> = {
draft: 'draft',
sent: 'sent',
partially_signed: 'partial',
completed: 'completed',
signed: 'signed',
expired: 'expired',
cancelled: 'cancelled',
rejected: 'rejected',
};
fix(ui): humanize enum labels, format dates, resolve actor names, loading skeleton - Documents hub signer status now renders via a label map (`Pending`, `Signed`, `Declined`, …) instead of the raw lowercase enum value. - Invoice detail formats `dueDate` and `paymentDate` as `MMM d, yyyy` via `date-fns` instead of leaking raw `2025-03-14` ISO strings, and swaps the "Payment Method" free-text input for a `Select` of labelled options (`Bank transfer`, `Credit card`, …) so we never store `bank_transfer` from a hand-typed field again. - Interest tabs `MilestoneSection` status badge uses a `humanizeStatus` helper so values like `waiting_for_signatures` show as `Waiting For Signatures` (correctly title-cased) instead of being a lower-snake-case fragment inside an ALL-CAPS pill. - `OUTCOME_BADGE` in the interest header now has a fall-through that renders any unknown outcome as a closed-state badge, preventing a closed interest from looking open just because its enum was added upstream without a matching label entry. - Interest timeline route joins the `user` table and returns `userName` alongside `userId`; the client renders the resolved name instead of a 36-char UUID. Falls back to `'a teammate'` if the user row was deleted. - Invoice "New / Step 3 — Review" replaces the truncated UUID display with a server-resolved client/company name via a small `useQuery`, so users can confirm they picked the right billing entity before submitting. - New `loading.tsx` for client detail renders a header / tab strip / card skeleton during the server-component / initial-query window that previously flashed empty. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-02 23:01:35 +02:00
const SIGNER_STATUS_LABELS: Record<string, string> = {
pending: 'Pending',
sent: 'Sent',
signed: 'Signed',
declined: 'Declined',
expired: 'Expired',
cancelled: 'Cancelled',
};
interface DocumentsHubProps {
portSlug: string;
}
function findInTree(nodes: FolderNode[], id: string): FolderNode | null {
for (const n of nodes) {
if (n.id === id) return n;
const found = findInTree(n.children, id);
if (found) return found;
}
return null;
}
export function DocumentsHub({ portSlug }: DocumentsHubProps) {
// undefined = "All documents" (no folder selected / hub root)
// null = root folder only
// string = specific folder id
const [selectedFolderId, setSelectedFolderId] = useState<string | null | undefined>(undefined);
const { data: tree = [] } = useDocumentFolders();
const selectedFolder =
typeof selectedFolderId === 'string' ? findInTree(tree, selectedFolderId) : null;
const isEntityFolder =
selectedFolder?.systemManaged === true &&
selectedFolder.entityType != null &&
selectedFolder.entityType !== 'root' &&
selectedFolder.entityId != null;
const handleFolderSelect = (id: string | null | undefined) => {
setSelectedFolderId(id);
};
return (
<div className="flex flex-col sm:flex-row h-full">
<FolderTreeSidebar
selectedFolderId={selectedFolderId}
onSelect={handleFolderSelect}
footer={
<PermissionGate resource="documents" action="manage_folders">
<FolderActionsMenu
selectedFolderId={selectedFolderId}
onAfterDelete={() => handleFolderSelect(undefined)}
/>
</PermissionGate>
}
/>
<div className="flex-1 min-w-0 p-4 space-y-4">
<FolderBreadcrumb selectedFolderId={selectedFolderId} onSelect={handleFolderSelect} />
<PageHeader
title="Documents"
description="Track signing status, chase pending signers, and audit completion."
actions={
<Button asChild>
<Link href={`/${portSlug}/documents/new`}>
<Plus className="mr-1.5 h-4 w-4" />
New document
</Link>
</Button>
}
variant="gradient"
/>
{selectedFolderId === undefined ? (
<HubRootView portSlug={portSlug} />
) : isEntityFolder ? (
<EntityFolderView
portSlug={portSlug}
entityType={selectedFolder!.entityType as 'client' | 'company' | 'yacht'}
entityId={selectedFolder!.entityId!}
/>
) : (
<FlatFolderListing key={selectedFolderId ?? 'root'} portSlug={portSlug} folderId={selectedFolderId} />
)}
</div>
</div>
);
}
// ---------------------------------------------------------------------------
// FlatFolderListing — the original search + type-chip + document rows panel,
// now scoped to a specific folder (or null for root-only).
// ---------------------------------------------------------------------------
interface FlatFolderListingProps {
portSlug: string;
folderId: string | null;
}
function FlatFolderListing({ portSlug, folderId }: FlatFolderListingProps) {
const [search, setSearch] = useState('');
const [typeFilter, setTypeFilter] = useState<string | undefined>(undefined);
const [expandedDocId, setExpandedDocId] = useState<string | null>(null);
const queryParams = useMemo(() => {
const params = new URLSearchParams();
if (search) params.set('search', search);
if (typeFilter) params.set('documentType', typeFilter);
// folderId null = root, string = specific folder
params.set('folderId', folderId ?? '');
return params;
}, [search, typeFilter, folderId]);
const { data: documents, isLoading } = usePaginatedQuery<HubDoc>({
queryKey: ['documents', 'hub', 'folder', queryParams.toString()],
endpoint: `/api/v1/documents?${queryParams.toString()}`,
filterDefinitions: [],
});
useRealtimeInvalidation({
'document:created': [['documents']],
'document:updated': [['documents']],
'document:deleted': [['documents']],
'document:sent': [['documents']],
'document:completed': [['documents']],
'document:expired': [['documents']],
'document:cancelled': [['documents']],
'document:rejected': [['documents']],
'document:signer:signed': [['documents']],
});
const renderRow = (doc: HubDoc) => {
const expanded = expandedDocId === doc.id;
const totalSigners = doc.signers?.length ?? 0;
const signedCount = doc.signers?.filter((s) => s.status === 'signed').length ?? 0;
const pillStatus = STATUS_PILL_MAP[doc.status] ?? 'pending';
const isNonSignature = [
'welcome_letter',
'handover_checklist',
'acknowledgment',
'correspondence',
].includes(doc.documentType);
return (
<li
key={doc.id}
className="border-b last:border-b-0 transition-colors hover:bg-gradient-brand-soft/40"
>
<div className="flex flex-wrap items-center gap-x-3 gap-y-1 px-4 py-3 text-sm sm:grid sm:grid-cols-[auto_1fr_auto_auto_auto_auto] sm:gap-3">
<button
type="button"
aria-label={expanded ? 'Collapse signers' : 'Expand signers'}
onClick={() => setExpandedDocId(expanded ? null : doc.id)}
className="text-muted-foreground transition-transform"
>
{expanded ? <ChevronDown className="h-4 w-4" /> : <ChevronRight className="h-4 w-4" />}
</button>
<Link
href={`/${portSlug}/documents/${doc.id}`}
className="min-w-0 truncate font-medium text-foreground hover:text-brand"
>
{doc.title}
</Link>
<span className="text-xs text-muted-foreground">
{TYPE_LABELS[doc.documentType] ?? doc.documentType}
</span>
<StatusPill
status={isNonSignature && doc.status === 'sent' ? 'delivered' : pillStatus}
withDot
>
{isNonSignature && doc.status === 'sent' ? 'Delivered' : doc.status.replace(/_/g, ' ')}
</StatusPill>
<span className="text-xs tabular-nums text-muted-foreground">
{totalSigners > 0 ? `${signedCount}/${totalSigners} signed` : '-'}
</span>
<span className="text-xs text-muted-foreground">
{new Date(doc.createdAt).toLocaleDateString('en-GB')}
</span>
</div>
{expanded && doc.signers && doc.signers.length > 0 ? (
<div className="border-t bg-muted/30 px-12 py-2">
<ul className="space-y-1">
{doc.signers.map((signer) => (
<li key={signer.id} className="flex items-center justify-between gap-2 text-xs">
<div className="flex min-w-0 items-center gap-2">
<span className="font-medium text-foreground">{signer.signerName}</span>
<span className="truncate text-muted-foreground">{signer.signerEmail}</span>
</div>
<StatusPill status={STATUS_PILL_MAP[signer.status] ?? 'pending'}>
fix(ui): humanize enum labels, format dates, resolve actor names, loading skeleton - Documents hub signer status now renders via a label map (`Pending`, `Signed`, `Declined`, …) instead of the raw lowercase enum value. - Invoice detail formats `dueDate` and `paymentDate` as `MMM d, yyyy` via `date-fns` instead of leaking raw `2025-03-14` ISO strings, and swaps the "Payment Method" free-text input for a `Select` of labelled options (`Bank transfer`, `Credit card`, …) so we never store `bank_transfer` from a hand-typed field again. - Interest tabs `MilestoneSection` status badge uses a `humanizeStatus` helper so values like `waiting_for_signatures` show as `Waiting For Signatures` (correctly title-cased) instead of being a lower-snake-case fragment inside an ALL-CAPS pill. - `OUTCOME_BADGE` in the interest header now has a fall-through that renders any unknown outcome as a closed-state badge, preventing a closed interest from looking open just because its enum was added upstream without a matching label entry. - Interest timeline route joins the `user` table and returns `userName` alongside `userId`; the client renders the resolved name instead of a 36-char UUID. Falls back to `'a teammate'` if the user row was deleted. - Invoice "New / Step 3 — Review" replaces the truncated UUID display with a server-resolved client/company name via a small `useQuery`, so users can confirm they picked the right billing entity before submitting. - New `loading.tsx` for client detail renders a header / tab strip / card skeleton during the server-component / initial-query window that previously flashed empty. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-02 23:01:35 +02:00
{SIGNER_STATUS_LABELS[signer.status] ?? signer.status}
</StatusPill>
</li>
))}
</ul>
</div>
) : null}
</li>
);
};
return (
<>
<div className="flex flex-wrap items-center gap-2">
<Input
placeholder="Search by title..."
value={search}
onChange={(e) => setSearch(e.target.value)}
className="max-w-xs h-9"
/>
{(() => {
const seenTypes = Array.from(new Set(documents.map((d) => d.documentType))).sort();
if (seenTypes.length === 0) return null;
return (
<div className="flex flex-wrap gap-1.5">
<button
type="button"
className={cn(
'rounded-full border px-2.5 py-0.5 text-xs',
typeFilter === undefined ? 'bg-foreground text-background' : 'hover:bg-accent',
)}
onClick={() => setTypeFilter(undefined)}
>
All types
</button>
{seenTypes.map((t) => (
<button
type="button"
key={t}
className={cn(
'rounded-full border px-2.5 py-0.5 text-xs',
typeFilter === t ? 'bg-foreground text-background' : 'hover:bg-accent',
)}
onClick={() => setTypeFilter(t)}
>
{TYPE_LABELS[t] ?? t}
</button>
))}
</div>
);
})()}
</div>
{isLoading ? (
<ul className="rounded-md border bg-white">
{[0, 1, 2, 3, 4].map((i) => (
<li key={i} className="h-12 animate-pulse border-b last:border-b-0 bg-muted/40" />
))}
</ul>
) : documents.length === 0 ? (
<EmptyState
icon={<FileText className="h-7 w-7" />}
title="No documents in this folder"
body="Create a document or move existing ones here."
actions={
<Button asChild>
<Link href={`/${portSlug}/documents/new`}>
<Plus className="mr-1.5 h-4 w-4" />
New document
</Link>
</Button>
}
/>
) : (
<ul className="rounded-md border bg-white shadow-xs">{documents.map(renderRow)}</ul>
)}
</>
);
}