# ESBSC — V3.2.0 Cette version ajoute la préparation collective des convocations, les disponibilités hebdomadaires et les exports à partager. Elle conserve les personnes, licences, imports, historiques et règles de contrôle de la V3.1. ## Installer depuis la V3.1 1. Sauvegarder la base MariaDB et le dossier de l'application. 2. Remplacer les fichiers par ceux de l'archive, en conservant la configuration locale (`config/database.php`, éventuel `.env`) et le dossier `storage/`. 3. Depuis la racine de l'application, lancer : ```bash php bin/console.php migrate ``` 4. Recharger la page et, si nécessaire, vider le cache du navigateur pour les nouveaux scripts. La migration `012_convocations` ajoute deux tables : disponibilités par personne et semaine, et accompagnateurs retenus par match. Elle peut être relancée. Aucun réimport Footclubs, aucune suppression de table ni remise à zéro des joueurs n'est nécessaire. Les prérequis restent ceux de la V3.1 : PHP 8.2+ avec notamment PDO MySQL, mbstring, iconv et ZipArchive, et MariaDB. Les exports n'exigent ni Docker, ni LibreOffice, ni service externe. Le PNG est généré dans le navigateur avec JavaScript ; PDF et Excel sont générés par PHP. ## Joueurs et Staff Le menu distingue désormais **Joueurs** et **Staff**. Il n'y a plus d'entrée « Rôles et staffs ». - Joueurs affiche les profils joueurs, avec filtres d'équipe, d'activité et de recherche. - Staff affiche par défaut les encadrants sportifs et les profils staff encore à classer. Les administratifs sont accessibles par le filtre dédié. - Le filtre « Tout le registre (affecter des rôles) » de Staff permet de trouver un joueur pour lui ajouter une fonction. La création de rôles et les affectations restent dans cette page. - Un joueur également encadrant apparaît dans les deux pages, avec une seule fiche et un seul historique disciplinaire. - Les rôles manuels demeurent prioritaires pour l'affichage. Ajouter le rôle **Joueur** à une personne classée manuellement qui joue également. Les réimports conservent les affectations. ## Préparer le match La sélection et les contrôles réglementaires existants sont conservés. Le lien **Synthèse et export des convocations** permet de retrouver les groupes de la semaine du match. Chaque joueur dispose d'un volet « Disponible · cette semaine » : choisir **Disponible**, **Blessé** ou **Indisponible**, ajouter éventuellement une courte note, puis enregistrer la disponibilité. Cet enregistrement est indépendant de celui du groupe : modifier une disponibilité ne perd pas les cases déjà cochées. Les disponibilités : - concernent la semaine du match, du lundi au dimanche, même si l'on prépare un match futur ; - sont communes à toutes les équipes, et rattachées à la personne ; - restent informatives et ne bloquent pas la sélection ni la validation ; - repartent sur Disponible la semaine suivante, sans tâche planifiée et sans effacer l'historique ; - sont en lecture seule pour les semaines passées ; - ne périment pas les contrôles réglementaires validés. Les notes restent internes : elles ne sont pas exportées. En cas de modification simultanée par deux responsables, le second enregistrement est refusé jusqu'au rechargement, pour éviter d'écraser le premier. Le **staff sportif habituel** peut être coché pour choisir les accompagnateurs de ce match. Les cases sont enregistrées avec le groupe ; aucun accompagnateur n'est sélectionné automatiquement. Il faut ensuite cocher « Inclure le staff » à l'export pour les faire apparaître. Ces personnes ne comptent pas dans les quotas de joueurs. ## Synthèse avant export Le menu **Convocations** permet de choisir une date et d'afficher toute sa semaine : - les rencontres sont disposées en colonnes, dans l'ordre des équipes ; - chaque colonne affiche adversaire, icône domicile/extérieur, date, heure et groupe enregistré ; - l'état de contrôle et les disponibilités restent visibles dans cette synthèse interne ; - les joueurs présents dans plusieurs groupes de la même semaine sont signalés, sans appliquer une interdiction automatique ; - les rencontres jouées affichent leur groupe FMI en lecture seule et ne sont pas exportables comme convocations à venir. En dessous figurent les **non-convoqués** : joueurs actifs absents de tous les groupes enregistrés de la semaine, même si certaines équipes ne sont pas cochées pour l'export. Les disponibles sont placés en premier. Leur équipe habituelle, leur disponibilité et les alertes disciplinaires par rencontre permettent de repérer les oublis. Un groupe encore vide laisse donc ses joueurs potentiels parmi les non-convoqués. Le lien **+ E1 / E2 / E3 / E4** ouvre la préparation du match avec le joueur coché en plus du groupe enregistré. Ce choix n'est conservé qu'après enregistrement ou validation, avec les contrôles habituels. ## Exporter et partager 1. Enregistrer puis **valider le contrôle** de chaque groupe à partager. 2. Ouvrir Convocations sur la bonne semaine. 3. Cocher une à quatre rencontres. 4. Facultativement cocher **Inclure le staff** et/ou **Afficher la légende domicile / extérieur**. Les deux options sont décochées par défaut. 5. Télécharger le PDF, l'Excel ou créer puis télécharger le PNG. Le document reprend un tableau commun : une colonne par équipe, l'adversaire précédé d'une maison ou d'un avion, la date et l'heure, puis les noms des joueurs. Aucune ligne Dom./Ext. ou Lieu supplémentaire. Si le calendrier ne précise pas domicile/extérieur, un « ? » apparaît : corriger le match dans Calendriers. - **PDF** : format A4 paysage avec pictogrammes vectoriels, noms accentués et en-têtes répétés si les effectifs ou noms nécessitent plusieurs pages. - **Excel** : véritable `.xlsx`, une feuille, colonnes par équipe, cellules renvoyées à la ligne et impression paysage. Les noms sont des textes, jamais des formules exécutables. - **PNG** : tableau en une image haute résolution, directement partageable sur un groupe privé. Télécharger avec le bouton après génération. Les noms sont triés alphabétiquement. Les non-convoqués, notes, blessures, indisponibilités, numéros de licence et alertes réglementaires ne figurent dans aucun export. Les options staff et légende n'ajoutent que les éléments demandés. Un brouillon ou un contrôle périmé doit être validé avant export. Si un groupe change après ouverture de la synthèse, l'export demande de revenir à une synthèse actualisée. Enregistrer une équipe ne périme plus le contrôle des autres ; une modification des données sportives (sanctions, licences, calendriers, paramètres) continue à périmer les contrôles. ## Droits Les entraîneurs, le secrétariat et les administrateurs peuvent préparer les groupes et renseigner les disponibilités. Les rôles et les fiches restent gérés par le secrétariat et les administrateurs. Les comptes en lecture seule peuvent consulter et exporter les groupes validés, sans modifier les disponibilités ou les effectifs. ## Vérifications Tests sur base jetable : migration relançable, historique de disponibilités, passage de semaine et d'année, contrôle de concurrence, séparation des pages et doubles rôles, synthèse et non-convoqués, options d'export, noms Excel non exécutables et exclusion des données privées. Parcours HTTP : validation, refus des brouillons et contrôles périmés, protection CSRF, droits en lecture seule, exports et ajout d'un non-convoqué sans écriture implicite. Tests antérieurs des imports et des contrôles réglementaires conservés.