Danvas
Danvas
DashboardSupportWelcome

👤 USER DOCS

User Guides

Getting Started

Getting StartedDashboard & OnboardingApp Settings

Tutorials

Tutorial: Setting Up Shift Tasks & ClosersTutorial: Managing Incidents in the InboxTutorial: Tracking Compliance & Sync StatusTutorial: Operational Workflows with the AI AssistantTutorial: Building & Deploying Custom Checklists

Daily Operations (Staff)

Shift Workspace & TasksService Day SetupDaily Line-UpStaff Service Day ReportsForms

Communication & Chat

Messages & AnnouncementsUnified Operations InboxAI Assistant

Manager & Admin Guides

Daily Line-Up SetupStaff SchedulingManaging LocationsNPS and Guest FeedbackCouponsContacts and Guest HistoryManager CloseoutsDaily Line-Up & ComplianceAnalyticsIncident ReportingWhistleblower Concerns & FeedbackAdmin Tools

⚙️ DEVELOPER DOCS

Getting Started

Getting StartedDevelopmentDeployment Guide

Architecture

Architecture OverviewExplanation: AI Integration & Tenant SecurityExplanation: Dynamic Forms Engine DesignExplanation: Compliance Ledger DesignExplanation: Live Sync & Data FreshnessData FlowArchitecture Decision Records

Core Domain

Core DomainDatabase ReferenceLocations DomainAuth & RBACScheduling DomainReports DomainIncidents DomainUnified Operations InboxLive Sync Data FreshnessToast Sync PipelineNotifications DomainCoupons and Guest NPSAudit Log & Compliance ArchitectureDesign Audit FindingsAI Chat IntegrationAnalytics & Tips Integration

Frontend

Frontend ArchitectureFormsLoading SkeletonsComponentsPWA & Offline ShellScreenshots

API Reference

API Reference

Endpoints

POS Sales APIOptimization Data APISchedule Shifts APIEmployee Export APIReports APIIncidents APIAI Chat APIPush Notifications APIWebhooks APICron API

Contributing

ContributingCode Examples

Security

Security & Compliance

Release Notes

What's New

Reports API

Endpoints for submitting and retrieving shift and manager reports

Overview

The Reports API handles the submission of operational data from both staff (Shift Reports) and management (Manager Reports). It also includes endpoints for compliance reminders and data aggregation.

Endpoints

Submit Shift Report

Used by staff to file end-of-shift data.

POST /api/reports/shift

Request Body

  • locationId: string (UUID)
  • date: string (YYYY-MM-DD)
  • shift: "morning" | "afternoon" | "evening"
  • actualSales: number
  • goalSales: number
  • hero: string (optional)

Submit Manager Report

Used by managers to file daily operational summaries and staff reviews.

POST /api/reports/manager

Request Body

  • locationId: string (UUID)
  • date: string (YYYY-MM-DD)
  • totalSales: number
  • employeeReviews: array (optional)

Automated Tasks (Cron)

EndpointSchedulePurpose
GET /cron/report-reminderDailySends Slack nudges for unfiled reports.
GET /cron/aggregate-heroesWeeklyCalculates MVPs from staff nominations.

Related

Reports Domain Architecture

Shift Reports User Guide

API Overview

Employee Export API

Employee data for import and bulk operations

Incidents API

Endpoints for reporting and managing operational incidents

On this page

OverviewEndpointsSubmit Shift ReportSubmit Manager ReportAutomated Tasks (Cron)Related