How khandelwal-arpit/springboot-starterkit works
This repository is a Spring Boot bus-reservation starter kit, demonstrated through an admin portal and end-user REST APIs. Admins manage profiles, agencies, buses, and trips; end users sign up, search stops/trips and schedules, then book tickets. The controllers delegate domain operations to services, which use MongoDB-backed repositories. The graph preserves the documented authentication split and key reservation stages; several subsystems are represented at directory level because their implementation files were not sampled.
Main entry points: UserServiceImpl.java User Services · BusReservationController.java Reservation API · DashboardController.java Admin UI · bus Bus Repositories
Components 15
Admin Portal
- Admin UI
src/main/java/com/starterkit/springboot/brs/controller/v1/ui/DashboardController.java - Admin Signup
src/main/java/com/starterkit/springboot/brs/controller/v1/ui/AdminController.java
Reservation API
- User API
src/main/java/com/starterkit/springboot/brs/controller/v1/api/UserController.java - Reservation API
src/main/java/com/starterkit/springboot/brs/controller/v1/api/BusReservationController.java - API Responses
src/main/java/com/starterkit/springboot/brs/dto/response/Response.java
Domain Services
- Bus Services
src/main/java/com/starterkit/springboot/brs/service/BusReservationServiceImpl.java - User Services
src/main/java/com/starterkit/springboot/brs/service/UserServiceImpl.java - Bus Domain
src/main/java/com/starterkit/springboot/brs/model/bus - User Domain
src/main/java/com/starterkit/springboot/brs/model/user - Authentication
src/main/java/com/starterkit/springboot/brs/security
Persistence
- Bus Repositories
src/main/java/com/starterkit/springboot/brs/repository/bus - User Repositories
src/main/java/com/starterkit/springboot/brs/repository/user
Other components
- Admin
- End User
- MongoDB
Connections 20
- Admin → Admin UI: manages portal
- Admin → Admin Signup: signs up
- End User → User API: signs up
- End User → Reservation API: searches and books
- Admin UI → Bus Services: manages agency and trips
src/main/java/com/starterkit/springboot/brs/controller/v1/ui/DashboardController.java - Admin UI → User Services: updates profile
src/main/java/com/starterkit/springboot/brs/controller/v1/ui/DashboardController.java - Admin Signup → User Services: registers admin
src/main/java/com/starterkit/springboot/brs/controller/v1/ui/AdminController.java - User API → User Services: registers user
src/main/java/com/starterkit/springboot/brs/controller/v1/api/UserController.java - Reservation API → Bus Services: searches and books
src/main/java/com/starterkit/springboot/brs/controller/v1/api/BusReservationController.java - Reservation API → User Services: finds passenger
src/main/java/com/starterkit/springboot/brs/controller/v1/api/BusReservationController.java - Reservation API → API Responses: returns result
src/main/java/com/starterkit/springboot/brs/controller/v1/api/BusReservationController.java - Bus Services → Bus Repositories: uses repositories
src/main/java/com/starterkit/springboot/brs/service/BusReservationServiceImpl.java - User Services → User Repositories: uses repository
src/main/java/com/starterkit/springboot/brs/service/UserServiceImpl.java - Bus Repositories → MongoDB: persists bus data
- User Repositories → MongoDB: persists user data
- Bus Repositories → Bus Domain: loads domain records
src/main/java/com/starterkit/springboot/brs/repository/bus/TripRepository.java - User Repositories → User Domain: loads user records
src/main/java/com/starterkit/springboot/brs/repository/user/UserRepository.java - Authentication → User Services: loads user identity
src/main/java/com/starterkit/springboot/brs/security/CustomUserDetailsService.java - Admin → Authentication: uses cookie authentication
- End User → Authentication: uses JWT authentication