mcpengine/servers/clover/src/ui/react-app/order-dashboard.tsx
Jake Shore 7ee40342c8 Clover: Complete MCP server with 50+ tools and 18 React apps
- API client with Clover REST API v3 integration (OAuth2 + API key auth)
- 50+ comprehensive tools across 10 categories:
  * Orders: list, get, create, update, delete, add/remove line items, discounts, payments, fire order
  * Inventory: items, categories, modifiers, stock management
  * Customers: CRUD, search, addresses, payment cards
  * Employees: CRUD, roles, shifts, clock in/out
  * Payments: list, get, refunds
  * Merchants: settings, devices, tender types
  * Discounts: CRUD operations
  * Taxes: CRUD, tax rates
  * Reports: sales summary, revenue by item/category, employee performance
  * Cash: cash drawer tracking and events

- 18 React MCP apps with full UI:
  * Order management: dashboard, detail, grid
  * Inventory: dashboard, detail, category manager
  * Customer: detail, grid
  * Employee: dashboard, schedule
  * Payment history
  * Analytics: sales dashboard, revenue by item, revenue by category
  * Configuration: discount manager, tax manager, device manager
  * Cash drawer

- Complete TypeScript types for Clover API
- Pagination support with automatic result fetching
- Comprehensive error handling
- Full README with examples and setup guide
2026-02-12 17:42:59 -05:00

160 lines
4.8 KiB
TypeScript

import React, { useState, useEffect } from 'react';
import { ShoppingCart, DollarSign, Clock, TrendingUp } from 'lucide-react';
interface OrderStats {
totalOrders: number;
openOrders: number;
totalRevenue: number;
averageOrderValue: number;
}
export default function OrderDashboard() {
const [stats, setStats] = useState<OrderStats | null>(null);
const [loading, setLoading] = useState(true);
const [timeRange, setTimeRange] = useState('today');
useEffect(() => {
fetchStats();
}, [timeRange]);
const fetchStats = async () => {
setLoading(true);
try {
const endDate = Date.now();
let startDate = endDate;
if (timeRange === 'today') {
startDate = new Date().setHours(0, 0, 0, 0);
} else if (timeRange === 'week') {
startDate = endDate - 7 * 24 * 60 * 60 * 1000;
} else if (timeRange === 'month') {
startDate = endDate - 30 * 24 * 60 * 60 * 1000;
}
const summary = await window.mcp.callTool('clover_sales_summary', {
startDate,
endDate,
});
const openOrders = await window.mcp.callTool('clover_list_orders', {
filter: 'state=open',
});
setStats({
totalOrders: summary.totalOrders || 0,
openOrders: openOrders.count || 0,
totalRevenue: summary.totalSales || 0,
averageOrderValue: summary.averageOrderValue || 0,
});
} catch (error) {
console.error('Failed to fetch order stats:', error);
} finally {
setLoading(false);
}
};
if (loading) {
return (
<div className="flex items-center justify-center h-64">
<div className="text-gray-500">Loading dashboard...</div>
</div>
);
}
return (
<div className="p-6 bg-gray-50 min-h-screen">
<div className="mb-6 flex justify-between items-center">
<h1 className="text-3xl font-bold text-gray-900">Order Dashboard</h1>
<select
value={timeRange}
onChange={(e) => setTimeRange(e.target.value)}
className="px-4 py-2 border border-gray-300 rounded-lg"
>
<option value="today">Today</option>
<option value="week">This Week</option>
<option value="month">This Month</option>
</select>
</div>
<div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-4 gap-6 mb-8">
<StatCard
icon={<ShoppingCart className="w-8 h-8 text-blue-600" />}
title="Total Orders"
value={stats?.totalOrders || 0}
bgColor="bg-blue-50"
/>
<StatCard
icon={<Clock className="w-8 h-8 text-yellow-600" />}
title="Open Orders"
value={stats?.openOrders || 0}
bgColor="bg-yellow-50"
/>
<StatCard
icon={<DollarSign className="w-8 h-8 text-green-600" />}
title="Total Revenue"
value={`$${((stats?.totalRevenue || 0) / 100).toFixed(2)}`}
bgColor="bg-green-50"
/>
<StatCard
icon={<TrendingUp className="w-8 h-8 text-purple-600" />}
title="Avg Order Value"
value={`$${((stats?.averageOrderValue || 0) / 100).toFixed(2)}`}
bgColor="bg-purple-50"
/>
</div>
<div className="bg-white rounded-lg shadow p-6">
<h2 className="text-xl font-semibold mb-4">Quick Actions</h2>
<div className="grid grid-cols-2 md:grid-cols-4 gap-4">
<button
onClick={() => window.mcp.showApp('order-grid')}
className="px-4 py-3 bg-blue-600 text-white rounded-lg hover:bg-blue-700"
>
View All Orders
</button>
<button
onClick={() => window.mcp.callTool('clover_create_order', {})}
className="px-4 py-3 bg-green-600 text-white rounded-lg hover:bg-green-700"
>
New Order
</button>
<button
onClick={() => window.mcp.showApp('order-detail')}
className="px-4 py-3 bg-purple-600 text-white rounded-lg hover:bg-purple-700"
>
Order Details
</button>
<button
onClick={() => window.mcp.showApp('payment-history')}
className="px-4 py-3 bg-indigo-600 text-white rounded-lg hover:bg-indigo-700"
>
Payment History
</button>
</div>
</div>
</div>
);
}
function StatCard({
icon,
title,
value,
bgColor,
}: {
icon: React.ReactNode;
title: string;
value: string | number;
bgColor: string;
}) {
return (
<div className={`${bgColor} rounded-lg p-6 shadow-sm`}>
<div className="flex items-center justify-between mb-3">
{icon}
</div>
<h3 className="text-gray-600 text-sm font-medium mb-1">{title}</h3>
<p className="text-2xl font-bold text-gray-900">{value}</p>
</div>
);
}