⚠️ All Rights Reserved. This repository is published for viewing and portfolio purposes only. The code is not open source: reuse, redistribution, modification, or derivative works are not permitted without written permission. See LICENSE.

MR Bus Portal is a full-stack, production-deployed bus booking platform that lets users search thousands of routes across the US, book seats with Stripe payments, earn loyalty points on every trip, and track their bus in real time. It includes AI-powered features like seat recommendations, price prediction, a travel AI chat assistant, and a smart packing list generator.

🚀 Fully deployed at mrbusportal.com: React frontend on Firebase Hosting, FastAPI backend on Google Cloud Run, PostgreSQL on Cloud SQL.

• Search buses across 321 US cities with live results
• One-way, Round Trip, and Multi-City booking modes
• City autocomplete with smart suggestions
• Voice search: say "from Chicago to Atlanta"
• Fare calendar to find the cheapest travel dates
• Passenger count selection (1–6 passengers)

• Stripe payment integration with secure payment intent flow
• Booking confirmation with email receipt
• Booking cancellation and reschedule support
• Multi-passenger fare calculation

• Earn points on every trip automatically
• 3-tier system: Silver (100 pts) → Gold (500 pts) → Platinum (1,500 pts)
• Redeem points at checkout for discounts
• Referral program: earn bonus points for referring friends
• Points history and balance dashboard

• Smart seat recommendations based on user preferences (window, aisle, quiet, etc.)
• AI travel chat assistant: natural language queries ("cheapest bus today", "show my bookings")
• Price prediction: flags when fares are expected to drop
• Packing list generator based on destination and trip length
• Travel Buddy: destination tips and local weather info

• Live progress bar showing bus location between stops
• Real ETA calculation based on departure/arrival times
• Animated route visualization with SVG path
• Fallback simulation mode when live times unavailable

• JWT authentication (signup / login / Google OAuth)
• User profile with trip history
• My Bookings page with cancellation, reschedule, and receipt resend
• Subscription / membership plans
• Customer reviews system
• Group booking coordinator
• Safety check-in feature
• Snack pre-order (coming soon)
• Price alert notifications
• Waitlist for sold-out routes

mr-bus-portal/
├── frontend/                  # React 18 app
│   ├── src/
│   │   ├── pages/             # HomePage, MyBookings, Profile, etc.
│   │   ├── components/        # BusTracker, PaymentModal, SeatMap, etc.
│   │   └── App.js             # Router + Navbar
│   └── public/
├── backend/
│   └── app/
│       ├── routers/           # bookings, buses, payments, loyalty, auth, ...
│       ├── models.py          # SQLAlchemy models
│       ├── schemas.py         # Pydantic schemas
│       ├── main.py            # FastAPI app + DB migrations
│       └── security.py        # JWT helpers
├── dataset/                   # 321-city US bus route dataset
└── docs/                      # Architecture & API docs

• Node.js 18+
• Python 3.11+
• PostgreSQL
• A Stripe account (test mode works fine)

cd backend
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# Create backend/app/.env (see .env.example)
cp backend/app/.env.example backend/app/.env
# Fill in your keys

uvicorn app.main:app --reload

cd frontend
npm install

# Create frontend/.env
echo "REACT_APP_API_URL=http://localhost:8000" > .env

npm start

Create backend/app/.env with:

DATABASE_URL=postgresql://user:password@localhost:5432/mrbus
SECRET_KEY=your_secret_key
SMTP_USER=your@gmail.com
SMTP_PASS=your_app_password
RESEND_API_KEY=re_...
STRIPE_SECRET_KEY=sk_test_...
STRIPE_PUBLISHABLE_KEY=pk_test_...
ANTHROPIC_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-proj-...
GOOGLE_CLIENT_ID=your_google_client_id

⚠️ Never commit .env. It is covered by .gitignore.

This project is a portfolio demonstration project. It is not a licensed commercial product.