How ruuuyin/smart-parking-test works
Smart Park is a Spring Boot parking-management API. Clients register vehicles and lots, check vehicles in and out, and query lot details, occupancy, and paginated parked vehicles. REST controllers delegate to business services, which coordinate use cases and persistence; domain and presentation models represent the parking state and API payloads. The README documents an in-memory H2 database with Flyway migrations. Some use-case and persistence wiring is supported only by the source index, so unsampled relationships are omitted rather than inferred.
Main entry points: ParkingLotServiceImpl.java Parking service · VehicleServiceImpl.java Vehicle service · GetParkedVehiclesByParkingLotIdCommandImpl.java Parked-vehicle query · domain Parking domain
Components 16
API layer
- Parking endpoints
src/main/java/com/royeen/smartpark/controller/ParkingLotController.java - Vehicle endpoint
src/main/java/com/royeen/smartpark/controller/VehicleController.java
Business logic
- Parking service
src/main/java/com/royeen/smartpark/business/service/ParkingLotServiceImpl.java - Vehicle service
src/main/java/com/royeen/smartpark/business/service/VehicleServiceImpl.java - Parking use cases
src/main/java/com/royeen/smartpark/business/usecase - Vehicle use cases
src/main/java/com/royeen/smartpark/business/usecase - Parked-vehicle query
src/main/java/com/royeen/smartpark/business/usecase/GetParkedVehiclesByParkingLotIdCommandImpl.java
Persistence
- Lot repository
src/main/java/com/royeen/smartpark/gateway/repository/ParkingLotRepository.java - Transaction repository
src/main/java/com/royeen/smartpark/gateway/repository/ParkingTransactionRepository.java - Vehicle repository
src/main/java/com/royeen/smartpark/gateway/repository/VehicleRepository.java
Models and errors
- Parking domain
src/main/java/com/royeen/smartpark/models/domain - API models
src/main/java/com/royeen/smartpark/models/presentation - Vehicle registration input
src/main/java/com/royeen/smartpark/models/RegisterVehicleRequest.java - Error handling
src/main/java/com/royeen/smartpark/exceptions/GlobalControllerHandler.java
Other components
- API client
- In-memory H2
Connections 18
- API client → Parking endpoints: calls parking routes
README.md - API client → Vehicle endpoint: registers vehicles
README.md - Parking endpoints → Parking service: delegates to
src/main/java/com/royeen/smartpark/controller/ParkingLotController.java - Vehicle endpoint → Vehicle service: delegates to
src/main/java/com/royeen/smartpark/controller/VehicleController.java - Parking service → Parking use cases: invokes
src/main/java/com/royeen/smartpark/business/service/ParkingLotServiceImpl.java - Parking service → Vehicle use cases: invokes
src/main/java/com/royeen/smartpark/business/service/ParkingLotServiceImpl.java - Vehicle service → Vehicle use cases: invokes
src/main/java/com/royeen/smartpark/business/service/VehicleServiceImpl.java - Parking service → Parking domain: uses
src/main/java/com/royeen/smartpark/business/service/ParkingLotServiceImpl.java - Parking service → API models: maps responses
src/main/java/com/royeen/smartpark/business/service/ParkingLotServiceImpl.java - Vehicle service → Vehicle registration input: accepts
src/main/java/com/royeen/smartpark/business/service/VehicleServiceImpl.java - Vehicle service → Parking domain: maps vehicle
src/main/java/com/royeen/smartpark/business/service/VehicleServiceImpl.java - Parked-vehicle query → Transaction repository: queries parked
src/main/java/com/royeen/smartpark/business/usecase/GetParkedVehiclesByParkingLotIdCommandImpl.java - Parked-vehicle query → Vehicle repository: loads vehicles
src/main/java/com/royeen/smartpark/business/usecase/GetParkedVehiclesByParkingLotIdCommandImpl.java - Parked-vehicle query → Parking domain: maps vehicles
src/main/java/com/royeen/smartpark/business/usecase/GetParkedVehiclesByParkingLotIdCommandImpl.java - Error handling → API models: formats errors
src/main/java/com/royeen/smartpark/exceptions/GlobalControllerHandler.java - Lot repository → In-memory H2: persists via JPA
- Transaction repository → In-memory H2: persists via JPA
- Vehicle repository → In-memory H2: persists via JPA