Implement admin ports and system settings management

- Port CRUD: list, create, update with branding, currency, timezone
- System settings: upsert key-value pairs per port with known settings UI
  (AI feature flags, invoice discount, pipeline weights, berth rules)
- Settings manager with toggle switches, number inputs, and JSON editors
- Replace both stub pages with real implementations

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-04-08 15:53:33 -04:00
parent f60159e91a
commit c8320023cc
12 changed files with 1096 additions and 28 deletions

View File

@@ -0,0 +1,209 @@
'use client';
import { useState, useEffect } from 'react';
import { Button } from '@/components/ui/button';
import { Input } from '@/components/ui/input';
import { Label } from '@/components/ui/label';
import { Switch } from '@/components/ui/switch';
import { Sheet, SheetContent, SheetHeader, SheetTitle, SheetFooter } from '@/components/ui/sheet';
import { apiFetch } from '@/lib/api/client';
interface PortFormProps {
open: boolean;
onOpenChange: (open: boolean) => void;
port?: {
id: string;
name: string;
slug: string;
logoUrl: string | null;
primaryColor: string | null;
defaultCurrency: string;
timezone: string;
isActive: boolean;
} | null;
onSuccess: () => void;
}
export function PortForm({ open, onOpenChange, port, onSuccess }: PortFormProps) {
const [name, setName] = useState('');
const [slug, setSlug] = useState('');
const [primaryColor, setPrimaryColor] = useState('#0F4C81');
const [defaultCurrency, setDefaultCurrency] = useState('USD');
const [timezone, setTimezone] = useState('America/Anguilla');
const [isActive, setIsActive] = useState(true);
const [loading, setLoading] = useState(false);
const [error, setError] = useState<string | null>(null);
const isEdit = !!port;
useEffect(() => {
if (open) {
if (port) {
setName(port.name);
setSlug(port.slug);
setPrimaryColor(port.primaryColor ?? '#0F4C81');
setDefaultCurrency(port.defaultCurrency);
setTimezone(port.timezone);
setIsActive(port.isActive);
} else {
setName('');
setSlug('');
setPrimaryColor('#0F4C81');
setDefaultCurrency('USD');
setTimezone('America/Anguilla');
setIsActive(true);
}
setError(null);
}
}, [open, port]);
function handleNameChange(value: string) {
setName(value);
if (!isEdit) {
setSlug(
value
.toLowerCase()
.replace(/[^a-z0-9]+/g, '-')
.replace(/^-|-$/g, ''),
);
}
}
async function handleSubmit(e: React.FormEvent) {
e.preventDefault();
setError(null);
setLoading(true);
try {
if (isEdit) {
await apiFetch(`/api/v1/admin/ports/${port.id}`, {
method: 'PATCH',
body: { name, slug, primaryColor, defaultCurrency, timezone, isActive },
});
} else {
await apiFetch('/api/v1/admin/ports', {
method: 'POST',
body: { name, slug, primaryColor, defaultCurrency, timezone },
});
}
onSuccess();
onOpenChange(false);
} catch (err: unknown) {
const message = err instanceof Error ? err.message : 'Something went wrong';
setError(message);
} finally {
setLoading(false);
}
}
return (
<Sheet open={open} onOpenChange={onOpenChange}>
<SheetContent className="overflow-y-auto">
<SheetHeader>
<SheetTitle>{isEdit ? 'Edit Port' : 'New Port'}</SheetTitle>
</SheetHeader>
<form onSubmit={handleSubmit} className="mt-6 space-y-4">
<div className="space-y-2">
<Label htmlFor="port-name">Name</Label>
<Input
id="port-name"
value={name}
onChange={(e) => handleNameChange(e.target.value)}
placeholder="Port Nimara"
required
/>
</div>
<div className="space-y-2">
<Label htmlFor="port-slug">Slug</Label>
<Input
id="port-slug"
value={slug}
onChange={(e) => setSlug(e.target.value)}
placeholder="port-nimara"
pattern="^[a-z0-9-]+$"
required
/>
<p className="text-xs text-muted-foreground">
Used in URLs. Lowercase letters, numbers, and hyphens only.
</p>
</div>
<div className="space-y-2">
<Label htmlFor="port-color">Brand Color</Label>
<div className="flex items-center gap-2">
<input
type="color"
id="port-color"
value={primaryColor}
onChange={(e) => setPrimaryColor(e.target.value)}
className="h-9 w-9 rounded border cursor-pointer"
/>
<Input
value={primaryColor}
onChange={(e) => setPrimaryColor(e.target.value)}
placeholder="#0F4C81"
className="w-28 font-mono text-sm"
maxLength={7}
/>
</div>
</div>
<div className="grid grid-cols-2 gap-4">
<div className="space-y-2">
<Label htmlFor="port-currency">Currency</Label>
<Input
id="port-currency"
value={defaultCurrency}
onChange={(e) => setDefaultCurrency(e.target.value.toUpperCase())}
placeholder="USD"
maxLength={3}
required
/>
</div>
<div className="space-y-2">
<Label htmlFor="port-timezone">Timezone</Label>
<Input
id="port-timezone"
value={timezone}
onChange={(e) => setTimezone(e.target.value)}
placeholder="America/Anguilla"
required
/>
</div>
</div>
{isEdit && (
<div className="flex items-center justify-between rounded-lg border p-3">
<div>
<Label htmlFor="port-active">Port Active</Label>
<p className="text-xs text-muted-foreground">
Inactive ports are hidden from users
</p>
</div>
<Switch id="port-active" checked={isActive} onCheckedChange={setIsActive} />
</div>
)}
{error && <p className="text-sm text-destructive">{error}</p>}
<SheetFooter>
<Button
type="button"
variant="outline"
onClick={() => onOpenChange(false)}
disabled={loading}
>
Cancel
</Button>
<Button type="submit" disabled={loading || !name.trim() || !slug.trim()}>
{loading ? 'Saving...' : isEdit ? 'Save Changes' : 'Create Port'}
</Button>
</SheetFooter>
</form>
</SheetContent>
</Sheet>
);
}

