Initial clean version

This commit is contained in:
root
2026-11-11 09:24:28 +01:00
commit ab58b33f9c
156 changed files with 5697 additions and 0 deletions
+54
View File
@@ -0,0 +1,54 @@
# V3.0.0-rc3 — licences automatiques et favoris par équipe
## Installer depuis RC1 ou RC2
1. Sauvegarder la base, la configuration et `storage/`, puis arrêter temporairement les écritures et tâches planifiées.
2. Installer cette version en conservant votre configuration et `storage/`. Le DocumentRoot reste `public/`. Aucun Docker, Composer ou outil de compilation n'est nécessaire.
3. Dans le dossier de l'application, avec la configuration de la base cible :
```bash
php bin/console.php migrate
```
4. Réimporter le fichier complet `44171420d.xlsx` dans **Imports**, type joueurs/personnes, saison **2026/2027**. Contrôler puis valider l'aperçu. La RC2 ne conservait pas encore le statut et la date d'enregistrement : ce réimport est nécessaire.
5. Ouvrir **Licences** pour vérifier le statut importé et la date calculée, puis **Préparer le match** pour utiliser les favoris. Les comptes, sanctions, groupes enregistrés, FMI et cachets sont conservés. Ne pas vider de table ni lancer `demo`.
Les migrations sont relançables. Pour revenir en arrière, restaurer ensemble le code, la base sauvegardée et le `storage/` correspondant. Pour une installation depuis V2, suivre également `MISE_A_JOUR_V3.md`.
## Licence et qualification
- **Statut** : `Active` ou `Non active`, importé par licence et par saison.
- **Enregistrement** : conservé comme date source. Pour le contrôle du joueur amateur Libre, la qualification est calculée à **J+5**, soit quatre jours francs. Exemple : enregistrement le 1er septembre, qualification le 6 septembre. Les changements de mois, d'année et les années bissextiles sont pris en compte.
- Une licence non active bloque le contrôle. Un match avant la date de qualification bloque également le contrôle. Le jour de qualification est autorisé pour ce critère.
- Les informations importées prennent priorité sur les anciennes valeurs manuelles. L'écran affiche la source et les dates. Pour corriger, réimporter le fichier actualisé.
- Une colonne absente conserve la valeur précédente. Une colonne présente mais vide rend ce critère inconnu et déclenche une vérification. Une date impossible, un statut non reconnu ou des valeurs contradictoires pour une même licence font refuser le lot entier.
- Un réimport identique ne crée pas de doublons et ne périme pas les convocations. Une modification des données impose un nouveau contrôle. Les sanctions restent liées à la personne, jamais au seul statut de sa licence.
La qualification calculée est celle utilisée pour les joueurs amateurs Libre. Elle ne vaut pas autorisation globale de participer : catégorie, surclassement, restrictions de compétition et autres cas particuliers restent contrôlés séparément. L'état importé est celui du dernier export, pas une interrogation en direct de Footclubs.
## Favoris dans Préparer le match
Chaque équipe dispose de deux listes dans le même écran :
1. **Joueurs habituels / favoris**, en premier.
2. **Tous les autres joueurs**, juste en dessous, avec la même recherche et les mêmes cases de sélection.
Le classement automatique utilise les cinq dernières FMI disponibles des matchs joués de cette équipe, dans la saison de la rencontre et avant sa date. Chaque présence sur la feuille, remplaçant entré ou non, contribue au classement. Les FMI les plus récentes pèsent davantage (5, 4, 3, 2 puis 1). L'équipe habituelle renseignée dans le registre permet aussi de proposer un joueur sans FMI. Les noms départagent les scores identiques.
Pour chaque joueur, le choix **Favori pour E1/E2/E3/E4** permet :
- **Automatique** : suivre les FMI et l'équipe habituelle.
- **Épinglé** : placer ce joueur en tête, même nouveau et sans historique.
- **Retiré des favoris** : le garder accessible parmi les autres joueurs, malgré son historique.
Cette préférence est commune aux responsables du club pour cette équipe et cette saison. Un joueur peut être favori dans plusieurs équipes. Le compte lecture seule peut consulter les favoris mais ne peut pas les modifier. Les matchs historiques restent en lecture seule.
**Aucune case n'est cochée automatiquement.** Les sélections existantes sont conservées. Modifier un favori s'enregistre immédiatement sans recharger la page et sans perdre les cases cochées, même avant enregistrement du brouillon. Cette préférence de présentation ne modifie ni les convocations ni leur validation.
Les joueurs suspendus restent visibles avec leur alerte. Les favoris ne contournent aucun contrôle individuel ou quota collectif. Les contrôles et compteurs du groupe sélectionné fonctionnent dans les deux listes. En début de saison, les anciennes FMI et préférences de la saison précédente ne sont pas reprises ; l'équipe habituelle du registre reste utilisable.
## Vérifications
Tests réalisés sur une base MariaDB jetable : migration depuis V2 et relance, suites existantes cachets/FMI/discipline/convocations, export réel (74 licences actives et une non active), qualification à J+4/J+5, années bissextiles, priorité des sources, données manquantes ou incohérentes, favoris par équipe/saison, retrait et épinglage sans changement de sélection. Les routes HTTP sont testées avec authentification, droits de lecture seule et formulaires périmés.
Les scripts SQL nécessitent `ESBSC_TEST_DATABASE=1` et ne doivent pas être lancés sur votre base de production. Les exports contenant les données personnelles ne sont pas inclus dans l'archive.