Files
2026-11-11 09:24:28 +01:00

3.8 KiB
Raw Permalink Blame History

Suivi sportif du club — V4.0.0-rc1

Version candidate du 2 octobre 2026, basée sur la V3.2.1 et ses correctifs de septembre.

Commencer par MISE_A_JOUR_V4.md pour mettre à jour une installation existante sans Docker. Les guides V2/V3 restent des documents historiques ; ce guide V4 fait référence.

Nouveautés

  • Import Spond XLSX : lecture exclusive de la feuille « À importer », rapprochement confirmé puis mémorisé, présent / absent / sans réponse, réimport et filtres dans les convocations.
  • Nom, logo, affiliation FFF et couleurs du club configurables. Logo proportionné dans les exports PNG et PDF des convocations ; nom et couleurs dans Excel.
  • Domicile et extérieur lisibles dans le calendrier. Alertes sur les créneaux qui se chevauchent sur un même terrain et sur trois réceptions dans la journée, avec suivi et justification.
  • Effectif et affectations du staff par saison. Ouverture d’une saison vide ou avec reprise de l’effectif, anciens calendriers et historiques conservés en consultation.
  • Connexion OpenID Connect facultative, comptes et droits locaux conservés, compte administrateur de secours.
  • Seuils de fin de saison communs aux convocations et rapports : +10 par défaut ; variante 2 joueurs à +7 soumise au paramétrage confirmé et au justificatif de chaque match.

Les fonctionnalités V3 restent disponibles : registre FFF par personne, multi-licences, calendriers et discipline Footclubs XLSX, FMI PDF, purge par équipe, statistiques, contrôles de qualification et cachets, favoris, staff, disponibilités manuelles et exports des groupes.

Installation neuve sans Docker

Prérequis : PHP 8.2 ou supérieur, MariaDB 10.11 ou supérieur, extensions PHP pdo_mysql, mbstring, iconv, session, zlib, zip, SimpleXML, gd, curl, openssl, fileinfo. poppler-utils et coreutils sont nécessaires pour les FMI PDF. Aucun service Node, Composer ou Docker n’est nécessaire en production ; la dépendance JWT est incluse.

  1. Créer une base MariaDB UTF-8 et un compte dédié, autorisé à gérer son schéma lors des migrations.
  2. Déployer le dossier de l’application, par exemple /var/www/esbsc.
  3. Configurer Apache/NGINX pour servir uniquement /var/www/esbsc/public. Exemples dans deploy/.
  4. Renseigner la connexion dans config/database.php, ou fournir DB_DSN, DB_USER, DB_PASSWORD au service PHP et à la commande de migration.
  5. Donner à PHP l’écriture sur storage/ et un dossier de sessions fonctionnel.
  6. Exécuter dans le dossier de l’application :
php bin/console.php migrate
php bin/console.php create-admin responsable@example.fr "Responsable du club"

La commande demande le mot de passe sans l’afficher. Utiliser HTTPS ; SESSION_SECURE=0 est réservé à un essai HTTP local. Le fichier .env.example documente les variables : hors Compose, PHP ne charge pas automatiquement un fichier .env.

Repères

  • MISE_A_JOUR_V4.md : mise à jour, nouveautés détaillées, OpenID, recette et retour arrière.
  • RELEASE_V4.md : périmètre livré, vérifications et limites connues de cette candidate.
  • THIRD_PARTY.md : dépendance OpenID incluse.
  • bin/console.php : migration, comptes et rapports en ligne de commande.
  • tests/ : tests à exécuter uniquement sur une base jetable.

Docker facultatif

Les fichiers Dockerfile et docker-compose.yml sont conservés. Utiliser le même nom de projet et les mêmes volumes qu’en V3. Ne pas supprimer les volumes. Lancer la migration après reconstruction du service ; cette voie n’a pas été reconstruite dans l’environnement de recette de la RC1.

La V4 ajoute un volume persistant pour les FMI. Avant de recréer un ancien conteneur, suivre la sauvegarde et la restauration du dossier FMI décrites dans MISE_A_JOUR_V4.md.