# Peppar — End-to-End Product Context

**Purpose:** Single source of truth for UI/UX design revamp, website copy, and marketing differentiation.  
**Product:** Peppar (internal codebase: Chakhna / `com.chakhna.app`)  
**Website:** https://www.peppar.in · **Partner portal:** https://partners.peppar.in  
**Last updated:** June 2026

---

## Table of contents

1. [Executive summary](#1-executive-summary)
2. [Who Peppar is for](#2-who-menubeez-is-for)
3. [Platform surfaces & architecture](#3-platform-surfaces--architecture)
4. [Brand identity & theme colors](#4-brand-identity--theme-colors)
5. [Customer / guest experience](#5-customer--guest-experience)
6. [Restaurant operations (Merchant console)](#6-restaurant-operations-merchant-console)
7. [KOT printing & print agent](#7-kot-printing--print-agent)
8. [Peppar Merchant App (Android)](#8-menubeez-merchant-app-android)
9. [Billing, payments & GST](#9-billing-payments--gst)
10. [Menu, catalog & branding](#10-menu-catalog--branding)
11. [Kitchen display & order lifecycle](#11-kitchen-display--order-lifecycle)
12. [Inventory & procurement](#12-inventory--procurement)
13. [CRM, marketing & promotions](#13-crm-marketing--promotions)
14. [Feedback, reviews & guest insights](#14-feedback-reviews--guest-insights)
15. [Reports & analytics](#15-reports--analytics)
16. [Multi-outlet & chain management](#16-multi-outlet--chain-management)
17. [SaaS platform, plans & onboarding](#17-saas-platform-plans--onboarding)
18. [Staff roles & access control](#18-staff-roles--access-control)
19. [Integrations & infrastructure](#19-integrations--infrastructure)
20. [Competitive differentiation (marketing angles)](#20-competitive-differentiation-marketing-angles)
21. [Copy-paste UI/UX design prompt](#21-copy-paste-uiux-design-prompt)

---

## 1. Executive summary

**Peppar** is a cloud-native, multi-tenant **restaurant POS and operations platform** for India. It unifies:

- **Front-of-house:** Fast billing, take-order counter, table management, reservations
- **Kitchen:** Web KDS, physical KOT printing, multi-station routing
- **Guest-facing digital:** Branded restaurant pages, QR menus, table-side ordering (no app download)
- **Back-office:** Inventory, procurement, reports, CRM, campaigns
- **SaaS business layer:** Subscription plans, Razorpay billing, feature gating, platform-owner admin

**Tagline (current):** *Restaurant POS, digital menus & operations — all in one platform*

**Positioning statement:**

> Peppar is a modern, customer-experience-first POS for dine-in and QR-first restaurants — with built-in branded online ordering, transparent all-inclusive SaaS pricing, and hardware-flexible kitchen printing. No add-on surprises.

**Target market:** Independent restaurants, cafés, cloud kitchens, and growing chains (2–10+ outlets) across India.

---

## 2. Who Peppar is for

| Persona | Needs | Peppar answer |
|---------|-------|-----------------|
| **Restaurant owner / partner** | Run billing, staff, menu, subscriptions, multi-outlet visibility | Partner portal + staff console + subscription self-service |
| **Manager / admin** | Daily ops, reports, setup, marketing | Full admin sidebar: billing, KDS, inventory, CRM |
| **Captain / waiter / worker** | Take orders, assign tables, serve guests | Take Order, Ongoing Orders, table workflows |
| **Chef / kitchen staff** | See tickets, update status | Web KDS + physical KOT slips |
| **Receptionist** | Table requests, reservations, guest seating | Table booking, QR approval flow |
| **Delivery person** | Assigned delivery orders | Delivery order assignment & tracking |
| **Dine-in guest** | Browse menu, order, pay, track — on phone | React customer SPA via QR (no install) |
| **Platform owner (Peppar)** | Onboard restaurants, plans, go-live | Admin console SPA |

---

## 3. Platform surfaces & architecture

| Surface | Technology | Users | Key routes |
|---------|------------|-------|------------|
| **Marketing & customer SPA** | React 19, TypeScript, Redux, React Router 7 | Public, guests, partners | `/`, `/restaurants/:appName/*`, `/partner/setup` |
| **Staff / Merchant console** | JSP + Apache Tiles (~120 pages) | Restaurant staff | `/manage/*`, `/service/*`, `/reports/*`, `/dashboard` |
| **Platform admin** | React 19 + Vite (`admin-console/`) | Peppar super-admin | `/api/v1/admin/*` |
| **Print Agent** | Electron tray app (`print-agent/`) | Billing PC | Polls `/api/print-agent/*` |
| **Merchant App** | Android WebView + native print bridge | Counter tablet | Same staff URLs + Bluetooth printing |

**Backend:** Java 8, Spring MVC, Hibernate, MySQL, Flyway migrations  
**Realtime:** CometD / Bayeux (live orders, KDS, print job push, guest notifications)  
**Auth:** Spring Security sessions (staff) + JWT (customer SPA & admin console)  
**Cloud:** AWS S3 (images), SNS (SMS), SES (email)

---

## 4. Brand identity & theme colors

Peppar uses a **warm honey-gold primary** on **neutral cream/charcoal** backgrounds — approachable, food-industry friendly, high contrast for POS readability.

### Primary palette

| Token | Hex | Usage |
|-------|-----|--------|
| **Primary (brand gold)** | `#F5C21A` | CTAs, active nav, table headers, badges, footer accent border |
| **Primary hover** | `#D4A416` | Button hover, link hover, darker gold states |
| **Primary text (on gold)** | `#1F2428` | Text on primary buttons and gold backgrounds |
| **Dark blue (brand accent)** | `#002359` | Secondary emphasis, links in some admin modules |

### Backgrounds & surfaces

| Token | Hex | Usage |
|-------|-----|--------|
| **Page background** | `#FFFFFF` / `#FAFAF8` | App shell, page canvas |
| **Card background** | `#FFFFFF` | Cards, modals, forms |
| **Navbar background** | `#FFFFFF` | Top navigation |
| **Footer background** | `#1F2428` | Platform footer (charcoal) |
| **Footer border** | `#F5C21A` | Footer top accent stripe |
| **Warm highlight** | `#fffef5`, `#fffbeb` | Focus states, selected rows, promo banners |
| **Subtle borders** | `#E9ECEF`, `#E5E5E0`, `#EAEAE6`, `#F0F0EA` | Inputs, dividers, table borders |

### Secondary & status

| Token | Hex | Usage |
|-------|-----|--------|
| **Secondary (brand charcoal)** | `#1F2428` | Wordmark, footer, dark UI accents |
| **Surface** | `#F8F9FA` | Subtle backgrounds, badges, elevated panels |
| **Secondary alert red** | `#DE342F` | Destructive / alert accent (legacy alias) |
| **Text primary** | `#1F2428` | Headings, body |
| **Text secondary** | `#4B5563` | Supporting copy |
| **Text muted / labels** | `#6B7280` | Form labels, order list metadata |
| **Text light** | `#FFFFFF` | On dark backgrounds |
| **Success** | `#16A34A` | Success states, online badges |
| **Error / danger** | `#DC2626` | Errors, failed print jobs |
| **Warning** | `#F59E0B` | Warnings, low-stock alerts |
| **Info** | `#2563EB` | Informational badges |

### Typography & UI tokens

- **Font family:** `'Manrope'`, `-apple-system`, `BlinkMacSystemFont`, `'Segoe UI'`, `'Roboto'`, sans-serif
- **Border radius:** `--radius-sm: 4px`, `--radius-md: 8px`, `--radius-lg: 12px`
- **Shadows:** `--shadow-sm` through `--shadow-lg` (subtle elevation)
- **Primary focus ring:** `box-shadow: 0 0 0 3px rgba(245, 194, 26, 0.15)` on focused inputs
- **Logo:** Hosted on S3 (`menubeez.s3.ap-south-1.amazonaws.com/logos/peppar-logo.png`)

**Design direction for revamp:** Modern SaaS + hospitality warmth. Gold CTAs on clean white/cream. Charcoal footer. Avoid cold corporate blue as dominant color — gold + charcoal is the brand pair.

---

## 5. Customer / guest experience

**No app download required.** Guests use the mobile web app via QR code or restaurant URL.

### Customer SPA routes

| Route | Feature |
|-------|---------|
| `/restaurants/:appName` | Branded restaurant home — hours, gallery, contact, hero |
| `/restaurants/:appName/menu` | Digital menu browse with filters |
| `/restaurants/:appName/menu/:itemUrl` | Item detail — photos, modifiers, add to cart |
| `/restaurants/:appName/cart` | Cart & checkout |
| `/restaurants/:appName/reserve-table` | Table reservation |
| `/restaurants/:appName/orders/:orderId` | Live order tracking |
| `/restaurants/:appName/my-orders` | Order history |
| `/restaurants/:appName/join-order` | **Shared / group ordering** — join table order via 4-digit PIN |

### QR dine-in flow

1. Guest scans table QR → lands on restaurant page  
2. Submits **table request** (staff approval workflow)  
3. Staff approves → guest gets menu access  
4. Guest browses, customizes items, places order  
5. Order flows to **kitchen (KDS + KOT)** and **billing** in real time  
6. Live status updates via CometD + order tracking page  

### Order types supported

- **Dine-in** (table-linked, shared ordering enabled)  
- **Takeaway**  
- **Delivery** (with delivery person assignment & route metadata)

### Guest-facing feature details

| Feature | Detail |
|---------|--------|
| **QR code menu** | Starter tier; scan-to-menu, no install |
| **Basic ordering** | Cart, modifiers (half plate, spiciness, gravy, size), checkout |
| **Table booking** | Pro tier; reserve tables from customer app |
| **Shared / group ordering** | Pro tier; multiple phones → one bill; 4-digit PIN to join (`/join-order`) |
| **Virtual Captain** | Pro tier; floating AI assistant — voice (opt-in TTS) + chat popover; narrates order journey from placed → ready |
| **Online payments** | Pro tier; PayU gateway (UPI/cards per restaurant config) |
| **Wishlist & reviews** | Save favorites; item reviews with moderation |
| **Notifications** | Real-time toasts + email/SMS for order updates |
| **Ongoing order bar** | Persistent strip showing active order status |
| **Social login** | Facebook, Twitter, Google OAuth (Spring Social) |

### Virtual Captain (differentiator)

- Persistent floating widget on all restaurant customer routes  
- Modes: minimized launcher → popover → expandable history  
- Phase 1: template-driven messages + browser TTS (user opts in to voice)  
- Events: welcome, menu nudge, order placed, confirmed, preparing, ready, complete  
- Feature-gated: `virtual_captain` on Pro plan  

---

## 6. Restaurant operations (Merchant console)

The **staff console** is the day-to-day control center for restaurant teams. Accessible via browser at the restaurant subdomain or staff login.

### Operations hub (sidebar)

| Module | What it does |
|--------|--------------|
| **Dashboard** | Sales overview, KPIs, quick insights (managers/admins) |
| **Take Order** | Counter ordering for walk-in / takeaway |
| **Table Booking** | Staff view of reservations & table requests |
| **Ongoing Orders** | Live order queue — status updates, waiter assignment |
| **Order History** | Past orders, reprint KOT/invoice, audit |
| **Billing / Fast Billing** | Full POS checkout — see §9 |
| **Kitchen Display (KDS)** | `/service/displayOrder` — station board with live timers |
| **Reviews** | Moderate guest item reviews |

### Menu management

- Categories, cuisines, menu items  
- Size-based pricing, half-plate options  
- Gravy type, spiciness level attributes  
- Per-item discounts with priority rules  
- Sub-recipes / BOM linkage  
- Featured items, veg/non-veg tags, SKU codes, images  
- **Bulk import/export** (Excel via Apache POI) — Pro  

### Restaurant setup

- Restaurant profile, logo, currency  
- Opening hours  
- Tables, sections, floor locations  
- **QR code generation** — multiple branded PDF templates (ZXing + Flying Saucer)  
- **KOT Printer settings** — see §7  
- Users & role management  
- Subscription & plan management  

### Partner portal

- URL: `https://partners.peppar.in`  
- New restaurant owners sign up as **Partner** role  
- Guided setup at `/partner/setup`: name → restaurant name → unique URL slug → go-live checklist  
- Self-serve subscription with Razorpay  

---

## 7. KOT printing & print agent

**Key marketing message:** Peppar connects to **any ESC/POS thermal printer** — no vendor lock-in. Network, USB, and Bluetooth (Android) supported.

### Why a print agent?

Cloud POS runs in the browser. Browsers cannot silently send raw bytes to LAN printers. Peppar uses the same pattern as Posist Print Utility: **cloud job queue + local print agent**.

### Supported printers

| Requirement | Detail |
|-------------|--------|
| Type | Thermal receipt / KOT printer (58 mm or 80 mm) |
| Protocol | **ESC/POS** (industry standard) |
| Vendor lock-in | **None** — Epson, TVS, Everycom, Rugtek, Posiflex, generic Amazon units |
| Brands (India) | Epson TM-T82/T88, TVS RP series, Everycom EC-58/80, Rugtek, Posiflex, etc. |

### Connection types

| Connection | Where | Print Agent | Notes |
|------------|-------|-------------|-------|
| **Network (Ethernet/Wi‑Fi LAN)** | Admin → `IP:9100` | Desktop (Win/Mac) | **Recommended** |
| **USB** | Admin → exact Windows printer name | Windows desktop only | Raw ESC/POS via OS spooler |
| **Bluetooth Classic** | Admin → printer MAC address | **Android Merchant App only** | Counter tablet + BT thermal |
| **Cloud from browser** | — | Not supported | Requires local agent |

### Setup flow (one-time)

1. **Settings → KOT Printer** — enable `kot_printing` (Starter tier)  
2. Add printer(s): name, connection, address, paper width (58/80 mm), copies, default flag  
3. **Generate pairing code** → enter in Print Agent with server URL  
4. Agent polls every 2 seconds (or CometD push on Merchant App)  
5. **Test Print** → verify slip within ~5 seconds  
6. Configure auto-print toggles and optional kitchen stations  

### Auto-print triggers

| Source | Event | When |
|--------|-------|------|
| Fast billing | `ORDER_CONFIRMED`, `ORDER_MODIFIED`, `ORDER_PREPARING` | Per toggle |
| Take order counter | `ORDER_CONFIRMED` | Per toggle |
| Customer QR app | `ORDER_PLACED`, `ORDER_MODIFIED` | Optional (many restaurants print only on staff confirm) |
| Manual **Print KOT** button | `REPRINT` | Always |
| Admin **Test Print** | `TEST` | Always |

### KOT slip content

```
        [Restaurant Name / Header]
           ** MODIFIED **          ← on order changes
        Station: Grill            ← multi-station routing

Order: AB-0042
Type: DINE-IN
Table: 5
Time: 14:32:05
--------------------------------
2x  Butter Chicken
    (Medium spicy, Dry)
1x  Garlic Naan
    (Half plate)
--------------------------------
[Footer text if configured]
Printed: 14:32:08
        [paper cut]
```

- **Delta KOT on modify:** only new/changed items print (not full reprint)  
- Modifiers on slip: half plate, spiciness, gravy type, size  
- Configurable header/footer text and top margin lines (for kitchen pin rails)

### Multi-station kitchen routing

- Define stations: Grill, Bar, Dessert, etc.  
- Map **menu categories** → station → dedicated printer  
- One confirm → **one print job per station** with filtered items  
- Fallback: default printer when no stations configured  

### Invoice printing

- **Print Invoice** in Fast Billing (manual)  
- Auto on payment toggle: `print_invoice_on_payment`  
- ESC/POS invoice via print agent OR HTML receipt in browser  
- Printer roles: **KITCHEN** (KOT) vs **INVOICE** (tax bill)

### Print job lifecycle

| Status | Meaning |
|--------|---------|
| `PENDING` | Queued; waiting for agent |
| `PRINTED` | Agent confirmed success |
| `FAILED` | Printer error (logged) |

- Jobs stored in cloud with base64 payload for audit & reprint  
- Agent offline → jobs queue; prints backlog when reconnected  
- **Sync Pending** admin action re-publishes stuck jobs  

### Desktop Print Agent

- Electron tray app in `print-agent/`  
- Pair via 6-character code  
- Downloads: `.deb`, `.AppImage` (arm64), Windows installer (`npm run dist`)  
- Env: `MENUBEEZ_API_URL` for default server URL  

---

## 8. Peppar Merchant App (Android)

The **Peppar Merchant App** (`menubeez-merchant`) is an Android tablet/phone app that wraps the staff web console with **native printing capabilities**.

### What it adds over browser-only

| Capability | Detail |
|------------|--------|
| **Bluetooth Classic printing** | Connect BT thermal printers via MAC address — ideal for counter tablets |
| **CometD push** | Instant `PRINT_JOB_READY` instead of 2-second polling |
| **Native print bridge** | `menubeez-native-bridge.js` — claim job → print ESC/POS → ack |
| **Pair as print agent** | Tablet becomes the print agent device (`platform: ANDROID`) |
| **Link printers to tablet** | Jobs route only to printers linked to this agent |

### Merchant App setup

1. Install Peppar Merchant on Android tablet  
2. Log in as staff → **Settings → KOT Printer**  
3. **Pair device** (generates agent token, shows **Agent Online**)  
4. Add printers: Network IP, USB name, or **Bluetooth Classic + MAC**  
5. Tap **Link Printers to This Tablet**  
6. **Sync Pending** → **Test Print**  
7. Configure KITCHEN vs INVOICE printer roles  

### Use cases

- **Counter tablet + Bluetooth thermal** — no billing PC required  
- **Kitchen pass tablet** — KDS + print in one device  
- **Multi-printer routing** — one agent, multiple network printers on LAN  

---

## 9. Billing, payments & GST

### Fast Billing (POS)

- Quick item search & cart-based checkout  
- Order types: dine-in, takeaway, delivery  
- Table assignment, customer name/phone capture  
- **Discounts:** flat or percentage at bill level  
- **Coupons:** code entry with validation at billing  
- **Promotions:** auto-applied promotional offers with banner preview  
- **Taxes:** service tax, CGST, SGST (configurable per restaurant)  
- **Charges:** delivery charges, packing charges (toggle per bill)  
- **Payment methods:** Cash, UPI, Card, COD  
- Mid-service item add/modify on open orders  
- Draft bills → confirm → kitchen trigger  
- **Print KOT** and **Print Invoice** buttons  
- Order history with reprint  

### GST compliance

- CGST / SGST breakdown on bills  
- Tax & GST reports (exportable Excel)  
- Purchase register report for GST (inventory module)  

### Customer online payments

- PayU integration for guest checkout (UPI/cards)  
- Per-restaurant merchant keys  

### SaaS subscription billing

- Razorpay for restaurant subscriptions to Peppar  
- Plans: Starter, Pro (outlet bands), Enterprise (custom)  

---

## 10. Menu, catalog & branding

| Capability | Detail |
|------------|--------|
| Categories & cuisines | Organize catalog; filter on guest menu |
| Item attributes | Veg/non-veg, tags, dietary info, descriptions, photos |
| Modifiers | Half plate, size types, gravy, spiciness |
| Pricing | Base price + size-based pricing tiers |
| Offers on items | Menu-level discounts with rules, priority, validity windows |
| Specials & featured | Highlight dishes on guest menu |
| Ingredient visibility | Control what guests see (allergens, ingredients) |
| Chain menu master | Central menu definition → preview → push to outlets (Pro) |
| Bulk import/export | Excel for categories, menu items (Pro) |
| Branded restaurant pages | Each outlet: `/restaurants/:slug` with logo, hours, gallery |
| QR PDF templates | Multiple branded QR designs for table tents / stickers |
| Custom domain | Pro tier (planned/ gated) — own domain for storefront |
| White-label | Enterprise — remove Peppar branding on guest experience |

---

## 11. Kitchen display & order lifecycle

### Web KDS (`/service/displayOrder`)

- Live kitchen board with order cards  
- CometD realtime push on new/modified orders  
- Station-aware display (when stations configured)  
- Status timers for prep tracking  
- Runs **in parallel** with paper KOT — chef sees screen + gets slip  

### Order lifecycle states

```
initiated → placed → confirmed → preparing → prepared → served → completed
```

- Staff can update status from ongoing orders or KDS  
- Delivery: assignment to delivery person, route metadata  
- Waiter/table reassignment on live orders  
- **Call waiter / service requests** from guest side  
- Wait-time estimates pushed to guests  

---

## 12. Inventory & procurement

**Feature key:** `inventory_management` (Pro)

| Submodule | Capability |
|-----------|------------|
| **Stock overview** | Current levels, low-stock visibility |
| **Ingredients** | Master list, activate/deactivate |
| **Units of measure** | UOM management |
| **Suppliers** | Vendor master |
| **Purchase orders** | Raise PO from low-stock alerts |
| **Inbound / outbound** | Stock movements |
| **Stock adjustments** | Manual corrections |
| **Stock take** | Physical count workflows |
| **Stock transfers** | Between locations |
| **Wastage** | Record spoilage |
| **Batches & expiry** | Batch tracking |
| **Central kitchen** | Inter-location production |
| **Chain inventory** | Cross-outlet stock view |
| **Valuation & costing** | Inventory value reports |
| **Menu BOM** | Link menu items → ingredients (recipe data model) |
| **Reorder alerts** | Low-stock thresholds per ingredient |

---

## 13. CRM, marketing & promotions

### Customer management (Pro)

- Restaurant-scoped customer profiles  
- Segmentation filters & saved presets  
- Excel export of customer lists  
- Customer lookup at billing  
- Order history per customer  

### Coupons & promotions (Pro)

**Coupon types & rules:**

- Percentage or fixed amount off  
- Min order value, order type (dine-in / takeaway / delivery)  
- Usage limits per customer and total  
- Validity date range  
- Apply at billing and guest checkout  

**Promotions:**

- Campaign-style offers with auto-apply at checkout  
- Visible promo banner in billing UI  

**Discount engine (menu-level):**

- PERCENTAGE, FIXED_AMOUNT, BUY_X_GET_Y, BULK_DISCOUNT, FREE_ITEM  
- Size-specific discounts, priority stacking rules  
- Time windows, day-of-week, customer segment rules  

### Marketing campaigns (Pro)

- SMS and email campaigns to customer segments  
- Campaign templates library  
- AWS SNS (SMS) + SES (email) delivery  

---

## 14. Feedback, reviews & guest insights

| Feature | Detail |
|---------|--------|
| **Item reviews** | Guest reviews with admin moderation workflow |
| **Configurable feedback surveys** | Custom question types |
| **Order-level feedback** | Structured post-order survey |
| **Per-item ratings** | Food quality ratings per dish ordered |
| **Ambience & captain ratings** | Multi-dimensional guest experience scores |
| **Recommend / NPS score** | Would-you-recommend metric |
| **Feedback report** | Analytics dashboard for guest satisfaction (Pro) |

---

## 15. Reports & analytics

**Feature keys:** `analytics_dashboard`, `reports_export` (Pro)

| Report | Content |
|--------|---------|
| **Sales** | Revenue, order counts, trends |
| **Menu** | Item performance, bestsellers |
| **Payment** | Payment method mix |
| **Staff** | Staff activity |
| **Feedback** | Guest satisfaction analytics |
| **Inventory** | Stock levels, movement |
| **Tax & GST** | Tax breakdown export |
| **Purchase register** | GST purchase register (inventory) |
| **Chain sales comparison** | Cross-outlet performance (chain admins) |

- All reports: date filters, Excel download  
- Dashboard overview with KPI cards  

---

## 16. Multi-outlet & chain management

**Feature key:** `chain_outlets` (Pro)

| Capability | Detail |
|------------|--------|
| **Restaurant chains** | Group outlets under one brand |
| **Chain admin role** | Switch between outlets or "All Outlets" view |
| **Outlet publish** | Per-outlet customer visibility toggle |
| **Menu master** | Central menu → preview → push to selected outlets |
| **Chain inventory** | Cross-outlet stock visibility |
| **Chain sales reports** | Compare outlet performance |
| **Outlet switcher** | Staff UI context switch without re-login |

### Pro pricing by outlet band

| Band | Outlets | Monthly (excl. GST) |
|------|---------|---------------------|
| Single Outlet | 1 | ₹1,299 |
| Small Chain | 2–5 | ₹2,499 |
| Growing Chain | 6–10 | ₹3,999 |

---

## 17. SaaS platform, plans & onboarding

### Plan tiers

| Plan | Monthly (1 outlet, excl. GST) | Includes |
|------|----------------------------------|----------|
| **Starter** | **₹599** | Menu, QR ordering, tables, kitchen orders, **KOT printing**, feedback, email support |
| **Pro** | **₹1,299** | Everything in Starter + analytics, reports, table booking, shared ordering, Virtual Captain, online payments, chain, bulk import, coupons, CRM, campaigns, custom domain, priority support |
| **Enterprise** | Custom | API access, white-label |

**Billing cycles:** Monthly, quarterly, yearly (yearly ~40–48% savings vs monthly peers)  
**GST:** 18% added at checkout  
**No transaction fees** on SaaS subscription (vs competitors charging 1.5–2% on payments)

### Trial & lifecycle

- Trial defaults: menu, basic ordering, QR, tables  
- States: trial → active → grace → suspended  
- Per-restaurant **feature gating** via subscription  
- Go-live: partner checklist → subscription → platform owner approval → `customer_published = true`

### Platform admin console

- Restaurant onboarding & approval  
- Plan & feature matrix editing  
- Subscription management  
- Razorpay webhook handling  
- Campaign oversight  

---

## 18. Staff roles & access control

| Role | ID | Access summary |
|------|----|----------------|
| **Admin** | 1 | Full restaurant admin |
| **Manager** | 2 | Admin + service operations |
| **Worker** | 3 | Service / take order |
| **Customer** | 4 | Guest SPA |
| **Receptionist** | 5 | Reception, table requests, delivery |
| **Delivery person** | 6 | Delivery orders |
| **Chef** | 7 | Kitchen / KDS |
| **Partner** | 8 | Owner signup & setup |
| **Chain admin** | 9 | Multi-outlet chain |
| **Platform owner** | 10 | Peppar super-admin |

Role-based sidebar visibility and feature flags combine for granular access.

---

## 19. Integrations & infrastructure

| Integration | Purpose |
|-------------|---------|
| **PayU** | Guest online payments |
| **Razorpay** | SaaS subscription billing |
| **AWS S3** | Images, logos, assets |
| **AWS SNS** | Transactional SMS |
| **AWS SES** | Transactional & campaign email |
| **Spring Social** | Facebook, Twitter, Google login |
| **Google Maps** | Restaurant address linking |
| **ZXing + Flying Saucer** | QR PDF generation |
| **Sentry** | Error monitoring (frontend bootstrap) |
| **CometD** | Realtime push (orders, KDS, print, guest) |

**Not yet integrated:** Swiggy, Zomato, Tally, QuickBooks, WhatsApp Business API (marketing links only today).

---

## 20. Competitive differentiation (marketing angles)

Use these on the website, ads, and sales decks.

### vs. Petpooja & legacy POS

| Peppar advantage | Message |
|--------------------|---------|
| **All-inclusive pricing** | "₹599/mo — no add-on surprises. QR menu, KOT printing, and kitchen display included." |
| **Modern guest UX** | "First-class React ordering app — not a bolt-on. Guests order from their phone, no app install." |
| **Shared group ordering** | "Multiple diners, one table bill — each guest orders from their phone via PIN." |
| **Virtual Captain** | "An AI captain guides guests through menu, ordering, and status — like having staff at every table." |
| **Universal KOT printing** | "Any ESC/POS thermal printer. Network, USB, or Bluetooth via Merchant App. No proprietary hardware." |
| **QR-first dine-in** | "Scan → request table → order → kitchen — fully integrated, not a separate product." |
| **Rich feedback** | "Rate food, ambience, captain, and NPS — not just a star rating." |
| **Branded QR PDFs** | "Print beautiful table QR codes from built-in templates." |
| **Chain menu master** | "Define once, preview, push to all outlets — included in Pro, not enterprise-only." |
| **Transparent SaaS** | "True multi-tenant SaaS with self-serve subscriptions — not per-terminal licensing." |
| **Merchant App** | "Run your counter on an Android tablet with native Bluetooth receipt printing." |

### Honest boundaries (for trust)

- No offline billing mode yet  
- No Swiggy/Zomato aggregator sync yet  
- No dedicated iOS native app (web + Android Merchant App today)  

---

## 21. Copy-paste UI/UX design prompt

Use the block below as a prompt for Figma, v0, or any AI design tool.

---

**PROMPT START**

Design a complete UI/UX revamp for **Peppar** — a cloud restaurant POS and operations platform for India.

**Product:** Peppar helps restaurants run billing, kitchen, inventory, CRM, and guest-facing digital ordering from one platform. Target users: restaurant owners, managers, waitstaff, chefs, and dine-in guests on mobile.

**Surfaces to design:**

1. **Marketing website** (homepage, pricing, features, demo request, about, FAQs, contact)  
2. **Customer mobile web app** (restaurant home, menu, item detail, cart, order tracking, join-order PIN flow, Virtual Captain widget, reservations)  
3. **Staff / merchant console** (dashboard, fast billing POS, take order, ongoing orders, KDS, KOT printer settings, menu management, inventory, reports, marketing)  
4. **Peppar Merchant App (Android tablet)** — staff console optimized for touch + Bluetooth printer pairing UI  
5. **Partner onboarding** (multi-step restaurant setup, slug picker, subscription)  

**Must-highlight features on website:**

- Fast billing & POS with GST, coupons, split bills  
- **KOT thermal printing — works with ANY ESC/POS printer** (Epson, TVS, generic 58/80mm) via Print Agent (desktop) or Merchant App (Android Bluetooth)  
- Web kitchen display (KDS) with realtime updates  
- QR menu & table-side ordering — **no guest app download**  
- Shared / group ordering (multiple phones, one bill, PIN join)  
- Virtual Captain AI assistant (voice + chat for guests)  
- Multi-outlet & chain management with menu master push  
- Inventory, purchase orders, low-stock alerts  
- CRM, coupons, promotions, SMS/email campaigns  
- Rich guest feedback (food, ambience, captain, NPS)  
- Branded restaurant pages & QR PDF templates  
- Transparent pricing: Starter ₹599/mo, Pro from ₹1,299/mo (excl. GST)  

**Brand colors (strict):**

- Primary gold: `#F5C21A` — CTAs, accents, active states  
- Primary hover: `#D4A416`  
- Text on gold: `#1F2428` (charcoal, not pure black)  
- Page background: `#FFFFFF` or `#FAFAF8` (warm off-white)  
- Cards: `#FFFFFF`  
- Footer: `#1F2428` with `#F5C21A` top border accent  
- Secondary charcoal: `#1F2428` · Surface: `#F8F9FA`  
- Dark blue accent: `#002359` (links, secondary emphasis)  
- Text primary: `#1F2428` · secondary: `#4B5563` · muted: `#6B7280`  
- Success `#16A34A` · Error `#DC2626` · Warning `#F59E0B`  
- Font: Manrope  

**Design personality:** Warm, modern, trustworthy SaaS for hospitality. Gold + charcoal. Clean cards, generous whitespace, mobile-first guest flows. POS screens must be high-contrast and touch-friendly for busy service hours. Kitchen KDS should be dark-mode friendly with large type.

**Differentiation vs competitors (Petpooja, Posist):** Emphasize no add-on pricing surprises, superior guest mobile UX, group ordering, Virtual Captain, and universal printer support without proprietary hardware.

**Deliverables:** Design system (colors, type, buttons, forms, tables, badges, toasts), homepage hero + feature sections, pricing page, customer menu flow (3–5 key screens), fast billing POS layout, KOT printer settings page, Merchant App printer pairing screen, KDS board.

**PROMPT END**

---

## Appendix: Feature catalog (subscription keys)

| Key | Label | Scope | Tier |
|-----|-------|-------|------|
| `basic_ordering` | Basic Ordering | customer | Starter |
| `qr_code_menu` | QR Code Menu | customer | Starter |
| `table_booking` | Table Booking | customer | Pro |
| `shared_ordering` | Shared / Group Ordering | customer | Pro |
| `virtual_captain` | Virtual Captain | customer | Pro |
| `online_payments` | Online Payments | customer | Pro |
| `menu_management` | Menu Management | restaurant | Starter |
| `table_management` | Table & Location Management | restaurant | Starter |
| `kitchen_order_management` | Kitchen & Order Management | restaurant | Starter |
| `kot_printing` | KOT Thermal Printing | restaurant | Starter |
| `analytics_dashboard` | Analytics Dashboard | restaurant | Pro |
| `reports_export` | Reports & Export | restaurant | Pro |
| `chain_outlets` | Multi-Outlet / Chain | restaurant | Pro |
| `bulk_menu_import` | Bulk Menu Import | restaurant | Pro |
| `coupons_promotions` | Coupons & Promotions | restaurant | Pro |
| `customer_management` | Customer Management | restaurant | Pro |
| `marketing_campaigns` | Marketing Campaigns | restaurant | Pro |
| `inventory_management` | Inventory Management | restaurant | Pro |
| `feedback_surveys` | Order Feedback & Report | restaurant | Pro |
| `custom_domain` | Custom Domain | restaurant | Pro |
| `api_access` | API Access | restaurant | Enterprise |
| `white_label` | White-label Branding | restaurant | Enterprise |
| `email_support` | Email Support | restaurant | Starter |
| `priority_support` | Priority Support | restaurant | Pro |

---

## Related internal docs

- [KOT_PRINTING_GUIDE.md](./KOT_PRINTING_GUIDE.md) — hardware setup & troubleshooting  
- [VIRTUAL_CAPTAIN_GUIDE.md](./VIRTUAL_CAPTAIN_GUIDE.md) — AI assistant product spec  
- [POS_COMPETITIVE_ANALYSIS.md](./POS_COMPETITIVE_ANALYSIS.md) — competitive matrix  
- [DISCOUNT_SYSTEM_README.md](./DISCOUNT_SYSTEM_README.md) — discount engine  
- [STARTER_PRO_PRICING.md](../html-pages/docs/STARTER_PRO_PRICING.md) — pricing benchmarks  

---

*Document generated from Peppar codebase inventory — controllers, feature catalog, theme tokens, KOT guide, and customer/staff modules.*