🍕 PizzaZing - Full-Stack Pizza Delivery App

"Zing in Every Bite!" ⚡

A production-ready, full-stack pizza delivery application built with React, Node.js, Express, MongoDB, and integrated payment processing via Razorpay. Features real-time order tracking with Socket.IO, email notifications, role-based authentication, and a modern responsive UI.

---

📋 Table of Contents

• Features
• Tech Stack
• Architecture
• Getting Started
• Environment Variables
• API Endpoints
• Database Schema
• Real-Time Features
• Future Improvements

---

Test Credentials

Role	Email	Password
Customer	test@pizzazing.com	test123
Admin	admin@pizzazing.com	admin123

---

✨ Features

Customer Features

• 🔐 JWT Authentication with email verification & password reset
• 🍕 Browse Menu with category filters (Veg, Non-Veg, Premium, Cheese Lovers)
• 📐 Size Selection - Small, Medium, Large with dynamic pricing
• 🛠️ Custom Pizza Builder - Build your own pizza step-by-step
• 💳 Razorpay Integration - Secure payment processing (Test Mode supported)
• 📦 Real-Time Order Tracking - Live status updates via WebSocket
• 📧 Email Notifications - Order confirmation, status updates, delivery alerts
• 📱 Responsive Design - Works seamlessly on mobile, tablet, desktop

Admin Features

• 📊 Admin Dashboard - Overview of all orders, inventory, alerts
• 🔄 Order Management - Update order status through the pipeline
• 📦 Inventory Management - Track ingredient stock levels, set thresholds
• ⚠️ Low Stock Alerts - Real-time notifications when stock runs low
• 👥 Customer View - See customer details, order history

Technical Features

• 🔄 Real-Time Updates - Socket.IO for instant notifications
• 🛡️ Role-Based Access Control - Admin vs Customer permissions
• 📧 Nodemailer Integration - SMTP email service
• 🔒 Secure Password Hashing - bcrypt with salt rounds
• 📝 Input Validation - Server-side validation on all endpoints
• 🔁 Stock Management - Automatic inventory deduction on orders

---

🛠️ Tech Stack

Frontend

Technology	Purpose
React 18	UI Library
React Router v6	Client-side routing
Tailwind CSS 3	Styling framework
Vite	Build tool & dev server
Axios	HTTP client
Socket.IO Client	Real-time communication

Backend

Technology	Purpose
Node.js 18+	Runtime environment
Express 5	Web framework
MongoDB + Mongoose	Database & ODM
Socket.IO	WebSocket server
JWT	Authentication tokens
bcrypt	Password hashing
Razorpay SDK	Payment processing
Nodemailer	Email service

---

🏗️ Architecture

┌─────────────────────────────────────────────────────────────────┐
│                         CLIENT (React)                          │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────────┐  │
│  │   Pages     │  │ Components  │  │     Context/Hooks       │  │
│  │ - Login     │  │ - Navbar    │  │ - AuthContext           │  │
│  │ - Dashboard │  │ - PayBtn    │  │ - useSocket             │  │
│  │ - Admin     │  │ - Timeline  │  │ - useToast              │  │
│  │ - Builder   │  │ - Toast     │  │ - usePayment            │  │
│  └─────────────┘  └─────────────┘  └─────────────────────────┘  │
└───────────────────────────┬─────────────────────────────────────┘
                            │ HTTP + WebSocket
┌───────────────────────────▼─────────────────────────────────────┐
│                       SERVER (Express)                          │
│  ┌─────────────────────────────────────────────────────────┐    │
│  │                      Middleware                         │    │
│  │         (CORS, Auth, Admin Check, Error Handler)        │    │
│  └─────────────────────────────────────────────────────────┘    │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────────┐  │
│  │   Routes    │  │  Helpers    │  │      Socket.IO          │  │
│  │ - /auth     │  │ - emailSvc  │  │ - order updates         │  │
│  │ - /orders   │  │ - pricing   │  │ - payment events        │  │
│  │ - /pizzas   │  │ - notifier  │  │ - inventory alerts      │  │
│  │ - /payment  │  │ - socketCfg │  │ - admin broadcasts      │  │
│  │ - /inventory│  │             │  │                         │  │
│  └─────────────┘  └─────────────┘  └─────────────────────────┘  │
└───────────────────────────┬─────────────────────────────────────┘
                            │
