Files
ESBSC-CONVOC/MISE_A_JOUR_CACHETS.md
2026-11-11 09:24:28 +01:00

4.6 KiB

V3.0.0-rc2 — cachets Footclubs

Complément RC3 : le statut et la qualification sont désormais automatisés avec les colonnes Statut et Enregistrement. Voir MISE_A_JOUR_RC3.md, qui remplace les limites RC2 ci-dessous sur ces deux critères.

Mise à jour depuis la RC1

  1. Arrêter temporairement les écritures et sauvegarder la base, la configuration et storage/.
  2. Installer ce code en conservant la configuration de connexion et le dossier storage/ existants. Ne pas lancer demo, ne pas vider de table. Le site doit toujours pointer vers public/.
  3. Depuis le dossier de l'application, avec la configuration de la base cible :
php bin/console.php migrate
  1. Dans Imports, réimporter l'export complet 44171420d.xlsx, type Joueurs / personnes, saison 2026/2027. Utiliser la première ligne pour les titres et la feuille contenant les licenciés. Contrôler l'aperçu, puis valider. Les comptes, sanctions et historiques sont conservés.
  2. Ouvrir Licences pour vérifier les cachets importés, puis ouvrir une convocation : les compteurs sont recalculés pour la date de cette rencontre. Refaire les contrôles des convocations précédemment validées si les données ont changé.

Pour une installation depuis V2, suivre également MISE_A_JOUR_V3.md.

Comportement

Donnée importée Effet à la date du match
MN, mutation normale, dans ses dates de validité Compte dans le total des mutés
MH, mutation hors période, dans ses dates de validité Compte dans le total et dans le sous-total hors période
Colonnes cachets toutes présentes mais vides Aucun cachet mutation pour cette licence ; remplace l'ancien relevé
Cachet pas encore commencé ou expiré Ne compte pas à cette date
Export sans colonnes cachets Conserve le relevé existant ; sans relevé, conserve le contrôle manuel
Cachet inconnu actif Alerte demandant une vérification humaine
Dates impossibles, code/libellé contradictoires ou colonnes incomplètes Import refusé avec explication ; aucune application partielle

Les dates de début et de fin sont inclusives. Un cachet finissant le 14 octobre compte encore le 14, plus le 15. Plusieurs lignes de cachets pour une même licence sont regroupées ; un joueur avec MN et MH ne compte qu'une fois dans le total.

Le champ « nature du changement de club », y compris « Mutée » ou « Non mutée », est ignoré. La présence d'une mutation administrative ne suffit donc jamais à classer le joueur comme muté.

Les cachets sont attachés à la licence de la saison, et le contrôle des joueurs utilise la licence Libre. Les sanctions restent attachées à la personne. Un import d'une autre saison ne remplace pas les cachets de la saison courante.

Le dernier export complet validé remplace le relevé de cachets de chaque licence présente ; les anciennes valeurs restent dans le journal d'audit. Les licences absentes du fichier sont conservées. Importer des exports à jour : l'application ne connaît pas leur date réelle d'extraction. Un réimport strictement identique ne change pas les données ni leur révision.

Les cachets importés sont affichés avec le fichier source et la date d'import. Ils prennent priorité sur l'ancienne saisie manuelle de mutation ou d'exemption. Pour corriger ce relevé, réimporter un export complet corrigé. Les plafonds des équipes restent ceux du profil réglementaire confirmé.

Ce qui reste à vérifier

Cette livraison automatise les cachets. L'activité de la licence, la date de qualification et les restrictions de catégorie restent à renseigner dans Licences. La date d'enregistrement n'est pas transformée en date de qualification. Les autres alertes « à vérifier » ne disparaissent donc pas automatiquement après cet import.

Vérifications de livraison

  • 19 tests unitaires cachets et 14 tests SQL sur une base MariaDB jetable.
  • Export réel : 75 licences, 9 MN, 1 MH et 65 sans cachet au 26 septembre 2026 ; 8 MN, 1 MH et 66 sans cachet au 15 octobre.
  • Réimport identique, conservation depuis un ancien export, remplacement par colonnes vides, saisons distinctes, lignes multiples et refus atomique d'un lot erroné.
  • Migration relancée, conservation des historiques V2, suites personnes/discipline/FMI/convocations et syntaxe PHP vérifiées.
  • Écrans et formulaires vérifiés par HTTP : affichage des cachets, maintien de la source importée lors d'une vérification manuelle, quotas et protection contre les formulaires périmés.

Ces vérifications ont été réalisées sur une base de test, pas sur votre serveur. Les exports personnels ne sont pas inclus dans l'archive.