# khandelwal-arpit/springboot-starterkit architecture

> Architecture diagram of the GitHub repository khandelwal-arpit/springboot-starterkit, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/khandelwal-arpit/springboot-starterkit
- Repository: https://github.com/khandelwal-arpit/springboot-starterkit

## Overview

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: [`src/main/java/com/starterkit/springboot/brs/service/UserServiceImpl.java`](https://github.com/khandelwal-arpit/springboot-starterkit/blob/master/src/main/java/com/starterkit/springboot/brs/service/UserServiceImpl.java) (User Services), [`src/main/java/com/starterkit/springboot/brs/controller/v1/api/BusReservationController.java`](https://github.com/khandelwal-arpit/springboot-starterkit/blob/master/src/main/java/com/starterkit/springboot/brs/controller/v1/api/BusReservationController.java) (Reservation API), [`src/main/java/com/starterkit/springboot/brs/controller/v1/ui/DashboardController.java`](https://github.com/khandelwal-arpit/springboot-starterkit/blob/master/src/main/java/com/starterkit/springboot/brs/controller/v1/ui/DashboardController.java) (Admin UI), [`src/main/java/com/starterkit/springboot/brs/repository/bus`](https://github.com/khandelwal-arpit/springboot-starterkit/tree/master/src/main/java/com/starterkit/springboot/brs/repository/bus) (Bus Repositories)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_admin["Admin Portal"]
  node_admin_ui["Admin UI"]
  node_admin_signup["Admin Signup"]
end

subgraph group_api["Reservation API"]
  node_user_api["User API"]
  node_reservation_api["Reservation API"]
  node_response["API Responses<br/>[Response.java]"]
end

subgraph group_domain["Domain Services"]
  node_bus_service["Bus Services"]
  node_user_service["User Services"]
  node_bus_models["Bus Domain"]
  node_user_models["User Domain"]
  node_security["Authentication"]
end

subgraph group_persistence["Persistence"]
  node_bus_repos["Bus Repositories"]
  node_user_repos["User Repositories"]
end

node_admin_actor(("Admin"))
node_passenger(("End User"))
node_mongodb[("MongoDB")]

node_admin_actor -->|"manages portal"| node_admin_ui
node_admin_actor -->|"signs up"| node_admin_signup
node_passenger -->|"signs up"| node_user_api
node_passenger -->|"searches and books"| node_reservation_api
node_admin_ui -->|"manages agency and trips"| node_bus_service
node_admin_ui -->|"updates profile"| node_user_service
node_admin_signup -->|"registers admin"| node_user_service
node_user_api -->|"registers user"| node_user_service
node_reservation_api -->|"searches and books"| node_bus_service
node_reservation_api -->|"finds passenger"| node_user_service
node_reservation_api -->|"returns result"| node_response
node_bus_service -->|"uses repositories"| node_bus_repos
node_user_service -->|"uses repository"| node_user_repos
node_bus_repos -->|"persists bus data"| node_mongodb
node_user_repos -->|"persists user data"| node_mongodb
node_bus_repos -->|"loads domain records"| node_bus_models
node_user_repos -->|"loads user records"| node_user_models
node_security -->|"loads user identity"| node_user_service
node_admin_actor -->|"uses cookie authentication"| node_security
node_passenger -->|"uses JWT authentication"| node_security

click node_admin_ui "https://github.com/khandelwal-arpit/springboot-starterkit/blob/master/src/main/java/com/starterkit/springboot/brs/controller/v1/ui/DashboardController.java"
click node_admin_signup "https://github.com/khandelwal-arpit/springboot-starterkit/blob/master/src/main/java/com/starterkit/springboot/brs/controller/v1/ui/AdminController.java"
click node_user_api "https://github.com/khandelwal-arpit/springboot-starterkit/blob/master/src/main/java/com/starterkit/springboot/brs/controller/v1/api/UserController.java"
click node_reservation_api "https://github.com/khandelwal-arpit/springboot-starterkit/blob/master/src/main/java/com/starterkit/springboot/brs/controller/v1/api/BusReservationController.java"
click node_bus_service "https://github.com/khandelwal-arpit/springboot-starterkit/blob/master/src/main/java/com/starterkit/springboot/brs/service/BusReservationServiceImpl.java"
click node_user_service "https://github.com/khandelwal-arpit/springboot-starterkit/blob/master/src/main/java/com/starterkit/springboot/brs/service/UserServiceImpl.java"
click node_bus_models "https://github.com/khandelwal-arpit/springboot-starterkit/tree/master/src/main/java/com/starterkit/springboot/brs/model/bus"
click node_user_models "https://github.com/khandelwal-arpit/springboot-starterkit/tree/master/src/main/java/com/starterkit/springboot/brs/model/user"
click node_bus_repos "https://github.com/khandelwal-arpit/springboot-starterkit/tree/master/src/main/java/com/starterkit/springboot/brs/repository/bus"
click node_user_repos "https://github.com/khandelwal-arpit/springboot-starterkit/tree/master/src/main/java/com/starterkit/springboot/brs/repository/user"
click node_security "https://github.com/khandelwal-arpit/springboot-starterkit/tree/master/src/main/java/com/starterkit/springboot/brs/security"
click node_response "https://github.com/khandelwal-arpit/springboot-starterkit/blob/master/src/main/java/com/starterkit/springboot/brs/dto/response/Response.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_admin_ui,node_admin_signup,node_passenger toneBlue
class node_user_api,node_reservation_api,node_response,node_mongodb toneAmber
class node_bus_service,node_user_service,node_bus_models,node_user_models,node_security toneMint
class node_bus_repos,node_user_repos toneRose
class node_admin_actor toneIndigo
```

## Components

### Admin Portal

- [Admin UI](https://github.com/khandelwal-arpit/springboot-starterkit/blob/master/src/main/java/com/starterkit/springboot/brs/controller/v1/ui/DashboardController.java): `src/main/java/com/starterkit/springboot/brs/controller/v1/ui/DashboardController.java`
- [Admin Signup](https://github.com/khandelwal-arpit/springboot-starterkit/blob/master/src/main/java/com/starterkit/springboot/brs/controller/v1/ui/AdminController.java): `src/main/java/com/starterkit/springboot/brs/controller/v1/ui/AdminController.java`

### Reservation API

- [User API](https://github.com/khandelwal-arpit/springboot-starterkit/blob/master/src/main/java/com/starterkit/springboot/brs/controller/v1/api/UserController.java): `src/main/java/com/starterkit/springboot/brs/controller/v1/api/UserController.java`
- [Reservation API](https://github.com/khandelwal-arpit/springboot-starterkit/blob/master/src/main/java/com/starterkit/springboot/brs/controller/v1/api/BusReservationController.java): `src/main/java/com/starterkit/springboot/brs/controller/v1/api/BusReservationController.java`
- [API Responses](https://github.com/khandelwal-arpit/springboot-starterkit/blob/master/src/main/java/com/starterkit/springboot/brs/dto/response/Response.java): `src/main/java/com/starterkit/springboot/brs/dto/response/Response.java`

### Domain Services

- [Bus Services](https://github.com/khandelwal-arpit/springboot-starterkit/blob/master/src/main/java/com/starterkit/springboot/brs/service/BusReservationServiceImpl.java): `src/main/java/com/starterkit/springboot/brs/service/BusReservationServiceImpl.java`
- [User Services](https://github.com/khandelwal-arpit/springboot-starterkit/blob/master/src/main/java/com/starterkit/springboot/brs/service/UserServiceImpl.java): `src/main/java/com/starterkit/springboot/brs/service/UserServiceImpl.java`
- [Bus Domain](https://github.com/khandelwal-arpit/springboot-starterkit/tree/master/src/main/java/com/starterkit/springboot/brs/model/bus): `src/main/java/com/starterkit/springboot/brs/model/bus`
- [User Domain](https://github.com/khandelwal-arpit/springboot-starterkit/tree/master/src/main/java/com/starterkit/springboot/brs/model/user): `src/main/java/com/starterkit/springboot/brs/model/user`
- [Authentication](https://github.com/khandelwal-arpit/springboot-starterkit/tree/master/src/main/java/com/starterkit/springboot/brs/security): `src/main/java/com/starterkit/springboot/brs/security`

### Persistence

- [Bus Repositories](https://github.com/khandelwal-arpit/springboot-starterkit/tree/master/src/main/java/com/starterkit/springboot/brs/repository/bus): `src/main/java/com/starterkit/springboot/brs/repository/bus`
- [User Repositories](https://github.com/khandelwal-arpit/springboot-starterkit/tree/master/src/main/java/com/starterkit/springboot/brs/repository/user): `src/main/java/com/starterkit/springboot/brs/repository/user`

### Other components

- **Admin**
- **End User**
- **MongoDB**

## Connections

- 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 (evidence: `src/main/java/com/starterkit/springboot/brs/controller/v1/ui/DashboardController.java`)
- Admin UI → User Services: updates profile (evidence: `src/main/java/com/starterkit/springboot/brs/controller/v1/ui/DashboardController.java`)
- Admin Signup → User Services: registers admin (evidence: `src/main/java/com/starterkit/springboot/brs/controller/v1/ui/AdminController.java`)
- User API → User Services: registers user (evidence: `src/main/java/com/starterkit/springboot/brs/controller/v1/api/UserController.java`)
- Reservation API → Bus Services: searches and books (evidence: `src/main/java/com/starterkit/springboot/brs/controller/v1/api/BusReservationController.java`)
- Reservation API → User Services: finds passenger (evidence: `src/main/java/com/starterkit/springboot/brs/controller/v1/api/BusReservationController.java`)
- Reservation API → API Responses: returns result (evidence: `src/main/java/com/starterkit/springboot/brs/controller/v1/api/BusReservationController.java`)
- Bus Services → Bus Repositories: uses repositories (evidence: `src/main/java/com/starterkit/springboot/brs/service/BusReservationServiceImpl.java`)
- User Services → User Repositories: uses repository (evidence: `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 (evidence: `src/main/java/com/starterkit/springboot/brs/repository/bus/TripRepository.java`)
- User Repositories → User Domain: loads user records (evidence: `src/main/java/com/starterkit/springboot/brs/repository/user/UserRepository.java`)
- Authentication → User Services: loads user identity (evidence: `src/main/java/com/starterkit/springboot/brs/security/CustomUserDetailsService.java`)
- Admin → Authentication: uses cookie authentication
- End User → Authentication: uses JWT authentication
