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

49 lines
3.8 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.
# 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](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 :
```bash
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`.