🚆 Welcome to the Railway Ticket Booking System

Hey there! 👋 I'm your ultimate railway ticket booking companion. Let me tell you what I can do for you...

What Am I All About? 🎯

Picture this: You're planning a trip, scrolling through trains, picking your perfect seat, and in seconds—boom! 🎫 Your ticket is confirmed with a beautiful digital receipt. That's me! I'm a full-stack, production-ready web application built to make railway ticket reservations smooth, fast, and incredibly reliable.

I'm powered by React (Vite) on the frontend, Node.js/Express.js APIs on the backend, and MongoDB for rock-solid data management. Oh, and I'm engineered with atomic seat reservations so you never get that dreaded "Seat already booked" moment when you're buying from two different browsers! 🛡️

What Can I Do For You? ✨

🔍 Search Trains Like a Pro: Find trains by origin, destination, and travel date. I even handle case-insensitive searches because I'm smart like that!
👀 Real-Time Seat Availability: See exactly how many seats are available (Available, Low Availability, or Sold Out). No surprises!
💺 Pick Your Perfect Seat: Choose your exact seat number interactively. See which seats are booked vs. free with visual feedback. You're in control!
🔐 Atomic Concurrency Protection: No double-booking nightmares! I use database-level atomic operations so even if 1000 people click at the same time, you're protected.
🎫 Digital Ticket Confirmation: Get a beautiful ticket with your unique Booking ID (like BK10234), complete with barcodes, journey details, and print/download options.
🔎 Find Your Ticket Fast: Lost your booking? No problem! Use the PNR lookup modal to retrieve your ticket by Booking ID in seconds.
☁️ AWS-Ready: I come with a /api/health endpoint built for AWS Application Load Balancers, because I'm enterprise-grade!
📱 Gorgeous UI: Clean travel theme with deep navy and azure colors, card layouts, mobile-friendly navigation, and helpful error messages.

What Powers Me? 🛠

My Frontend Brain (in `client/`)

React 18 — Modern UI components
Vite — Lightning-fast development and builds
React Router DOM v6 — Smooth client-side navigation (/, /results, /booking/:trainId, /confirmation/:bookingId)
Axios — Reliable API communication
Lucide React — Beautiful icons
CSS3 — Responsive, custom-designed, print-friendly styling

My Backend Heart (in `server/`)

Node.js — Asynchronous, event-driven runtime
Express.js — RESTful API framework
MongoDB & Mongoose — NoSQL database with ODM
CORS — Cross-origin request handling
Dotenv — Environment variable management

How I'm Organized 📁

railway-ticket-booking/
│
├── client/                           # Frontend React app
│   ├── src/
│   │   ├── components/
│   │   │   ├── Navbar.jsx           # Top bar + PNR lookup
│   │   │   ├── Footer.jsx           # Footer with HA badge
│   │   │   ├── TrainCard.jsx        # Train card display
│   │   │   ├── SearchForm.jsx       # Station & date picker
│   │   │   └── BookingForm.jsx      # Passenger form & seat picker
│   │   │
│   │   ├── pages/
│   │   │   ├── Home.jsx             # Landing page
│   │   │   ├── SearchResults.jsx    # Search results view
│   │   │   ├── Booking.jsx          # Booking page
│   │   │   └── Confirmation.jsx     # Ticket confirmation
│   │   │
│   │   ├── services/
│   │   │   └── api.js               # API wrapper
│   │   │
│   │   ├── App.jsx                  # Routes configuration
│   │   ├── main.jsx                 # Entry point
│   │   └── index.css                # Styles
│   │
│   ├── .env                         # Frontend config
│   ├── package.json
│   └── vite.config.js
│
├── server/                           # Backend Express app
│   ├── config/
│   │   └── db.js                    # MongoDB connection
│   │
│   ├── controllers/
│   │   ├── trainController.js       # Train logic
│   │   └── bookingController.js     # Booking logic
│   │
│   ├── models/
│   │   ├── Train.js                 # Train schema
│   │   └── Booking.js               # Booking schema
│   │
│   ├── routes/
│   │   ├── trainRoutes.js           # /api/trains endpoints
│   │   └── bookingRoutes.js         # /api/bookings endpoints
│   │
│   ├── seed/
│   │   └── seedTrains.js            # Initial data seeding
│   │
│   ├── .env                         # Backend config
│   ├── package.json
│   └── server.js                    # Entry point
│
├── .gitignore
└── README.md

