Skip to content

README.md

Latest commit

 

History

History
97 lines (86 loc) · 3.1 KB

README.md

File metadata and controls

97 lines (86 loc) · 3.1 KB

🚇 Metro Ticketing System

A modern solution for automated metro management | MERN Stack

MongoDB Express.js React NodeJS

📖 Overview

A full-stack web application designed to digitize metro operations, featuring ticket management, route planning, and user complaint resolution. Built to streamline public transportation services in urban areas.

✨ Key Features

  • 🔐 User Authentication
    • Secure registration/login with encrypted credentials
    • Session management
  • 🎫 Smart Ticketing
    • Purchase digital tickets with validity periods
    • View ticket history
    • QR-based validation system (planned upgrade)
  • 🗺️ Route Management
    • Fixed pricing per route
    • Interactive metro map display
  • 📢 Complaint Portal
    • Submit service-related complaints
    • Track complaint resolution status
  • 📊 Admin Dashboard
    • Manage routes/pricing
    • Analyze user traffic

🛠️ Tech Stack

Frontend: React, Bootstrap
Backend: Node.js, Express
Database: MongoDB
Tools: Postman, Git, VS Code

⚙️ Installation

  1. Clone Repository
git clone https://github.com/juni2003/Metro-Ticketing-System-Project.git
  1. Install Dependencies
cd client && npm install
cd ../server && npm install
  1. Configure Environment
  • Create .env files with these variables:
  • Server
MONGO_URI = your_mongodb_connection_string 
JWT_SECRET = your_jwt_secret
PORT = 5000
# Replace `your_mongodb_connection_string` and `your_jwt_secret` with actual values
  • Client
REACT_APP_API_URL = http://localhost:5000
  1. Run Application
# Start backend
cd server && npm start

# Start frontend
cd ../client && npm start

📄 Database Schema

Key Collections:

Users Tickets Routes
- username - user_id - route_id
- email - route_id - stations
- password (hash) - purchase_time - price
- ticket_history - valid_until - active_status

🌟 Future Enhancements

  • 💳 Integrated payment gateway
  • 📱 Progressive Web App (PWA) support
  • 🚌 Real-time metro tracking
  • 📈 AI-driven demand prediction

🤝 Contribute

  1. Fork the repository
  2. Create a feature branch
git checkout -b feature/your-idea
  1. Commit changes
git commit -m "Add your feature"
  1. Push and open a Pull Request

🌟 Support the Project

If this project helps you, consider giving it a star! ⭐