Initial clean version
This commit is contained in:
@@ -0,0 +1,48 @@
|
||||
# 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`.
|
||||
Reference in New Issue
Block a user