8.8 KiB
ESBSC V3.0.0-rc1
Guide initial conservé. La RC2 automatise maintenant les cachets : suivre aussi MISE_A_JOUR_CACHETS.md. Les mentions de saisie manuelle des cachets ci-dessous ne concernent plus les licences pour lesquelles un export complet a été importé.
Version candidate, construite à partir de la V2.6.1. Installation sans Docker conservée : PHP 8.2+, MariaDB 10.11+, extensions existantes et Poppler pour les FMI. Pas de Composer, CDN ou compilation JavaScript.
Ce qui est livré
- Convocation avec groupe sélectionné toujours visible, recherche et compteurs instantanés : effectif, mutés, hors période, participations supérieures.
- Contrôles refaits côté serveur : un formulaire modifié dans le navigateur ne contourne pas les quotas ou une suspension.
- Brouillon enregistrable avec alertes ; validation refusée en présence d’un blocage. Les contrôles inconnus exigent une justification humaine lors de la validation. Cette justification est historisée et n’efface pas les alertes.
- Validation liée à la révision des données : toute modification sportive ultérieure impose un nouveau contrôle. Les rapports PDF sont des instantanés.
- Profils par équipe, saison et libellé exact de compétition, avec référence justificative. Pas de profil Ligue implicitement appliqué au District. Une coupe n’hérite pas du championnat.
- Modèles ESBSC non confirmés : E1 4 + 1 bonus, autres équipes 4, hors période 2. Ce sont les paramètres déclarés par le club, pas une affirmation que le quota FFF général serait 4. Les plafonds réels et leur justification doivent être confirmés chaque saison.
- Écran Licences : activité, qualification, cachet, date de fin, exemption et vérification des restrictions seniors. Données par licence saisonnière, sanctions par personne.
- Groupe historique en lecture seule depuis « Groupe » : FMI réelle, titulaires, remplaçants, participation confirmée et lien PDF. Sans FMI, aucune composition n’est inventée.
- Discipline regroupe cartons et suspensions. Jaunes/blancs : en attente, confirmés ou annulés avec justificatif et audit. Carton blanc disponible en saisie, sans conversion en jaune ni suspension automatique.
- Seuls les jaunes confirmés alimentent le risque dans le rapport ; les importations de décisions Footclubs les confirment. Les anciens jaunes manuels passent en attente : les contrôler après migration. L’absence dans un export n’annule rien. Le réimport d’un jaune annulé impose un contrôle humain.
- Rapports enrichis des quotas et alertes de la convocation enregistrée. Le compteur +10 comprend les participations effectives en rencontres officielles, coupes comprises. Un plafond n’est appliqué que si le profil et sa période sont explicitement confirmés.
- Détection automatique des trois exports Footclubs connus, aperçu toujours obligatoire, sélection manuelle possible si format ambigu. Accès FMI depuis Imports.
- Identités, licences multiples, sanctions, comptes, calendriers et historiques V2 conservés. Aucune table joueur à tronquer, aucune fusion incertaine automatique.
Limites à connaître avant recette
Cette version ne constitue pas une certification réglementaire exhaustive.
| Sujet | Comportement de la V3.0-rc1 |
|---|---|
| Qualification, cachets et statut actif | Renseignés dans l’écran Licences depuis Footclubs ; pas de déduction depuis le seul statut actif de la personne, ni extraction automatique de ces champs dans tous les exports. La date saisie est la date de qualification, pas d’enregistrement. |
| Catégorie, surclassement, licence après le 31 janvier | Vérification humaine tracée, pas de calcul automatique de toutes les exceptions. |
| Descente après le dernier match supérieur | Alerte expliquée et dates affichées ; exceptions à contrôler. Une composition manquante entraîne une vérification, pas une autorisation. |
| +10 / cinq dernières rencontres | Option pour le périmètre « toutes compétitions officielles et toutes équipes supérieures ». Début de période saisi et à revoir après report. Ne pas activer ce mode si le texte prévoit un périmètre différent (ex. équipes nationales seules). Sans confirmation, statistique indicative. |
| Deux dernières rencontres, matchs rapprochés, restrictions de coupe | Contrôle manuel. Le calendrier et les participations doivent être complets. Les exclusions statistiques pour forfait général ne sont pas automatisées. |
| FMI | Import automatisé de la composition et propositions de participation, puis validation. Les cartons jaunes/rouges/blancs et le staff du banc ne sont PAS extraits automatiquement du PDF dans cette RC. Saisir les cartons utiles dans Discipline, notamment un rouge immédiat, et importer les commissions. |
| Suspension / purge | Moteur V2 conservé et testé par équipe. Match arrêté, match à rejouer, changement de club et double pratique nécessitent encore un contrôle spécifique ; pas d’automatisation exhaustive de l’article 226. La saisie calendrier permet de justifier une dérogation de purge. |
| Doublons | Pas de fusion générale nouvelle ; conserver la procédure de rapprochement existante. Ne pas exécuter repair-hebras sur des identifiants différents de son cas historique. |
| Registre et fraîcheur | Un import n’atteste pas qu’un export est complet. Confirmer la vérification dans Imports et actualisation après consultation des sources. |
| Staff | Les sanctions du staff restent dans le suivi disciplinaire et les rapports sans convocation. Une convocation enregistrée est une liste de joueurs : elle ne constitue pas un contrôle complet du banc. |
Migration sans Docker
- Mettre l’application en maintenance : arrêter les écritures web ET les tâches cron. Tester d’abord sur une copie de la base.
- Sauvegarder la base MariaDB (toutes les tables), l’ancienne version du code, la configuration effective et le dossier
storage/complet, notammentstorage/fmi/. Vérifier que la sauvegarde se restaure. Ne pas me transmettre les mots de passe. - Extraire le dossier
esbsc-suspensions-v3séparément. Ne pas remplacer la configuration de production par le fichier de configuration par défaut du ZIP. Reprendre les paramètres de connexion, la configuration de session et les fichiersstorage/nécessaires. - Avec les variables d’environnement ou la configuration de la base cible correctes, depuis le dossier de la V3 :
php bin/console.php migrate
La migration crée les nouvelles tables, ajoute les colonnes et conserve les données. Elle est relançable ; le DDL MariaDB n’est pas une transaction globale. En cas d’erreur, ne pas rouvrir les écritures : corriger le problème puis relancer ou restaurer la sauvegarde.
- Faire pointer le DocumentRoot uniquement vers
public/de cette version. Le code, la configuration, les PDF et sauvegardes ne doivent pas être exposés directement. Conserver les permissions d’écriture du service PHP surstorage/fmietstorage/reportset le paramétrage HTTPS existant. - Ne pas recréer les utilisateurs ni lancer
demo. Les comptes existants sont conservés. - Dans Règlements, ouvrir les modèles E1/E2/E3/E4, choisir le libellé exact du calendrier, vérifier les plafonds et le maximum de joueurs, saisir le justificatif et confirmer. Créer séparément les profils de coupes nécessaires.
- Dans Licences, compléter progressivement les joueurs convoqués : statut, date de qualification, cachet et restrictions. Une licence éducateur ou dirigeant ne remplace pas la licence joueur Libre.
- Dans Discipline, contrôler les anciens jaunes manuels en attente. Les décisions Footclubs restent importables sans doublonnage.
- Comparer une convocation et son rapport avec Footclubs/FMI. Vérifier un joueur suspendu, un muté hors période et une personne multi-licences. Vérifier que les matchs historiques ouvrent le groupe réel, pas une nouvelle sélection.
- Une fois la recette validée, basculer la production et réactiver les tâches avec les chemins adaptés. Refaire le contrôle avant le match si les données ont évolué.
Retour arrière
Garder les écritures arrêtées et restaurer ensemble le code V2, la sauvegarde SQL et le storage/ correspondant. Ne pas simplement remettre l’ancien code sur une base modifiée sans vérification. Les données saisies après la sauvegarde ne seront pas présentes dans une restauration de celle-ci : les inventorier avant toute restauration.
Vérifications effectuées
Voir VALIDATION_V3.md. Les scripts SQL de test exigent ESBSC_TEST_DATABASE=1 et une base jetable : ne jamais les lancer sur la production.
php tests/run.php
php tests/regulations.php
Les autres suites nécessitent une base de test et certains fichiers d’exemple, volontairement non inclus dans la livraison pour ne pas diffuser les données personnelles des licenciés.