Company Metrics: Reading Your Org's Performance Dashboard

The company dashboard opens with a timeframe picker followed by six metric cards arranged in a responsive grid (1 column on mobile, 2 on medium screens, 4 on large screens). The timeframe picker defaults to 'This Month' and accepts ranges from 'This Month' and 'Last 6 Months' to individual calendar quarters (Q1, Q2, etc.) and 'All Time'. Every card title shows the selected timeframe in parentheses when it is not 'live' data — for example 'Total Jobs (This Month)'. Changing the timeframe triggers a backend refetch and the cards animate to 50% opacity with a pulse animation while loading, then snap to the new values.

The four top-row cards are: Total Jobs (overall count plus breakdowns of Pending / Active / Delivered at smaller type below the number), Technician Utilization (a percentage with a progress bar and 'X/Y available' note showing how many of your active technicians have open capacity), Avg Delivery Time (average hours from shoot completion to media delivery for the period), and Revenue (total revenue in your org's currency — CAD, USD, EUR — with a per-job average below). The revenue card has a small eye icon in the header; clicking it replaces the dollar figure with bullet placeholders so you can share your screen without revealing financials.

The two wide cards spanning the bottom row are On-Time Delivery Rate (percentage of jobs delivered by the committed deadline, with a progress bar and a count like '42 of 48 jobs delivered on time') and Client Approval Rate (percentage of delivered jobs where the client approved the media without a revision request). Both metrics are computed server-side by the MetricsService and reflect only the selected timeframe. A small refresh icon appears at the top-right of the metric grid; clicking it re-fetches the latest data from the backend without a full page reload.

Provider and technician dashboards show a simpler four-tile StatsGrid instead of the six-card MetricsDashboard. Their tiles are: Upcoming Jobs (count of assigned jobs not yet completed), Total Completed (lifetime delivered jobs), Rating (overall average from client reviews, displayed as X.X), and On-Time Rate (percentage, displayed as XX%). These stats come from the backend's ProviderStats shape — the same endpoint used by the /dashboard API — so they are authoritative rather than client-computed.

A metrics error banner appears at the top of the company dashboard if the backend fetch fails. It shows the error message and a 'Retry' button that re-fires the query. This is the only red alert on the dashboard page — all other data failures degrade gracefully to zero values rather than showing errors. If you see this banner, checking your network connection and clicking Retry resolves most transient errors.