TT Team Planner WP Registry grade D. High-severity findings · 5 findingsWP RegistryHigh-severity findings · 5 findingsOpen the reportD

Plugin WordPress pour gérer les compositions d'équipes d'un club de tennis de table sur une saison de championnat par équipes.

Développé par l'US Talence Tennis de Table (Nouvelle-Aquitaine), il implémente les règles de brûlage FFTT en vigueur dans la ligue.

Fonctionnalités

• 📋 Compositions par journée — assignation des 4 slots joueurs par équipe et par journée
• 🔥 Brûlage en temps réel — calcul automatique des règles 2 et 3 (FFTT II.112.1) à chaque saisie
• 📅 Disponibilités — chaque joueur renseigne ses disponibilités (dispo / indispo / incertain)
• 👥 Effectifs par phase — ventilation des joueurs dans les équipes pour chaque demi-saison
• 🔄 Synchronisation FFTT — import des licenciés depuis le plugin Mon Club TT
• 📱 Application mobile (PWA) — installable sur iOS et Android, fonctionne hors ligne
• 🌙 Mode sombre — thème clair/sombre

Captures d'écran

Tableau de bord	Compositions

Liste des joueurs	Joueur brûlé

Architecture

tt-team-planner/
├── tt-team-planner.php          # Point d'entrée WordPress
├── assets/
│   ├── js/app.js                # SPA vanilla JS (zéro dépendance)
│   ├── css/style.css            # Styles globaux
│   ├── manifest.json            # Manifeste PWA
│   └── service-worker.js        # Cache shell + API offline
└── includes/
    ├── Plugin.php               # Bootstrap & DI
    ├── Activator.php / Deactivator.php
    ├── Admin/
    │   ├── SettingsPage.php     # Interface de configuration
    │   └── SyncPage.php         # Synchronisation manuelle
    ├── Domain/
    │   ├── Player.php           # Entité joueur
    │   ├── BurnageChecker.php   # Règles de brûlage FFTT
    │   ├── BurnageStatus.php    # Résultat (ok / rule2 / rule3)
    │   ├── Availability.php
    │   ├── MatchAppearance.php
    │   ├── PhaseSquad.php
    │   └── TeamComposition.php
    ├── Repository/
    │   ├── MatchAppearanceRepository.php
    │   └── TeamCompositionRepository.php
    ├── Rest/
    │   ├── PlayersController.php         # GET /ttp/v1/players
    │   ├── AvailabilityController.php    # GET|POST /ttp/v1/availability
    │   ├── TeamsController.php           # GET|POST|DELETE /ttp/v1/compositions
    │   ├── PhaseSquadController.php      # GET|POST|DELETE /ttp/v1/phase-squads
    │   ├── MatchAppearanceController.php # GET|POST|DELETE /ttp/v1/appearances
    │   ├── SyncController.php            # POST /ttp/v1/players/sync
    │   └── SeasonController.php          # POST /ttp/v1/season/reset
    └── Front/
        ├── Assets.php                   # Enqueue + wp_localize_script
        └── StandaloneTemplate.php       # Template page standalone

SPA côté client

L'interface est une Single Page Application vanilla JS (aucun framework, aucun build step) rendue dans #ttp-app. Elle fonctionne selon un cycle état → rendu → événement :

S (state)  →  render()  →  DOM
     ↑                        │
     └──── attachEvents() ←───┘

Le state (S) est un objet JS simple. Toute modification passe par setState(patch) qui déclenche un nouveau rendu.

API REST

Base : /wp-json/ttp/v1/

Règles de brûlage (FFTT II.112.1)

Le plugin implémente les deux règles de brûlage applicables en championnat par équipes format 4 joueurs.

Ces règles sont appliquées dans BurnageChecker.php en se basant sur les MatchAppearance (apparences validées) enregistrées en base.

Règle 2 — Plafonnement par équipe

Un joueur ayant disputé 2 rencontres ou plus au cours d'une phase dans une équipe de rang N (ou inférieur) ne peut plus jouer dans une équipe de rang supérieur à N pour le reste de la phase.

Le rang d'une équipe est déduit de son code (ex. T1 → rang 1, T3 → rang 3). Plus le numéro est petit, plus l'équipe est forte.

Exemple :

• J1 : Florian joue en Équipe 1 (T1)
• J2 : Florian joue en Équipe 2 (T2)
• J3 : le plafond est max(rang joué) = 2 → Florian est brûlé pour toute équipe de rang > 2 → 🔥 ne peut plus jouer qu'en T1 ou T2

Règle 3 — Limite J2 (montée de niveau)

À la 2e journée d'une phase, une équipe ne peut aligner plus d'un joueur ayant joué la 1re journée dans une équipe de rang inférieur (plus forte).

Exemple :

• J1 : Luc joue en T1, Marc joue en T1
• J2 : si Luc est déjà aligné en T2, Marc ne peut pas l'être → ⚠ Limite J2

Affichage dans l'UI

Le statut est recalculé côté serveur après chaque modification de composition (invalidation du cache local + rechargement via /burnage).

Prérequis

• PHP 8.1 ou supérieur
• WordPress 6.4 ou supérieur
• Plugin Mon Club TT pour la synchronisation des licenciés FFTT

Installation

Développement

cd wp-content/plugins
git clone <url-du-repo> tt-team-planner
cd tt-team-planner
composer install

Activer le plugin depuis l'interface WordPress, puis configurer les équipes dans Réglages → TT Team Planner.

Production

Chaque release GitHub embarque un ZIP prêt à l'emploi (tt-team-planner.zip), déjà nettoyé des fichiers de dev (tests, composer, etc.).

1. Télécharger le ZIP de la dernière release.
2. Dans l'administration WordPress : Extensions → Ajouter → Téléverser une extension, sélectionner le ZIP, Installer maintenant.
3. Pour une mise à jour, réactiver après l'installation (WordPress propose de remplacer la version existante).

Alternative FTP/SSH : décompresser le ZIP dans wp-content/plugins/.

Configuration

Depuis WP Admin → TT Team Planner → Réglages :

Application mobile (PWA)

L'application est installable sur mobile via le bandeau d'installation intégré :

• Android / Chrome : bouton "Installer" → prompt natif du navigateur
• iOS / Safari : instructions "⎙ Partager → Sur l'écran d'accueil"

Une fois installée, l'app fonctionne en mode hors ligne (cache shell CSS/JS + cache des dernières données API).

Tests

# PHP
composer test

# PHP — unitaires uniquement
composer test:unit

# PHP — avec couverture
composer test:coverage

# JavaScript
npm install && npm test

Licence

GPL v2 or later — voir LICENSE