# EZ-RMS (by INS Technology)
> Next-Generation Multi-Tenant Restaurant Management System & Operating SaaS

EZ-RMS is an all-in-one smart restaurant operating system featuring 100m GPS-geofenced dynamic QR ordering, real-time Kitchen Display Systems (KDS), automated recipe-linked inventory portion depletion, and an Agentic Google Gemini AI suite.

- Main Website: https://ezrms.instechnepal.com
- Restaurant Portal / POS: https://app.ezrms.instechnepal.com
- Super Admin SaaS Portal: https://admin.ezrms.instechnepal.com
- Documentation: https://ezrms.instechnepal.com/documentation

## Core Capabilities & Architecture

### 1. Contactless Dynamic QR Dine-In Ordering
- Dynamic expiring QR tokens with embedded [resOwner:tableId:timestamp] signature.
- Strict 100m GPS proximity verification stopping fraudulent off-premise orders.
- Multi-guest headcount (peopleCount) session binding and real-time consolidated cart.
- Live order status tracker: in-progress -> preparing -> ready -> completed.
- Flexible payment methods: Cash, Credit Card, Online Gateway, or Table Account tab.

### 2. Live Kitchen Display System (KDS)
- Real-time WebSocket order delivery (< 40ms latency) to kitchen cooking stations.
- Interactive multi-station status management with audio alert notifications.
- Cooking timers with visual color alerts for delayed tickets.

### 3. Agentic Gemini AI Suite
- Bi-directional Hands-Free Voice Assistant powered by Web Speech API (STT/TTS) and Google Gemini AI.
- Predictive Inventory Stockout Forecasts incorporating Japanese dining culinary seasonality.
- AI Culinary & Menu Consultant recommending high-margin dishes and copywriting improvements.
- Dynamic Menu Pricing strategist based on cost-per-dish margins and sales volume.
- Automated 7-Day Staff Roster Scheduler matching employee skills with peak shift demands.
- Strict RMS Boundary Guardrails: Safe refusal of non-restaurant operational questions (OWASP LLM01/LLM02).

### 4. Recipe-Linked Smart Inventory
- Raw ingredients linked directly to menu items with precise portion ratios (grams, ml, slices).
- Automated inventory depletion executed immediately at the point of order placement.
- Cost per dish tracking with real-time calculated gross profit margin percentages.
- Supplier directory with reorder alert generation.

### 5. Multi-Currency, Localization & POS Financials
- Built-in multi-currency switching: Japanese Yen (JPY ¥), US Dollars (USD $), Nepalese Rupees (NPR Rs.).
- Tax engine supporting inclusive and exclusive sales taxes plus custom service charges.
- Automated daily closing balance reconciliations (Opening cash, closing cash, sales by payment type, expenses by category, net profit).
- Server-side executive summary branded PDF report exports (PDFKit).

### 6. IoT Hardware & Electronic Shelf Label (ESL) Sync
- Sub-second MQTT broadcasting over topic `esl/table/{tableId}` via HiveMQ broker.
- Dynamic table e-ink displays showing table IDs, reservation states, and refreshed QR codes.
- KOT thermal printer status telemetry and paper roll level tracking.

### 7. SaaS Multi-Tenant Platform Administration
- Super Admin management of restaurant tenants, subscription tiers, and 14-day free trials.
- Real-time system monitoring, hardware device ping telemetry, and SaaS revenue analytics.

## Technology Stack
- Backend: Node.js, Express.js (v4.21), MongoDB, Mongoose, Socket.io, MQTT, Google Generative AI SDK, PDFKit, Nodemailer.
- Security: Helmet, NoSQL Sanitization, HPP, Multi-Tier Rate Limiting, Brute Force Account Lockout, 6-digit numeric OTPs.
- Frontends: React 18, TypeScript, Vite, TailwindCSS, Radix UI / Shadcn, TanStack Query, Recharts, Framer Motion.

## Contact & Inquiries
- Provider: INS Technology
- Website: https://ezrms.instechnepal.com
- Support Email: support@ezrms.instechnepal.com