GuidesEmployeeOrder Queue

Order Queue

The Order Queue is the staff-facing view for managing incoming customer orders. It appears as the Orders tab for users with the employee or admin role.

Overview

StaffOrdersView displays all active orders (pending, in progress, ready) with:

  • Filter chips: All, Pending, In Progress, Ready
  • Order cards: Order number, items with modifiers, timestamp
  • Action buttons: Claim, Mark Ready, Complete (based on current status)
  • Auto-refresh: Real-time updates via Supabase Realtime

How It Works

  1. OrderQueueViewModel calls OrderQueueService.getActiveOrders()
  2. Fetches all orders with status pending, in_progress, or ready
  3. Orders are sorted by created_at ascending (oldest first)
  4. Supabase Realtime pushes updates when any order changes
  5. The view auto-refreshes to show new orders and status changes

Order Card Display

Each order card shows:

  • Order number: e.g., “SC-A042”
  • Status badge: Color-coded by status
  • Items: Name, quantity, modifiers, notes
  • Time: How long ago the order was placed
  • Assigned to: Which staff member claimed the order (if any)

Status Colors

StatusColorMeaning
PendingGrayNew order, waiting to be claimed
In ProgressAmberClaimed by staff, being prepared
ReadyGreenReady for customer pickup
CompletedBluePicked up by customer
CancelledRedOrder was cancelled