┌───────────────────────────▼─────────────────────────────────────┐
│                        MongoDB                                  │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌───────────┐  │
│  │  Users  │ │ Orders  │ │ Pizzas  │ │Payments │ │Ingredients│  │
│  └─────────┘ └─────────┘ └─────────┘ └─────────┘ └───────────┘  │
└─────────────────────────────────────────────────────────────────┘

---

🚀 Getting Started

Prerequisites

• Node.js 18+
• MongoDB (local or Atlas)
• Razorpay account (for payments)
• SMTP credentials (for emails)

Installation

1. Clone the repository

git clone https://github.com/yourusername/pizzazing.git
cd pizzazing

2. Install backend dependencies

cd backend
npm install

3. Install frontend dependencies

cd ../frontend
npm install

4. Set up environment variables (see Environment Variables)

5. Seed the database

cd backend
node test/seedPizzaZing.js

6. Start the backend server

npm run dev
# Server runs on http://localhost:5000

7. Start the frontend (new terminal)

cd frontend
npm run dev
# App runs on http://localhost:5173

---

🔐 Environment Variables

Create a .env file in the backend directory:

# Server
PORT=5000
NODE_ENV=development

# MongoDB
MONGODB_URI=mongodb://localhost:27017/pizza_app

# JWT
JWT_SECRET=your-super-secret-jwt-key-here
JWT_EXPIRES_IN=7d

# Razorpay (Get from Razorpay Dashboard)
RAZORPAY_KEY_ID=rzp_test_xxxxxxxxxxxxx
RAZORPAY_KEY_SECRET=your-razorpay-secret

# Email (SMTP)
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_USER=your-email@gmail.com
SMTP_PASS=your-app-password

# Frontend URL (for email links)
FRONTEND_URL=http://localhost:5173

---

📡 API Endpoints

Authentication

Method	Endpoint	Description	Auth Required
POST	/api/auth/register	Register new user	🔓 Public
POST	/api/auth/login	Login & get JWT	🔓 Public
GET	/api/auth/verify-email	Verify email token	🔓 Public
POST	/api/auth/forgot-password	Request password reset	🔓 Public
POST	/api/auth/reset-password	Reset password with token	🔓 Public
GET	/api/auth/me	Get current user	🔐 JWT

Pizzas

Method	Endpoint	Description	Auth Required
GET	/api/pizzas	Get all pizza presets	🔐 JWT
GET	/api/pizzas/:id	Get single pizza	🔐 JWT

Orders

Method	Endpoint	Description	Auth Required
POST	/api/orders/create-preset	Create order from preset	🔐 JWT
POST	/api/orders/create-custom	Create custom pizza order	🔐 JWT
GET	/api/orders/my	Get user's orders	🔐 JWT
GET	/api/orders/:id	Get order details	🔐 JWT
GET	/api/orders/admin	Get all orders (Admin)	👑 Admin
PATCH	/api/orders/admin/:id/status	Update order status (Admin)	👑 Admin

Payments

Method	Endpoint	Description	Auth Required
POST	/api/payments/create	Create Razorpay order	🔐 JWT
POST	/api/payments/verify	Verify payment signature	🔐 JWT

Inventory

Method	Endpoint	Description	Auth Required
GET	/api/inventory/public	Get available ingredients	🔐 JWT
GET	/api/inventory/ingredients	Get all ingredients (Admin)	👑 Admin
PUT	/api/inventory/ingredients/:id	Update ingredient (Admin)	👑 Admin

---

🗄️ Database Schema

User

{
  name: String,
  email: String (unique),
  password: String (hashed),
  role: 'user' | 'admin',
  isVerified: Boolean,
  verificationToken: String,
  resetPasswordToken: String,
  resetPasswordExpires: Date,
  phone: String,
  addresses: [{ label, street, city, state, pincode, isDefault }],
  favorites: [ObjectId -> PizzaPreset],
  loyaltyPoints: Number,
  totalOrders: Number
}

