Analytics
Location-scoped metrics and performance dashboards
Danvas analytics (Insights → Analytics) provides location-scoped insights into available team performance, observed tip/check activity, upsell coaching, and (for admins) platform form usage. Data is scoped to locations you can access; some employee-level metrics remain typed unavailable until certified.
Canonical source: Analytics Dashboard feature contract. It owns metric certification and implementation details; this page explains the user-facing surfaces.
Dashboard Overview
Navigate to Insights → Analytics in the sidebar. What you see depends on your role:
| Section | Who can access | What it shows |
|---|---|---|
| Overview | All members with location access | Links to every analytics surface below |
| Team Performance | Members with location access | Available location/team metrics; employee-level tips or performance may be typed unavailable |
| Upgrade Scores | All members with location access | Protein and side upsell performance |
| Submissions | Admins only | Platform form usage and AI token costs |
| Q12 Engagement | Admins only | Gallup Q12 survey results (separate admin route) |
| Discount Review | Managers with location access | Weekly qualified discount dollars, six approved purpose buckets, source reasons, and review actions |
Use the tab bar at the top of Analytics to switch between sections without leaving the area.
Team Performance
Discount Review
Managers can open Insights → Analytics → Discount Review for the last completed restaurant business week. The page defaults to the active authorized location and also supports the last four completed weeks or a bounded custom date range.
Use the four summary cards and six-purpose table to understand where signed discount dollars went. Needs purpose review identifies qualified dollars without a confirmed purpose; it does not label a legitimate benefit, marketing offer, or guest recovery as a loss. The source-reason table keeps Toast reason identity and name visible, while the detail panel shows only bounded permitted supporting information and the exact check/application identifiers needed for review.
For an unresolved transaction, a manager may clarify the exact transaction with an approved subcategory, supporting reason, and before/after confirmation, or leave it unclear and create an assigned Operations Inbox follow-up. A clarification changes that transaction's classification only. The page keeps a “Classification updating” state until the refreshed revision is visible.
Freshness, financial qualification, source coverage, and classification coverage are shown separately. A missing sales denominator leaves the rate unavailable while qualified discount dollars remain visible.
These dashboards expose only certified, location-scoped metrics for the selected date range and optional location filter. A missing, stale, or uncertified employee metric is shown as unavailable.
Sales by Employee
Employee sales and hours comparisons are shown only when the exact metric scope is certified. When available, sales figures use the payment-sales compatibility alias from the tip mart (tipped_payment_total + non_tipped_payment_total on qualifying nonvoid checks); this is a check/payment total, not operational Net Sales from the certified sales mart.
Tips
Employee-level tips, leaderboards, location comparisons, and effective hourly pay are currently unavailable until the certified exact-scope health and watermark evidence is present. Daily observed tip/check values, where shown, are provisional and must not be treated as settled payroll or performance rankings.
If the Tips surface is unavailable, use the typed unavailable state rather than inferring or filling missing employee values.
Open Tabs
Live open tabs, guest counts, and open sales for the current service period where the source is certified; unavailable or stale employee detail remains typed unavailable.
Avg Check
Average check size trends are shown when certified; employee comparisons remain unavailable unless the exact employee metric scope is certified.
Sales/Hour
The Sales/Hour route is currently unavailable and is omitted from navigation: certified hourly net sales evidence is not yet wired, so no SPLH surface can be served for this view.
SPLH (sales per labor hour) is always sales in the numerator divided by accepted labor hours in the denominator. Certified SPLH is defined as certified operational Net Sales for the location/service day ÷ accepted worked labor hours; it remains unavailable until certified hourly net sales and labor evidence exist, and it is never computed from payment-sales aliases or scheduled hours.
Key Tip Metrics
Tip Analytics follows the house tip model documented in ADR-0076.
| Metric | Description |
|---|---|
Charged tips (actual_tips) | Credit and digital tips recorded on checks (after Bar Bot redistribution) |
| Declared cash tips | Cash declared at clock-out; shown for comparison, not added into intraday combined total |
| Estimated cash tips | Inferred from non-tipped payments using the day's observed tip rate (clamped 15–30%) |
| Total combined tips | Intraday: charged + estimated. After settlement: authoritative tips to pay from the warehouse |
| Tip % | Observed charged÷tipped rate intraday; warehouse effective tip % after settlement |
| SPH (Sales Per Hour) | Payment sales (tip-mart net_sales alias) ÷ accepted worked hours |
| Effective hourly pay | Currently unavailable until certified employee tips and accepted labor evidence are present |
[!NOTE] Tip variance (difference between settled pay and POS-observable components) is visible to managers and admins only.
Upgrade Scores
The Upgrade Scores dashboard shows certified upsell performance (protein upgrades and side additions) where available. If the source or employee scope is unavailable, the dashboard uses its typed unavailable state rather than ranking incomplete data.
Submissions Analytics (Admins Only)
Admins can view overall platform submission stats:
- KPI cards — active users, active forms, total submissions, AI token costs
- Trend charts — 14-day submission history
- Completion rates — top 10 most active forms
Q12 Gallup Employee Engagement (Admins Only)
Danvas includes a Q12 Survey system to measure team engagement using Gallup's 12-question framework.
Q12 Privacy Guard
[!IMPORTANT] Individual survey scores and detailed breakdowns are hidden unless a location has received at least 5 submissions in the selected quarter. Fewer than 5 responses shows a privacy guard screen.
Running a Q12 Survey Round
- Publish a round — Q12 Dashboard → Publish Q12 Round (notifies location chat rooms)
- Monitor responses — live submission count on the Q12 Analytics page
- Close the round — Close Q12 Round when the survey period ends
Q12 Analytics Dashboard
Navigate to the Q12 admin analytics page to view overall engagement score, location breakdown, question breakdown, and quarter-over-quarter trends.
Seeding test data
In non-production environments, admins can seed demo Q12 responses from the repository root:
SEED_Q12_SAMPLE_SUBMISSIONS=true RESET_Q12_SAMPLE_SUBMISSIONS=true bun db:seed-q12Data freshness
Analytics freshness is metric- and scope-specific. Treat displayed values as valid only with their location/date/timezone scope, data-through timestamp, last successful sync, and freshness state. Stale, source-empty, missing, or uncertified metrics appear as typed unavailable/degraded states; do not infer a value from a neighboring range. The analytics certification matrix and metrics dictionary own the current contract.