View File

@@ -0,0 +1,147 @@
'use client';
import { useState, useEffect, useCallback } from 'react';
import { type ColumnDef } from '@tanstack/react-table';
import { Pencil, Plus } from 'lucide-react';
import { DataTable } from '@/components/shared/data-table';
import { PageHeader } from '@/components/shared/page-header';
import { Button } from '@/components/ui/button';
import { Badge } from '@/components/ui/badge';
import { apiFetch } from '@/lib/api/client';
import { PortForm } from './port-form';
interface PortRow {
id: string;
name: string;
slug: string;
logoUrl: string | null;
primaryColor: string | null;
defaultCurrency: string;
timezone: string;
isActive: boolean;
settings: Record<string, unknown>;
createdAt: string;
}
export function PortList() {
const [ports, setPorts] = useState<PortRow[]>([]);
const [loading, setLoading] = useState(true);
const [formOpen, setFormOpen] = useState(false);
const [editingPort, setEditingPort] = useState<PortRow | null>(null);
const fetchPorts = useCallback(async () => {
setLoading(true);
try {
const res = await apiFetch<{ data: PortRow[] }>('/api/v1/admin/ports');
setPorts(res.data);
} finally {
setLoading(false);
}
}, []);
useEffect(() => {
void fetchPorts();
}, [fetchPorts]);
function handleNewPort() {
setEditingPort(null);
setFormOpen(true);
}
function handleEditPort(port: PortRow) {
setEditingPort(port);
setFormOpen(true);
}
const columns: ColumnDef<PortRow, unknown>[] = [
{
accessorKey: 'name',
header: 'Name',
cell: ({ row }) => (
<div className="flex items-center gap-2">
{row.original.primaryColor && (
<span
className="inline-block h-3 w-3 rounded-full"
style={{ backgroundColor: row.original.primaryColor }}
/>
)}
<span className="font-medium">{row.original.name}</span>
</div>
),
},
{
accessorKey: 'slug',
header: 'Slug',
cell: ({ row }) => (
<code className="text-xs bg-muted px-1.5 py-0.5 rounded">{row.original.slug}</code>
),
},
{
accessorKey: 'defaultCurrency',
header: 'Currency',
},
{
accessorKey: 'timezone',
header: 'Timezone',
},
{
accessorKey: 'isActive',
header: 'Status',
cell: ({ row }) =>
row.original.isActive ? (
<Badge variant="default" className="bg-green-600">
Active
</Badge>
) : (
<Badge variant="destructive">Inactive</Badge>
),
},
{
id: 'actions',
header: '',
cell: ({ row }) => (
<Button variant="ghost" size="sm" onClick={() => handleEditPort(row.original)}>
<Pencil className="h-4 w-4" />
<span className="sr-only">Edit</span>
</Button>
),
enableSorting: false,
size: 60,
},
];
return (
<div>
<PageHeader
title="Port Management"
description="Manage marina ports and their configuration"
actions={
<Button onClick={handleNewPort}>
<Plus className="mr-1.5 h-4 w-4" />
New Port
</Button>
}
/>
<DataTable
columns={columns}
data={ports}
isLoading={loading}
getRowId={(row) => row.id}
emptyState={
<div className="text-center py-8">
<p className="text-muted-foreground">No ports configured.</p>
</div>
}
/>
<PortForm
open={formOpen}
onOpenChange={setFormOpen}
port={editingPort}
onSuccess={fetchPorts}
/>
</div>
);
}