Order

{
  user: ObjectId -> User,
  items: [{
    type: 'preset' | 'custom',
    preset: ObjectId -> PizzaPreset,
    ingredients: [ObjectId -> Ingredient],
    name: String,
    price: Number,
    quantity: Number,
    size: 'small' | 'medium' | 'large'
  }],
  size: String,
  totalAmount: Number,
  paymentStatus: 'pending' | 'paid' | 'failed' | 'refunded',
  orderStatus: 'pending' | 'received' | 'in_kitchen' | 'out_for_delivery' | 'delivered' | 'cancelled',
  razorpayOrderId: String,
  razorpayPaymentId: String,
  deliveryAddress: Object,
  estimatedDelivery: Date,
  rating: Number,
  review: String
}

PizzaPreset

{
  name: String (unique),
  description: String,
  category: 'veg' | 'non-veg' | 'premium' | 'cheese-lovers',
  basePrice: Number,
  prices: { small: Number, medium: Number, large: Number },
  ingredients: [ObjectId -> Ingredient],
  isActive: Boolean,
  isBestseller: Boolean,
  isNewArrival: Boolean,
  spiceLevel: 'mild' | 'medium' | 'hot' | 'extra-hot',
  rating: Number,
  totalOrders: Number
}

Ingredient

{
  name: String (unique),
  type: 'base' | 'sauce' | 'cheese' | 'veggie' | 'meat',
  price: Number,
  stock: Number,
  threshold: Number,
  isActive: Boolean
}

---

🔄 Real-Time Features

The app uses Socket.IO for real-time communication:

Events Emitted by Server

Event	Payload	Description
ORDER_STATUS_UPDATE	{ orderId, status, updatedAt }	Order status changed
PAYMENT_SUCCESS	{ orderId, paymentId }	Payment completed
NEW_ORDER_CREATED	{ orderId, user, totalItems }	New order (to admins)
LOW_STOCK_ALERT	{ name, stock, threshold }	Ingredient low (to admins)

Rooms

• user-{userId} - Personal notifications for each user
• admin - Admin-only notifications
• order-{orderId} - Order-specific updates

---

Customer Dashboard

Modern UI with category filters, size selection, and real-time order tracking

Custom Pizza Builder

Step-by-step wizard: Base → Sauce → Cheese → Toppings → Review

Admin Dashboard

Order management, inventory tracking, low stock alerts

Order Tracking

Visual timeline showing order progress from received to delivered

---

🔮 Future Improvements

• Add Google/Facebook OAuth login
• Implement order scheduling (pre-order for later)
• Add promo codes & discount system
• Delivery partner assignment & tracking
• Customer reviews & ratings on pizzas
• Push notifications (PWA)
• Order history analytics for admins
• Multi-language support (i18n)

---

📁 Project Structure

pizzazing/
├── backend/
│   ├── controllers/          # Business logic
│   ├── helpers/              # Utility functions
│   │   ├── emailService.js   # Nodemailer setup
│   │   ├── notificationManager.js
│   │   ├── orderPricing.js
│   │   └── socketIOConfig.js
│   ├── middleware/           # Auth, admin checks
│   ├── models/               # Mongoose schemas
│   │   ├── user.js
│   │   ├── order.js
│   │   ├── pizza.js
│   │   ├── PizzaPreset.js
│   │   ├── ingredient.js
│   │   └── payment.js
│   ├── routes/               # API routes
│   ├── test/                 # Test scripts & seeders
│   └── server.js             # Entry point
│
├── frontend/
│   ├── src/
│   │   ├── api/              # Axios instance
│   │   ├── components/       # Reusable components
│   │   ├── context/          # React context (Auth)
│   │   ├── hooks/            # Custom hooks
│   │   ├── pages/            # Route pages
│   │   └── main.jsx          # Entry point
│   ├── index.html
│   ├── tailwind.config.js
│   └── vite.config.js
│
└── README.md

---

🧪 Testing

# Run seed script
cd backend
node test/seedPizzaZing.js

# Health check
curl http://localhost:5000/api/health

# Run smoke tests
npm run smoke

PizzaZing - Where every slice tells a story 🍕✨