☁️ CloudPass – Smart Digital Bus Pass Management System

CloudPass is a web-based digital bus pass management system developed using Flask and SQLite. It simplifies the process of applying for, managing, approving, and verifying bus passes through a secure and user-friendly platform.

🚀 Features

• 👤 User Registration & Login
• 🚌 Online Bus Pass Application
• 💰 Smart Fare Calculation
• 📅 1-Month, 3-Month & 6-Month Pass Plans
• 🎫 Digital Bus Pass Generation
• 📱 QR Code-Based Pass Verification
• ⏳ Automatic Pass Validity & Expiry Tracking
• 🗺️ Bus Routes & Fare Information
• 👤 User Profile & Pass History
• 🔐 Dedicated Administrator Login
• 📊 Administrator Dashboard
• ✅ Pass Application Approval & Management
• 👥 User Management
• 🔍 Digital Pass Verification

🛠️ Technologies Used

• Python
• Flask
• SQLite
• HTML5
• CSS3
• JavaScript
• QR Code Generation
• python-dateutil
• python-dotenv

📁 Project Structure

CloudPass includes:

• app.py – Main Flask application
• templates/ – HTML templates
• static/css/ – Application styling
• static/js/ – JavaScript functionality
• static/images/qr/ – Generated QR codes
• requirements.txt – Python dependencies
• .env – Environment variables (not uploaded to GitHub)
• database.db – Local database (not uploaded to GitHub)

⚙️ How to Run

1. Clone the repository.

2. Open the project folder in VS Code.

3. Create and activate a Python virtual environment.

4. Install the required dependencies:

   pip install -r requirements.txt

5. Create the required .env file with your environment variables.

6. Run the application:

   python app.py

7. Open the local Flask URL displayed in the terminal, typically:

   http://127.0.0.1:5000

🔄 How It Works

1. Users create an account and securely log in.
2. Users can explore available routes and fare plans.
3. A user selects the route, pass type, and duration.
4. CloudPass calculates the appropriate fare.
5. The pass application is submitted for administrator approval.
6. The administrator reviews and approves the application.
7. An approved digital bus pass is generated with validity information and a QR code.
8. The QR code can be used to verify the pass.
9. The system automatically determines whether a pass is valid or expired.

🔒 Security

Sensitive environment variables, local database files, virtual environments, and Python cache files are excluded from the GitHub repository using .gitignore.

🎯 Project Objective

The objective of CloudPass is to digitize the traditional bus pass process and provide a convenient, efficient, and scalable system for passengers and administrators.

---

⭐ CloudPass demonstrates practical implementation of cloud-oriented web application development, backend development, database management, authentication, QR-based verification, and digital service automation.