Setting Me Up 🚀

Step 0: MongoDB Setup

First, I need a database to store all those bookings! Make sure MongoDB is running:

# On Windows: Check if MongoDB is running
Get-Service *mongo*

# Start MongoDB if it's not running
net start MongoDB

Or use MongoDB Atlas for cloud hosting: mongodb+srv://username:password@cluster.mongodb.net/railway_booking

Step 1: Configure Environment Variables

Backend (server/.env):

PORT=5000
MONGODB_URI=mongodb://localhost:27017/railway_booking

Frontend (client/.env):

VITE_API_URL=http://localhost:5000/api

Step 2: Install My Dependencies

# Backend
cd server
npm install

# Frontend
cd ../client
npm install

Step 3: Populate My Database

I come with pre-seeded trains (Rajdhani Express, Shatabdi Express, Duronto Express). Let's load them:

cd server
npm run seed

Step 4: Start Me Up! 🎉

Start the Backend (runs on port 5000):

cd server
npm run dev

✅ Server: http://localhost:5000
✅ Health check: http://localhost:5000/api/health

Start the Frontend (runs on port 5173):

cd client
npm run dev

✅ Open: http://localhost:5173

How to Talk to Me (API Reference) 📡

1️⃣ Check if I'm Alive

GET /api/health

Response:

{
  "status": "OK",
  "message": "Railway Booking API is running",
  "timestamp": "2026-09-13T12:45:00.000Z",
  "environment": "development"
}

2️⃣ Get All Trains

GET /api/trains

3️⃣ Search for Trains

GET /api/trains/search?from=Delhi&to=Mumbai&date=20/09/2026

Query Parameters:

from (required) — Source station
to (required) — Destination station
date (optional) — Travel date (DD/MM/YYYY)

Example Response:

{
  "success": true,
  "count": 3,
  "searchCriteria": {
    "from": "Delhi",
    "to": "Mumbai",
    "date": "20/09/2026"
  },
  "data": [
    {
      "_id": "670f...",
      "name": "Rajdhani Express",
      "trainNumber": "12952",
      "from": "Delhi",
      "to": "Mumbai",
      "departureTime": "10:00 PM",
      "arrivalTime": "08:00 AM",
      "availableSeats": 42,
      "totalSeats": 60,
      "price": 2150
    }
  ]
}

4️⃣ Get Train Details

GET /api/trains/:id

See the train info and which seats are already booked.

5️⃣ Book a Ticket ✈️

POST /api/bookings
Content-Type: application/json

{
  "trainId": "670f...",
  "passengerName": "Krishna",
  "age": 21,
  "seatNumber": 23
}

Response (201 Created):

{
  "success": true,
  "message": "Booking confirmed successfully!",
  "booking": {
    "bookingId": "BK10234",
    "trainId": "670f...",
    "trainName": "Rajdhani Express",
    "from": "Delhi",
    "to": "Mumbai",
    "passengerName": "Krishna",
    "age": 21,
    "seatNumber": 23,
    "createdAt": "2026-09-13T12:45:30.120Z"
  }
}

If seat is already booked (409 Conflict):

{
  "success": false,
  "message": "Seat 23 is already booked. Please select another seat."
}

6️⃣ Retrieve Your Booking

GET /api/bookings/:bookingId

Example: GET /api/bookings/BK10234

My AWS Future 🌐

