Actorle
Un jeu de devinettes inspiré de Wordle, mais autour des acteurs de cinéma. Le joueur doit deviner le nom d'un acteur lettre par lettre, en s'aidant d'indices liés aux films, personnages et récompenses des acteurs.
Principe du jeu
- Le joueur lance une partie. Le système choisit un acteur aléatoire (filtré par popularité TMDB).
- Pour chaque lettre du nom de l'acteur, un acteur-indice est attribué, dont le nom commence par cette lettre.
- Chaque ligne de la grille propose un indice sur l'acteur-indice : un film dans lequel il a joué, un personnage qu'il a incarné, ou une récompense qu'il a reçue.
- Le joueur utilise ces indices pour reconstituer le nom de l'acteur principal.
Les données proviennent de la filmographie Letterboxd de l'utilisateur : seuls les acteurs issus de ses films regardés sont utilisés pour générer les grilles.
Stack technique
| Couche | Technologies |
|---|---|
| Backend | PHP 8.4, Symfony 8.0, Doctrine ORM, Symfony Messenger |
| Frontend | React 19, Stimulus, Turbo, Vite 6 |
| Base | PostgreSQL 16 |
| Stockage | FlySystem (S3-compatible) |
| Serveur | FrankenPHP (dev), Caddy (prod) |
| Infra | Docker Compose |
Architecture
src/
├── Controller/ # Contrôleurs (Game, Import, Auth)
├── Entity/ # Entités Doctrine (Game, Actor, Movie, Award...)
├── Provider/ # Fournisseurs de données (GameGridProvider)
├── Import/ # Import de données externes (FilmImporter, ActorSyncer, AwardImporter)
├── Repository/ # Requêtes Doctrine
├── Gateway/ # Intégrations externes (TMDB, Wikidata, Letterboxd)
├── Message/ # Messages async (ProcessImport, ImportFilmsBatch)
├── MessageHandler/ # Handlers Symfony Messenger
├── EventListener/ # Abandon auto des parties anonymes au login
├── Form/ # Formulaires (inscription)
└── Model/ # DTOs (TMDB, Letterboxd)
Intégrations externes
- TMDB API : recherche de films, récupération des castings et crédits
- Wikidata SPARQL : récupération des récompenses des acteurs (Oscars, BAFTA, etc.)
- Letterboxd : import de la filmographie via export CSV
Import de films
- L'utilisateur exporte son historique depuis Letterboxd (CSV).
- Il upload le fichier via l'interface.
- Un message async découpe l'import en batchs de 50 films.
- Chaque batch recherche les films sur TMDB, synchronise les acteurs et importe leurs récompenses depuis Wikidata.
- L'avancement est consultable en temps réel via l'API (
GET /api/imports/latest).
Installation
Prérequis
- Docker et Docker Compose
- Un token API TMDB
Lancement en développement
# Démarrer les conteneurs (app, messenger, database, node)
make dev:up
# Installer les dépendances npm
make node:install
# Exécuter les migrations
make db:migrate
L'application est accessible sur http://localhost.
Le serveur Vite (HMR) tourne sur le port 5173.
Configuration
Les secrets (token TMDB, etc.) se gèrent via Symfony Secrets :
make symfony:secrets-set NAME="TMDB_API_TOKEN"
Variables d'environnement principales :
| Variable | Description |
|---|---|
APP_ENV |
Environnement (dev / prod) |
APP_SECRET |
Secret Symfony |
TMDB_API_TOKEN |
Token API TMDB (via secrets) |
POSTGRES_HOST |
Hôte PostgreSQL |
POSTGRES_USER |
Utilisateur PostgreSQL |
POSTGRES_PASSWORD |
Mot de passe PostgreSQL |
POSTGRES_DB |
Nom de la base |
MESSENGER_TRANSPORT_DSN |
DSN du transport Messenger |
Commandes utiles
make dev:up # Démarrer le dev
make dev:down # Arrêter le dev
make dev:logs # Logs en temps réel
make dev:shell # Shell dans le conteneur app
make db:migrate # Exécuter les migrations
make db:migration # Générer une migration
make db:reset # Reset complet de la base
make test # Lancer les tests PHPUnit
make node:build # Build des assets pour la prod
make help # Afficher toutes les commandes
Déploiement
# Build et push des images vers le registry
make docker:build
make docker:push
# Sur le serveur de production
make prod:up
Les images sont hébergées sur le registry Gitea git.lclr.dev.
Services Docker
| Service | Description |
|---|---|
app |
Application FrankenPHP (dev) / Caddy (prod) |
messenger |
Worker Symfony Messenger (consomme la queue async) |
database |
PostgreSQL 16 |
node |
Vite dev server avec HMR (dev uniquement) |