View File

@@ -0,0 +1,340 @@
'use client';
import { useState, useEffect, useCallback } from 'react';
import { Trash2, Plus, Save } from 'lucide-react';
import { PageHeader } from '@/components/shared/page-header';
import { ConfirmationDialog } from '@/components/shared/confirmation-dialog';
import { Button } from '@/components/ui/button';
import { Input } from '@/components/ui/input';
import { Label } from '@/components/ui/label';
import { Switch } from '@/components/ui/switch';
import { Textarea } from '@/components/ui/textarea';
import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/components/ui/card';
import { Separator } from '@/components/ui/separator';
import { apiFetch } from '@/lib/api/client';
interface Setting {
key: string;
value: unknown;
portId: string | null;
updatedBy: string | null;
updatedAt: string;
}
/** Well-known settings with their display metadata */
const KNOWN_SETTINGS: Array<{
key: string;
label: string;
description: string;
type: 'boolean' | 'number' | 'json';
defaultValue: unknown;
}> = [
{
key: 'ai_interest_scoring',
label: 'AI Interest Scoring',
description: 'Enable AI-powered interest scoring based on engagement signals',
type: 'boolean',
defaultValue: false,
},
{
key: 'ai_email_drafts',
label: 'AI Email Drafts',
description: 'Enable AI-assisted email draft generation',
type: 'boolean',
defaultValue: false,
},
{
key: 'invoice_net10_discount',
label: 'Net-10 Invoice Discount (%)',
description: 'Discount percentage applied when payment terms are net-10',
type: 'number',
defaultValue: 2,
},
{
key: 'pipeline_weights',
label: 'Pipeline Stage Weights',
description: 'Probability weights for revenue forecast by pipeline stage (JSON)',
type: 'json',
defaultValue: {
open: 0.05,
details_sent: 0.1,
in_communication: 0.2,
signed_eoi_nda: 0.4,
deposit_10pct: 0.6,
contract: 0.8,
completed: 1.0,
},
},
{
key: 'berth_rules',
label: 'Berth Status Rules',
description: 'Auto/suggest/off rules for berth status transitions (JSON)',
type: 'json',
defaultValue: [],
},
];
export function SettingsManager() {
const [portSettings, setPortSettings] = useState<Setting[]>([]);
const [loading, setLoading] = useState(true);
const [saving, setSaving] = useState<string | null>(null);
const [values, setValues] = useState<Record<string, unknown>>({});
const [customKey, setCustomKey] = useState('');
const [customValue, setCustomValue] = useState('');
const fetchSettings = useCallback(async () => {
setLoading(true);
try {
const res = await apiFetch<{ data: { portSettings: Setting[]; globalSettings: Setting[] } }>(
'/api/v1/admin/settings',
);
setPortSettings(res.data.portSettings);
// Build values map from existing settings
const vals: Record<string, unknown> = {};
for (const s of res.data.portSettings) {
vals[s.key] = s.value;
}
setValues(vals);
} finally {
setLoading(false);
}
}, []);
useEffect(() => {
void fetchSettings();
}, [fetchSettings]);
async function saveSetting(key: string, value: unknown) {
setSaving(key);
try {
await apiFetch('/api/v1/admin/settings', {
method: 'PUT',
body: { key, value },
});
await fetchSettings();
} finally {
setSaving(null);
}
}
async function handleDeleteSetting(key: string) {
await apiFetch('/api/v1/admin/settings', {
method: 'DELETE',
body: { key },
});
await fetchSettings();
}
async function handleAddCustom() {
if (!customKey.trim()) return;
let parsed: unknown;
try {
parsed = JSON.parse(customValue);
} catch {
parsed = customValue;
}
await saveSetting(customKey, parsed);
setCustomKey('');
setCustomValue('');
}
function getEffectiveValue(key: string, defaultValue: unknown): unknown {
return values[key] ?? defaultValue;
}
if (loading) {
return (
<div>
<PageHeader title="System Settings" description="Configure system behavior for this port" />
<div className="flex items-center justify-center py-12 text-muted-foreground">
Loading...
</div>
</div>
);
}
// Custom settings = port settings that aren't in KNOWN_SETTINGS
const knownKeys = new Set(KNOWN_SETTINGS.map((s) => s.key));
const customSettings = portSettings.filter((s) => !knownKeys.has(s.key));
return (
<div>
<PageHeader title="System Settings" description="Configure system behavior for this port" />
<div className="space-y-6 mt-6">
{/* Feature Flags */}
<Card>
<CardHeader>
<CardTitle>Feature Flags</CardTitle>
<CardDescription>Enable or disable optional features</CardDescription>
</CardHeader>
<CardContent className="space-y-4">
{KNOWN_SETTINGS.filter((s) => s.type === 'boolean').map((setting) => (
<div key={setting.key} className="flex items-center justify-between">
<div>
<Label>{setting.label}</Label>
<p className="text-xs text-muted-foreground">{setting.description}</p>
</div>
<Switch
checked={getEffectiveValue(setting.key, setting.defaultValue) === true}
disabled={saving === setting.key}
onCheckedChange={(checked) => saveSetting(setting.key, checked)}
/>
</div>
))}
</CardContent>
</Card>
{/* Numeric Settings */}
<Card>
<CardHeader>
<CardTitle>Business Rules</CardTitle>
<CardDescription>Configure financial and operational parameters</CardDescription>
</CardHeader>
<CardContent className="space-y-4">
{KNOWN_SETTINGS.filter((s) => s.type === 'number').map((setting) => (
<div key={setting.key} className="flex items-center justify-between gap-4">
<div className="flex-1">
<Label>{setting.label}</Label>
<p className="text-xs text-muted-foreground">{setting.description}</p>
</div>
<div className="flex items-center gap-2">
<Input
type="number"
className="w-24"
value={String(getEffectiveValue(setting.key, setting.defaultValue) ?? '')}
onChange={(e) =>
setValues((prev) => ({
...prev,
[setting.key]: parseFloat(e.target.value) || 0,
}))
}
/>
<Button
size="sm"
variant="outline"
disabled={saving === setting.key}
onClick={() =>
saveSetting(setting.key, values[setting.key] ?? setting.defaultValue)
}
>
<Save className="h-3.5 w-3.5" />
</Button>
</div>
</div>
))}
</CardContent>
</Card>
{/* JSON Settings */}
<Card>
<CardHeader>
<CardTitle>Advanced Configuration</CardTitle>
<CardDescription>
JSON-based settings for pipeline weights and berth rules
</CardDescription>
</CardHeader>
<CardContent className="space-y-6">
{KNOWN_SETTINGS.filter((s) => s.type === 'json').map((setting) => {
const currentValue = getEffectiveValue(setting.key, setting.defaultValue);
const jsonStr =
values[`${setting.key}_edit`] !== undefined
? String(values[`${setting.key}_edit`])
: JSON.stringify(currentValue, null, 2);
return (
<div key={setting.key} className="space-y-2">
<Label>{setting.label}</Label>
<p className="text-xs text-muted-foreground">{setting.description}</p>
<Textarea
className="font-mono text-xs"
rows={6}
value={jsonStr}
onChange={(e) =>
setValues((prev) => ({ ...prev, [`${setting.key}_edit`]: e.target.value }))
}
/>
<Button
size="sm"
disabled={saving === setting.key}
onClick={() => {
try {
const parsed = JSON.parse(
String(values[`${setting.key}_edit`] ?? JSON.stringify(currentValue)),
);
void saveSetting(setting.key, parsed);
} catch {
// invalid JSON — do nothing
}
}}
>
{saving === setting.key ? 'Saving...' : 'Save'}
</Button>
</div>
);
})}
</CardContent>
</Card>
{/* Custom Settings */}
<Card>
<CardHeader>
<CardTitle>Custom Settings</CardTitle>
<CardDescription>Additional key-value settings for this port</CardDescription>
</CardHeader>
<CardContent className="space-y-4">
{customSettings.map((setting) => (
<div key={setting.key} className="flex items-center justify-between gap-2">
<div>
<code className="text-sm font-mono">{setting.key}</code>
<p className="text-xs text-muted-foreground">
{typeof setting.value === 'object'
? JSON.stringify(setting.value)
: String(setting.value)}
</p>
</div>
<ConfirmationDialog
trigger={
<Button
variant="ghost"
size="sm"
className="text-destructive hover:text-destructive"
>
<Trash2 className="h-4 w-4" />
</Button>
}
title="Delete Setting"
description={`Delete "${setting.key}"? This may affect system behavior.`}
confirmLabel="Delete"
onConfirm={() => handleDeleteSetting(setting.key)}
/>
</div>
))}
<Separator />
<div className="flex gap-2">
<Input
placeholder="Key"
value={customKey}
onChange={(e) => setCustomKey(e.target.value)}
className="w-40"
/>
<Input
placeholder="Value (JSON or string)"
value={customValue}
onChange={(e) => setCustomValue(e.target.value)}
className="flex-1"
/>
<Button variant="outline" onClick={handleAddCustom} disabled={!customKey.trim()}>
<Plus className="mr-1 h-4 w-4" />
Add
</Button>
</div>
</CardContent>
</Card>
</div>
</div>
);
}