Mr. Chicken Platform

📋 Project Overview

Mr. Chicken is a full-stack restaurant management platform designed for a chicken specialty restaurant in Addis Ababa, Ethiopia. The system provides a modern digital menu experience for customers while offering comprehensive order management, kitchen operations, and business analytics for restaurant staff. It solves the challenge of traditional paper menus and manual order tracking by digitizing the entire customer-to-kitchen workflow.

✨ Key Features

Customer-Facing Features

• Interactive Digital Menu - Real-time availability and pricing updates
• Category-Based Browsing - Organized by appetizers, main courses, desserts, and beverages
• Ratings & Reviews - Customer feedback system with 1-5 star ratings
• Customer Engagement - Feedback forms and contact submission
• Multi-Branch Support - Location-specific information and services
• Quick Order - Fast ordering functionality for improved service speed
• SEO Optimization - Structured data (Schema.org) for enhanced discoverability

Admin Dashboard Features

• Order Management - Real-time order tracking with status updates
• Kitchen Display System - Item-level preparation tracking
  • Status flow: Pending → In Progress → Cooking → Ready → Served
• Menu Management - Full CRUD operations with image uploads
• Category Management - Organize menu items efficiently
• Price History Tracking - Complete audit trail for pricing changes
• Multi-Branch Management - Centralized control across locations
• Employee Management - Staff assignments with role-based access
• Customer Management - Order history and customer insights
• Analytics Dashboard - Sales trends, top items, and customer metrics
• Payment Processing - Multiple payment methods (cash, card, mobile)
• Role-Based Access Control (RBAC) - Granular permission management

Business Intelligence

• Sales Analytics - Monthly trends and revenue tracking
• Order Distribution - Category-based performance analysis
• Top-Selling Items - Data-driven menu optimization
• Customer Segmentation - New vs. returning customer analysis
• Feedback Analysis - Ratings aggregation and sentiment tracking

🏗️ Architecture

The system follows a clean three-tier architecture:

Component Interaction

• Frontend (Next.js) → Handles UI/UX and SEO optimization
• Backend (NestJS) → Processes orders, manages inventory, handles authentication
• Database (MySQL) → Stores menu items, orders, users, branches, and analytics data

🛠️ Tech Stack

Frontend Technologies

• Next.js 15, TypeScript, Tailwind CSS, Radix UI, TanStack Query, Zustand

Backend Technologies

• NestJS, TypeORM, JWT & Passport, Swagger

Database & DevOps

• MySQL, Docker, Docker Compose, TypeORM Migrations

🎯 Notable Implementations

1. Price History Tracking

Automatic audit trail for all price changes with user attribution, reason logging, change type classification, and effective dating.

2. Kitchen Item Status Management

Granular tracking of individual order items through the preparation pipeline (PENDING → IN_PROGRESS → COOKING → READY → SERVED).

3. Role-Based Access Control (RBAC)

Flexible permission system with predefined roles for Admins, Managers, Staff, and Customers.

4. SEO Optimization

Comprehensive search engine optimization strategy with server-side rendering, structured data markup, and automatic sitemap generation.

5. Multi-Branch Support

Complete branch management system enabling scalable operations across multiple locations with independent operating hours and menus.

💼 Use Case

Designed for fast-casual dining establishments, multi-location restaurants, and high-volume operations requiring efficient order processing. The platform streamlines restaurant operations resulting in reduced errors, improved efficiency, enhanced customer experience, and data-driven decisions.