I'm designed to scale! Here's how I'll run in the cloud:

                          [ Users ]
                             │
                             ▼
                    [ Amazon Route 53 ]
                             │
                             ▼
              [ Application Load Balancer ]
                             │
              ┌──────────────┴──────────────┐
              ▼                             ▼
      [ Availability Zone A ]       [ Availability Zone B ]
      [ EC2: Node.js API ]         [ EC2: Node.js API ]
      [ Auto Scaling Group ]       [ Auto Scaling Group ]
              │                             │
              └──────────────┬──────────────┘
                             ▼
                   [ MongoDB Atlas Cluster ]
                   (Multi-AZ Replica Set)

Here's My Cloud Architecture:

Route 53 — Global DNS routing
Application Load Balancer — Distributes traffic, health checks via /api/health
Auto Scaling Group — Automatically scales instances based on demand
Multiple EC2 Instances — Stateless API servers across availability zones
MongoDB Atlas — Managed cloud database with automatic failover
CloudWatch — Monitoring and alerts
AWS IAM — Security and access control
GitHub Actions — Automated CI/CD pipeline for zero-downtime deployments

The Tech Stack at a Glance 📊

Component	Technology
Frontend	React 18 + Vite + React Router v6
Backend	Node.js + Express.js
Database	MongoDB + Mongoose
API Communication	Axios + REST
Styling	CSS3 + Custom Design
Icons	Lucide React
State Management	React Hooks
Environment	Dotenv
Infrastructure	AWS (ALB, ASG, EC2, RDS/Atlas)
CI/CD	GitHub Actions

Quick Start TL;DR ⚡

# 1. Setup MongoDB
net start MongoDB

# 2. Backend setup
cd server
npm install
npm run seed
npm run dev

# 3. Frontend setup (new terminal)
cd client
npm install
npm run dev

# 4. Open browser
# http://localhost:5173

License 📄

MIT License — Use me however you like! 🎉

Ready to book some trains? Let's go! 🚆💨

Built with ❤️ for seamless railway ticket reservations.

Navigation Menu

Repository navigation

About

Repository files navigation

🚆 Welcome to the Railway Ticket Booking System

What Am I All About? 🎯

What Can I Do For You? ✨

What Powers Me? 🛠

My Frontend Brain (in `client/`)

My Backend Heart (in `server/`)

How I'm Organized 📁

Setting Me Up 🚀

Step 0: MongoDB Setup

Step 1: Configure Environment Variables

Step 2: Install My Dependencies

Step 3: Populate My Database

Step 4: Start Me Up! 🎉

How to Talk to Me (API Reference) 📡

1️⃣ Check if I'm Alive

2️⃣ Get All Trains

3️⃣ Search for Trains

4️⃣ Get Train Details

5️⃣ Book a Ticket ✈️

6️⃣ Retrieve Your Booking

My AWS Future 🌐

Here's My Cloud Architecture:

The Tech Stack at a Glance 📊

Quick Start TL;DR ⚡

License 📄

About

Releases

Packages

Contributors

Languages

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
client		client
server		server
terraform		terraform
.gitignore		.gitignore
README.md		README.md
package-lock.json		package-lock.json
package.json		package.json

Latest commit

History

Folders and files

Repository files navigation

🚆 Welcome to the Railway Ticket Booking System

What Am I All About? 🎯

What Can I Do For You? ✨

What Powers Me? 🛠

My Frontend Brain (in client/)

My Backend Heart (in server/)

How I'm Organized 📁

Setting Me Up 🚀

Step 0: MongoDB Setup

Step 1: Configure Environment Variables

Step 2: Install My Dependencies

Step 3: Populate My Database

Step 4: Start Me Up! 🎉

How to Talk to Me (API Reference) 📡

1️⃣ Check if I'm Alive

2️⃣ Get All Trains

3️⃣ Search for Trains

4️⃣ Get Train Details

5️⃣ Book a Ticket ✈️

6️⃣ Retrieve Your Booking

My AWS Future 🌐

Here's My Cloud Architecture:

The Tech Stack at a Glance 📊

Quick Start TL;DR ⚡

License 📄

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

My Frontend Brain (in `client/`)

My Backend Heart (in `server/`)