- Add QBO OAuth2 client with token refresh (lib/services/qbo-client.ts) - Add QBO sync service for invoices, payments, deposits, purchases, journal entries, reports (lib/services/qbo-sync-service.ts) - Add QBO types (lib/types/qbo.ts) - Add API routes: /api/qbo/auth, /api/qbo/sync, /api/qbo/disconnect - Add /admin/qbo status and sync management page - Add legal pages: /legal/eula, /legal/privacy (Intuit app assessment) - Add QBO nav link under Admin - Fix reports: remove invalid summarize_column_by, add accounting_method from Preferences API, add showrows=all&showcols=all - Add CashFlow report type alongside P&L and BalanceSheet - Add NoReportData check to skip empty report months - Add intuit_tid capture in error messages - Add redirect: follow for cluster routing - Migration 051: qbo_tokens, qbo_invoices, qbo_payments, qbo_deposits, qbo_transactions, qbo_reports tables Also includes earlier work: - Ping flap suppression pipeline step - Ticket digest reports with LLM analysis - Zabbix WAN monitor and gap analysis - Kiosk is_deleted filter fixes - Datto RMM ping target enrichment - Entity sync soft-delete detection
246 lines
9.1 KiB
TypeScript
246 lines
9.1 KiB
TypeScript
'use client';
|
|
|
|
import { useState, useEffect, useCallback, Suspense } from 'react';
|
|
import { useSearchParams } from 'next/navigation';
|
|
import { Button } from '@/components/ui/button';
|
|
import {
|
|
CheckCircle2, XCircle, AlertTriangle, RefreshCw, Loader2,
|
|
Link2, Link2Off, FileText, CreditCard, Building2, ArrowDownToLine, BarChart3,
|
|
} from 'lucide-react';
|
|
|
|
interface QboStatus {
|
|
tokenStatus: 'valid' | 'expired' | 'missing';
|
|
counts: {
|
|
invoices: number;
|
|
payments: number;
|
|
deposits: number;
|
|
transactions: number;
|
|
reports: number;
|
|
};
|
|
lastSync: {
|
|
invoices: string | null;
|
|
payments: string | null;
|
|
deposits: string | null;
|
|
transactions: string | null;
|
|
reports: string | null;
|
|
};
|
|
}
|
|
|
|
function fmtDate(d: string | null) {
|
|
if (!d) return 'Never';
|
|
const date = new Date(d);
|
|
const diff = Date.now() - date.getTime();
|
|
const mins = Math.floor(diff / 60000);
|
|
if (mins < 1) return 'Just now';
|
|
if (mins < 60) return `${mins}m ago`;
|
|
const hrs = Math.floor(mins / 60);
|
|
if (hrs < 24) return `${hrs}h ago`;
|
|
return `${Math.floor(hrs / 24)}d ago`;
|
|
}
|
|
|
|
function fmtNum(n: number) {
|
|
return n.toLocaleString();
|
|
}
|
|
|
|
const ENTITY_META = [
|
|
{ key: 'invoices', label: 'Invoices', icon: FileText, color: 'text-blue-400' },
|
|
{ key: 'payments', label: 'Payments', icon: CreditCard, color: 'text-green-400' },
|
|
{ key: 'deposits', label: 'Deposits', icon: Building2, color: 'text-purple-400' },
|
|
{ key: 'transactions', label: 'Transactions', icon: ArrowDownToLine, color: 'text-orange-400' },
|
|
{ key: 'reports', label: 'Reports', icon: BarChart3, color: 'text-cyan-400' },
|
|
] as const;
|
|
|
|
function QboPageInner() {
|
|
const searchParams = useSearchParams();
|
|
const connected = searchParams.get('connected');
|
|
const disconnected = searchParams.get('disconnected');
|
|
const errorParam = searchParams.get('error');
|
|
|
|
const [status, setStatus] = useState<QboStatus | null>(null);
|
|
const [loading, setLoading] = useState(true);
|
|
const [syncing, setSyncing] = useState(false);
|
|
const [syncMessage, setSyncMessage] = useState<string | null>(null);
|
|
const [banner, setBanner] = useState<{ type: 'success' | 'error' | 'info'; msg: string } | null>(null);
|
|
|
|
const fetchStatus = useCallback(async () => {
|
|
setLoading(true);
|
|
try {
|
|
const res = await fetch('/api/qbo/sync');
|
|
const data = await res.json();
|
|
setStatus(data);
|
|
} catch {
|
|
setStatus(null);
|
|
} finally {
|
|
setLoading(false);
|
|
}
|
|
}, []);
|
|
|
|
useEffect(() => {
|
|
fetchStatus();
|
|
}, [fetchStatus]);
|
|
|
|
useEffect(() => {
|
|
if (connected === 'true') setBanner({ type: 'success', msg: 'QuickBooks Online connected successfully.' });
|
|
else if (disconnected === 'true') setBanner({ type: 'info', msg: 'QuickBooks Online disconnected.' });
|
|
else if (errorParam) setBanner({ type: 'error', msg: decodeURIComponent(errorParam) });
|
|
}, [connected, disconnected, errorParam]);
|
|
|
|
async function triggerSync(syncType: 'full' | 'incremental') {
|
|
setSyncing(true);
|
|
setSyncMessage(null);
|
|
try {
|
|
const res = await fetch('/api/qbo/sync', {
|
|
method: 'POST',
|
|
headers: { 'Content-Type': 'application/json' },
|
|
body: JSON.stringify({ syncType, triggeredBy: 'admin-ui' }),
|
|
});
|
|
const data = await res.json();
|
|
if (res.ok) {
|
|
setSyncMessage(`${syncType === 'full' ? 'Full' : 'Incremental'} sync started. This may take a few minutes.`);
|
|
setTimeout(() => fetchStatus(), 10000);
|
|
setTimeout(() => fetchStatus(), 30000);
|
|
setTimeout(() => { fetchStatus(); setSyncing(false); }, 60000);
|
|
} else {
|
|
setSyncMessage(`Error: ${data.error}`);
|
|
setSyncing(false);
|
|
}
|
|
} catch (err) {
|
|
setSyncMessage(`Error: ${err instanceof Error ? err.message : String(err)}`);
|
|
setSyncing(false);
|
|
}
|
|
}
|
|
|
|
const tokenOk = status?.tokenStatus === 'valid';
|
|
const tokenBadge = {
|
|
valid: { icon: CheckCircle2, label: 'Connected', cls: 'text-green-400' },
|
|
expired: { icon: AlertTriangle, label: 'Token Expired', cls: 'text-yellow-400' },
|
|
missing: { icon: XCircle, label: 'Not Connected', cls: 'text-red-400' },
|
|
}[status?.tokenStatus ?? 'missing'];
|
|
|
|
return (
|
|
<div className="p-6 max-w-4xl mx-auto space-y-6">
|
|
{/* Header */}
|
|
<div className="flex items-center justify-between">
|
|
<div>
|
|
<h1 className="text-2xl font-bold">QuickBooks Online</h1>
|
|
<p className="text-muted-foreground text-sm mt-1">Sync invoices, payments, deposits, transactions and financial reports</p>
|
|
</div>
|
|
<Button variant="outline" size="sm" onClick={fetchStatus} disabled={loading}>
|
|
<RefreshCw className={`w-4 h-4 mr-2 ${loading ? 'animate-spin' : ''}`} />
|
|
Refresh
|
|
</Button>
|
|
</div>
|
|
|
|
{/* Banner */}
|
|
{banner && (
|
|
<div className={`flex items-center gap-3 px-4 py-3 rounded-lg border text-sm ${
|
|
banner.type === 'success' ? 'bg-green-500/10 border-green-500/30 text-green-300' :
|
|
banner.type === 'error' ? 'bg-red-500/10 border-red-500/30 text-red-300' :
|
|
'bg-blue-500/10 border-blue-500/30 text-blue-300'
|
|
}`}>
|
|
{banner.type === 'success' ? <CheckCircle2 className="w-4 h-4 shrink-0" /> :
|
|
banner.type === 'error' ? <XCircle className="w-4 h-4 shrink-0" /> :
|
|
<AlertTriangle className="w-4 h-4 shrink-0" />}
|
|
{banner.msg}
|
|
<button className="ml-auto opacity-60 hover:opacity-100" onClick={() => setBanner(null)}>✕</button>
|
|
</div>
|
|
)}
|
|
|
|
{/* Connection Status */}
|
|
<div className="rounded-xl border bg-card p-5 space-y-4">
|
|
<div className="flex items-center justify-between">
|
|
<h2 className="font-semibold text-base">Connection Status</h2>
|
|
{loading ? (
|
|
<Loader2 className="w-4 h-4 animate-spin text-muted-foreground" />
|
|
) : (
|
|
<div className={`flex items-center gap-1.5 text-sm font-medium ${tokenBadge.cls}`}>
|
|
<tokenBadge.icon className="w-4 h-4" />
|
|
{tokenBadge.label}
|
|
</div>
|
|
)}
|
|
</div>
|
|
|
|
<div className="flex gap-3 flex-wrap">
|
|
<a href="/api/qbo/auth">
|
|
<Button variant="outline" size="sm" className="gap-2">
|
|
<Link2 className="w-4 h-4" />
|
|
{tokenOk ? 'Reconnect' : 'Connect to QuickBooks'}
|
|
</Button>
|
|
</a>
|
|
{tokenOk && (
|
|
<a href="/api/qbo/disconnect">
|
|
<Button variant="outline" size="sm" className="gap-2 text-red-400 border-red-500/30 hover:bg-red-500/10">
|
|
<Link2Off className="w-4 h-4" />
|
|
Disconnect
|
|
</Button>
|
|
</a>
|
|
)}
|
|
</div>
|
|
</div>
|
|
|
|
{/* Sync Controls */}
|
|
<div className="rounded-xl border bg-card p-5 space-y-4">
|
|
<h2 className="font-semibold text-base">Sync</h2>
|
|
<div className="flex gap-3 flex-wrap">
|
|
<Button
|
|
onClick={() => triggerSync('full')}
|
|
disabled={syncing || !tokenOk}
|
|
size="sm"
|
|
className="gap-2"
|
|
>
|
|
{syncing ? <Loader2 className="w-4 h-4 animate-spin" /> : <RefreshCw className="w-4 h-4" />}
|
|
Full Sync
|
|
</Button>
|
|
<Button
|
|
onClick={() => triggerSync('incremental')}
|
|
disabled={syncing || !tokenOk}
|
|
variant="outline"
|
|
size="sm"
|
|
className="gap-2"
|
|
>
|
|
{syncing ? <Loader2 className="w-4 h-4 animate-spin" /> : <RefreshCw className="w-4 h-4" />}
|
|
Incremental Sync
|
|
</Button>
|
|
</div>
|
|
{syncMessage && (
|
|
<p className="text-sm text-muted-foreground">{syncMessage}</p>
|
|
)}
|
|
</div>
|
|
|
|
{/* Entity Counts */}
|
|
<div className="rounded-xl border bg-card p-5 space-y-4">
|
|
<h2 className="font-semibold text-base">Synced Data</h2>
|
|
{loading ? (
|
|
<div className="flex items-center gap-2 text-muted-foreground text-sm">
|
|
<Loader2 className="w-4 h-4 animate-spin" /> Loading...
|
|
</div>
|
|
) : (
|
|
<div className="grid grid-cols-2 sm:grid-cols-3 gap-4">
|
|
{ENTITY_META.map(({ key, label, icon: Icon, color }) => (
|
|
<div key={key} className="flex items-center gap-3 p-3 rounded-lg bg-muted/30 border border-border">
|
|
<Icon className={`w-5 h-5 shrink-0 ${color}`} />
|
|
<div>
|
|
<div className="text-lg font-semibold leading-none">
|
|
{fmtNum(status?.counts[key] ?? 0)}
|
|
</div>
|
|
<div className="text-xs text-muted-foreground mt-0.5">{label}</div>
|
|
<div className="text-xs text-muted-foreground/60 mt-0.5">
|
|
{fmtDate(status?.lastSync[key] ?? null)}
|
|
</div>
|
|
</div>
|
|
</div>
|
|
))}
|
|
</div>
|
|
)}
|
|
</div>
|
|
</div>
|
|
);
|
|
}
|
|
|
|
export default function QboAdminPage() {
|
|
return (
|
|
<Suspense fallback={<div className="p-6 text-muted-foreground text-sm">Loading...</div>}>
|
|
<QboPageInner />
|
|
</Suspense>
|
|
);
|
|
}
|