Ajout des commentaires dans le code

docs/README_V7_2.md

@@ -0,0 +1,31 @@
+# PTA V7.2 — Vue annuelle de contrôle
+
+Cette version ajoute une page `annual.php` destinée au responsable qui contrôle le prévisionnel annuel d’un agent.
+
+## Fonctionnement
+
+- sélection d’un agent et d’une année civile ;
+- affichage de janvier à décembre dans un tableau horizontal compact ;
+- en-tête de synthèse : poste, lieu principal, contrat, quotité, quota et reste à affecter ;
+- affichage des périodes contractuelles qui traversent l’année civile ;
+- colonnes proches du tableau d’annualisation historique :
+  - `AP` : activité périscolaire ;
+  - `PP` : préparation périscolaire ;
+  - `AE` : activité extrascolaire ;
+  - `PE` : préparation extrascolaire ;
+- code couleur pour le travail, la préparation, la formation, les congés, les absences, les JNT et les journées de fractionnement ;
+- vacances scolaires visibles sur le calendrier ;
+- contour orange pour les affectations encore en brouillon ;
+- clic sur une journée pour ouvrir directement la semaine correspondante dans la saisie du planning ;
+- mode plein écran et impression A3 paysage.
+
+## Architecture
+
+- Page : `annual.php`
+- Vue : `app/Views/partials/annual_overview.php`
+- API : `api/annual_overview.php`
+- Contrôleur : `app/Controllers/AnnualOverviewController.php`
+- Modèle SQL/PHP : `app/Models/AnnualOverviewModel.php`
+- JavaScript ciblé : `assets/js/annual-overview.js`
+
+Aucune migration SQL n’est nécessaire depuis la V7.1.