☕ Smart Cafeteria System

A complete full-stack cafeteria management system built with Flask and MySQL featuring user authentication, shopping cart functionality, order management, reviews, coupons, and an admin dashboard.

---

📸 Screenshots

🏠 Homepage

🍽️ Menu Page

🛒 Cart Page

🔐 Login Page

📝 Register Page

👤 Profile Page

📊 Admin Dashboard

✨ Features

👤 User Features

• User Registration & Login
• Profile Management
• Change Password
• Order History Tracking
• Reorder Previous Orders
• Food Ratings & Reviews
• Coupon System

🛒 Shopping Features

• Browse Menu by Categories
• Search Food Items
• Shopping Cart Management
• Checkout System
• Multiple Payment Methods
• Order Confirmation

👑 Admin Features

• Dashboard Analytics
• Revenue Statistics
• Order Management
• Menu Item CRUD Operations
• Category Management
• User Management
• Search & Filtering

🎨 UI/UX

• Coffee-Themed Modern Design
• Fully Responsive Layout
• Toast Notifications
• Loading Skeletons
• Featured Item Badges
• Star Rating System

---

🛠️ Tech Stack

Backend

• Flask
• Flask-SQLAlchemy
• Flask-Login
• Flask-CORS
• PyMySQL
• Werkzeug

Frontend

• HTML5
• CSS3
• JavaScript
• Bootstrap 5
• jQuery
• Chart.js
• Font Awesome

Database

• MySQL 8.0+

---

📂 Database Tables

• users
• categories
• menu_items
• orders
• order_items
• cart
• reviews

---

🚀 Installation

1. Clone Repository

git clone https://github.com/Sara12-2/Smart_Cafeteria_Full_Stack_Website
cd smart-cafeteria-system

2. Create Virtual Environment

# Windows
python -m venv venv
venv\Scripts\activate

# Linux/macOS
python3 -m venv venv
source venv/bin/activate

3. Install Dependencies

pip install -r requirements.txt

4. Configure Environment Variables

Create a .env file:

SECRET_KEY=your_secret_key
DEBUG=False

MYSQL_HOST=localhost
MYSQL_USER=root
MYSQL_PASSWORD=your_password
MYSQL_DB=smart_cafeteria

5. Create Database

CREATE DATABASE smart_cafeteria;

6. Run Application

python app.py

7. Open Browser

http://localhost:5000

---

📁 Project Structure

Smart_Cafeteria_System/
│
├── app.py
├── config.py
├── models.py
├── requirements.txt
├── .env.example
│
├── routes/
│   ├── auth.py
│   ├── menu.py
│   ├── cart.py
│   ├── orders.py
│   └── admin.py
│
├── templates/
│   ├── index.html
│   ├── menu.html
│   ├── cart.html
│   ├── orders.html
│   ├── profile.html
│   ├── login.html
│   ├── register.html
│   └── admin.html
│
├── static/
│   ├── css/
│   ├── js/
│   └── images/
│
└── database/
    └── schema.sql

---

🔗 API Endpoints

Authentication

Method	Endpoint
POST	/auth/login
POST	/auth/register
GET	/auth/logout
GET	/auth/status
GET	/auth/profile
PUT	/auth/profile
PUT	/auth/change-password

Menu

Method	Endpoint
GET	/api/menu/items
GET	/api/menu/categories
GET	/api/menu/items/popular
GET	/api/menu/items/featured
POST	/api/menu/reviews

Cart

Method	Endpoint
GET	/api/cart
POST	/api/cart/add
PUT	/api/cart/update
DELETE	/api/cart/remove
POST	/api/cart/checkout

Orders

Method	Endpoint
GET	/api/orders
GET	/api/orders/
PUT	/api/orders//cancel
POST	/api/orders//reorder

Admin

Method	Endpoint
GET	/api/admin/stats
GET	/api/admin/orders
PUT	/api/admin/orders//status
POST	/api/admin/menu
PUT	/api/admin/menu/
DELETE	/api/admin/menu/

---

💳 Coupon Codes

Code	Discount
WELCOME20	20% OFF
CAFE10	10% OFF

---

🔧 Troubleshooting

Issue	Solution
Module Not Found	Install requirements
Database Error	Check .env credentials
MySQL Connection Failed	Start MySQL Service
Login Failed	Verify User Exists
Port Already In Use	Change Flask Port

---

🚀 Future Enhancements

• Image Uploads
• Real-Time Order Tracking
• Email Notifications
• PDF Invoice Generation
• Loyalty Points System
• Wishlist Feature
• Dark Mode
• Progressive Web App (PWA)

---

🤝 Contributing

1. Fork Repository
2. Create Feature Branch
3. Commit Changes
4. Push Changes
5. Open Pull Request

---

📄 License

This project is licensed under the MIT License.

---

👩‍💻 Author

Sara Manzoor

GitHub: https://github.com/Sara12-2

---

⭐ Support

If you found this project helpful, please consider giving it a star on GitHub.

Made with ☕ and ❤️ by Sara