Mission 2 : Application Web Laravel — GSBRH¶

Présentation¶

Objectif¶

GSBRH est une application web développée avec le framework Laravel (PHP). Elle sert de système central de gestion des ressources humaines pour le réseau GSB (Groupement de Santé Bretagne).

Elle propose deux interfaces complémentaires : - Une interface web (Blade + Bootstrap) réservée aux membres RH pour gérer les praticiens - Une API REST sécurisée par JWT consommée par l'application mobile Flutter (Mission 3)

Les fonctionnalités principales sont : - Authentification sécurisée (session web + token JWT pour l'API) - Consultation et recherche des praticiens - Gestion de l'ancienneté et des échelons salariaux - Système de notation des praticiens (notes clients et experts) - Gestion des demandes de congé - Notifications internes entre RH et praticiens

Stack Technique¶

Architecture¶

GSBRH/
├── app/
│   ├── Http/
│   │   ├── Controllers/
│   │   │   ├── AuthController.php          # API : login, register, logout, refresh, me
│   │   │   ├── PostController.php          # API : CRUD praticiens + notes
│   │   │   ├── PraticienControlleur.php    # Web : liste, recherche, ancienneté
│   │   │   └── ConnexionControlleur.php    # Web : connexion / déconnexion
│   │   └── Resources/
│   │       └── PraticienResource.php       # Sérialisation JSON des praticiens
│   └── Models/
│       ├── Praticien.php
│       ├── Connexion.php                   # Utilisateur JWT
│       ├── Note.php
│       ├── Congé.php
│       ├── Notification.php
│       ├── Expert.php
│       ├── Echelon.php
│       ├── Ville.php
│       ├── TypePraticien.php
│       ├── Etat.php
│       └── EtatLecture.php
├── routes/
│   ├── api.php                             # Routes REST (JWT)
│   └── web.php                             # Routes web (session)
├── resources/views/
│   ├── praticiens/
│   │   ├── index.blade.php                 # Liste des praticiens
│   │   └── show.blade.php                  # Détail praticien
│   └── Connecter/
│       ├── index.blade.php                 # Formulaire de connexion
│       └── fraude.blade.php                # Page d'avertissement fraude
└── database/migrations/                    # Schéma de la base de données

Base de données¶

Entités principales¶

Praticien¶

Connexion (utilisateurs)¶

Congé¶

Note¶

Echelon¶

Notification¶

Interface Web¶

Connexion¶

La page de connexion (/login) permet aux membres RH de s'authentifier via leur adresse mail et mot de passe.

Le système vérifie les identifiants avec Hash::check() (BCrypt), puis ouvre une session Laravel. En cas de tentative suspecte répétée, une page d'alerte fraude (fraude.blade.php) est affichée.

Liste des praticiens¶

La page /praticiens affiche tous les praticiens sous forme de grille Bootstrap. Chaque carte affiche le nom, le prénom et la ville du praticien.

Un champ de recherche par nom (insensible à la casse) est disponible via un formulaire POST /search.

Détail d'un praticien¶

La page /praticiens/{id} affiche la fiche complète d'un praticien : - Informations personnelles (nom, prénom, adresse, ville) - Ancienneté actuelle - Échelon et salaire brut associé - Notes clients et experts

Un bouton "Ajouter 1 an d'ancienneté" permet d'incrémenter l'ancienneté directement depuis l'interface (POST /praticiens/{id}/add-anciennete).

API REST¶

L'API REST expose des endpoints consommés par l'application mobile Flutter.
La documentation complète est générée automatiquement et accessible à : /api/documentation

Authentification¶

Exemple de réponse login (200 OK)¶

{
  "status": "success",
  "user": {
    "identifiant": "jean.dupont@gsb.fr",
    "id_praticiens": 1,
    "privilèges": 1
  },
  "authorization": {
    "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
    "type": "bearer",
    "expires_in": 3600
  }
}

Exemple d'erreur (401 Unauthorized)¶

{
  "status": "error",
  "message": "Identifiants incorrects"
}

Praticiens¶

Champs requis à la création / modification :
nom, prenom, adresse, id_ville, anciennete, id_echelon
Les clés étrangères (id_ville, id_echelon) sont validées par une vérification d'existence en base.

Exemple de réponse praticien¶

{
  "data": {
    "id": 1,
    "nom": "Dupont",
    "prenom": "Jean",
    "adresse": "123 Rue de Paris",
    "ville": {
      "id": 35001,
      "nom_reel": "Rennes",
      "code_postal": "35000"
    },
    "note_client": 4.5,
    "note_expert": 4.8,
    "note_global": 4.65
  }
}

Notes¶

Logique Métier Clé¶

Ancienneté¶

L'ancienneté d'un praticien est incrémentée manuellement par le RH via le bouton dédié dans l'interface web. Ce champ détermine l'échelon salarial correspondant.

```php title='Incrémenter l'ancienneté' \(praticien = Praticien::findOrFail(\)id); $praticien->anciennete += 1; $praticien->save();

### Recherche de praticien

La recherche s'effectue avec une requête SQL `LIKE` insensible à la casse :

```php title='Recherche par nom'
$praticiens = Praticien::where('nom', 'LIKE', '%' . $request->search . '%')->get();

Authentification JWT (API)¶

L'API utilise tymon/jwt-auth. Après connexion, le token est requis dans le header Authorization pour toutes les routes protégées :

Authorization: Bearer <token>

Les routes protégées utilisent le middleware auth:api. Les routes publiques (consultation des praticiens et des notes) ne nécessitent pas de token.

Le payload JWT embarque des claims personnalisés pour identifier l'utilisateur côté mobile :

public function getJWTCustomClaims(): array
{
    return [
        'id_praticiens' => $this->id_praticiens,
        'privileges'    => $this->privilèges,
    ];
}