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

55 lines
4.6 KiB
Markdown

# 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](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 :
```bash
php bin/console.php migrate
```
4. 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.
5. 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.