# nethmisilva-code/ridelink architecture

> Architecture diagram of the GitHub repository nethmisilva-code/ridelink, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nethmisilva-code/ridelink
- Repository: https://github.com/nethmisilva-code/ridelink

## Overview

This appears to be a Spring Boot service for managing driver and vehicle data, with JWT-based request security and an account-service client. The likely user workflow enters through driver or vehicle APIs and reaches corresponding services and repositories. The supplied excerpts contain no implementation bodies for those components, and the README is empty, so these connections are shown as unverified rather than asserted; storage technology and detailed behavior cannot be established.

Main entry points: [`driver-vehicle-service/src/main/java/com/ridelink/driver/controller/DriverController.java`](https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/controller/DriverController.java) (Driver API), [`driver-vehicle-service/src/main/java/com/ridelink/driver/controller/VehicleController.java`](https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/controller/VehicleController.java) (Vehicle API), [`driver-vehicle-service/src/main/java/com/ridelink/driver/service/DriverService.java`](https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/service/DriverService.java) (Driver service), [`driver-vehicle-service/src/main/java/com/ridelink/driver/service/VehicleService.java`](https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/service/VehicleService.java) (Vehicle service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["API entry"]
  node_app["Spring application"]
  node_driver_api["Driver API"]
  node_vehicle_api["Vehicle API"]
end

subgraph group_domain["Driver and vehicle"]
  node_driver_service["Driver service<br/>[DriverService.java]"]
  node_vehicle_service["Vehicle service"]
  node_driver_model["Driver model<br/>[Driver.java]"]
  node_location_model["Location model<br/>[Location.java]"]
  node_vehicle_model["Vehicle model<br/>[Vehicle.java]"]
end

subgraph group_security["Security and clients"]
  node_security_config["Security config"]
  node_jwt_filter["JWT filter<br/>[JwtAuthFilter.java]"]
  node_jwt_service["JWT service<br/>[JwtService.java]"]
  node_rest_config["HTTP client config"]
  node_account_client["Account client<br/>[AccountClient.java]"]
end

subgraph group_support["Persistence and errors"]
  node_driver_repo["Driver repository"]
  node_vehicle_repo["Vehicle repository"]
  node_exception_handler["Exception handler"]
end

node_user(("API caller"))

node_user -.->|"requests"| node_driver_api
node_user -.->|"requests"| node_vehicle_api
node_driver_api -.->|"delegates to"| node_driver_service
node_vehicle_api -.->|"delegates to"| node_vehicle_service
node_driver_service -.->|"uses"| node_driver_repo
node_vehicle_service -.->|"uses"| node_vehicle_repo
node_driver_repo -.->|"persists"| node_driver_model
node_vehicle_repo -.->|"persists"| node_vehicle_model
node_security_config -.->|"configures"| node_jwt_filter
node_jwt_filter -.->|"validates with"| node_jwt_service
node_rest_config -.->|"configures"| node_account_client

click node_app "https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/DriverVehicleServiceApplication.java"
click node_driver_api "https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/controller/DriverController.java"
click node_vehicle_api "https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/controller/VehicleController.java"
click node_driver_service "https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/service/DriverService.java"
click node_vehicle_service "https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/service/VehicleService.java"
click node_driver_model "https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/model/Driver.java"
click node_location_model "https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/model/Location.java"
click node_vehicle_model "https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/model/Vehicle.java"
click node_driver_repo "https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/repository/DriverRepository.java"
click node_vehicle_repo "https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/repository/VehicleRepository.java"
click node_security_config "https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/config/SecurityConfig.java"
click node_jwt_filter "https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/security/JwtAuthFilter.java"
click node_jwt_service "https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/security/JwtService.java"
click node_rest_config "https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/config/RestClientConfig.java"
click node_account_client "https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/client/AccountClient.java"
click node_exception_handler "https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/exception/GlobalExceptionHandler.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_app,node_driver_api,node_vehicle_api toneBlue
class node_driver_service,node_vehicle_service,node_driver_model,node_location_model,node_vehicle_model toneAmber
class node_security_config,node_jwt_filter,node_jwt_service,node_rest_config,node_account_client,node_user toneMint
class node_driver_repo,node_vehicle_repo,node_exception_handler toneRose
```

## Components

### API entry

- [Spring application](https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/DriverVehicleServiceApplication.java): `driver-vehicle-service/src/main/java/com/ridelink/driver/DriverVehicleServiceApplication.java`
- [Driver API](https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/controller/DriverController.java): `driver-vehicle-service/src/main/java/com/ridelink/driver/controller/DriverController.java`
- [Vehicle API](https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/controller/VehicleController.java): `driver-vehicle-service/src/main/java/com/ridelink/driver/controller/VehicleController.java`

### Driver and vehicle

- [Driver service](https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/service/DriverService.java): `driver-vehicle-service/src/main/java/com/ridelink/driver/service/DriverService.java`
- [Vehicle service](https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/service/VehicleService.java): `driver-vehicle-service/src/main/java/com/ridelink/driver/service/VehicleService.java`
- [Driver model](https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/model/Driver.java): `driver-vehicle-service/src/main/java/com/ridelink/driver/model/Driver.java`
- [Location model](https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/model/Location.java): `driver-vehicle-service/src/main/java/com/ridelink/driver/model/Location.java`
- [Vehicle model](https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/model/Vehicle.java): `driver-vehicle-service/src/main/java/com/ridelink/driver/model/Vehicle.java`

### Security and clients

- [Security config](https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/config/SecurityConfig.java): `driver-vehicle-service/src/main/java/com/ridelink/driver/config/SecurityConfig.java`
- [JWT filter](https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/security/JwtAuthFilter.java): `driver-vehicle-service/src/main/java/com/ridelink/driver/security/JwtAuthFilter.java`
- [JWT service](https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/security/JwtService.java): `driver-vehicle-service/src/main/java/com/ridelink/driver/security/JwtService.java`
- [HTTP client config](https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/config/RestClientConfig.java): `driver-vehicle-service/src/main/java/com/ridelink/driver/config/RestClientConfig.java`
- [Account client](https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/client/AccountClient.java): `driver-vehicle-service/src/main/java/com/ridelink/driver/client/AccountClient.java`

### Persistence and errors

- [Driver repository](https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/repository/DriverRepository.java): `driver-vehicle-service/src/main/java/com/ridelink/driver/repository/DriverRepository.java`
- [Vehicle repository](https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/repository/VehicleRepository.java): `driver-vehicle-service/src/main/java/com/ridelink/driver/repository/VehicleRepository.java`
- [Exception handler](https://github.com/nethmisilva-code/ridelink/blob/feature/driver-vehicle-service/driver-vehicle-service/src/main/java/com/ridelink/driver/exception/GlobalExceptionHandler.java): `driver-vehicle-service/src/main/java/com/ridelink/driver/exception/GlobalExceptionHandler.java`

### Other components

- **API caller**

## Connections

- API caller → Driver API: requests
- API caller → Vehicle API: requests
- Driver API → Driver service: delegates to
- Vehicle API → Vehicle service: delegates to
- Driver service → Driver repository: uses
- Vehicle service → Vehicle repository: uses
- Driver repository → Driver model: persists
- Vehicle repository → Vehicle model: persists
- Security config → JWT filter: configures
- JWT filter → JWT service: validates with
- HTTP client config → Account client: configures