Ajout des commentaires dans le code

api/preview_school_holidays.php

@@ -4,6 +4,14 @@ declare(strict_types=1);
 
 require_once dirname(__DIR__) . '/app/autoload.php';
 
+/**
+ * GET — propositions de vacances de l'API data.education.gouv.fr, SANS écriture.
+ * Un échec du service distant ressort en 502.
+ * Paramètres : academy, year (année civile).
+ *
+ * Point d'entrée mince : toute la logique est dans le contrôleur appelé.
+ * Voir CLAUDE.md, section « Deux types de points d'entrée ».
+ */
 use App\Controllers\VacationController;
 use App\Core\JsonResponse;