Ajout des commentaires dans le code

app/Core/Request.php

@@ -4,8 +4,19 @@ declare(strict_types=1);
 
 namespace App\Core;
 
+/**
+ * Lecture de la requête entrante pour les endpoints JSON.
+ *
+ * Les deux méthodes coupent l'exécution en cas de non-conformité plutôt que de
+ * lever une exception : l'appelant peut donc enchaîner sans bloc try/catch.
+ */
 final class Request
 {
+    /**
+     * Décode le corps JSON de la requête.
+     *
+     * @return array<string, mixed>
+     */
     public static function json(): array
     {
         $payload = json_decode((string) file_get_contents('php://input'), true);
@@ -16,6 +27,9 @@ final class Request
         return $payload;
     }
 
+    /**
+     * Impose le verbe HTTP attendu (typiquement « POST » pour un endpoint mutant).
+     */
     public static function requireMethod(string $method): void
     {
         if (strtoupper($_SERVER['REQUEST_METHOD'] ?? 'GET') !== strtoupper($method)) {