How itmangz/bussin works
BUSSIN is a commuter booking and queue-management product, delivered here as a Swing desktop client and a Spring API. The main user path is desktop startup and authentication, trip discovery, seat/booking review and confirmation; staff also manage routes, buses, trips, users, queues and reports. The API exposes bus, route, trip and user management backed by repositories. The README also describes payments, voice announcements and Gmail verification, but the supplied tree and excerpts do not establish their runtime implementations or wiring, so those are not represented as implemented components.
Main entry points: App.java Desktop startup · TripService.java Trip service · BookingScreen.java Trip and seat booking · BookingService.java Booking service
Components 32
Desktop client
- Desktop startup
bussin-desktop/src/main/java/com/bussin/desktop/App.java - Login and registration
bussin-desktop/src/main/java/com/bussin/desktop/ui/auth - Auth session
bussin-desktop/src/main/java/com/bussin/desktop/services/AuthSession.java - Application navigation
bussin-desktop/src/main/java/com/bussin/desktop/ui/MainFrame.java - Operations screens
bussin-desktop/src/main/java/com/bussin/desktop/ui/screens - Queue management
bussin-desktop/src/main/java/com/bussin/desktop/ui/screens/QueueScreen.java - Reports and export
bussin-desktop/src/main/java/com/bussin/desktop/ui/screens/ReportScreen.java - User API client
bussin-desktop/src/main/java/com/bussin/desktop/services/UserApiService.java - HTTP client
bussin-desktop/src/main/java/com/bussin/desktop/services/ApiClient.java
Commuter booking
- Trip and seat booking
bussin-desktop/src/main/java/com/bussin/desktop/ui/screens/BookingScreen.java - Booking state
bussin-desktop/src/main/java/com/bussin/desktop/ui/flow/BookingStore.java - Booking review
bussin-desktop/src/main/java/com/bussin/desktop/ui/screens/BookingReviewScreen.java - Booking confirmation
bussin-desktop/src/main/java/com/bussin/desktop/ui/screens/BookingConfirmationScreen.java - Booking service
bussin-desktop/src/main/java/com/bussin/desktop/services/BookingService.java - Trip search
bussin-desktop/src/main/java/com/bussin/desktop/ui/screens/TripSearchScreen.java
API services
- Route endpoints
src/main/java/com/bussin/bussin_api/controller/RouteController.java - Trip endpoints
src/main/java/com/bussin/bussin_api/controller/TripController.java - User endpoints
src/main/java/com/bussin/bussin_api/controller/UserController.java - Bus endpoints
src/main/java/com/bussin/bussin_api/controller/BusController.java - Route service
src/main/java/com/bussin/bussin_api/service/RouteService.java - Trip service
src/main/java/com/bussin/bussin_api/service/TripService.java - User service
src/main/java/com/bussin/bussin_api/service/UserService.java - Bus service
src/main/java/com/bussin/bussin_api/service/BusService.java
Persistent domain
- Routes
src/main/java/com/bussin/bussin_api/entity/Route.java - Trips
src/main/java/com/bussin/bussin_api/entity/Trip.java - Buses
src/main/java/com/bussin/bussin_api/entity/Bus.java - Trip repository
src/main/java/com/bussin/bussin_api/repository/TripRepository.java - User repository
src/main/java/com/bussin/bussin_api/repository/UserRepository.java - Route repository
src/main/java/com/bussin/bussin_api/repository/RouteRepository.java - Bus repository
src/main/java/com/bussin/bussin_api/repository/BusRepository.java
Other components
- Commuter
- Staff user
Connections 30
- Commuter → Desktop startup: starts
- Staff user → Desktop startup: starts
- Desktop startup → Login and registration: opens
bussin-desktop/src/main/java/com/bussin/desktop/App.java - Desktop startup → Auth session: uses
bussin-desktop/src/main/java/com/bussin/desktop/App.java - Desktop startup → Application navigation: opens
bussin-desktop/src/main/java/com/bussin/desktop/App.java - Application navigation → Trip and seat booking: navigates
bussin-desktop/src/main/java/com/bussin/desktop/ui/MainFrame.java - Commuter → Trip search: searches trips
- Trip search → Trip and seat booking: selects trip
- Trip and seat booking → Booking state: updates
- Trip and seat booking → Booking review: opens review
- Booking review → Booking confirmation: confirms
bussin-desktop/src/main/java/com/bussin/desktop/ui/screens/BookingReviewScreen.java - Booking confirmation → Booking service: creates booking
- Booking service → Booking state: uses
bussin-desktop/src/main/java/com/bussin/desktop/services/BookingService.java - Booking service → Trip search: reads trips
- Staff user → Operations screens: manages operations
- Staff user → Queue management: monitors queue
- Staff user → Reports and export: views reports
- User API client → HTTP client: uses
bussin-desktop/src/main/java/com/bussin/desktop/services/UserApiService.java - User API client → User endpoints: HTTP requests
- Route endpoints → Route service: delegates
src/main/java/com/bussin/bussin_api/controller/RouteController.java - Trip endpoints → Trip service: delegates
src/main/java/com/bussin/bussin_api/controller/TripController.java - User endpoints → User service: delegates
src/main/java/com/bussin/bussin_api/controller/UserController.java - Bus endpoints → Bus service: delegates
src/main/java/com/bussin/bussin_api/controller/BusController.java - Route service → Route repository: reads and writes
src/main/java/com/bussin/bussin_api/service/RouteService.java - Trip service → Trip repository: reads and writes
src/main/java/com/bussin/bussin_api/service/TripService.java - Trip service → Bus repository: looks up buses
src/main/java/com/bussin/bussin_api/service/TripService.java - Trip service → Route repository: looks up routes
src/main/java/com/bussin/bussin_api/service/TripService.java - User service → User repository: reads and writes
src/main/java/com/bussin/bussin_api/service/UserService.java - Bus service → Bus repository: reads and writes
src/main/java/com/bussin/bussin_api/service/BusService.java - Trip repository → Trips: persists
src/main/java/com/bussin/bussin_api/repository/TripRepository.java