# hammamimariam/parckingauto architecture

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

- Interactive diagram: https://gitdiagram.com/hammamimariam/parckingauto
- Repository: https://github.com/hammamimariam/parckingauto

## Overview

ParckingAuto is a Tunisian fleet and parking-management web application: Blazor users submit operational requests to a REST API, which applies business rules and persists fleet records. The documented backend layering is controllers, services, repositories, and an EF Core context; statistics and dashboard capabilities are also documented. The graph preserves major feature stages, authentication, shared DTOs, and storage. Several feature implementations were not sampled, so their internal call paths are omitted rather than inferred.

Main entry points: [`ParckingAuto/Program.cs`](https://github.com/hammamimariam/parckingauto/blob/main/ParckingAuto/Program.cs) (API host), [`ParckingAuto/Services`](https://github.com/hammamimariam/parckingauto/tree/main/ParckingAuto/Services) (Business services), [`ParckingAuto/Data/ParcAutoContext.cs`](https://github.com/hammamimariam/parckingauto/blob/main/ParckingAuto/Data/ParcAutoContext.cs) (EF data context), [`Front/Program.cs`](https://github.com/hammamimariam/parckingauto/blob/main/Front/Program.cs) (Blazor client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_front["Blazor client<br/>[Program.cs]"]
  node_authui["Client authentication<br/>[AuthService.cs]"]
  node_shared["Shared DTOs<br/>[VehiculeDto.cs]"]
end

subgraph group_api["REST API"]
  node_api["API host<br/>[Program.cs]"]
  node_auth["JWT authentication<br/>[JwtService.cs]"]
  node_services["Business services"]
  node_repositories["Data repositories"]
end

subgraph group_domain["Fleet capabilities"]
  node_vehicles["Vehicle management"]
  node_parking["Parking movements"]
  node_fuel["Fuel tracking"]
  node_maintenance["Maintenance records"]
  node_alerts["Automatic alerts<br/>[AlerteService.cs]"]
  node_documents["Document archive<br/>[OcrController.cs]"]
  node_drivers["Driver management"]
  node_dashboard["Dashboard"]
  node_statistics["Statistics exports"]
  node_users["User administration"]
  node_settings["Settings"]
  node_audit["Audit trail<br/>[AuditService.cs]"]
end

subgraph group_storage["Persistence"]
  node_context["EF data context<br/>[ParcAutoContext.cs]"]
  node_mysql[("MySQL database")]
end

node_user(("Fleet users"))

node_user -->|"uses"| node_front
node_front -->|"REST requests"| node_api
node_authui -->|"posts login"| node_api
node_api -->|"registers"| node_auth
node_api -->|"routes requests"| node_vehicles
node_api -->|"routes requests"| node_parking
node_api -->|"routes requests"| node_fuel
node_api -->|"routes requests"| node_maintenance
node_api -->|"routes requests"| node_alerts
node_api -.->|"routes requests"| node_documents
node_api -.->|"routes requests"| node_drivers
node_api -.->|"routes requests"| node_dashboard
node_api -->|"routes requests"| node_statistics
node_api -->|"routes requests"| node_users
node_api -->|"routes requests"| node_settings
node_vehicles -->|"business logic"| node_services
node_parking -->|"business logic"| node_services
node_fuel -->|"business logic"| node_services
node_maintenance -->|"business logic"| node_services
node_alerts -->|"business logic"| node_services
node_services -->|"uses"| node_repositories
node_repositories -->|"queries"| node_context
node_dashboard -->|"reads data"| node_context
node_statistics -->|"queries data"| node_context
node_context -->|"persists records"| node_mysql
node_front -->|"exchanges DTOs"| node_shared
node_api -->|"exchanges DTOs"| node_shared
node_api -->|"registers service"| node_audit
node_api -->|"registers repositories"| node_repositories

click node_front "https://github.com/hammamimariam/parckingauto/blob/main/Front/Program.cs"
click node_authui "https://github.com/hammamimariam/parckingauto/blob/main/Front/Services/AuthService.cs"
click node_shared "https://github.com/hammamimariam/parckingauto/blob/main/Partagee/DTO/VehiculeDto.cs"
click node_api "https://github.com/hammamimariam/parckingauto/blob/main/ParckingAuto/Program.cs"
click node_auth "https://github.com/hammamimariam/parckingauto/blob/main/ParckingAuto/Services/JwtService.cs"
click node_vehicles "https://github.com/hammamimariam/parckingauto/blob/main/ParckingAuto/Controllers/VehiculesController.cs"
click node_parking "https://github.com/hammamimariam/parckingauto/blob/main/ParckingAuto/Controllers/MouvementsController.cs"
click node_fuel "https://github.com/hammamimariam/parckingauto/blob/main/ParckingAuto/Controllers/CarburantController.cs"
click node_maintenance "https://github.com/hammamimariam/parckingauto/blob/main/ParckingAuto/Controllers/MaintenanceController.cs"
click node_alerts "https://github.com/hammamimariam/parckingauto/blob/main/ParckingAuto/Services/AlerteService.cs"
click node_documents "https://github.com/hammamimariam/parckingauto/blob/main/ParckingAuto/Controllers/OcrController.cs"
click node_drivers "https://github.com/hammamimariam/parckingauto/blob/main/ParckingAuto/Controllers/ChauffeursController.cs"
click node_dashboard "https://github.com/hammamimariam/parckingauto/blob/main/ParckingAuto/Controllers/DashboardController.cs"
click node_statistics "https://github.com/hammamimariam/parckingauto/blob/main/ParckingAuto/Controllers/StatistiquesController.cs"
click node_users "https://github.com/hammamimariam/parckingauto/blob/main/ParckingAuto/Controllers/UtilisateursController.cs"
click node_settings "https://github.com/hammamimariam/parckingauto/blob/main/ParckingAuto/Controllers/SettingsController.cs"
click node_audit "https://github.com/hammamimariam/parckingauto/blob/main/ParckingAuto/Services/AuditService.cs"
click node_services "https://github.com/hammamimariam/parckingauto/tree/main/ParckingAuto/Services"
click node_repositories "https://github.com/hammamimariam/parckingauto/tree/main/ParckingAuto/Repositories"
click node_context "https://github.com/hammamimariam/parckingauto/blob/main/ParckingAuto/Data/ParcAutoContext.cs"

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_front,node_authui,node_shared,node_user toneBlue
class node_api,node_auth,node_services,node_repositories toneAmber
class node_vehicles,node_parking,node_fuel,node_maintenance,node_alerts,node_documents,node_drivers,node_dashboard,node_statistics,node_users,node_settings,node_audit toneMint
class node_context,node_mysql toneRose
```

## Components

### Web client

- [Blazor client](https://github.com/hammamimariam/parckingauto/blob/main/Front/Program.cs): `Front/Program.cs`
- [Client authentication](https://github.com/hammamimariam/parckingauto/blob/main/Front/Services/AuthService.cs): `Front/Services/AuthService.cs`
- [Shared DTOs](https://github.com/hammamimariam/parckingauto/blob/main/Partagee/DTO/VehiculeDto.cs): `Partagee/DTO/VehiculeDto.cs`

### REST API

- [API host](https://github.com/hammamimariam/parckingauto/blob/main/ParckingAuto/Program.cs): `ParckingAuto/Program.cs`
- [JWT authentication](https://github.com/hammamimariam/parckingauto/blob/main/ParckingAuto/Services/JwtService.cs): `ParckingAuto/Services/JwtService.cs`
- [Business services](https://github.com/hammamimariam/parckingauto/tree/main/ParckingAuto/Services): `ParckingAuto/Services`
- [Data repositories](https://github.com/hammamimariam/parckingauto/tree/main/ParckingAuto/Repositories): `ParckingAuto/Repositories`

### Fleet capabilities

- [Vehicle management](https://github.com/hammamimariam/parckingauto/blob/main/ParckingAuto/Controllers/VehiculesController.cs): `ParckingAuto/Controllers/VehiculesController.cs`
- [Parking movements](https://github.com/hammamimariam/parckingauto/blob/main/ParckingAuto/Controllers/MouvementsController.cs): `ParckingAuto/Controllers/MouvementsController.cs`
- [Fuel tracking](https://github.com/hammamimariam/parckingauto/blob/main/ParckingAuto/Controllers/CarburantController.cs): `ParckingAuto/Controllers/CarburantController.cs`
- [Maintenance records](https://github.com/hammamimariam/parckingauto/blob/main/ParckingAuto/Controllers/MaintenanceController.cs): `ParckingAuto/Controllers/MaintenanceController.cs`
- [Automatic alerts](https://github.com/hammamimariam/parckingauto/blob/main/ParckingAuto/Services/AlerteService.cs): `ParckingAuto/Services/AlerteService.cs`
- [Document archive](https://github.com/hammamimariam/parckingauto/blob/main/ParckingAuto/Controllers/OcrController.cs): `ParckingAuto/Controllers/OcrController.cs`
- [Driver management](https://github.com/hammamimariam/parckingauto/blob/main/ParckingAuto/Controllers/ChauffeursController.cs): `ParckingAuto/Controllers/ChauffeursController.cs`
- [Dashboard](https://github.com/hammamimariam/parckingauto/blob/main/ParckingAuto/Controllers/DashboardController.cs): `ParckingAuto/Controllers/DashboardController.cs`
- [Statistics exports](https://github.com/hammamimariam/parckingauto/blob/main/ParckingAuto/Controllers/StatistiquesController.cs): `ParckingAuto/Controllers/StatistiquesController.cs`
- [User administration](https://github.com/hammamimariam/parckingauto/blob/main/ParckingAuto/Controllers/UtilisateursController.cs): `ParckingAuto/Controllers/UtilisateursController.cs`
- [Settings](https://github.com/hammamimariam/parckingauto/blob/main/ParckingAuto/Controllers/SettingsController.cs): `ParckingAuto/Controllers/SettingsController.cs`
- [Audit trail](https://github.com/hammamimariam/parckingauto/blob/main/ParckingAuto/Services/AuditService.cs): `ParckingAuto/Services/AuditService.cs`

### Persistence

- [EF data context](https://github.com/hammamimariam/parckingauto/blob/main/ParckingAuto/Data/ParcAutoContext.cs): `ParckingAuto/Data/ParcAutoContext.cs`
- **MySQL database**

### Other components

- **Fleet users**

## Connections

- Fleet users → Blazor client: uses
- Blazor client → API host: REST requests
- Client authentication → API host: posts login (evidence: `Front/Services/AuthService.cs`)
- API host → JWT authentication: registers (evidence: `ParckingAuto/Program.cs`)
- API host → Vehicle management: routes requests
- API host → Parking movements: routes requests
- API host → Fuel tracking: routes requests
- API host → Maintenance records: routes requests
- API host → Automatic alerts: routes requests
- API host → Document archive: routes requests
- API host → Driver management: routes requests
- API host → Dashboard: routes requests
- API host → Statistics exports: routes requests
- API host → User administration: routes requests
- API host → Settings: routes requests
- Vehicle management → Business services: business logic
- Parking movements → Business services: business logic
- Fuel tracking → Business services: business logic
- Maintenance records → Business services: business logic
- Automatic alerts → Business services: business logic (evidence: `ParckingAuto/Services/AlerteService.cs`)
- Business services → Data repositories: uses (evidence: `ParckingAuto/Services/AlerteService.cs`)
- Data repositories → EF data context: queries (evidence: `ParckingAuto/Repositories/MaintenanceRepository.cs`)
- Dashboard → EF data context: reads data (evidence: `ParckingAuto/Controllers/DashboardController.cs`)
- Statistics exports → EF data context: queries data (evidence: `ParckingAuto/Controllers/StatistiquesController.cs`)
- EF data context → MySQL database: persists records
- Blazor client → Shared DTOs: exchanges DTOs
- API host → Shared DTOs: exchanges DTOs
- API host → Audit trail: registers service (evidence: `ParckingAuto/Program.cs`)
- API host → Data repositories: registers repositories (evidence: `ParckingAuto/Program.cs`)
