# Édition d'une formation depuis le planning — Spécification de design ## Contexte La vue planning affiche les formations en lecture seule. L'utilisateur veut pouvoir modifier une formation directement depuis cette vue, avec propagation immédiate vers Google Calendar. La suppression depuis cette vue est hors périmètre pour cette itération. ## Fonctionnalité Bouton "Modifier" sur chaque ligne du tableau planning. Au clic, une modal s'ouvre avec un formulaire pré-rempli (mêmes champs que le formulaire de création). Soumission via AJAX, mise à jour de la ligne en place sans rechargement de page. ## Architecture - **Authentification** : nouveau contrôleur PHP session-authentifié, distinct de l'API REST `X-API-Key` (pas de mélange des schémas d'auth) - **Réutilisation** : `FormValidator` existant pour la validation, extraction de la logique de construction summary/description dans `GoogleCalendarService` pour la partager entre création et mise à jour - **Frontend** : modal HTML cachée par défaut, ouverture/fermeture en JS pur, soumission via `fetch()` ## Endpoint serveur ### Nouveau contrôleur : `public/edit-event.php` - Auth : `$auth->requireAuth()` (session) - Méthode acceptée : `POST` (uniquement, ne pas confondre avec PUT de l'API REST) - Query string : `?id=` requis - Body JSON : mêmes champs que le formulaire de création - `formation`, `client`, `lieu`, `statut` (requis) - `date_debut`, `date_fin` (requis, format `YYYY-MM-DD`) - `heure_debut`, `heure_fin` (requis, format `HH:MM`) - `description` (optionnel, notes libres sans les horaires) - Validation : appel `FormValidator::validate()` - Réponses : - `200` : `{id, summary, location, description, colorId, start, end, notes}` — l'événement mis à jour, plus le champ `notes` (description sans la première ligne d'horaires) pour faciliter le DOM update côté client - `400` : body JSON invalide ou paramètre `id` manquant - `404` : événement introuvable dans Google Calendar - `405` : méthode non autorisée - `422` : validation échouée — `{error, details: {champ: message}}` - `503` : Google Calendar non authentifié ### Extension `GoogleCalendarService` Trois méthodes ajoutées : - `static buildSummary(string $formation, string $client, string $lieu): string` — extrait depuis la concaténation actuelle dans `buildEventsData` - `static buildDescription(string $heureDebut, string $heureFin, string $description): string` — extrait également - `updateEventFromForm(string $eventId, array $data): array` — équivalent de `updateEvent` mais accepte les champs haut-niveau (formation, client, lieu, statut, dates, horaires, description) et reconstruit summary/description avant d'appeler l'API Google. Retourne le tableau de l'événement mis à jour (mêmes clés que `getEvent`) plus une clé `notes` (description sans la première ligne). `buildEventsData` est refactorisé pour utiliser ces deux helpers (DRY). ## Frontend ### Modification du contrôleur `public/planning.php` - Charger les référentiels (`formations`, `clients`, `lieux`) via `$referentials->getAll()` pour pré-remplir les Tom Select de la modal - Pour chaque événement, ajouter dans le tableau `$events` une clé `notes` = description sans la première ligne d'horaires (déjà calculée dans le foreach existant) ### Modification du template `templates/planning.php` **Nouvelle première colonne** : "Actions" avec un bouton "Modifier" par ligne, portant un `data-id` (l'eventId Google). **Attributs supplémentaires sur chaque ``** : - `data-id` : eventId - `data-formation`, `data-client`, `data-lieu` (déjà présents) - `data-statut` (déjà présent) - `data-end` : date de fin inclusive (en plus de `data-start`) - `data-heure-debut`, `data-heure-fin` : extraits des horaires - `data-notes` : description sans la première ligne **Modal HTML** : ajoutée à la fin du template, structure : ```html ``` **Listes pré-remplies** : les `