Tarot — Suivi des scores à 5 joueurs

Application mobile-first (PWA) pour le suivi des scores au Tarot à 5 joueurs, suivant les règles officielles de la FFT.

Fonctionnalités

• Gestion des joueurs : créer et gérer les joueurs
• Gestion des sessions : sélectionner 5 joueurs pour démarrer ou reprendre automatiquement une session
• Saisie des scores : assistant en deux étapes — enregistrer l'enchère au début du tour, compléter avec les résultats à la fin
• Correction des scores : modifier la dernière partie d'une session
• Statistiques : classement global, stats par joueur, évolution des scores par session

Stack technique

Couche	Technologie
Backend	Symfony 7.4, API Platform 4, PHP 8.3
Base de données	MariaDB 10.11
Frontend	React 19, TypeScript, Vite
Style	Tailwind CSS 4
PWA	vite-plugin-pwa
Données	TanStack Query
Local	DDEV

Démarrage rapide

Prérequis

• DDEV installé
• Node.js 20+

Installation

# Cloner le dépôt
git clone git@github.com:Soviann/tarot.git
cd tarot

# Démarrer l'environnement (installe les dépendances PHP et Node automatiquement)
ddev start
ddev composer install
ddev exec bin/console doctrine:database:create -n   # Créer la base de données
ddev exec bin/console doctrine:migrations:migrate -n # Appliquer les migrations

Note : le serveur de développement frontend (Vite) est lancé automatiquement par DDEV via un daemon configuré dans .ddev/config.yaml. Pas besoin de le démarrer manuellement.

Accès

• Application : https://tarot.ddev.site (frontend + API sur le même domaine)
• API Backend : https://tarot.ddev.site/api

Développement

Backend

ddev exec bin/phpunit                              # Lancer les tests
ddev exec bin/console doctrine:migrations:diff -n  # Générer une migration
ddev exec bin/console doctrine:migrations:migrate -n  # Appliquer les migrations

Frontend

ddev exec bash -c 'cd /var/www/html/frontend && npm run dev'    # Serveur de dev
ddev exec bash -c 'cd /var/www/html/frontend && npm test'       # Tests (Vitest)
ddev exec bash -c 'cd /var/www/html/frontend && npm run build'  # Build production

Gestion de projet

Les issues et la roadmap sont suivies sur le tableau Tarot - Roadmap.

Documentation

• Guide utilisateur — comment utiliser l'application
• Guide de contribution — comment contribuer au projet
• Guide de déploiement — héberger sur un VPS OVH
• Référence frontend — composants, hooks et types
• Document de conception — architecture et choix de conception