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
+43
View File
@@ -0,0 +1,43 @@
# Version 2.3 — Identité FFF et licences saisonnières
La clé de rapprochement est désormais le numéro de personne FFF. Les licences sont stockées séparément, avec leur numéro, type, catégorie et saison. Les sanctions, cartons et convocations restent rattachés à la même fiche interne de personne.
## Mise à jour depuis 2.1, 2.1.1 ou 2.2
1. Sauvegarder la base et l’application. Interrompre brièvement les accès pendant la mise à jour.
2. Copier `src/`, `templates/`, `bin/` et `VERSION` aux mêmes emplacements. Conserver `config/database.php`, les réglages locaux et `storage/`.
3. À la racine de l’application :
```bash
php bin/console.php migrate
```
Cette commande conserve les anciennes fiches, ajoute le numéro de personne et la table des licences. Elle ne transforme pas automatiquement les anciens numéros de licence en numéros de personne. Elle peut être relancée. Les anciens rapports deviennent périmés.
4. Recharger PHP-FPM ou Apache si nécessaire pour vider OPcache. Refaire tout aperçu d’import ouvert avant la mise à jour.
5. Dans Imports, choisir « Licenciés / joueurs et staff ». Indiquer explicitement la saison `2026/2027` pour les deux exports fournis, puis importer chaque fichier. Ligne d’en-tête : 1. La saison est obligatoire parce qu’aucune colonne du fichier ne donne la saison de la licence. Ne pas utiliser « Saison club quitté » à cette fin.
6. Vérifier les fiches rattachées, puis refaire l’import disciplinaire : il recherche désormais le numéro de personne FFF.
## Rattachement des anciennes fiches
L’import recherche d’abord le numéro de personne. Une ancienne fiche non encore rattachée peut être reconnue si son ancien champ licence correspond exactement au numéro personne ou au numéro de licence fourni, et si nom et prénom concordent après normalisation des accents et espaces.
Le rattachement conserve l’identifiant interne, donc les sanctions et les convocations existantes. Les numéros historiques restent conservés dans le champ technique d’origine. Ils ne sont pas présentés comme des licences de la saison actuelle.
Si plusieurs anciennes fiches correspondent, ou si l’identité diffère, le lot est bloqué avec le numéro personne concerné. Cette version n’effectue pas de fusion automatique de plusieurs historiques. Ne pas supprimer une fiche pour contourner ce blocage. Les anciennes fiches non rattachées apparaissent « À rattacher ».
## Registre et contrôle
La fiche affiche le numéro personne et la liste des licences avec leur saison et type. Un licencié joueur et dirigeant reste une seule personne. Les profils sont cumulés lors de ces imports ; ils ne constituent pas une preuve de validité des licences pour une compétition donnée. Un nouvel export ne supprime aucune ancienne licence.
Le contrôle par liste attend désormais des numéros de personne FFF. Les rapports affichent ce même identifiant. Les durées de suspension et les règles de purge existantes ne sont pas changées par cette évolution.
Les deux fichiers Footclubs fournis comportent 109 lignes, pour 100 personnes : 74 lignes Libre, 30 Dirigeant et 5 Educateur Fédéral. Huit personnes sont présentes dans les deux fichiers. Le fichier staff contient également une personne avec plusieurs types de licence.
L’import ne conserve pas les coordonnées, données médicales, dates de naissance, paiements et informations familiales de ces exports. Seules l’identité utile, la catégorie et les données de licence sont reprises.
Les anciens CSV génériques restent compatibles pour les fiches historiques, mais utiliser les exports Footclubs avec les deux identifiants pour le rattachement et le suivi saisonnier. Les avertissements et décisions ambiguës conservent les limites documentées dans les versions précédentes.
## Validation
11 tests spécifiques réussis : import réel des deux fichiers, 100 personnes, licences multiples, profil cumulé, rattachement d’une fiche existante avec conservation d’une sanction, réimports sans modification, changement de saison, saison obligatoire, rapprochement des sanctions par personne et migration relançable. Les 14 tests d’intégration antérieurs et le parcours HTTP du calendrier XLSX réussissent. Syntaxe PHP vérifiée. Aucune modification effectuée sur le serveur du club.