How animesh4956/bus-ticket-booking-system works
BusGo is a full-stack bus ticket booking platform. Travelers search routes, choose seats, book tickets, view confirmations and download PDFs; users can also manage accounts and verify tickets, while administrators manage buses, bookings, users and promotions. The Next.js app calls a Spring Boot REST API backed by PostgreSQL. The README documents Redis seat locking, but the sampled source does not show its runtime wiring; several backend details are likewise represented only by documented capabilities and directory paths.
Main entry points: api.ts REST API client · api Spring REST API · BookingService.java Booking services · repository Data repositories
Components 21
Web experience
- Route search
frontend/src/app/page.tsx - Bus results
frontend/src/app/buses/page.tsx - Seat selection
frontend/src/app/book/[busId]/page.tsx - Booking confirmation
frontend/src/app/booking/[reference]/page.tsx - User dashboard
frontend/src/app/dashboard/page.tsx - Ticket verification
frontend/src/app/verify/[pnr]/page.tsx - Admin console
frontend/src/app/admin/page.tsx
Identity and access
- Login and registration
frontend/src/app/login/page.tsx - Auth context
frontend/src/hooks/useAuth.tsx - REST API client
frontend/src/lib/api.ts - JWT security
src/main/java/com/example/demo/security
Booking domain
- Spring REST API
src/main/java/com/example/demo/controller/api - Booking services
src/main/java/com/example/demo/service/BookingService.java - PDF ticket generation
src/main/java/com/example/demo/service/PdfTicketService.java - Redis seat locking
Operations and persistence
- Admin management
src/main/java/com/example/demo/controller/api/AdminController.java - Domain entities
src/main/java/com/example/demo/model - Data repositories
src/main/java/com/example/demo/repository - PostgreSQL
- Schema migrations
src/main/resources/db/migration
Other components
- Traveler
Connections 23
- Traveler → Route search: searches routes
README.md - Route search → Bus results: opens results
frontend/src/app/page.tsx - Bus results → Seat selection: chooses bus
frontend/src/app/buses/page.tsx - Seat selection → Booking confirmation: views booking
README.md - Traveler → Login and registration: signs in
README.md - Login and registration → Auth context: calls login
frontend/src/app/login/page.tsx - Auth context → REST API client: requests identity
frontend/src/hooks/useAuth.tsx - REST API client → Spring REST API: calls REST API
README.md - Seat selection → REST API client: requests booking
README.md - Booking confirmation → REST API client: loads ticket
README.md - User dashboard → REST API client: manages bookings
README.md - Ticket verification → REST API client: verifies PNR
README.md - Admin console → REST API client: manages platform
README.md - Spring REST API → JWT security: secures routes
README.md - Spring REST API → Booking services: delegates booking
README.md - Booking services → PDF ticket generation: generates PDF
README.md - Spring REST API → Admin management: routes admin
README.md - Booking services → Data repositories: persists bookings
README.md - Admin management → Data repositories: manages records
README.md - Data repositories → Domain entities: maps entities
README.md - Data repositories → PostgreSQL: reads and writes
README.md - Schema migrations → PostgreSQL: creates schema
README.md - Booking services → Redis seat locking: locks seats
README.md