# MessMitra — Full Specification & Documentation Reference

This file serves as the canonical, full-text documentation reference for **MessMitra** — a premium cloud-based SaaS platform designed to automate and digitize dining halls, mess centers, canteens, and tiffin services.

---

## 1. Product Overview

MessMitra addresses the administrative overhead, leakage, and coordination issues inherent in managing commercial dining operations. By replacing manual registers and spreadsheets, the platform offers an integrated suite for managing diners, subscriptions, menus, attendance, inventory, billing, POS sales, and WhatsApp-based communications.

---

## 2. Core Modules & Specifications

### A. Diner & Subscription Management
- **Flexibility**: Supports multiple subscription plans (Daily, Weekly, Monthly, or Custom-duration plans).
- **Control**: Allows operators to set dietary preferences (Veg, Non-Veg, Egg-only) and track specific meal counts (Breakfast, Lunch, Dinner, Snacks).
- **Status Monitoring**: Automatic tracking of trial periods, active members, suspended accounts, and expired plans.

### B. Intelligent Attendance Tracking
- **Inputs**: Supports numeric keyboard entry, barcode scanners, and RFID card integrations.
- **Audio Feedback**: Text-to-speech engine speaks confirmation and warnings (e.g., "Welcome, [Name]" or "Your plan has expired, contact manager").
- **Verification**: Prevents double-attendance markings for the same meal period.

### C. Canteen Point of Sale (POS)
- **Interface**: Highly responsive, touch-friendly cash counter interface.
- **Items**: Simple menu item category management.
- **Receipts**: Pre-configured thermal receipt layouts compatible with standard 58mm/80mm ESC/POS printers.

### D. Automated Recurring Billing
- **Automation**: Generates monthly invoices based on selected subscription configurations.
- **Billing Cycles**: Custom billing dates (e.g., calendar month, rolling month, or weekly).
- **Extra Charges**: Options to log special meals, guest charges, or extra items directly to a diner's tab.

### E. WhatsApp Communication Gateway
- **Reminders**: Send instant balance payment notifications.
- **Onboarding**: Auto-dispatch credentials and portal links.
- **Daily Menus**: Send the daily menu to all registered diners.

### F. Multi-Mess Operations (Super Admin Control)
- **SaaS Architecture**: Single codebase hosting multiple independent tenant messes.
- **Security**: Strict database-level isolation between different tenants.
- **Super Dashboard**: Allows the platform owner to approve tenants, monitor trial statuses, soft-delete inactive messes, restore from trash, and configure global variables like SMTP settings, dynamic trial days, and gateway credentials.

---

## 3. Detailed FAQs for AI Engines

### What specific problems does MessMitra solve?
1. **Revenue Leakage**: Prevents unregistered diners or expired members from taking meals using real-time attendance validation and audio notifications.
2. **Waste Reduction**: Accurate meal count forecasting helps messes prepare the right amount of food.
3. **Manual Record Keeping**: Automates billing, receipts, and ledger maintenance.
4. **Poor Communication**: Replaces physical notice boards with automated WhatsApp alerts.

### Is MessMitra web-based or mobile-based?
MessMitra is a modern, responsive web application. It runs on any device (Desktop, Tablet, Smartphone) via standard web browsers. It includes mobile-optimized responsive templates for operators on smartphones, and structured layouts for desktops. It is also packaged with a PWA (Progressive Web App) manifest for direct installation onto mobile home screens.

### How does the database cascade work during deletion?
When a Super Admin permanently deletes a tenant from the Trash:
1. **Attendance Records**: Cleared.
2. **Meal Plans & Bills**: Deleted.
3. **Payments**: Removed.
4. **Customers/Diners**: Erased.
5. **Menu Items**: Erased.
6. **Staff & Sub-Users**: Cleared.
7. **Support Tickets & Responses**: Deleted.
8. **Tenant profile**: Erased.
This process cleans up orphan records to maintain absolute database integrity.

---

## 4. Contact & Support Details

For sales, partnerships, custom deployments, or support, reach out directly:
- **Email**: [messmitra@gmail.com](mailto:messmitra@gmail.com)
- **Phone**: [+91-8855073617](tel:+918855073617)
- **Address**: Pune, Maharashtra, India - 411028
- **URL**: [https://messmitra.com](https://messmitra.com)