# h-4mza/gestion-de-demande architecture

> Architecture diagram of the GitHub repository h-4mza/gestion-de-demande, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/h-4mza/gestion-de-demande
- Repository: https://github.com/h-4mza/gestion-de-demande

## Overview

NEXUS is a PHP application for submitting and processing organizational requests. A requester creates a request, optionally adds attachments, and receives notifications; a validator reviews requests, while administrators manage users, request types, statuses, and reporting. Role-specific dashboards and process endpoints sit above PDO-backed domain classes and a MySQL database. The excerpts and source index support the principal request, validation, administration, notification, and attachment components; connections among unsampled endpoint behavior are omitted where their wiring is not shown.

Main entry points: [`classes/Demande.php`](https://github.com/h-4mza/gestion-de-demande/blob/main/classes/Demande.php) (Request model), [`process/create_demande.php`](https://github.com/h-4mza/gestion-de-demande/blob/main/process/create_demande.php) (Request creation), [`process/validation_process.php`](https://github.com/h-4mza/gestion-de-demande/blob/main/process/validation_process.php) (Validation processing), [`classes/Notification.php`](https://github.com/h-4mza/gestion-de-demande/blob/main/classes/Notification.php) (Notification model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["User access"]
  node_login["Login<br/>[login.php]"]
  node_login_process["Login processing<br/>[login_process.php]"]
  node_requester_dashboard["Requester dashboard<br/>[dashboard.php]"]
  node_requester_requests["My requests<br/>[mes-demandes.php]"]
  node_validator_dashboard["Validator dashboard<br/>[dashboard.php]"]
end

subgraph group_workflow["Request workflow"]
  node_request_creation["Request creation<br/>[create_demande.php]"]
  node_validation_processing["Validation processing"]
  node_request_endpoints["Request endpoints"]
end

subgraph group_admin["Administration"]
  node_admin_dashboard["Admin dashboard<br/>[dashboard.php]"]
  node_admin_endpoints["Admin endpoints"]
end

subgraph group_data["Domain and storage"]
  node_demandes["Request model<br/>[Demande.php]"]
  node_attachments["Attachment model<br/>[PieceJointe.php]"]
  node_validations["Validation model<br/>[Validation.php]"]
  node_notifications["Notification model<br/>[Notification.php]"]
  node_users["User model<br/>[User.php]"]
  node_types["Request types<br/>[TypeBesoin.php]"]
  node_database_config["Database connection<br/>[Database.php]"]
  node_mysql[("MySQL database")]
end

node_requester(("Requester"))
node_validator(("Validator"))
node_administrator(("Administrator"))

node_requester -->|"signs in"| node_login
node_login -.->|"submits credentials"| node_login_process
node_login_process -->|"authenticates"| node_users
node_requester -->|"uses"| node_requester_dashboard
node_requester -->|"views requests"| node_requester_requests
node_requester_dashboard -->|"reads statistics"| node_demandes
node_requester_dashboard -->|"loads types"| node_types
node_requester -->|"submits request"| node_request_creation
node_request_creation -->|"creates request"| node_demandes
node_request_creation -->|"saves uploads"| node_attachments
node_request_creation -->|"creates alerts"| node_notifications
node_request_creation -->|"loads requester"| node_users
node_validator -->|"reviews requests"| node_validator_dashboard
node_validator_dashboard -->|"loads statistics"| node_demandes
node_validator -->|"records decision"| node_validation_processing
node_validation_processing -->|"updates status"| node_demandes
node_validation_processing -->|"records decision"| node_validations
node_validation_processing -->|"sends alerts"| node_notifications
node_administrator -->|"manages system"| node_admin_dashboard
node_admin_dashboard -->|"loads requests"| node_demandes
node_admin_dashboard -->|"loads types"| node_types
node_administrator -.->|"manages records"| node_admin_endpoints
node_admin_endpoints -->|"updates requests"| node_demandes
node_admin_endpoints -->|"notifies users"| node_notifications
node_request_endpoints -.->|"serves request data"| node_demandes
node_request_endpoints -.->|"serves attachments"| node_attachments
node_database_config -->|"opens PDO connection"| node_mysql
node_demandes -->|"queries requests"| node_mysql
node_attachments -->|"stores metadata"| node_mysql
node_validations -->|"stores decisions"| node_mysql
node_notifications -->|"stores alerts"| node_mysql
node_users -->|"queries users"| node_mysql
node_types -->|"queries types"| node_mysql

click node_login "https://github.com/h-4mza/gestion-de-demande/blob/main/login.php"
click node_login_process "https://github.com/h-4mza/gestion-de-demande/blob/main/process/login_process.php"
click node_requester_dashboard "https://github.com/h-4mza/gestion-de-demande/blob/main/pages/demandeur/dashboard.php"
click node_requester_requests "https://github.com/h-4mza/gestion-de-demande/blob/main/pages/demandeur/mes-demandes.php"
click node_validator_dashboard "https://github.com/h-4mza/gestion-de-demande/blob/main/pages/validateur/dashboard.php"
click node_admin_dashboard "https://github.com/h-4mza/gestion-de-demande/blob/main/pages/admin/dashboard.php"
click node_request_creation "https://github.com/h-4mza/gestion-de-demande/blob/main/process/create_demande.php"
click node_validation_processing "https://github.com/h-4mza/gestion-de-demande/blob/main/process/validation_process.php"
click node_request_endpoints "https://github.com/h-4mza/gestion-de-demande/tree/main/process"
click node_admin_endpoints "https://github.com/h-4mza/gestion-de-demande/tree/main/process/admin"
click node_demandes "https://github.com/h-4mza/gestion-de-demande/blob/main/classes/Demande.php"
click node_attachments "https://github.com/h-4mza/gestion-de-demande/blob/main/classes/PieceJointe.php"
click node_validations "https://github.com/h-4mza/gestion-de-demande/blob/main/classes/Validation.php"
click node_notifications "https://github.com/h-4mza/gestion-de-demande/blob/main/classes/Notification.php"
click node_users "https://github.com/h-4mza/gestion-de-demande/blob/main/classes/User.php"
click node_types "https://github.com/h-4mza/gestion-de-demande/blob/main/classes/TypeBesoin.php"
click node_database_config "https://github.com/h-4mza/gestion-de-demande/blob/main/config/Database.php"

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_login,node_login_process,node_requester_dashboard,node_requester_requests,node_validator_dashboard toneBlue
class node_request_creation,node_validation_processing,node_request_endpoints toneAmber
class node_admin_dashboard,node_admin_endpoints,node_requester toneMint
class node_demandes,node_attachments,node_validations,node_notifications,node_users,node_types,node_database_config,node_mysql toneRose
class node_validator,node_administrator toneIndigo
```

## Components

### User access

- [Login](https://github.com/h-4mza/gestion-de-demande/blob/main/login.php): `login.php`
- [Login processing](https://github.com/h-4mza/gestion-de-demande/blob/main/process/login_process.php): `process/login_process.php`
- [Requester dashboard](https://github.com/h-4mza/gestion-de-demande/blob/main/pages/demandeur/dashboard.php): `pages/demandeur/dashboard.php`
- [My requests](https://github.com/h-4mza/gestion-de-demande/blob/main/pages/demandeur/mes-demandes.php): `pages/demandeur/mes-demandes.php`
- [Validator dashboard](https://github.com/h-4mza/gestion-de-demande/blob/main/pages/validateur/dashboard.php): `pages/validateur/dashboard.php`

### Request workflow

- [Request creation](https://github.com/h-4mza/gestion-de-demande/blob/main/process/create_demande.php): `process/create_demande.php`
- [Validation processing](https://github.com/h-4mza/gestion-de-demande/blob/main/process/validation_process.php): `process/validation_process.php`
- [Request endpoints](https://github.com/h-4mza/gestion-de-demande/tree/main/process): `process`

### Administration

- [Admin dashboard](https://github.com/h-4mza/gestion-de-demande/blob/main/pages/admin/dashboard.php): `pages/admin/dashboard.php`
- [Admin endpoints](https://github.com/h-4mza/gestion-de-demande/tree/main/process/admin): `process/admin`

### Domain and storage

- [Request model](https://github.com/h-4mza/gestion-de-demande/blob/main/classes/Demande.php): `classes/Demande.php`
- [Attachment model](https://github.com/h-4mza/gestion-de-demande/blob/main/classes/PieceJointe.php): `classes/PieceJointe.php`
- [Validation model](https://github.com/h-4mza/gestion-de-demande/blob/main/classes/Validation.php): `classes/Validation.php`
- [Notification model](https://github.com/h-4mza/gestion-de-demande/blob/main/classes/Notification.php): `classes/Notification.php`
- [User model](https://github.com/h-4mza/gestion-de-demande/blob/main/classes/User.php): `classes/User.php`
- [Request types](https://github.com/h-4mza/gestion-de-demande/blob/main/classes/TypeBesoin.php): `classes/TypeBesoin.php`
- [Database connection](https://github.com/h-4mza/gestion-de-demande/blob/main/config/Database.php): `config/Database.php`
- **MySQL database**

### Other components

- **Requester**
- **Validator**
- **Administrator**

## Connections

- Requester → Login: signs in
- Login → Login processing: submits credentials
- Login processing → User model: authenticates (evidence: `process/login_process.php`)
- Requester → Requester dashboard: uses (evidence: `pages/demandeur/dashboard.php`)
- Requester → My requests: views requests
- Requester dashboard → Request model: reads statistics (evidence: `pages/demandeur/dashboard.php`)
- Requester dashboard → Request types: loads types (evidence: `pages/demandeur/dashboard.php`)
- Requester → Request creation: submits request (evidence: `process/create_demande.php`)
- Request creation → Request model: creates request (evidence: `process/create_demande.php`)
- Request creation → Attachment model: saves uploads (evidence: `process/create_demande.php`)
- Request creation → Notification model: creates alerts (evidence: `process/create_demande.php`)
- Request creation → User model: loads requester (evidence: `process/create_demande.php`)
- Validator → Validator dashboard: reviews requests (evidence: `pages/validateur/dashboard.php`)
- Validator dashboard → Request model: loads statistics (evidence: `pages/validateur/dashboard.php`)
- Validator → Validation processing: records decision (evidence: `process/validation_process.php`)
- Validation processing → Request model: updates status (evidence: `process/validation_process.php`)
- Validation processing → Validation model: records decision (evidence: `process/validation_process.php`)
- Validation processing → Notification model: sends alerts (evidence: `process/validation_process.php`)
- Administrator → Admin dashboard: manages system (evidence: `pages/admin/dashboard.php`)
- Admin dashboard → Request model: loads requests (evidence: `pages/admin/dashboard.php`)
- Admin dashboard → Request types: loads types (evidence: `pages/admin/dashboard.php`)
- Administrator → Admin endpoints: manages records
- Admin endpoints → Request model: updates requests (evidence: `process/admin/update_demande_service.php`)
- Admin endpoints → Notification model: notifies users (evidence: `process/admin/update_demande_status.php`)
- Request endpoints → Request model: serves request data (evidence: `process/admin/update_demande_service.php`)
- Request endpoints → Attachment model: serves attachments (evidence: `process/create_demande.php`)
- Database connection → MySQL database: opens PDO connection (evidence: `config/Database.php`)
- Request model → MySQL database: queries requests (evidence: `classes/Demande.php`)
- Attachment model → MySQL database: stores metadata (evidence: `classes/PieceJointe.php`)
- Validation model → MySQL database: stores decisions (evidence: `classes/Validation.php`)
- Notification model → MySQL database: stores alerts (evidence: `classes/Notification.php`)
- User model → MySQL database: queries users (evidence: `classes/User.php`)
- Request types → MySQL database: queries types (evidence: `classes/TypeBesoin.php`)
