feat: ajout documentation PHPDoc et maj slides bloc 3

backend/app/Http/Controllers/AuthController.php

@@ -12,6 +12,15 @@ use Tymon\JWTAuth\Facades\JWTAuth;
 
 class AuthController extends Controller
 {
+    /**
+     * Inscription d'un nouvel utilisateur.
+     * 
+     * Assigne automatiquement le rôle "membre", enregistre le consentement RGPD,
+     * crée un tracker par défaut et génère le token JWT.
+     *
+     * @param RegisterRequest $request
+     * @return JsonResponse
+     */
     public function register(RegisterRequest $request): JsonResponse
     {
         $role = Role::where('nom', 'membre')->first();
@@ -40,6 +49,15 @@ class AuthController extends Controller
         ], 201);
     }
 
+    /**
+     * Authentification d'un utilisateur existant.
+     * 
+     * Vérifie les identifiants, le statut actif du compte et génère un token JWT.
+     * Renvoie une erreur 403 si le compte est désactivé/anonymisé.
+     *
+     * @param LoginRequest $request
+     * @return JsonResponse
+     */
     public function login(LoginRequest $request): JsonResponse
     {
         $credentials = $request->only('email', 'password');