MVP Scope Document
PeyePeye — Restaurant App MVP Scope
iPad (768px) + Web Dashboard
The app restaurant staff and owners use. Optimized for iPad landscape. Covers everything from onboarding and menu setup through live floor operations, kitchen display, payments, and analytics.
26
Total Screens
|
7
Sections
Table of Contents
1. Setup & Onboarding (9 screens)
- 1.1 Restaurant Registration
- 1.2 Menu Builder
- 1.3 Menu Item Editor
- 1.4 AI Menu Upload
- 1.5 AI Allergen Review
- 1.6 Table Setup
- 1.7 Staff Management
- 1.8 POS Integration Setup
- 1.9 Payment Setup
2. Live Operations — Floor View (4 screens)
3. Kitchen Display System (3 screens)
4. Order Management (3 screens)
5. Payments & Settlement (3 screens)
6. Analytics & Settings (4 screens)
7. MVP Scope Boundaries
iPad-Optimized: All restaurant screens are designed for iPad landscape (768px). Storybook previews below render at that viewport width.
1 Setup & Onboarding 9 screens
1.1 Restaurant Registration
Business name, address, type, contact info
Feature Specs
- Step indicator (1 of 4) showing registration progress
- Two-column form layout optimized for iPad landscape
- Cuisine type dropdown with common categories
- Average check size field for pricing context
- Primary contact fields (name, email, phone)
Technical: Multi-step wizard with client-side validation. Data persists between steps via local state. Final submission creates restaurant record and triggers verification email.
1.2 Menu Builder
Add/edit menu items
Feature Specs
- Left sidebar with collapsible category navigation
- 2-column item grid displaying name, price, and thumbnail
- Search bar for quick item lookup
- "AI Upload" sparkle button for automatic menu import from PDF/photo
- Drag-to-reorder items within categories
- Quick-add floating action button for new items
Key Feature: The "AI Upload" sparkle button launches the AI Menu Upload flow (screen 1.4), enabling restaurants to import their entire menu from an existing PDF or photo.
1.3 Menu Item Editor
Individual item editing with modifiers
Feature Specs
- Two-column layout: image upload + details on left; modifiers + tags on right
- Left column: image upload zone, item name, price, description, category selector
- Right column: modifier groups (sizes, add-ons, removals) with pricing
- Allergen tags with multi-select chips (Nuts, Dairy, Gluten, Shellfish, etc.)
- Dietary tags (Vegan, Vegetarian, Gluten-Free, Halal, Kosher)
1.4 AI Menu Upload
Upload PDF/photo → AI extracts items
Feature Specs
- 3-step flow: Upload → AI Processing → Results
- Step 1 — Upload Zone: Drag/drop area for PDF or photo files
- Step 2 — AI Processing: Animated progress with pipeline steps: OCR → Item Extraction → Allergen Classification
- Step 3 — Results Table: Extracted items with name, price, category, and allergen tags
- Editable results before confirming import into the menu
Technical: Uses vision model (GPT-4V or equivalent) for OCR, then structured extraction via LLM. Allergen classification uses a fine-tuned model. All AI costs tracked in the AI Cost Dashboard (screen 6.4).
1.5 AI Allergen Review
Review AI-classified allergens per item
Feature Specs
- Table with columns: Item Name, AI-Detected Allergens (colored chips), Confidence (High/Medium/Low badges), Status (Confirmed/Needs Review)
- Batch confirm button for bulk approval of high-confidence items
- Individual edit capability per item for allergen corrections
- Low-confidence items highlighted in yellow for attention
- Confidence scoring: High (>90%), Medium (70-90%), Low (<70%)
Safety Critical: Allergen data must always be human-reviewed before going live. Low-confidence items require mandatory manual review. This screen ensures no AI classification goes unchecked.
1.6 Table Setup
Define tables, capacity, sections
Feature Specs
- Visual floor plan with SVG grid for spatial layout
- Colored section zones: Main Floor, Patio, Bar, Private
- Right panel with table properties: number, capacity, shape (round/square/rectangular)
- Drag-to-position tables on the floor plan
- Section management for grouping tables
1.7 Staff Management
Add staff, assign roles
Feature Specs
- Role filter tabs: All, Owners, Managers, Servers, Kitchen
- Staff table with avatars, name, role, and status columns
- Invite button to send email invitations to new staff
- Role assignment dropdown with permission descriptions
- Active/inactive status toggle per staff member
1.8 POS Integration Setup
Connect to Toast/Clover/Square or use standalone
Feature Specs
- 3 POS cards (Toast, Clover, Square) with logos and "Connect" buttons
- "Use PeyePeye Standalone" option card with description of standalone benefits
- Connected state shows green checkmark and sync status
- Disconnect option with confirmation dialog
Technical: POS integrations are Phase 2. MVP ships with the "PeyePeye Standalone" option as default. POS cards are displayed but connect buttons show "Coming Soon" state.
1.9 Payment Setup
Connect bank account for payouts
Feature Specs
- Stripe / Finix tab switcher with fee comparison
- Stripe: 2.9% + $0.30 per transaction
- Finix: custom rate (negotiable)
- Bank account form with routing and account number fields
- Estimated payout schedule display (daily/weekly options)
2 Live Operations — Floor View 4 screens
2.1 Floor Dashboard
All tables at a glance
Feature Specs
- 4-column table grid optimized for iPad landscape viewport
- Color-coded table status: green = empty, blue = occupied, orange = ordering, pink = paying
- LIVE badge with pulse animation indicating real-time data
- Summary bar at top: total occupied, average time at table, revenue today
- Tap any table to open Table Detail (screen 2.2)
Core Screen: This is the primary view for servers and managers during service. Must load in under 1 second and update in real time via WebSocket.
2.2 Table Detail
Who's seated, orders, running tab
Feature Specs
- Guest section with "PeyePeye Verified" badges for authenticated guests
- Orders grouped by guest with item details and modifiers
- Running tab total with real-time updates
- Time at table display
- Action buttons: Add Item, Print Check, Close Table
2.3 Guest Verification Alert
Notification when verified guest checks in
Feature Specs
- Toast-style slide-in notification cards from top-right
- "PeyePeye Verified" green badge on notification
- Guest name + table number displayed prominently
- Dismiss and View action buttons
- Stacked display when multiple guests arrive simultaneously
Technical: Triggered via WebSocket when a diner app user scans the table QR code. Notifications auto-dismiss after 30 seconds if not interacted with.
2.4 Incoming Order Alert
New order notification
Feature Specs
- Order card with table number and items list
- Allergen warning banner (red) displayed prominently if allergies present
- "SEND TO KDS" primary action button
- "REVIEW" secondary button for order inspection before sending
- Audio notification chime for new orders
Allergen Safety: If any ordered items contain allergens matching a verified guest's allergy profile, a prominent red warning banner appears. This cannot be dismissed without acknowledgment.
3 Kitchen Display System 3 screens
3.1 KDS Main View
Order queue as cards
Feature Specs
- Dark theme (#1a1a2e background) optimized for kitchen environments
- 3-column card layout for maximum visibility
- Each card: table number, items with modifiers, allergen warnings in red
- Time elapsed with color coding: green <5min, yellow 5-10min, red >10min
- Bump/complete buttons per order card
Technical: Dark theme reduces eye strain in kitchen lighting. Cards auto-sort by time (oldest first). Designed for touch interaction with large tap targets.
3.2 KDS Order Card
Single order detail
Feature Specs
- Expanded dark theme card with full item details
- Item list with modifier details (add-ons, removals, special requests)
- Station labels: Grill, Sauté, Prep, Dessert
- Allergen banner with specific allergen callouts
- Timestamps: received, started, estimated completion
- "MARK READY" button as primary action
3.3 KDS Completed View
Cleared orders for reference
Feature Specs
- Completed orders list with actual prep time stats
- Filter tabs: All, Last Hour, Flagged
- Average prep time display per category
- Items that exceeded time target highlighted in red
- Quick reference for re-fire or dispute resolution
4 Order Management 3 screens
4.1 Order Queue
All active orders across tables
Feature Specs
- Filterable table with columns: Order #, Table, Items, Status (color badges), Time, Priority
- Sort by time or priority
- Filter by status: New, In Progress, Ready, Served
- Click any order row to open Order Detail (screen 4.2)
- Batch actions for selected orders
4.2 Order Detail
Full order with controls
Feature Specs
- Two-column layout: items on left, controls on right
- Left: items with per-item status indicators and modifier details
- Right: status pipeline (Received → Preparing → Ready → Served)
- Special instructions section with highlighted text
- Guest info panel with PeyePeye Verified status and allergy info
4.3 86'd Items
Mark items unavailable
Feature Specs
- 86'd items list with reason field (e.g., "Out of stock", "Quality issue")
- Restore buttons to make items available again
- Real-time note: "Menu updates automatically for all diners"
- Time since item was 86'd displayed per item
- Category grouping for easy scanning
Real-Time Sync: When an item is 86'd, it is immediately removed from all diner app menus. Diners who have the item in their cart receive a notification.
5 Payments & Settlement 3 screens
5.1 Payment Dashboard
Today's transactions and revenue
Feature Specs
- 4 stat cards: Total Revenue, Transactions, Avg Ticket, Tips
- Transactions table: Time, Table, Amount, Tip, Card Type, Status
- Walkout attempts highlighted in red with alert badge
- Date range selector for historical views
- Export button for CSV download
5.2 Transaction Detail
Individual payment breakdown
Feature Specs
- Split guest breakdown with per-person charges
- Stripe/Finix processor info with transaction ID
- Processing fee breakdown (platform fee, processor fee, net amount)
- Tip amount and percentage
- Timestamp and receipt link
5.3 Payout History
Funds payout schedule
Feature Specs
- Next payout hero card with amount and scheduled date
- Bank account info (masked — e.g., ****1234)
- Payout history table with status: Completed, Pending, Processing
- Total paid to date running sum
- Click any payout for detailed breakdown
6 Analytics & Settings 4 screens
6.1 Daily Summary
Covers, revenue, metrics
Feature Specs
- 5 stat cards: Covers, Revenue, Avg Ticket, Tips %, Table Turn
- Revenue-by-hour bar chart (SVG) showing peak periods
- Category breakdown donut chart (Appetizers, Mains, Drinks, Desserts)
- Walkout events section with details and resolution status
- Date picker for reviewing historical days
6.2 Menu Performance
Best sellers, analytics
Feature Specs
- Best sellers ranking with horizontal bar chart visualization
- "Needs Attention" section for low-performing items
- Revenue by category breakdown
- Time period selector (Today, This Week, This Month, Custom)
- Item-level metrics: orders count, revenue, avg rating
6.3 Settings
Restaurant configuration
Feature Specs
- 5-tab navigation: General, Hours, Taxes, Tips, Notifications
- General tab: Restaurant name, address, phone, website
- Hours tab: Day-by-day schedule with open/close times and closed toggle
- Taxes tab: Tax rate configuration per category
- Tips tab: Auto-gratuity rules (party size threshold, percentage)
- Notifications tab: Alert preferences (push, email, SMS) per event type
6.4 AI Cost Dashboard
AI usage and cost tracking
Feature Specs
- AI usage stat cards: Total API Calls, OCR Calls, LLM Tokens, Monthly Cost
- Budget progress bar with 80% (warning) and 100% (limit) thresholds
- Usage breakdown table: date, type, model, tokens, cost
- Per-restaurant limits with configurable caps
- Month-over-month comparison
Technical: AI costs are tracked per restaurant. Default budget cap is $50/month. Alerts fire at 80% usage. Covers OCR for menu uploads, LLM for allergen classification, and any future AI features.
7 MVP Scope Boundaries
IN SCOPE MVP v1.0
- ✓ Restaurant self-serve registration
- ✓ Menu builder with AI upload from PDF/photo
- ✓ AI allergen auto-classification with mandatory human review
- ✓ Table and floor management (visual floor plan)
- ✓ Staff roles: Owner, Manager, Server, Kitchen
- ✓ Standalone ordering (no POS integration required)
- ✓ Basic KDS optimized for iPad
- ✓ Bill splitting and tipping support
- ✓ Payment processing via Stripe or Finix
- ✓ Basic analytics (daily summary, menu performance)
- ✓ AI cost tracking dashboard
OUT OF SCOPE Phase 2+
- ✗ POS integration (Toast/Clover/Square) — Phase 2
- ✗ Advanced analytics and reporting
- ✗ Multi-location management
- ✗ Reservation system integration
- ✗ Loyalty/rewards programs
- ✗ Custom branding per restaurant
- ✗ Advanced staff scheduling
Related Scope Documents
Diner App
Diner MVP Scope
Mobile-first consumer experience
Restaurant App
Restaurant MVP Scope
You are here — 26 screens
Platform
Platform MVP Scope
Admin dashboard & infrastructure