# beanthere - Comprehensive Platform Documentation for Language Models

> Full technical specification, architectural blueprint, ROI economics, and operational documentation for beanthere (https://beanthere.co.in).

---

## 1. Executive Summary & Mission
beanthere is a modern customer growth engine and digital dining platform built specifically for independent cafes, specialty coffee roasters, and restaurants across India. 

Traditional food delivery aggregators deduct **25% to 30%** from every order, mask customer contact information, and lock merchants into fee-driven dependency. beanthere eliminates third-party commission cuts through a direct web-based ecosystem operating on a flat monthly subscription model (₹499/month).

---

## 2. Multi-Tenant Platform Architecture
1. **Domain Routing & Subdomain Matching**:
   - Main Platform: `https://beanthere.co.in` (Merchant marketing, explore hub, onboarding, pricing, legal).
   - Tenant Outlets: `https://[slug].beanthere.co.in` (Custom branded digital storefronts, table QR sessions, menu catalogs, food moments).
   - Dashboard Subdomain: `https://dashboard.beanthere.co.in` (Kitchen Display Systems, POS floor maps, analytics, menu manager).
2. **Frictionless QR Table Sessions**:
   - Guests scan a table QR code to launch an instant PWA web session.
   - Requires **0 app downloads** or upfront registration.
   - Orders route directly to kitchen display screens with web audio chimes and table location tags.
3. **Dual Fulfillment Architecture**:
   - **Dine-In QR Sessions**: Table-side browsing, item customization (milk types, roast levels, add-ons), and instant kitchen dispatch.
   - **Takeaway & Pickup Storefront**: Direct WhatsApp order injection, Instagram bio link storefronts, and takeaway time slots.
   - **D2C & Specialty Retail**: Multi-variant merchandise catalog (coffee beans, apparel, packaged goods) with stock level tracking.

---

## 3. Customer Retention & Bites XP Engine
- **Non-Monetary Loyalty Unlocks**: Guests earn **Bites XP** points by reviewing ordered items, leaving verified dining feedback, and uploading dish photos ("Food Moments").
- **Zero-Liability for Merchants**: Merchants define custom item perks (e.g. 500 XP = 1 Free Cortado) instead of issuing margin-destroying cash discounts.
- **100% Owned Customer Profiles**: Merchant dashboards store guest phone numbers, visit frequency, and average order value (AOV) for direct WhatsApp re-engagement.

---

## 4. Merchant Financial & ROI Comparison Ledger

| Operational Dimension | beanthere Platform | Traditional Delivery Aggregators |
| :--- | :--- | :--- |
| **Commission Per Order** | **0% Commission** | 25% – 30% Cut per order |
| **Pricing Model** | Flat ₹499/month Subscription | Percentage deduct on revenue |
| **Guest Data Ownership** | **100% Owned** by Merchant | Platform locked & encrypted |
| **Access Friction** | Instant Web-QR (No App Needed) | Forced App Download |
| **Payout Speed** | Direct Instant UPI Settlement | Weekly / Delayed payouts |
| **Monthly Savings (100 orders/day @ ₹350 AOV)** | **₹2,94,000 Saved / Month** | Lost to commissions |

---

## 5. Security, Trust & Compliance Standards
- **DPDPA 2023 Compliant**: Diners can browse menus anonymously. Sessions use HMAC signed tokens.
- **Row-Level Security (RLS)**: PostgreSQL database tables in Supabase enforce strict tenant isolation per store ID.
- **Encryption**: TLS 256-bit encryption in transit for all APIs and session cookies.

---

## 6. Official Contact & Brand References
- **Brand Banner (16:9)**: `https://beanthere.co.in/beantherebanner.jpg`
- **Brand Logo (1:1 Circular)**: `https://beanthere.co.in/beanthere-logo.png`
- **Brand Logo (1:1 Square)**: `https://beanthere.co.in/beanthere.jpg`
- **Official Website**: https://beanthere.co.in
- **Founder Contact Email**: nitishpradhan66@gmail.com
- **WhatsApp Support Desk**: +91 99717 67228