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

143 lines
13 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Mise à jour V3.2.1 → V4.0.0-rc1
Cette archive est complète et inclut les correctifs des rapports, de la vue du week-end et des doubles profils joueur/staff. La migration est obligatoire. Une RC est une version candidate destinée à la recette sur une copie de l’installation avant son adoption en production.
## 1. Préparer et installer sans Docker
1. Sauvegarder la base avec `mariadb-dump`, le dossier `storage/`, `config/database.php`, et la configuration Apache/NGINX/PHP. Conserver le code V3.
2. Faire d’abord la mise à jour sur une copie de la base et de `storage/`. Une installation de test doit utiliser sa propre base.
3. Suspendre les accès à l’application le temps de remplacer le code et d’exécuter la migration.
4. Remplacer les fichiers applicatifs par ceux de cette archive. Conserver votre `config/database.php`, votre `.env` éventuel, `storage/` et vos réglages de déploiement. Ajouter `vendor/`, les nouveaux fichiers de `src/`, `templates/`, `public/assets/` et `config/oidc.php`. Ne pas utiliser une synchronisation qui supprimerait les fichiers FMI existants.
5. Vérifier les extensions PHP. Sur Debian/Ubuntu, les nouveaux besoins sont `php-gd` pour traiter le logo et `php-curl` pour OpenID ; les extensions déjà utilisées par la V3 restent nécessaires. Redémarrer le service PHP/Apache approprié après installation.
6. Depuis le dossier de l’application, avec les mêmes paramètres de connexion que le service web :
```bash
php bin/console.php migrate
```
7. Recharger PHP-FPM/Apache si OPcache conserve les anciens fichiers, puis recharger le navigateur. Se reconnecter et vérifier le pied de page `V4.0.0-rc1`.
Le schéma V4 ajoute les paramètres du club, les saisons et leurs effectifs, les réponses Spond, les résolutions des alertes et les associations OpenID. Les joueurs, licences, décisions, matchs, FMI et rapports restent en base. Le numéro de personne FFF conserve son rôle d’identifiant sportif. Aucun nouvel export Footclubs n’est imposé pour migrer la version.
La migration initiale affecte le registre existant à la saison correspondant à la date du serveur et retrouve les saisons des calendriers/licences existants. Vérifier cette saison dans le menu après migration. Les anciens exports ne permettent pas de reconstruire exactement des affectations manuelles qui n’avaient jamais été historisées avant la V4.
### Cas d’une installation Docker existante
Conserver le nom de projet Compose et les volumes de base/rapports. Ne jamais utiliser `down -v`. La V4 ajoute le volume `fmi_data` : les PDF stockés dans l’ancien conteneur doivent être copiés avant sa recréation, sinon le nouveau volume vide les masquera.
Avant de remplacer les fichiers Compose, depuis le dossier de l’ancienne installation, après sauvegarde de la base et fermeture des accès :
```bash
mkdir sauvegarde-fmi-v3
docker compose stop app
docker compose cp app:/var/www/html/storage/fmi/. ./sauvegarde-fmi-v3/
```
Vérifier que les PDF attendus sont bien présents dans cette sauvegarde. Si aucun FMI n’a jamais été importé, le dossier source peut ne pas exister. Après remplacement du code et reconstruction, avec les accès toujours fermés :
```bash
docker compose up -d --build
docker compose cp ./sauvegarde-fmi-v3/. app:/var/www/html/storage/fmi/
docker compose exec -u root app chown -R www-data:www-data /var/www/html/storage/fmi
docker compose exec app php bin/console.php migrate
```
Vérifier le téléchargement d’un ancien FMI avant de rouvrir les accès. Conserver la sauvegarde hors des conteneurs. Cette voie Docker n’a pas été reconstruite pendant la recette RC1.
## 2. Disponibilités Spond
Menu **Disponibilités Spond** (administrateur ou secrétariat) :
1. Charger l’export XLSX complet. L’application utilise uniquement « À importer », titres ligne 4.
2. Choisir une date de la semaine, pour une réponse commune à toutes les équipes, ou un match précis.
3. Confirmer les correspondances proposées. Rattacher manuellement les noms abrégés ou homonymes. Choisir explicitement « Ignorer » pour un participant qui ne doit pas être rattaché.
4. Confirmer l’import.
Les identités sont suggérées sur les noms normalisés ; aucune fusion de fiches FFF n’est effectuée. Les correspondances confirmées sont mémorisées avec une empreinte du nom et des coordonnées. Si ces éléments changent dans Spond, un nouveau rapprochement peut être demandé.
Les trois réponses restent distinctes : **Présent**, **Absent**, **Sans réponse**. **Non renseigné** signifie que le joueur n’a aucune réponse importée pour cette portée. Des réponses différentes sur la semaine et sur un match affichent **Réponses contradictoires**. Les heures de réponse et d’import sont conservées ; le fuseau horaire n’étant pas indiqué par Spond dans ce fichier, les dates/horaires sont repris tels qu’exportés.
Un réimport remplace l’état de la même semaine ou du même match, sans doubler les personnes. Les réponses plus anciennes que celles déjà enregistrées sont refusées. Les lignes ignorées ou absentes du nouveau fichier ne restent pas comme réponses courantes pour cette portée. Les autres semaines et matchs sont conservés.
Dans **Préparer match** et les **Non-convoqués**, le filtre Spond réduit la liste. Un joueur déjà sélectionné reste visible même s’il ne correspond plus au filtre. Présence et absence restent informatives : elles n’accordent pas la qualification et n’empêchent pas la sélection. Les blessures et indisponibilités manuelles ne sont pas écrasées. Les réponses Spond et les coordonnées ne sont pas incluses dans les exports partagés des convocations.
## 3. Personnalisation et exports
Menu administrateur **Réglages du club** : nom complet, nom court, numéro d’affiliation FFF, couleur principale et secondaire, logo PNG/JPEG de 2 Mo maximum et de 4096 pixels maximum par dimension.
Le logo conserve ses proportions. Préférer une image source d’au moins 512 pixels, idéalement PNG transparent. Le logo apparaît dans l’application, le PNG et le PDF des convocations. Le PDF utilise une copie normalisée sur fond blanc. Le nom et les couleurs sont repris dans Excel ; l’export Excel de cette RC n’intègre pas l’image du logo.
L’export PNG reste prévisualisé avant téléchargement et conserve le tableau des équipes côte à côte, avec date/heure et pictogramme domicile/extérieur. Staff et légende sont optionnels. Sans logo fourni, l’en-tête affiche le nom du club.
L’affiliation FFF configurée est utilisée pour reconnaître le club dans les FMI. La valeur initiale reste `520480` pour ESBSC. Les quatre équipes E1 à E4 restent celles de l’installation existante.
## 4. Calendrier et terrains
Chaque match affiche **⌂ Dom.**, **✈ Ext.** ou **? Lieu à préciser**. Le terrain peut être renseigné sur la fiche du match. Un match à domicile sans terrain précisé utilise le terrain par défaut des réglages.
La durée d’occupation est configurable, marges comprises : **120 minutes par défaut** (deux coups d’envoi à 13 h et 15 h sont compatibles). Sur une RC1 déjà installée avec 150 minutes, modifier cette valeur dans les réglages du club. Deux matchs qui occupent le même terrain sur des créneaux qui se chevauchent sont signalés. Trois réceptions le même jour sont toujours signalées, même à des horaires différents. Une heure manquante sur deux réceptions du même terrain déclenche une demande de vérification.
L’alerte montre les rencontres concernées. Modifier les horaires/terrains si nécessaire, puis indiquer l’organisation retenue et cocher **Organisation traitée**. Une modification des données impliquées réactive la vérification. Ce suivi ne reporte aucun match auprès du District et ne bloque pas la préparation du groupe.
## 5. Saisons
Le sélecteur du menu permet de consulter les saisons. Dans **Saisons**, un administrateur peut ouvrir une nouvelle saison :
- effectif vide à reconstituer par import Footclubs ;
- ou reprise de l’effectif et des affectations du staff.
Les personnes ne sont pas supprimées. Une personne réimportée est retrouvée par son numéro FFF. Les licences restent propres à leur saison. Dans le mode vide, les anciennes affectations d’équipe habituelle ne sont pas imposées aux personnes réimportées.
Le nouveau calendrier est vide. Les profils réglementaires sont copiés comme modèles **non confirmés**, sans date de début des cinq dernières rencontres ni confirmation du calendrier complet ; le bonus arbitrage doit être revérifié pour la nouvelle saison. Les favoris manuels et disponibilités ne sont pas copiés vers de nouvelles dates.
L’ancienne saison devient consultable : effectif, affectations, calendriers, FMI et statistiques. Les décisions disciplinaires restent disponibles dans l’historique commun et continuent d’être prises en compte si leur effet dépasse la saison. Ne pas tronquer les tables joueurs, sanctions ou matchs.
L’ouverture d’une nouvelle saison n’a pas de bouton d’annulation dans cette RC. Le retour à l’état antérieur se fait par restauration de sauvegarde. Le passage est donc à essayer sur la copie de recette.
## 6. Contrôles de fin de saison
Les participations effectives (`participated=1`) à des matchs officiels joués ou arrêtés des équipes supérieures sont cumulées depuis le début de la saison. Championnat et coupe entrent dans ce périmètre ; les amicaux marqués non officiels sont exclus. Les seuils sont stricts : 10 ne signifie pas plus de 10, et 7 ne signifie pas plus de 7.
Le profil normal reste **+10**, avec le maximum configuré (habituellement 3). La variante **2 joueurs à +7** nécessite :
1. un profil de compétition confirmé, identifié comme championnat, avec le contrôle de fin de saison et la variante autorisés ;
2. un match situé dans la période des cinq dernières rencontres configurée ;
3. l’option cochée sur cette rencontre et un justificatif concernant l’adversaire, ses engagements, le texte applicable et la saison.
Cette variante n’est activée automatiquement pour aucun adversaire. La RC fournit le contrôle paramétrable ; elle ne certifie pas l’interprétation réglementaire ni les engagements des clubs adverses. Les textes applicables à la saison doivent être confirmés avant activation. Les mêmes seuils alimentent les compteurs de préparation et le rapport.
## 7. OpenID Connect facultatif
La connexion locale continue de fonctionner tant qu’OpenID n’est pas configuré. Conserver un administrateur local avec un mot de passe connu.
Dans le fournisseur d’identité, créer un client Web confidentiel acceptant **Authorization Code**, **PKCE S256**, signatures **RS256**, authentification du client **client_secret_post** et retour par paramètres de requête. Déclarer exactement l’URL HTTPS de retour, par exemple `https://votre-application.example/auth/callback`.
Renseigner `config/oidc.php` hors du dossier public, ou les variables du service PHP :
```text
OIDC_ISSUER=https://votre-fournisseur.example/chemin-emetteur
OIDC_CLIENT_ID=identifiant-client
OIDC_CLIENT_SECRET=secret-client
OIDC_REDIRECT_URI=https://votre-application.example/auth/callback
```
L’URL d’émetteur doit correspondre exactement à `issuer` dans la découverte OpenID. Pour un fournisseur avec plusieurs tenants, utiliser l’émetteur exact du tenant du club. Les appels sortants HTTPS de PHP vers la découverte, les clés et l’échange de code doivent être autorisés ; la validation TLS reste activée.
Dans **Utilisateurs**, créer ou modifier le compte et renseigner l’identifiant **sub** correspondant au client. Un utilisateur authentifié mais non associé reçoit son identifiant à transmettre à l’administrateur. Aucun compte n’est créé automatiquement sur la seule base d’un e-mail. L’association repose sur l’émetteur et le `sub` ; les rôles admin/secrétariat/coach/lecture seule restent locaux.
Un nouveau compte avec identité OpenID peut être créé sans mot de passe à transmettre. Le secours local peut être rétabli avec :
```bash
php bin/console.php reset-password responsable@example.fr
```
Les jetons ne sont pas conservés en session après connexion. La déconnexion termine la session de l’application ; elle ne déconnecte pas globalement l’utilisateur du fournisseur. Les fournisseurs utilisant uniquement ES256, chiffrement de jetons ou une autre méthode d’authentification du client ne sont pas pris en charge par cette RC.
## 8. Recette et retour arrière
Après migration, comparer sur la copie les nombres de personnes/licences, matchs, FMI, sanctions et rapports avec la V3. Vérifier notamment une suspension partiellement purgée, un double profil joueur/staff, une qualification à un jour près et un groupe déjà enregistré.
Tester Spond sur une semaine à venir, l’import du logo et les exports PNG/PDF, puis une ouverture de saison sur une autre copie jetable. La connexion OpenID doit faire l’objet d’un essai avec votre fournisseur réel avant ouverture aux collègues.
Pour revenir à la V3, restaurer **ensemble** la sauvegarde de base, le code V3, la configuration et `storage/`. Ne pas remettre uniquement le code V3 sur le schéma V4. Les anciennes commandes de réparation nominatives documentées dans les guides historiques ne font pas partie de la procédure de mise à jour.