# ruuuyin/smart-parking-test architecture

> Architecture diagram of the GitHub repository ruuuyin/smart-parking-test, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ruuuyin/smart-parking-test
- Repository: https://github.com/ruuuyin/smart-parking-test

## Overview

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: [`src/main/java/com/royeen/smartpark/business/service/ParkingLotServiceImpl.java`](https://github.com/ruuuyin/smart-parking-test/blob/main/src/main/java/com/royeen/smartpark/business/service/ParkingLotServiceImpl.java) (Parking service), [`src/main/java/com/royeen/smartpark/business/service/VehicleServiceImpl.java`](https://github.com/ruuuyin/smart-parking-test/blob/main/src/main/java/com/royeen/smartpark/business/service/VehicleServiceImpl.java) (Vehicle service), [`src/main/java/com/royeen/smartpark/business/usecase/GetParkedVehiclesByParkingLotIdCommandImpl.java`](https://github.com/ruuuyin/smart-parking-test/blob/main/src/main/java/com/royeen/smartpark/business/usecase/GetParkedVehiclesByParkingLotIdCommandImpl.java) (Parked-vehicle query), [`src/main/java/com/royeen/smartpark/models/domain`](https://github.com/ruuuyin/smart-parking-test/tree/main/src/main/java/com/royeen/smartpark/models/domain) (Parking domain)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API layer"]
  node_parking_api["Parking endpoints"]
  node_vehicle_api["Vehicle endpoint"]
end

subgraph group_business["Business logic"]
  node_parking_service["Parking service"]
  node_vehicle_service["Vehicle service"]
  node_parking_usecases["Parking use cases"]
  node_vehicle_usecases["Vehicle use cases"]
  node_vehicle_list_usecase["Parked-vehicle query"]
end

subgraph group_data["Persistence"]
  node_lot_repo["Lot repository"]
  node_transaction_repo["Transaction repository"]
  node_vehicle_repo["Vehicle repository"]
end

subgraph group_models["Models and errors"]
  node_domain["Parking domain"]
  node_api_models["API models"]
  node_vehicle_request["Vehicle registration input"]
  node_error_handler["Error handling"]
end

node_client(("API client"))
node_h2[("In-memory H2")]

node_client -->|"calls parking routes"| node_parking_api
node_client -->|"registers vehicles"| node_vehicle_api
node_parking_api -->|"delegates to"| node_parking_service
node_vehicle_api -->|"delegates to"| node_vehicle_service
node_parking_service -->|"invokes"| node_parking_usecases
node_parking_service -->|"invokes"| node_vehicle_usecases
node_vehicle_service -->|"invokes"| node_vehicle_usecases
node_parking_service -->|"uses"| node_domain
node_parking_service -->|"maps responses"| node_api_models
node_vehicle_service -->|"accepts"| node_vehicle_request
node_vehicle_service -->|"maps vehicle"| node_domain
node_vehicle_list_usecase -->|"queries parked"| node_transaction_repo
node_vehicle_list_usecase -->|"loads vehicles"| node_vehicle_repo
node_vehicle_list_usecase -->|"maps vehicles"| node_domain
node_error_handler -->|"formats errors"| node_api_models
node_lot_repo -.->|"persists via JPA"| node_h2
node_transaction_repo -.->|"persists via JPA"| node_h2
node_vehicle_repo -.->|"persists via JPA"| node_h2

click node_parking_api "https://github.com/ruuuyin/smart-parking-test/blob/main/src/main/java/com/royeen/smartpark/controller/ParkingLotController.java"
click node_vehicle_api "https://github.com/ruuuyin/smart-parking-test/blob/main/src/main/java/com/royeen/smartpark/controller/VehicleController.java"
click node_parking_service "https://github.com/ruuuyin/smart-parking-test/blob/main/src/main/java/com/royeen/smartpark/business/service/ParkingLotServiceImpl.java"
click node_vehicle_service "https://github.com/ruuuyin/smart-parking-test/blob/main/src/main/java/com/royeen/smartpark/business/service/VehicleServiceImpl.java"
click node_parking_usecases "https://github.com/ruuuyin/smart-parking-test/tree/main/src/main/java/com/royeen/smartpark/business/usecase"
click node_vehicle_usecases "https://github.com/ruuuyin/smart-parking-test/tree/main/src/main/java/com/royeen/smartpark/business/usecase"
click node_vehicle_list_usecase "https://github.com/ruuuyin/smart-parking-test/blob/main/src/main/java/com/royeen/smartpark/business/usecase/GetParkedVehiclesByParkingLotIdCommandImpl.java"
click node_lot_repo "https://github.com/ruuuyin/smart-parking-test/blob/main/src/main/java/com/royeen/smartpark/gateway/repository/ParkingLotRepository.java"
click node_transaction_repo "https://github.com/ruuuyin/smart-parking-test/blob/main/src/main/java/com/royeen/smartpark/gateway/repository/ParkingTransactionRepository.java"
click node_vehicle_repo "https://github.com/ruuuyin/smart-parking-test/blob/main/src/main/java/com/royeen/smartpark/gateway/repository/VehicleRepository.java"
click node_domain "https://github.com/ruuuyin/smart-parking-test/tree/main/src/main/java/com/royeen/smartpark/models/domain"
click node_api_models "https://github.com/ruuuyin/smart-parking-test/tree/main/src/main/java/com/royeen/smartpark/models/presentation"
click node_vehicle_request "https://github.com/ruuuyin/smart-parking-test/blob/main/src/main/java/com/royeen/smartpark/models/RegisterVehicleRequest.java"
click node_error_handler "https://github.com/ruuuyin/smart-parking-test/blob/main/src/main/java/com/royeen/smartpark/exceptions/GlobalControllerHandler.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_parking_api,node_vehicle_api,node_client toneBlue
class node_parking_service,node_vehicle_service,node_parking_usecases,node_vehicle_usecases,node_vehicle_list_usecase,node_h2 toneAmber
class node_lot_repo,node_transaction_repo,node_vehicle_repo toneMint
class node_domain,node_api_models,node_vehicle_request,node_error_handler toneRose
```

## Components

### API layer

- [Parking endpoints](https://github.com/ruuuyin/smart-parking-test/blob/main/src/main/java/com/royeen/smartpark/controller/ParkingLotController.java): `src/main/java/com/royeen/smartpark/controller/ParkingLotController.java`
- [Vehicle endpoint](https://github.com/ruuuyin/smart-parking-test/blob/main/src/main/java/com/royeen/smartpark/controller/VehicleController.java): `src/main/java/com/royeen/smartpark/controller/VehicleController.java`

### Business logic

- [Parking service](https://github.com/ruuuyin/smart-parking-test/blob/main/src/main/java/com/royeen/smartpark/business/service/ParkingLotServiceImpl.java): `src/main/java/com/royeen/smartpark/business/service/ParkingLotServiceImpl.java`
- [Vehicle service](https://github.com/ruuuyin/smart-parking-test/blob/main/src/main/java/com/royeen/smartpark/business/service/VehicleServiceImpl.java): `src/main/java/com/royeen/smartpark/business/service/VehicleServiceImpl.java`
- [Parking use cases](https://github.com/ruuuyin/smart-parking-test/tree/main/src/main/java/com/royeen/smartpark/business/usecase): `src/main/java/com/royeen/smartpark/business/usecase`
- [Vehicle use cases](https://github.com/ruuuyin/smart-parking-test/tree/main/src/main/java/com/royeen/smartpark/business/usecase): `src/main/java/com/royeen/smartpark/business/usecase`
- [Parked-vehicle query](https://github.com/ruuuyin/smart-parking-test/blob/main/src/main/java/com/royeen/smartpark/business/usecase/GetParkedVehiclesByParkingLotIdCommandImpl.java): `src/main/java/com/royeen/smartpark/business/usecase/GetParkedVehiclesByParkingLotIdCommandImpl.java`

### Persistence

- [Lot repository](https://github.com/ruuuyin/smart-parking-test/blob/main/src/main/java/com/royeen/smartpark/gateway/repository/ParkingLotRepository.java): `src/main/java/com/royeen/smartpark/gateway/repository/ParkingLotRepository.java`
- [Transaction repository](https://github.com/ruuuyin/smart-parking-test/blob/main/src/main/java/com/royeen/smartpark/gateway/repository/ParkingTransactionRepository.java): `src/main/java/com/royeen/smartpark/gateway/repository/ParkingTransactionRepository.java`
- [Vehicle repository](https://github.com/ruuuyin/smart-parking-test/blob/main/src/main/java/com/royeen/smartpark/gateway/repository/VehicleRepository.java): `src/main/java/com/royeen/smartpark/gateway/repository/VehicleRepository.java`

### Models and errors

- [Parking domain](https://github.com/ruuuyin/smart-parking-test/tree/main/src/main/java/com/royeen/smartpark/models/domain): `src/main/java/com/royeen/smartpark/models/domain`
- [API models](https://github.com/ruuuyin/smart-parking-test/tree/main/src/main/java/com/royeen/smartpark/models/presentation): `src/main/java/com/royeen/smartpark/models/presentation`
- [Vehicle registration input](https://github.com/ruuuyin/smart-parking-test/blob/main/src/main/java/com/royeen/smartpark/models/RegisterVehicleRequest.java): `src/main/java/com/royeen/smartpark/models/RegisterVehicleRequest.java`
- [Error handling](https://github.com/ruuuyin/smart-parking-test/blob/main/src/main/java/com/royeen/smartpark/exceptions/GlobalControllerHandler.java): `src/main/java/com/royeen/smartpark/exceptions/GlobalControllerHandler.java`

### Other components

- **API client**
- **In-memory H2**

## Connections

- API client → Parking endpoints: calls parking routes (evidence: `README.md`)
- API client → Vehicle endpoint: registers vehicles (evidence: `README.md`)
- Parking endpoints → Parking service: delegates to (evidence: `src/main/java/com/royeen/smartpark/controller/ParkingLotController.java`)
- Vehicle endpoint → Vehicle service: delegates to (evidence: `src/main/java/com/royeen/smartpark/controller/VehicleController.java`)
- Parking service → Parking use cases: invokes (evidence: `src/main/java/com/royeen/smartpark/business/service/ParkingLotServiceImpl.java`)
- Parking service → Vehicle use cases: invokes (evidence: `src/main/java/com/royeen/smartpark/business/service/ParkingLotServiceImpl.java`)
- Vehicle service → Vehicle use cases: invokes (evidence: `src/main/java/com/royeen/smartpark/business/service/VehicleServiceImpl.java`)
- Parking service → Parking domain: uses (evidence: `src/main/java/com/royeen/smartpark/business/service/ParkingLotServiceImpl.java`)
- Parking service → API models: maps responses (evidence: `src/main/java/com/royeen/smartpark/business/service/ParkingLotServiceImpl.java`)
- Vehicle service → Vehicle registration input: accepts (evidence: `src/main/java/com/royeen/smartpark/business/service/VehicleServiceImpl.java`)
- Vehicle service → Parking domain: maps vehicle (evidence: `src/main/java/com/royeen/smartpark/business/service/VehicleServiceImpl.java`)
- Parked-vehicle query → Transaction repository: queries parked (evidence: `src/main/java/com/royeen/smartpark/business/usecase/GetParkedVehiclesByParkingLotIdCommandImpl.java`)
- Parked-vehicle query → Vehicle repository: loads vehicles (evidence: `src/main/java/com/royeen/smartpark/business/usecase/GetParkedVehiclesByParkingLotIdCommandImpl.java`)
- Parked-vehicle query → Parking domain: maps vehicles (evidence: `src/main/java/com/royeen/smartpark/business/usecase/GetParkedVehiclesByParkingLotIdCommandImpl.java`)
- Error handling → API models: formats errors (evidence: `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
