# saifmejri/autoloc architecture

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

- Interactive diagram: https://gitdiagram.com/saifmejri/autoloc
- Repository: https://github.com/saifmejri/autoloc

## Overview

AutoLoc is a Spring application for managing vehicle rentals. The main user workflow is to call a REST endpoint, which delegates to a service for rental operations such as reservations or vehicle management, then persists domain data through repositories. The tree also shows distinct contract, payment, maintenance, fleet, staff, and pricing/notification capabilities. Edges backed by excerpts or the SOURCE INDEX are cited; dashed edges indicate plausible connections not verified in the sampled source. The README provides no further product detail.

Main entry points: [`tp-autoloc/src/main/java/tn/esprit/autoloc/service/impl/ReservationServiceImpl.java`](https://github.com/saifmejri/autoloc/blob/main/tp-autoloc/src/main/java/tn/esprit/autoloc/service/impl/ReservationServiceImpl.java) (Reservation service), [`tp-autoloc/src/main/java/tn/esprit/autoloc/repository`](https://github.com/saifmejri/autoloc/tree/main/tp-autoloc/src/main/java/tn/esprit/autoloc/repository) (JPA repositories), [`tp-autoloc/src/main/java/tn/esprit/autoloc/service/impl/VehiculeServiceImpl.java`](https://github.com/saifmejri/autoloc/blob/main/tp-autoloc/src/main/java/tn/esprit/autoloc/service/impl/VehiculeServiceImpl.java) (Vehicle service), [`tp-autoloc/src/main/java/tn/esprit/autoloc/service/impl/EmployeServiceImpl.java`](https://github.com/saifmejri/autoloc/blob/main/tp-autoloc/src/main/java/tn/esprit/autoloc/service/impl/EmployeServiceImpl.java) (Employee service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_reservation_api["Reservation endpoints"]
  node_fleet_api["Vehicle endpoints"]
  node_staff_api["Employee endpoints"]
  node_other_api["Other endpoints"]
  node_exception_handler["Exception handling"]
end

subgraph group_operations["Rental Operations"]
  node_reservation_service["Reservation service"]
  node_contract_service["Contract service"]
  node_payment_service["Payment service"]
  node_other_services["Other services"]
end

subgraph group_fleet["Fleet Administration"]
  node_maintenance_service["Maintenance service"]
  node_vehicle_service["Vehicle service"]
  node_employee_service["Employee service"]
end

subgraph group_data["Persistence and Domain"]
  node_reservation_model["Reservation model<br/>[Reservation.java]"]
  node_client_model["Client model<br/>[Client.java]"]
  node_vehicle_model["Vehicle model<br/>[Vehicule.java]"]
  node_fleet_models["Fleet and staff models"]
  node_repositories["JPA repositories"]
  node_database[("Relational database")]
end

subgraph group_support["Pricing and Notifications"]
  node_pricing_factory["Pricing strategy factory"]
  node_pricing_strategies["Pricing strategies"]
  node_reservation_observers["Reservation observers"]
end

node_user(("API client"))
node_notifications["Email / SMS services"]

node_user -->|"calls"| node_reservation_api
node_user -->|"calls"| node_fleet_api
node_user -->|"calls"| node_staff_api
node_reservation_api -->|"delegates to"| node_reservation_service
node_fleet_api -->|"delegates to"| node_vehicle_service
node_staff_api -->|"delegates to"| node_employee_service
node_other_api -.->|"delegates to"| node_other_services
node_reservation_service -->|"reads and writes"| node_repositories
node_maintenance_service -->|"reads and writes"| node_repositories
node_vehicle_service -->|"reads and writes"| node_repositories
node_employee_service -->|"reads and writes"| node_repositories
node_repositories -.->|"persists"| node_database
node_reservation_service -->|"manages"| node_reservation_model
node_reservation_model -->|"references"| node_client_model
node_reservation_model -->|"references"| node_vehicle_model
node_vehicle_service -->|"assigns agency"| node_fleet_models
node_employee_service -->|"assigns agency"| node_fleet_models
node_reservation_service -.->|"obtains pricing"| node_pricing_factory
node_pricing_factory -->|"selects strategy"| node_pricing_strategies
node_reservation_service -.->|"notifies"| node_reservation_observers
node_reservation_observers -.->|"sends notices"| node_notifications
node_exception_handler -.->|"handles errors"| node_reservation_service

click node_reservation_api "https://github.com/saifmejri/autoloc/blob/main/tp-autoloc/src/main/java/tn/esprit/autoloc/web/controller/ReservationController.java"
click node_fleet_api "https://github.com/saifmejri/autoloc/blob/main/tp-autoloc/src/main/java/tn/esprit/autoloc/web/controller/VehiculeController.java"
click node_staff_api "https://github.com/saifmejri/autoloc/blob/main/tp-autoloc/src/main/java/tn/esprit/autoloc/web/controller/EmployeController.java"
click node_other_api "https://github.com/saifmejri/autoloc/tree/main/tp-autoloc/src/main/java/tn/esprit/autoloc/web/controller"
click node_reservation_service "https://github.com/saifmejri/autoloc/blob/main/tp-autoloc/src/main/java/tn/esprit/autoloc/service/impl/ReservationServiceImpl.java"
click node_contract_service "https://github.com/saifmejri/autoloc/blob/main/tp-autoloc/src/main/java/tn/esprit/autoloc/service/impl/ContratServiceImpl.java"
click node_payment_service "https://github.com/saifmejri/autoloc/blob/main/tp-autoloc/src/main/java/tn/esprit/autoloc/service/impl/PaiementServiceImpl.java"
click node_maintenance_service "https://github.com/saifmejri/autoloc/blob/main/tp-autoloc/src/main/java/tn/esprit/autoloc/service/impl/MaintenanceServiceImpl.java"
click node_vehicle_service "https://github.com/saifmejri/autoloc/blob/main/tp-autoloc/src/main/java/tn/esprit/autoloc/service/impl/VehiculeServiceImpl.java"
click node_employee_service "https://github.com/saifmejri/autoloc/blob/main/tp-autoloc/src/main/java/tn/esprit/autoloc/service/impl/EmployeServiceImpl.java"
click node_other_services "https://github.com/saifmejri/autoloc/tree/main/tp-autoloc/src/main/java/tn/esprit/autoloc/service/impl"
click node_reservation_model "https://github.com/saifmejri/autoloc/blob/main/tp-autoloc/src/main/java/tn/esprit/autoloc/domain/Reservation.java"
click node_client_model "https://github.com/saifmejri/autoloc/blob/main/tp-autoloc/src/main/java/tn/esprit/autoloc/domain/Client.java"
click node_vehicle_model "https://github.com/saifmejri/autoloc/blob/main/tp-autoloc/src/main/java/tn/esprit/autoloc/domain/Vehicule.java"
click node_fleet_models "https://github.com/saifmejri/autoloc/tree/main/tp-autoloc/src/main/java/tn/esprit/autoloc/domain"
click node_repositories "https://github.com/saifmejri/autoloc/tree/main/tp-autoloc/src/main/java/tn/esprit/autoloc/repository"
click node_pricing_factory "https://github.com/saifmejri/autoloc/blob/main/tp-autoloc/src/main/java/tn/esprit/autoloc/service/Factory/TarificationStrategyFactory.java"
click node_pricing_strategies "https://github.com/saifmejri/autoloc/tree/main/tp-autoloc/src/main/java/tn/esprit/autoloc/service/strategy"
click node_reservation_observers "https://github.com/saifmejri/autoloc/tree/main/tp-autoloc/src/main/java/tn/esprit/autoloc/service/observer"
click node_exception_handler "https://github.com/saifmejri/autoloc/blob/main/tp-autoloc/src/main/java/tn/esprit/autoloc/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_reservation_api,node_fleet_api,node_staff_api,node_other_api,node_exception_handler,node_user toneBlue
class node_reservation_service,node_contract_service,node_payment_service,node_other_services toneAmber
class node_maintenance_service,node_vehicle_service,node_employee_service toneMint
class node_reservation_model,node_client_model,node_vehicle_model,node_fleet_models,node_repositories,node_database toneRose
class node_pricing_factory,node_pricing_strategies,node_reservation_observers,node_notifications toneIndigo
```

## Components

### REST API

- [Reservation endpoints](https://github.com/saifmejri/autoloc/blob/main/tp-autoloc/src/main/java/tn/esprit/autoloc/web/controller/ReservationController.java): `tp-autoloc/src/main/java/tn/esprit/autoloc/web/controller/ReservationController.java`
- [Vehicle endpoints](https://github.com/saifmejri/autoloc/blob/main/tp-autoloc/src/main/java/tn/esprit/autoloc/web/controller/VehiculeController.java): `tp-autoloc/src/main/java/tn/esprit/autoloc/web/controller/VehiculeController.java`
- [Employee endpoints](https://github.com/saifmejri/autoloc/blob/main/tp-autoloc/src/main/java/tn/esprit/autoloc/web/controller/EmployeController.java): `tp-autoloc/src/main/java/tn/esprit/autoloc/web/controller/EmployeController.java`
- [Other endpoints](https://github.com/saifmejri/autoloc/tree/main/tp-autoloc/src/main/java/tn/esprit/autoloc/web/controller): `tp-autoloc/src/main/java/tn/esprit/autoloc/web/controller`
- [Exception handling](https://github.com/saifmejri/autoloc/blob/main/tp-autoloc/src/main/java/tn/esprit/autoloc/exception/GlobalExceptionHandler.java): `tp-autoloc/src/main/java/tn/esprit/autoloc/exception/GlobalExceptionHandler.java`

### Rental Operations

- [Reservation service](https://github.com/saifmejri/autoloc/blob/main/tp-autoloc/src/main/java/tn/esprit/autoloc/service/impl/ReservationServiceImpl.java): `tp-autoloc/src/main/java/tn/esprit/autoloc/service/impl/ReservationServiceImpl.java`
- [Contract service](https://github.com/saifmejri/autoloc/blob/main/tp-autoloc/src/main/java/tn/esprit/autoloc/service/impl/ContratServiceImpl.java): `tp-autoloc/src/main/java/tn/esprit/autoloc/service/impl/ContratServiceImpl.java`
- [Payment service](https://github.com/saifmejri/autoloc/blob/main/tp-autoloc/src/main/java/tn/esprit/autoloc/service/impl/PaiementServiceImpl.java): `tp-autoloc/src/main/java/tn/esprit/autoloc/service/impl/PaiementServiceImpl.java`
- [Other services](https://github.com/saifmejri/autoloc/tree/main/tp-autoloc/src/main/java/tn/esprit/autoloc/service/impl): `tp-autoloc/src/main/java/tn/esprit/autoloc/service/impl`

### Fleet Administration

- [Maintenance service](https://github.com/saifmejri/autoloc/blob/main/tp-autoloc/src/main/java/tn/esprit/autoloc/service/impl/MaintenanceServiceImpl.java): `tp-autoloc/src/main/java/tn/esprit/autoloc/service/impl/MaintenanceServiceImpl.java`
- [Vehicle service](https://github.com/saifmejri/autoloc/blob/main/tp-autoloc/src/main/java/tn/esprit/autoloc/service/impl/VehiculeServiceImpl.java): `tp-autoloc/src/main/java/tn/esprit/autoloc/service/impl/VehiculeServiceImpl.java`
- [Employee service](https://github.com/saifmejri/autoloc/blob/main/tp-autoloc/src/main/java/tn/esprit/autoloc/service/impl/EmployeServiceImpl.java): `tp-autoloc/src/main/java/tn/esprit/autoloc/service/impl/EmployeServiceImpl.java`

### Persistence and Domain

- [Reservation model](https://github.com/saifmejri/autoloc/blob/main/tp-autoloc/src/main/java/tn/esprit/autoloc/domain/Reservation.java): `tp-autoloc/src/main/java/tn/esprit/autoloc/domain/Reservation.java`
- [Client model](https://github.com/saifmejri/autoloc/blob/main/tp-autoloc/src/main/java/tn/esprit/autoloc/domain/Client.java): `tp-autoloc/src/main/java/tn/esprit/autoloc/domain/Client.java`
- [Vehicle model](https://github.com/saifmejri/autoloc/blob/main/tp-autoloc/src/main/java/tn/esprit/autoloc/domain/Vehicule.java): `tp-autoloc/src/main/java/tn/esprit/autoloc/domain/Vehicule.java`
- [Fleet and staff models](https://github.com/saifmejri/autoloc/tree/main/tp-autoloc/src/main/java/tn/esprit/autoloc/domain): `tp-autoloc/src/main/java/tn/esprit/autoloc/domain`
- [JPA repositories](https://github.com/saifmejri/autoloc/tree/main/tp-autoloc/src/main/java/tn/esprit/autoloc/repository): `tp-autoloc/src/main/java/tn/esprit/autoloc/repository`
- **Relational database**

### Pricing and Notifications

- [Pricing strategy factory](https://github.com/saifmejri/autoloc/blob/main/tp-autoloc/src/main/java/tn/esprit/autoloc/service/Factory/TarificationStrategyFactory.java): `tp-autoloc/src/main/java/tn/esprit/autoloc/service/Factory/TarificationStrategyFactory.java`
- [Pricing strategies](https://github.com/saifmejri/autoloc/tree/main/tp-autoloc/src/main/java/tn/esprit/autoloc/service/strategy): `tp-autoloc/src/main/java/tn/esprit/autoloc/service/strategy`
- [Reservation observers](https://github.com/saifmejri/autoloc/tree/main/tp-autoloc/src/main/java/tn/esprit/autoloc/service/observer): `tp-autoloc/src/main/java/tn/esprit/autoloc/service/observer`

### Other components

- **API client**
- **Email / SMS services**

## Connections

- API client → Reservation endpoints: calls (evidence: `tp-autoloc/src/main/java/tn/esprit/autoloc/web/controller/ReservationController.java`)
- API client → Vehicle endpoints: calls (evidence: `tp-autoloc/src/main/java/tn/esprit/autoloc/web/controller/VehiculeController.java`)
- API client → Employee endpoints: calls (evidence: `tp-autoloc/src/main/java/tn/esprit/autoloc/web/controller/EmployeController.java`)
- Reservation endpoints → Reservation service: delegates to (evidence: `tp-autoloc/src/main/java/tn/esprit/autoloc/web/controller/ReservationController.java`)
- Vehicle endpoints → Vehicle service: delegates to (evidence: `tp-autoloc/src/main/java/tn/esprit/autoloc/web/controller/VehiculeController.java`)
- Employee endpoints → Employee service: delegates to (evidence: `tp-autoloc/src/main/java/tn/esprit/autoloc/web/controller/EmployeController.java`)
- Other endpoints → Other services: delegates to
- Reservation service → JPA repositories: reads and writes (evidence: `tp-autoloc/src/main/java/tn/esprit/autoloc/service/impl/ReservationServiceImpl.java`)
- Maintenance service → JPA repositories: reads and writes (evidence: `tp-autoloc/src/main/java/tn/esprit/autoloc/service/impl/MaintenanceServiceImpl.java`)
- Vehicle service → JPA repositories: reads and writes (evidence: `tp-autoloc/src/main/java/tn/esprit/autoloc/service/impl/VehiculeServiceImpl.java`)
- Employee service → JPA repositories: reads and writes (evidence: `tp-autoloc/src/main/java/tn/esprit/autoloc/service/impl/EmployeServiceImpl.java`)
- JPA repositories → Relational database: persists
- Reservation service → Reservation model: manages (evidence: `tp-autoloc/src/main/java/tn/esprit/autoloc/service/impl/ReservationServiceImpl.java`)
- Reservation model → Client model: references (evidence: `tp-autoloc/src/main/java/tn/esprit/autoloc/domain/Reservation.java`)
- Reservation model → Vehicle model: references (evidence: `tp-autoloc/src/main/java/tn/esprit/autoloc/domain/Reservation.java`)
- Vehicle service → Fleet and staff models: assigns agency (evidence: `tp-autoloc/src/main/java/tn/esprit/autoloc/service/impl/VehiculeServiceImpl.java`)
- Employee service → Fleet and staff models: assigns agency (evidence: `tp-autoloc/src/main/java/tn/esprit/autoloc/service/impl/EmployeServiceImpl.java`)
- Reservation service → Pricing strategy factory: obtains pricing
- Pricing strategy factory → Pricing strategies: selects strategy (evidence: `tp-autoloc/src/main/java/tn/esprit/autoloc/service/Factory/TarificationStrategyFactory.java`)
- Reservation service → Reservation observers: notifies
- Reservation observers → Email / SMS services: sends notices
- Exception handling → Reservation service: handles errors
