A full-stack restaurant management platform with digital menu, QR-based table ordering, and real-time order tracking. Built with a Go backend and Next.js frontend, MaMenu enables multi-hotel operations with role-based access, WebSocket-powered live updates, and a public-facing digital menu for customers.

• Multi-Role Authentication - Super Admin and Hotel Admin roles with JWT-based auth
• Multi-Hotel Support - Single owner can manage multiple hotels and switch between them
• Digital Menu Management - Hierarchical categories, veg/non-veg tags, pricing, availability toggling
• QR Code Table System - Auto-generated QR codes per table linking to the public digital menu
• Real-Time Order Tracking - WebSocket-powered live order status updates for both admins and customers
• Public Ordering - Customers scan a QR code, browse the menu, and place orders without logging in
• Order Workflow - Full lifecycle: Pending > Confirmed > Preparing > Ready > Completed / Cancelled
• Table Management - Bulk creation, capacity tracking, occupied/vacant status
• Soft Deletes - Resources are deactivated rather than permanently deleted

ma-menu/
├── MaMenu_FE/                       # Next.js Frontend
│   ├── app/
│   │   ├── login/                   # Login page
│   │   ├── admin/                   # Super admin dashboard
│   │   │   ├── hotel-owners/        # Manage hotel owners
│   │   │   └── hotels/              # Manage hotels
│   │   ├── hotel/                   # Hotel admin dashboard
│   │   │   └── [hotel_id]/
│   │   │       ├── menu/            # Menu items CRUD
│   │   │       ├── tables/          # Table management + QR codes
│   │   │       ├── categories/      # Category management
│   │   │       └── orders/          # Order management
│   │   └── menu/[hotel_id]/         # Public menu (customer-facing)
│   ├── components/                  # Shared UI components
│   ├── lib/
│   │   ├── api.ts                   # API client
│   │   └── auth.ts                  # JWT token management
│   └── types/                       # TypeScript interfaces
│
└── MaMenu_BE/                       # Go Backend
    ├── cmd/server/main.go           # Entry point
    ├── models/                      # MongoDB data models
    ├── components/
    │   ├── middleware/auth.go        # JWT auth middleware
    │   ├── router/                  # Route definitions
    │   └── services/                # Business logic
    │       ├── auth/
    │       ├── admin/
    │       └── hotelowner/
    ├── pkg/
    │   ├── storage/
    │   │   ├── mongodb/             # MongoDB connection
    │   │   └── database/            # Database operations
    │   ├── ws/                      # WebSocket hub
    │   ├── logger/                  # Structured logging
    │   └── utils/
    ├── config/config.go             # Config loader
    └── Dockerfile

• Go 1.25+
• Node.js 18+
• npm
• MongoDB (local or Atlas)

cd MaMenu_BE

# Install dependencies
go mod tidy

# Configure environment
cp .env.example .env
# Edit .env with your MongoDB URI and JWT secret

# Run the server
go run cmd/server/main.go

Backend runs on http://localhost:8080

cd MaMenu_FE

# Install dependencies
npm install

# Configure environment
# Create .env.local with:
# BACKEND_URL=http://localhost:8080
# NEXT_PUBLIC_WS_URL=ws://localhost:8080

# Run the dev server
npm run dev

Frontend runs on http://localhost:3000

PORT=8080

# MongoDB
MONGO_URI=mongodb+srv://<user>:<password>@<cluster>.mongodb.net/<db>?retryWrites=true&w=majority
MONGO_MAX_POOL_SIZE=50
MONGO_CONNECT_TIMEOUT=10
MONGO_MAX_IDLE_TIME=30

# Auth
JWT_SECRET=your_strong_secret_here

# Logging
LOG_ENABLED=true
APP_LOG_FILE=logs/app.log
AUDIT_LOG_FILE=logs/audit.log
APP_LOG_LEVEL=2
AUDIT_LOG_LEVEL=3

BACKEND_URL=http://localhost:8080
NEXT_PUBLIC_WS_URL=ws://localhost:8080

cd MaMenu_BE
docker build -t mamenu-backend .
docker run -p 8080:8080 --env-file .env mamenu-backend

1. Super Admin creates hotel owners and assigns hotels to them
2. Hotel Admin logs in, sets up tables, categories, and menu items
3. QR codes are generated for each table - printed and placed on physical tables
4. Customers scan the QR code, browse the digital menu, and place orders
5. Hotel Admin receives orders in real-time via WebSocket and updates order status
6. Customers can track their order status live

• Redis caching layer
• Image upload for menu items
• Analytics dashboard
• Payment gateway integration
• Push notifications
• Docker Compose for full-stack deployment
• CI/CD pipeline

1. Fork the repo
2. Create your feature branch (git checkout -b feature/your-feature)
3. Commit your changes
4. Push to your branch
5. Open a Pull Request

This project is licensed under the MIT License.

Sirisolla Jaya Surya

Backend Engineer | Go, Kafka, Microservices | Passionate about scalable systems and distributed architecture