🚌 Govindha Marg - Devotee Bus Ticketing System

🌟 Seamless Bus Ticketing for Tirumala & Tirupati Devotees 🌟

🎯 Overview

Govindha Marg is a comprehensive web-based bus ticketing system designed specifically for devotees traveling between Tirumala and Tirupati. This platform provides an intuitive interface for booking bus tickets, managing bookings, and accessing travel services with role-based access for users and staff.

✨ Key Highlights

• Role-Based Access - Separate interfaces for users and staff
• Real-time Booking - Instant booking confirmation with QR codes
• Multiple Booking Types - One-way, round-trip, and special packages
• Secure Authentication - Local storage-based user management
• Responsive Design - Works perfectly on all devices

🚀 Features

🎫 Booking System

• One-Way Booking - Tirumala ↔ Tirupati single journey
• Two-Way Booking - Round trip packages
• Flexible Routes - Multiple route options
• Seat Management - Visual booking interface

📱 QR Code System

• Instant QR Generation - Automatic QR code for each booking
• Mobile Scanning - QR scanner for ticket validation
• Offline Access - Downloadable tickets

👥 User Management

• User Registration - Simple signup process
• Staff Portal - Dedicated admin interface
• Secure Login - Role-based authentication
• Profile Management - Personal details storage

🔍 Smart Features

• Booking History - Track all past bookings
• Real-time Updates - Instant booking confirmations
• Responsive Design - Mobile-first approach
• Video Background - Engaging login experience

🛠 Tech Stack

Technology	Purpose
HTML5	Semantic markup structure
CSS3	Modern styling with animations
JavaScript	Dynamic functionality
Local Storage	Client-side data persistence
Responsive Design	Mobile-first approach

🏁 Getting Started

Prerequisites

• Modern web browser (Chrome, Firefox, Safari, Edge)
• No server setup required - runs entirely in browser

Quick Start

1. Clone or Download

   # Simply download all files and open index.html
   # No installation required

2. Open in Browser

   # Open index.html directly in your browser
   # Or use any local development server

3. First Time Setup

   • Open index.html to access login page
   • Click "Sign up here" to create your first account
   • Choose role: User or Staff
   • Start booking tickets immediately

📁 Project Structure

govindha-marg/
├── 📄 index.html              # Login page with video background
├── 📄 signup.html             # User registration page
├── 📄 nav.html                # User dashboard/navigation
├── 📄 staffindex.html         # Staff dashboard
├── 📄 bookings.html           # Booking management
├── 📄 bookticket.html         # Ticket booking interface
├── 📄 scanner.html            # QR code scanner for staff
├── 📄 qr_*.html               # QR code generation pages
├── 📄 booking_*.html          # Route-specific booking pages
├── 📄 account.html            # User account management
├── 📄 admin.html              # Admin panel
├── 📄 styles.css              # Main stylesheet
├── 📄 index.css               # Login page styles
├── 📄 main.js                 # Core JavaScript functionality
├── 📄 chatbot.js              # AI chatbot assistant
├── 📄 common.js               # Shared utilities
├── 📁 images/                 # Project assets
├── 📄 loginvideo.mp4          # Background video for login
└── 📄 README.md               # Project documentation

🎯 Usage

For Devotees (Users)

1. Register - Visit signup.html to create account
2. Login - Use index.html with your credentials
3. Book Tickets - Navigate through booking interfaces
4. View QR - Access your booking QR codes
5. Manage Account - Update profile and view history

For Staff

1. Staff Login - Use index.html and select "Staff" role
2. Dashboard - Access staffindex.html for management
3. Scan Tickets - Use scanner.html for QR validation
4. Manage Bookings - View and manage all bookings

Data Storage

• Users: Stored in localStorage.users as JSON array
• Bookings: Stored in localStorage.bookings as JSON array
• Session: Managed via sessionStorage.loggedInUser

Key Files

• index.html - Main login with video background
• main.js - Core booking and user management logic
• styles.css - Consistent styling across all pages
• scanner.html - QR code scanning functionality

🤝 Contributing

Contributions are welcome! This is a client-side project, so you can:

• Improve UI/UX design
• Add new booking features
• Enhance QR code functionality
• Optimize for mobile devices
• Add new route options

📄 License

This project is open-source and available under the MIT License.

---

🙏 Govindha Govindha! Experience Divine Journey with Govindha Marg 🙏

⬆ Back to Top