Unified Operations Inbox

The Operations Inbox v2 (governed by ADR-0075) serves as the unified operational command feed for restaurant managers and staff. It consolidates incidents, announcements, staff messages, and workflow notifications into a single triaged inbox.

Architectural OverviewCopy Anchor Link

The inbox is located at /inbox and is designed around a responsive Master-Detail layout with structured triage states:

Primary ViewsCopy Anchor Link

1. Attention: Urgent, unassigned, or aging items requiring immediate manager action.
2. Mine: Items claimed by or explicitly assigned to the signed-in user.
3. Active: All open, in-progress, or escalated operational items across the team.
4. History: Completed, closed, or dismissed items with full audit history.

Canonical Lifecycle State MachineCopy Anchor Link

All operational items progress through deterministic lifecycle states with optimistic concurrency control (revision checks):

stateDiagram-v2
    [*] --> unclaimed: Created
    unclaimed --> in_progress: Claim / Assign
    in_progress --> waiting: Awaiting Vendor / Info
    waiting --> in_progress: Update Received
    in_progress --> completed: Resolve / Sign-off
    unclaimed --> dismissed: Dismiss Noise
    in_progress --> dismissed: Dismiss
    completed --> [*]
    dismissed --> [*]

State Transitions & OwnershipCopy Anchor Link

• Claiming: Sets ownerId to the current user and moves state to in_progress.
• Unclaiming: Releases item back to unclaimed state for team pickup.
• Escalation: Bumps urgency tier (low → medium → high → critical) and alerts managers via Slack.
• Resolution: Requires resolution notes and logs an immutable audit event.

Keyboard Navigation & ShortcutsCopy Anchor Link

To maximize manager speed during busy service shifts:

• J / K or ↓ / ↑ — Navigate feed items
• C — Claim selected item
• U — Unclaim selected item
• E — Escalate urgency
• R — Focus reply / response input
• Esc — Deselect / close detail drawer

Mobile ExperienceCopy Anchor Link

On viewports < 768px, the inbox collapses into a high-density list with 48px touch targets. Selecting an item opens a slide-over sheet preserving full thread history and action buttons without losing feed context.