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

Scheduling Domain

Current technical architecture of read-only 7shifts scheduling and service-day planning

Overview

In the current MVP, 7shifts is the schedule source of truth. Danvas mirrors published shifts into a local read model and exposes the staff viewer at /schedule. The former manual builder is not an active write surface; /admin/schedule-builder redirects to /schedule.

Canonical sources: Schedule Builder compatibility record, ADR-0058, and executable schedule services.

Schedule sync

  • The Vercel cron apps/api/app/cron/sync-schedule-from-7shifts runs every six hours (0 */6 * * *).
  • It imports the current and upcoming 7shifts window into the local schedule read model.
  • Danvas schedule rows are read-only in this mode; edits and publication happen in 7shifts.
  • SCHEDULE_SYNC_EXCLUDED_SLUGS controls configured exclusions; verify the current route parser before changing operational defaults.

Service-day planning and tasks

Schedule synchronization and Daily Line-Up publication are separate lifecycle boundaries. Published Daily Line-Up dayparts are the side-effect boundary for service-day assignments, accountability, and task/readiness materialization; schedule sync does not replace lineup publish. See ADR-0071, the Lineup Cards contract, and the current packages/shift-tasks / packages/lineup modules.

Related

  • Scheduling user guide
  • Daily Line-Up
  • Workspace & Tasks

Auth & RBAC

Technical design of Clerk integration and Role-Based Access Control

Reports Domain

Current technical overview of staff and manager report workflows

On this page

OverviewSchedule syncService-day planning and tasksRelated