🌟 Overview CampusHub is a production-ready cafeteria management system designed to modernize university cafeteria operations. Built from scratch over 2 weeks with 3,500+ lines of code, it addresses real-world inefficiencies observed at PAF-IAST campus by providing a seamless digital ordering experience.
🎯 Key Highlights Real-time order tracking with visual progress indicators
Four distinct user roles with specialized dashboards
Persistent shopping cart across browser sessions
Complete authentication & authorization system
Responsive design for all devices
Role-based UI with dynamic updates
🚀 Features 👥 Multi-Role System Role Capabilities Students Browse menu, place orders, track deliveries, manage wallet Teachers All student features + special privileges Administrators Manage menu, view all orders, generate reports, user management Kitchen Staff View pending orders, update preparation status 🛠️ Technical Features ✅ Real-time order tracking with color-coded progress bars
✅ Dark/Light theme toggle with persistent preference
✅ Toast notifications for user feedback
✅ Discount/Offer system with code validation
✅ Wallet system for cashless payments
✅ Admin dashboard with comprehensive statistics
✅ Kitchen interface for order preparation tracking
✅ Search & filter functionality across menu
✅ Shopping cart with persistent storage
🏗️ Architecture text ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ │ Frontend │ │ Backend │ │ Database │ │ │ │ │ │ │ │ • HTML5/CSS3 │◄───►│ • Python Flask │◄───►│ • SQLite3 │ │ • Vanilla JS │ │ • REST API │ │ • 8 Tables │ │ • Bootstrap 5 │ │ • 25+ Endpoints │ │ • Relationships │ │ • Animate.css │ │ • JWT Sessions │ │ • Indexes │ └─────────────────┘ └─────────────────┘ └─────────────────┘ 📊 Database Schema sql users menu_items orders cart ───────── ─────────── ──────── ─────── • id • id • id • id • username • name • user_id • user_id • email • category • total • item_id • password_hash • price • status • quantity • role • description • created_at • added_at • balance • preparation_time • delivery_option • is_active • rating 🛠️ Technology Stack Frontend HTML5 - Semantic structure
CSS3 - Styling with animations
Vanilla JavaScript - 3,500+ lines of interactive logic
Bootstrap 5 - Responsive grid system
Font Awesome - Professional icons
Animate.css - Smooth transitions
Backend Python Flask - Lightweight REST API framework
SQLite3 - Single-file relational database
Jinja2 - Template rendering (if used)
Development Tools VS Code - Primary IDE
Git - Version control
Postman - API testing (25+ test cases)
Chrome DevTools - Debugging & performance
📋 Project Structure text CampusHub/ ├── Frontend/ │ ├── index.html # Main HTML (600+ lines) │ ├── style.css # All CSS (900+ lines) │ └── app.js # All JavaScript (1,400+ lines) ├── Backend/ │ ├── app.py # Flask server (800+ lines) │ ├── database.py # DB operations (600+ lines) │ ├── requirements.txt # Python dependencies │ └── config.py # Configuration ├── database/ │ └── campus_hub.db # SQLite database ├── assets/ │ └── images/ # Project screenshots ├── README.md # This file └── .gitignore # Git ignore rules 🚀 Quick Start Prerequisites Python 3.8+
Modern web browser
Git
Installation bash
git clone https://github.com/yourusername/campus-hub-cafeteria.git cd campus-hub-cafeteria
pip install -r requirements.txt
python init_db.py
python app.py
Frontend: http://localhost:5000
API Base: http://localhost:5000/api
Test Accounts Role Username Password Admin admin admin123 Student student1 password123 Teacher teacher1 teacher123 Kitchen Staff kitchen1 kitchen123 📚 API Documentation Authentication Endpoints http POST /api/auth/login # User login POST /api/auth/logout # User logout GET /api/auth/me # Current user info Menu Endpoints http GET /api/menu # Get all menu items GET /api/menu/categories # Get all categories Cart Endpoints http GET /api/cart # Get user's cart POST /api/cart/add # Add item to cart POST /api/cart/update # Update cart item quantity DELETE /api/cart/remove/:id # Remove item from cart POST /api/cart/clear # Clear entire cart Order Endpoints http GET /api/orders # Get user's orders POST /api/orders/create # Create new order GET /api/orders/:id/track # Track specific order POST /api/orders/:id/update-status # Update order status 🧪 Testing The project includes comprehensive testing:
Manual Testing User flow testing across all roles
Cross-browser compatibility (Chrome, Firefox, Edge, Safari)
Mobile responsiveness testing
Error scenario testing
API Testing with Postman 25+ API tests organized in collections
Authentication, menu, cart, orders, admin tests
Environment variables for session management
Test Coverage ✅ Authentication & session management
✅ Cart functionality
✅ Order processing
✅ Discount/offer validation
✅ Admin/kitchen dashboards
✅ Error handling scenarios
🏆 Key Achievements Technical Excellence 3,500+ lines of clean, documented JavaScript
800+ lines of Python with proper error handling
600+ lines of database code with transaction support
8 normalized tables with foreign key constraints
Real-time updates via polling mechanism
Security measures: password hashing, SQL injection prevention, XSS protection
User Experience Intuitive navigation with active state indication
Progressive disclosure of complex features
Accessibility features: keyboard navigation, screen reader support
Responsive design for all screen sizes
Loading states and meaningful feedback
📈 Performance Metrics Metric Result Page Load Time < 3 seconds API Response Time < 500ms Mobile Compatibility 100% Browser Compatibility Chrome, Firefox, Edge, Safari Database Queries Optimized with indexes
📝 License This project is licensed under the MIT License - see the LICENSE file for details.
🌟 Star this repository if you find it useful! https://img.shields.io/github/stars/yourusername/campus-hub-cafeteria?style=social https://img.shields.io/github/forks/yourusername/campus-hub-cafeteria?style=social
Built with ❤️ by Abdul Wasay Full Stack Developer | Computer Science Student