# seifal111/tripart-gestionutilisateurs architecture

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

- Interactive diagram: https://gitdiagram.com/seifal111/tripart-gestionutilisateurs
- Repository: https://github.com/seifal111/tripart-gestionutilisateurs

## Overview

TripArt is a JavaFX desktop application combining accommodation browsing and reservation management with account registration, sign-in, password recovery, and administration. In the booking workflow, the front-office controller loads and manages accommodations and reservations through dedicated services; those services execute SQL-backed persistence operations. Account workflows use the user service and, where evidenced, session, validation, password, location, and SMS utilities. The excerpts establish these calls, but do not show the full JavaFX navigation or database connection configuration, so those links are omitted.

Main entry points: [`pidev/src/main/java/services/ServiceUtilisateur.java`](https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/services/ServiceUtilisateur.java) (User service), [`pidev/src/main/java/controllers/InscriptionController.java`](https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/controllers/InscriptionController.java) (Registration), [`pidev/src/main/java/controllers/LoginController.java`](https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/controllers/LoginController.java) (Sign in), [`pidev/src/main/java/controllers/GestionUserController.java`](https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/controllers/GestionUserController.java) (User administration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_booking["Booking"]
  node_frontoffice["Accommodation front office"]
  node_accommodation["Accommodation service"]
  node_reservation["Reservation service"]
  node_accommodation_model["Accommodation model<br/>[Hebergement.java]"]
  node_reservation_model["Reservation model"]
end

subgraph group_accounts["Accounts"]
  node_register["Registration"]
  node_login["Sign in"]
  node_forgot["Password recovery"]
  node_verify["Recovery code"]
  node_new_password["Set new password"]
  node_user_model["User model<br/>[Utilisateur.java]"]
  node_session["User session<br/>[UserSession.java]"]
end

subgraph group_admin["Administration"]
  node_user_admin["User administration"]
  node_user_edit["Edit user"]
  node_dashboard["User dashboard"]
  node_stat_card["Statistic card"]
  node_stat_data["Statistic data<br/>[StatData.java]"]
end

subgraph group_infra["Persistence and utilities"]
  node_user_service["User service"]
  node_db[("SQL database")]
  node_sms["SMS delivery<br/>[SmsService.java]"]
  node_validation["Input validation"]
  node_password["Password utilities<br/>[PasswordUtils.java]"]
  node_gps["Location lookup<br/>[GPSClient.java]"]
  node_mydb["Booking DB connector<br/>[Mydb.java]"]
  node_user_db["User DB connector<br/>[ConnexionBD.java]"]
end

node_visitor(("Visitor"))

node_visitor -.->|"uses"| node_frontoffice
node_frontoffice -->|"manages stays"| node_accommodation
node_frontoffice -->|"manages bookings"| node_reservation
node_accommodation -->|"maps"| node_accommodation_model
node_reservation -->|"maps"| node_reservation_model
node_accommodation -->|"connects via"| node_mydb
node_reservation -->|"connects via"| node_mydb
node_register -->|"creates account"| node_user_service
node_login -->|"authenticates"| node_user_service
node_forgot -->|"requests recovery"| node_user_service
node_forgot -->|"routes code"| node_verify
node_verify -->|"checks code"| node_user_service
node_verify -->|"routes reset"| node_new_password
node_new_password -->|"updates password"| node_user_service
node_register -->|"builds"| node_user_model
node_login -->|"loads"| node_user_model
node_login -->|"sets session"| node_session
node_register -->|"validates"| node_validation
node_register -->|"hashes password"| node_password
node_register -->|"sends SMS"| node_sms
node_login -->|"checks password"| node_password
node_login -->|"looks up location"| node_gps
node_user_admin -->|"manages users"| node_user_service
node_user_admin -->|"reads session"| node_session
node_user_admin -->|"opens editor"| node_user_edit
node_user_admin -->|"refreshes metrics"| node_dashboard
node_user_edit -->|"updates user"| node_user_service
node_user_edit -->|"syncs session"| node_session
node_dashboard -->|"loads metrics"| node_user_service
node_dashboard -->|"loads cards"| node_stat_card
node_stat_card -->|"displays"| node_stat_data
node_user_service -->|"maps users"| node_user_model
node_user_service -->|"connects via"| node_user_db
node_accommodation -->|"queries"| node_db
node_reservation -->|"queries"| node_db
node_user_service -->|"queries"| node_db

click node_frontoffice "https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/controllers/FrontOfficeController.java"
click node_accommodation "https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/services/ServiceHebergement.java"
click node_reservation "https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/services/ServiceReservationHebergement.java"
click node_accommodation_model "https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/entities/Hebergement.java"
click node_reservation_model "https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/entities/ReservationHebergement.java"
click node_register "https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/controllers/InscriptionController.java"
click node_login "https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/controllers/LoginController.java"
click node_forgot "https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/controllers/MdpOublieController.java"
click node_verify "https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/controllers/VerifCodeController.java"
click node_new_password "https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/controllers/NouveauMdpController.java"
click node_user_model "https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/entities/Utilisateur.java"
click node_session "https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/utils/UserSession.java"
click node_user_admin "https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/controllers/GestionUserController.java"
click node_user_edit "https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/controllers/ModifierUtilisateurController.java"
click node_dashboard "https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/controllers/DashboardController.java"
click node_stat_card "https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/controllers/StatCardController.java"
click node_stat_data "https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/entities/StatData.java"
click node_user_service "https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/services/ServiceUtilisateur.java"
click node_sms "https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/utils/SmsService.java"
click node_validation "https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/utils/ValidationUtils.java"
click node_password "https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/utils/PasswordUtils.java"
click node_gps "https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/utils/GPSClient.java"
click node_mydb "https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/tools/Mydb.java"
click node_user_db "https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/tools/ConnexionBD.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_frontoffice,node_accommodation,node_reservation,node_accommodation_model,node_reservation_model toneBlue
class node_register,node_login,node_forgot,node_verify,node_new_password,node_user_model,node_session toneAmber
class node_user_admin,node_user_edit,node_dashboard,node_stat_card,node_stat_data toneMint
class node_user_service,node_db,node_sms,node_validation,node_password,node_gps,node_mydb,node_user_db toneRose
class node_visitor toneIndigo
```

## Components

### Booking

- [Accommodation front office](https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/controllers/FrontOfficeController.java): `pidev/src/main/java/controllers/FrontOfficeController.java`
- [Accommodation service](https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/services/ServiceHebergement.java): `pidev/src/main/java/services/ServiceHebergement.java`
- [Reservation service](https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/services/ServiceReservationHebergement.java): `pidev/src/main/java/services/ServiceReservationHebergement.java`
- [Accommodation model](https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/entities/Hebergement.java): `pidev/src/main/java/entities/Hebergement.java`
- [Reservation model](https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/entities/ReservationHebergement.java): `pidev/src/main/java/entities/ReservationHebergement.java`

### Accounts

- [Registration](https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/controllers/InscriptionController.java): `pidev/src/main/java/controllers/InscriptionController.java`
- [Sign in](https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/controllers/LoginController.java): `pidev/src/main/java/controllers/LoginController.java`
- [Password recovery](https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/controllers/MdpOublieController.java): `pidev/src/main/java/controllers/MdpOublieController.java`
- [Recovery code](https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/controllers/VerifCodeController.java): `pidev/src/main/java/controllers/VerifCodeController.java`
- [Set new password](https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/controllers/NouveauMdpController.java): `pidev/src/main/java/controllers/NouveauMdpController.java`
- [User model](https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/entities/Utilisateur.java): `pidev/src/main/java/entities/Utilisateur.java`
- [User session](https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/utils/UserSession.java): `pidev/src/main/java/utils/UserSession.java`

### Administration

- [User administration](https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/controllers/GestionUserController.java): `pidev/src/main/java/controllers/GestionUserController.java`
- [Edit user](https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/controllers/ModifierUtilisateurController.java): `pidev/src/main/java/controllers/ModifierUtilisateurController.java`
- [User dashboard](https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/controllers/DashboardController.java): `pidev/src/main/java/controllers/DashboardController.java`
- [Statistic card](https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/controllers/StatCardController.java): `pidev/src/main/java/controllers/StatCardController.java`
- [Statistic data](https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/entities/StatData.java): `pidev/src/main/java/entities/StatData.java`

### Persistence and utilities

- [User service](https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/services/ServiceUtilisateur.java): `pidev/src/main/java/services/ServiceUtilisateur.java`
- **SQL database**
- [SMS delivery](https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/utils/SmsService.java): `pidev/src/main/java/utils/SmsService.java`
- [Input validation](https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/utils/ValidationUtils.java): `pidev/src/main/java/utils/ValidationUtils.java`
- [Password utilities](https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/utils/PasswordUtils.java): `pidev/src/main/java/utils/PasswordUtils.java`
- [Location lookup](https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/utils/GPSClient.java): `pidev/src/main/java/utils/GPSClient.java`
- [Booking DB connector](https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/tools/Mydb.java): `pidev/src/main/java/tools/Mydb.java`
- [User DB connector](https://github.com/seifal111/tripart-gestionutilisateurs/blob/main/pidev/src/main/java/tools/ConnexionBD.java): `pidev/src/main/java/tools/ConnexionBD.java`

### Other components

- **Visitor**

## Connections

- Visitor → Accommodation front office: uses
- Accommodation front office → Accommodation service: manages stays (evidence: `pidev/src/main/java/controllers/FrontOfficeController.java`)
- Accommodation front office → Reservation service: manages bookings (evidence: `pidev/src/main/java/controllers/FrontOfficeController.java`)
- Accommodation service → Accommodation model: maps (evidence: `pidev/src/main/java/services/ServiceHebergement.java`)
- Reservation service → Reservation model: maps (evidence: `pidev/src/main/java/services/ServiceReservationHebergement.java`)
- Accommodation service → Booking DB connector: connects via (evidence: `pidev/src/main/java/services/ServiceHebergement.java`)
- Reservation service → Booking DB connector: connects via (evidence: `pidev/src/main/java/services/ServiceReservationHebergement.java`)
- Registration → User service: creates account (evidence: `pidev/src/main/java/controllers/InscriptionController.java`)
- Sign in → User service: authenticates (evidence: `pidev/src/main/java/controllers/LoginController.java`)
- Password recovery → User service: requests recovery (evidence: `pidev/src/main/java/controllers/MdpOublieController.java`)
- Password recovery → Recovery code: routes code (evidence: `pidev/src/main/java/controllers/MdpOublieController.java`)
- Recovery code → User service: checks code (evidence: `pidev/src/main/java/controllers/VerifCodeController.java`)
- Recovery code → Set new password: routes reset (evidence: `pidev/src/main/java/controllers/VerifCodeController.java`)
- Set new password → User service: updates password (evidence: `pidev/src/main/java/controllers/NouveauMdpController.java`)
- Registration → User model: builds (evidence: `pidev/src/main/java/controllers/InscriptionController.java`)
- Sign in → User model: loads (evidence: `pidev/src/main/java/controllers/LoginController.java`)
- Sign in → User session: sets session (evidence: `pidev/src/main/java/controllers/LoginController.java`)
- Registration → Input validation: validates (evidence: `pidev/src/main/java/controllers/InscriptionController.java`)
- Registration → Password utilities: hashes password (evidence: `pidev/src/main/java/controllers/InscriptionController.java`)
- Registration → SMS delivery: sends SMS (evidence: `pidev/src/main/java/controllers/InscriptionController.java`)
- Sign in → Password utilities: checks password (evidence: `pidev/src/main/java/controllers/LoginController.java`)
- Sign in → Location lookup: looks up location (evidence: `pidev/src/main/java/controllers/LoginController.java`)
- User administration → User service: manages users (evidence: `pidev/src/main/java/controllers/GestionUserController.java`)
- User administration → User session: reads session (evidence: `pidev/src/main/java/controllers/GestionUserController.java`)
- User administration → Edit user: opens editor (evidence: `pidev/src/main/java/controllers/GestionUserController.java`)
- User administration → User dashboard: refreshes metrics (evidence: `pidev/src/main/java/controllers/GestionUserController.java`)
- Edit user → User service: updates user (evidence: `pidev/src/main/java/controllers/ModifierUtilisateurController.java`)
- Edit user → User session: syncs session (evidence: `pidev/src/main/java/controllers/ModifierUtilisateurController.java`)
- User dashboard → User service: loads metrics (evidence: `pidev/src/main/java/controllers/DashboardController.java`)
- User dashboard → Statistic card: loads cards (evidence: `pidev/src/main/java/controllers/DashboardController.java`)
- Statistic card → Statistic data: displays (evidence: `pidev/src/main/java/controllers/StatCardController.java`)
- User service → User model: maps users (evidence: `pidev/src/main/java/services/ServiceUtilisateur.java`)
- User service → User DB connector: connects via (evidence: `pidev/src/main/java/services/ServiceUtilisateur.java`)
- Accommodation service → SQL database: queries (evidence: `pidev/src/main/java/services/ServiceHebergement.java`)
- Reservation service → SQL database: queries (evidence: `pidev/src/main/java/services/ServiceReservationHebergement.java`)
- User service → SQL database: queries (evidence: `pidev/src/main/java/services/ServiceUtilisateur.java`)
