Spyk
Organiser, arbitrer et suivre des tournois de volley-ball en temps réel
Le besoin
Un tournoi de volley-ball amateur, c’est souvent des feuilles de match papier, un tableur, des inscriptions par message et un organisateur débordé le jour J. Les joueurs ne savent pas quand ni sur quel terrain ils jouent ; les spectateurs n’ont pas les scores. Spyk part de ces frictions vécues, pas d’une idée de fonctionnalité.
Clarifier et spécifier
- Les acteurs d’abord. Organisateur, participant, arbitre occasionnel, spectateur, administrateur : qui fait quoi, avec quels droits, et sans quelle contrainte — l’arbitre, par exemple, n’a pas besoin de créer de compte.
- Les parcours ensuite. Créer puis relancer un tournoi d’une année sur l’autre, ouvrir les inscriptions, encaisser en ligne ou sur place, démarrer, suivre en direct.
- Des règles écrites, pas supposées. Cycle de vie du tournoi, désistements, affectation des terrains, modèle économique : chaque décision structurante est documentée avant d’être développée.
Extrait de spécification
user story · démarrer un tournoi
En tant qu'organisateur, je veux démarrer mon tournoi moi-même, afin de garder la main le jour J, quel que soit l'horaire prévu.
- Le démarrage est une action explicite : une date de début dépassée ne déclenche rien automatiquement.
- Il exige des inscriptions closes, un calendrier généré et à jour, et au moins un terrain.
- Ce qui manque est listé sur l'aperçu du tournoi, avant même d'essayer.
- Dès qu'un match a démarré, le calendrier est figé.
Un arbitrage. Une équipe se désiste après la génération du calendrier : faut-il recalculer automatiquement ? Non. L’organisateur choisit entre déclarer forfait (le reste du calendrier ne bouge pas) et régénérer les poules concernées, avec les conséquences de chaque option affichées avant de valider. Un automatisme aurait été plus simple à coder, mais il aurait cassé des plannings déjà communiqués aux joueurs.
Choix d’architecture
- Le score comme une suite d’événements. Chaque point est un fait enregistré : le score se reconstruit, se corrige et se diffuse en temps réel à tous les téléphones.
- Un planning vivant. Les terrains sont attribués selon l’avancement réel des matchs, pas selon un horaire théorique qui ne tient jamais.
- L’organisateur reste maître. Le démarrage du tournoi est une décision humaine, jamais un automatisme à date fixe.
- Prévu pour les pics. Une finale, ce sont des dizaines d’écrans sur le même match au même moment : traitements asynchrones, cache et repli automatique si le direct décroche.
Livrer avec l’IA
Le développement est en grande partie réalisé par des agents de code. Ce qui le rend fiable n’est pas l’outil, mais le cadre : une documentation produit et technique qui sert de source de vérité, des décisions tracées, et chaque fonctionnalité livrée avec ses tests et vérifiée.
Résultats
TODO — Date de lancement, lien public, premiers tournois organisés.