feat: include release year in film hint text

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

.dockerignore

@@ -1,6 +1,6 @@
 vendor/
 var/
-.env.local
+.env
 .env.*.local
 /public/assets/
 /assets/vendor/

.env.dist

@@ -8,6 +8,4 @@ MESSENGER_TRANSPORT_DSN=doctrine://default?auto_setup=0
 
 MAILER_DSN=null://null
 
-TMDB_API_TOKEN=
-
 SERVER_NAME=

.env.test

@@ -1,3 +1,4 @@
 # define your env variables for the test env here
 KERNEL_CLASS='App\Kernel'
 APP_SECRET='$ecretf0rt3st'
+POSTGRES_DB=app_test

.gitea/issue_template/bug_report.yaml

@@ -0,0 +1,13 @@
+name: Report Bug
+about: Signaler un bug rencontré dans le jeu
+labels:
+  - "type: bug"
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: Décrivez le bug rencontré
+      placeholder: Décrivez ce qui s'est passé et ce que vous attendiez...
+    validations:
+      required: true

.gitea/workflows/docker.yml

@@ -1,126 +0,0 @@
-name: Build and Push Docker Images
-
-on:
-  push:
-    branches:
-      - main
-
-jobs:
-  build-app:
-    name: Build app image
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 2
-
-      - name: Check if app image should be rebuilt
-        id: changed
-        run: |
-          # Rebuild if docker/app/ or any PHP/config source changed
-          CHANGED=$(git diff --name-only HEAD~1 HEAD | grep -E '^(docker/app/|src/|config/|templates/|migrations/|composer\.(json|lock)|symfony\.lock|\.env)' | wc -l)
-          echo "changed=$([ "$CHANGED" -gt 0 ] && echo true || echo false)" >> $GITHUB_OUTPUT
-
-      - name: Set up Docker Buildx
-        if: steps.changed.outputs.changed == 'true'
-        uses: docker/setup-buildx-action@v3
-
-      - name: Login to Gitea registry
-        if: steps.changed.outputs.changed == 'true'
-        uses: docker/login-action@v3
-        with:
-          registry: git.lclr.dev
-          username: ${{ github.actor }}
-          password: ${{ secrets.GITEA_TOKEN }}
-
-      - name: Build and push app
-        if: steps.changed.outputs.changed == 'true'
-        uses: docker/build-push-action@v6
-        with:
-          context: .
-          file: docker/app/Dockerfile
-          target: prod
-          push: true
-          tags: |
-            git.lclr.dev/thibaud-lclr/ltbxd-actorle/app:latest
-            git.lclr.dev/thibaud-lclr/ltbxd-actorle/app:${{ github.sha }}
-          cache-from: type=registry,ref=git.lclr.dev/thibaud-lclr/ltbxd-actorle/app:buildcache
-          cache-to: type=registry,ref=git.lclr.dev/thibaud-lclr/ltbxd-actorle/app:buildcache,mode=max
-
-  build-database:
-    name: Build database image
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 2
-
-      - name: Check if database image should be rebuilt
-        id: changed
-        run: |
-          CHANGED=$(git diff --name-only HEAD~1 HEAD | grep -q '^docker/database/' && echo true || echo false)
-          echo "changed=$CHANGED" >> $GITHUB_OUTPUT
-
-      - name: Set up Docker Buildx
-        if: steps.changed.outputs.changed == 'true'
-        uses: docker/setup-buildx-action@v3
-
-      - name: Login to Gitea registry
-        if: steps.changed.outputs.changed == 'true'
-        uses: docker/login-action@v3
-        with:
-          registry: git.lclr.dev
-          username: ${{ github.actor }}
-          password: ${{ secrets.GITEA_TOKEN }}
-
-      - name: Build and push database
-        if: steps.changed.outputs.changed == 'true'
-        uses: docker/build-push-action@v6
-        with:
-          context: docker/database
-          push: true
-          tags: |
-            git.lclr.dev/thibaud-lclr/ltbxd-actorle/database:latest
-            git.lclr.dev/thibaud-lclr/ltbxd-actorle/database:${{ github.sha }}
-          cache-from: type=registry,ref=git.lclr.dev/thibaud-lclr/ltbxd-actorle/database:buildcache
-          cache-to: type=registry,ref=git.lclr.dev/thibaud-lclr/ltbxd-actorle/database:buildcache,mode=max
-
-  build-node:
-    name: Build node image
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 2
-
-      - name: Check if node image should be rebuilt
-        id: changed
-        run: |
-          CHANGED=$(git diff --name-only HEAD~1 HEAD | grep -E '^(docker/node/|assets/|package(-lock)?\.json|vite\.config\.js)' | wc -l)
-          echo "changed=$([ "$CHANGED" -gt 0 ] && echo true || echo false)" >> $GITHUB_OUTPUT
-
-      - name: Set up Docker Buildx
-        if: steps.changed.outputs.changed == 'true'
-        uses: docker/setup-buildx-action@v3
-
-      - name: Login to Gitea registry
-        if: steps.changed.outputs.changed == 'true'
-        uses: docker/login-action@v3
-        with:
-          registry: git.lclr.dev
-          username: ${{ github.actor }}
-          password: ${{ secrets.GITEA_TOKEN }}
-
-      - name: Build and push node
-        if: steps.changed.outputs.changed == 'true'
-        uses: docker/build-push-action@v6
-        with:
-          context: .
-          file: docker/node/Dockerfile
-          target: dev
-          push: true
-          tags: |
-            git.lclr.dev/thibaud-lclr/ltbxd-actorle/node:latest
-            git.lclr.dev/thibaud-lclr/ltbxd-actorle/node:${{ github.sha }}
-          cache-from: type=registry,ref=git.lclr.dev/thibaud-lclr/ltbxd-actorle/node:buildcache
-          cache-to: type=registry,ref=git.lclr.dev/thibaud-lclr/ltbxd-actorle/node:buildcache,mode=max

.gitignore

@@ -1,7 +1,8 @@
 ###> symfony/framework-bundle ###
-/.env.local
+/.env
 /.env.local.php
 /.env.*.local
+/.env
 /config/secrets/*/*.decrypt.private.php
 /public/bundles/
 /var/

Makefile

@@ -52,8 +52,15 @@ symfony\:secrets-set: ## Ajoute un secret Symfony (ex: make symfony:secrets-set
 symfony\:console: ## Lance une commande Symfony (ex: make symfony:console CMD="cache:clear")
 	docker compose exec app php bin/console $(CMD)
 
+php\:console: ## Lance bin/console avec arguments (ex: make php:console -- cache:clear --env=prod)
+	docker compose exec app php bin/console $(filter-out $@,$(MAKECMDGOALS))
+
+%:
+	@:
+
 symfony\:cache-clear: ## Vide le cache Symfony
 	docker compose exec app php bin/console cache:clear
+	docker compose restart messenger
 
 test: ## Lance les tests PHPUnit
 	docker compose exec app php bin/phpunit

README.md

@@ -0,0 +1,135 @@
+# 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
+
+1. Le joueur lance une partie. Le système choisit un acteur aléatoire (filtré par popularité TMDB).
+2. Pour chaque lettre du nom de l'acteur, un **acteur-indice** est attribué, dont le nom commence par cette lettre.
+3. 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.
+4. 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
+
+1. L'utilisateur exporte son historique depuis Letterboxd (CSV).
+2. Il upload le fichier via l'interface.
+3. Un message async découpe l'import en **batchs de 50 films**.
+4. Chaque batch recherche les films sur TMDB, synchronise les acteurs et importe leurs récompenses depuis Wikidata.
+5. 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
+
+```bash
+# 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 :
+
+```bash
+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
+
+```bash
+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
+
+```bash
+# 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)           |

assets/app.js

@@ -1,2 +1,3 @@
+import '@fortawesome/fontawesome-free/css/all.min.css';
 import './bootstrap.js';
 import './styles/app.css';

assets/bootstrap.js

@@ -1,12 +1,16 @@
 import { startStimulusApp } from 'vite-plugin-symfony/stimulus/helpers';
 import DropdownController from './controllers/dropdown_controller.js';
-import NotificationsController from './controllers/notifications_controller.js';
 import ImportModalController from './controllers/import_modal_controller.js';
+import ImportStatusController from './controllers/import_status_controller.js';
+import ImportHelpController from './controllers/import_help_controller.js';
+import GameConfigController from './controllers/game_config_controller.js';
 
 const app = startStimulusApp();
 app.register('dropdown', DropdownController);
-app.register('notifications', NotificationsController);
 app.register('import-modal', ImportModalController);
+app.register('import-status', ImportStatusController);
+app.register('import-help', ImportHelpController);
+app.register('game-config', GameConfigController);
 
 // Register React components for {{ react_component() }} Twig function.
 // We register them manually because @symfony/ux-react's registerReactControllerComponents

assets/controllers/game_config_controller.js

@@ -0,0 +1,33 @@
+import { Controller } from '@hotwired/stimulus';
+
+export default class extends Controller {
+    static targets = ['hintType', 'awardSection', 'allAwards', 'awardType'];
+
+    enforceMinOneChecked(event) {
+        const checked = this.hintTypeTargets.filter((e) => e.checked);
+        if (checked.length === 0) {
+            event.target.checked = true;
+        }
+        this.toggleAwardSection();
+    }
+
+    toggleAwardSection() {
+        const awardChecked = this.hintTypeTargets.find(
+            (el) => el.name === 'hint_award'
+        )?.checked;
+
+        this.awardSectionTarget.style.display = awardChecked ? '' : 'none';
+    }
+
+    toggleAllAwards() {
+        const checked = this.allAwardsTarget.checked;
+        this.awardTypeTargets.forEach((el) => {
+            el.checked = checked;
+        });
+    }
+
+    syncAllAwards() {
+        const allChecked = this.awardTypeTargets.every((el) => el.checked);
+        this.allAwardsTarget.checked = allChecked;
+    }
+}

assets/controllers/import_help_controller.js

@@ -0,0 +1,20 @@
+import { Controller } from '@hotwired/stimulus';
+
+export default class extends Controller {
+    static targets = ['overlay'];
+
+    open(event) {
+        event.stopPropagation();
+        this.overlayTarget.hidden = false;
+    }
+
+    close() {
+        this.overlayTarget.hidden = true;
+    }
+
+    closeOnBackdrop(event) {
+        if (event.target === this.overlayTarget) {
+            this.close();
+        }
+    }
+}

assets/controllers/import_modal_controller.js

@@ -43,6 +43,7 @@ export default class extends Controller {
             }
 
             this._showFeedback('Import lancé !', false);
+            document.dispatchEvent(new CustomEvent('import:started'));
             setTimeout(() => this.close(), 1500);
         } catch (e) {
             this._showFeedback('Une erreur est survenue.', true);

assets/controllers/import_status_controller.js

@@ -0,0 +1,95 @@
+import { Controller } from '@hotwired/stimulus';
+
+export default class extends Controller {
+    static targets = ['item', 'importBtn'];
+
+    connect() {
+        this._poll();
+        this._interval = setInterval(() => this._poll(), 5000);
+        this._onImportStarted = () => this._poll();
+        document.addEventListener('import:started', this._onImportStarted);
+    }
+
+    disconnect() {
+        clearInterval(this._interval);
+        document.removeEventListener('import:started', this._onImportStarted);
+    }
+
+    async _poll() {
+        try {
+            const response = await fetch('/api/imports/latest');
+            if (!response.ok) return;
+
+            const data = await response.json();
+            this._update(data);
+        } catch (e) {
+            // silently ignore
+        }
+    }
+
+    _update(data) {
+        if (!data) {
+            this._showDefault();
+            return;
+        }
+
+        const isActive = data.status === 'pending' || data.status === 'processing';
+
+        if (isActive) {
+            this._showActive(data);
+        } else if (data.status === 'completed') {
+            this._showCompleted(data);
+        } else if (data.status === 'failed') {
+            this._showFailed();
+        } else {
+            this._showDefault();
+        }
+    }
+
+    _showDefault() {
+        this.importBtnTarget.disabled = false;
+        this.importBtnTarget.textContent = 'Importer ses films';
+        this._removeStatus();
+    }
+
+    _showActive(data) {
+        this.importBtnTarget.disabled = true;
+        this.importBtnTarget.textContent = 'Import en cours\u2026';
+
+        const progress = data.totalFilms > 0
+            ? Math.round((data.processedFilms / data.totalFilms) * 100)
+            : 0;
+
+        this._setStatus(`${progress}% — ${data.processedFilms}/${data.totalFilms} films`, 'active');
+    }
+
+    _showCompleted(data) {
+        this.importBtnTarget.disabled = false;
+        this.importBtnTarget.textContent = 'Importer ses films';
+
+        const imported = data.totalFilms - data.failedFilms;
+        this._setStatus(`Dernier import : ${imported}/${data.totalFilms} films`, 'completed');
+    }
+
+    _showFailed() {
+        this.importBtnTarget.disabled = false;
+        this.importBtnTarget.textContent = 'Importer ses films';
+        this._setStatus('Dernier import : échoué', 'failed');
+    }
+
+    _setStatus(text, type) {
+        let statusEl = this.itemTarget.querySelector('.import-status-text');
+        if (!statusEl) {
+            statusEl = document.createElement('span');
+            statusEl.className = 'import-status-text';
+            this.itemTarget.appendChild(statusEl);
+        }
+        statusEl.textContent = text;
+        statusEl.className = `import-status-text import-status-${type}`;
+    }
+
+    _removeStatus() {
+        const statusEl = this.itemTarget.querySelector('.import-status-text');
+        if (statusEl) statusEl.remove();
+    }
+}

assets/controllers/notifications_controller.js

@@ -1,77 +0,0 @@
-import { Controller } from '@hotwired/stimulus';
-
-export default class extends Controller {
-    static targets = ['badge', 'list'];
-
-    connect() {
-        this._poll();
-        this._interval = setInterval(() => this._poll(), 30000);
-    }
-
-    disconnect() {
-        clearInterval(this._interval);
-    }
-
-    async _poll() {
-        try {
-            const response = await fetch('/api/notifications');
-            if (!response.ok) return;
-
-            const data = await response.json();
-            this._updateBadge(data.unreadCount);
-            this._updateTitle(data.unreadCount);
-            this._updateList(data.notifications);
-        } catch (e) {
-            // silently ignore polling errors
-        }
-    }
-
-    _updateBadge(count) {
-        if (count > 0) {
-            this.badgeTarget.textContent = count;
-            this.badgeTarget.hidden = false;
-        } else {
-            this.badgeTarget.hidden = true;
-        }
-    }
-
-    _updateTitle(count) {
-        const base = 'Actorle';
-        document.title = count > 0 ? `(${count}) ${base}` : base;
-    }
-
-    _updateList(notifications) {
-        if (notifications.length === 0) {
-            this.listTarget.innerHTML = '<p class="dropdown-empty">Aucune notification</p>';
-            return;
-        }
-
-        this.listTarget.innerHTML = notifications.map(n => `
-            <div class="notification-item ${n.read ? '' : 'notification-unread'}">
-                <p>${this._escapeHtml(n.message)}</p>
-                <time>${this._formatDate(n.createdAt)}</time>
-            </div>
-        `).join('');
-    }
-
-    async markRead() {
-        await fetch('/api/notifications/read', { method: 'POST' });
-        this._poll();
-    }
-
-    _escapeHtml(text) {
-        const div = document.createElement('div');
-        div.textContent = text;
-        return div.innerHTML;
-    }
-
-    _formatDate(isoString) {
-        const date = new Date(isoString);
-        return date.toLocaleDateString('fr-FR', {
-            day: 'numeric',
-            month: 'short',
-            hour: '2-digit',
-            minute: '2-digit',
-        });
-    }
-}

assets/react/controllers/ActorPopover.jsx

@@ -1,20 +1,40 @@
 import React, { useState } from 'react';
-import { useFloating, useClick, useDismiss, useInteractions, offset, flip, shift } from '@floating-ui/react';
+import { useFloating, useClick, useDismiss, useInteractions, offset, shift, size, FloatingPortal } from '@floating-ui/react';
 
-export default function ActorPopover({ actorName }) {
+const HINT_ICONS = {
+    film: 'fa-solid fa-film',
+    character: 'fa-solid fa-masks-theater',
+    award: 'fa-solid fa-trophy',
+};
+
+export default function ActorPopover({ hintType, hintText }) {
     const [isOpen, setIsOpen] = useState(false);
 
     const { refs, floatingStyles, context } = useFloating({
         open: isOpen,
         onOpenChange: setIsOpen,
-        middleware: [offset(8), flip(), shift()],
-        placement: 'top',
+        middleware: [
+            offset(8),
+            size({
+                apply({ availableWidth, elements }) {
+                    Object.assign(elements.floating.style, {
+                        maxWidth: `${availableWidth - 16}px`,
+                    });
+                },
+            }),
+            shift({ padding: 8 }),
+        ],
+        placement: 'left',
     });
 
     const click = useClick(context);
     const dismiss = useDismiss(context);
     const { getReferenceProps, getFloatingProps } = useInteractions([click, dismiss]);
 
+    if (!hintText) return null;
+
+    const iconClass = HINT_ICONS[hintType] || 'fa-solid fa-circle-question';
+
     return (
         <>
             <button
@@ -23,17 +43,19 @@ export default function ActorPopover({ actorName }) {
                 className="popover-trigger"
                 type="button"
             >
-                ?
+                <i className={iconClass}></i>
             </button>
             {isOpen && (
-                <div
-                    ref={refs.setFloating}
-                    style={floatingStyles}
-                    {...getFloatingProps()}
-                    className="actor-popover"
-                >
-                    <strong>{actorName}</strong>
-                </div>
+                <FloatingPortal>
+                    <div
+                        ref={refs.setFloating}
+                        style={floatingStyles}
+                        {...getFloatingProps()}
+                        className="actor-popover"
+                    >
+                        {hintText}
+                    </div>
+                </FloatingPortal>
             )}
         </>
     );

assets/react/controllers/GameGrid.jsx

@@ -1,20 +1,44 @@
 import React from 'react';
 import GameRow from './GameRow';
+import ActorPopover from './ActorPopover';
 
 export default function GameGrid({ grid, width, middle }) {
     return (
-        <table id="actors">
-            <tbody>
-                {grid.map((row, rowIndex) => (
-                    <GameRow
-                        key={rowIndex}
-                        actorName={row.actorName}
-                        pos={row.pos}
-                        colStart={middle - row.pos}
-                        totalWidth={width}
-                    />
-                ))}
-            </tbody>
-        </table>
+        <div className="game-grid-scroll">
+            <table id="actors">
+                <tbody>
+                    {grid.map((row, rowIndex) => {
+                        if (row.separator !== undefined) {
+                            return (
+                                <tr key={rowIndex} className="separator-row">
+                                    <td className="hint-cell" />
+                                    {Array.from({ length: middle }, (_, i) => (
+                                        <td key={i} />
+                                    ))}
+                                    <td className="letter-static separator-char">
+                                        {row.separator === ' ' ? '' : row.separator}
+                                    </td>
+                                    {Array.from({ length: width - middle }, (_, i) => (
+                                        <td key={middle + 1 + i} />
+                                    ))}
+                                </tr>
+                            );
+                        }
+
+                        return (
+                            <GameRow
+                                key={rowIndex}
+                                actorName={row.actorName}
+                                pos={row.pos}
+                                colStart={middle - row.pos}
+                                totalWidth={width}
+                                hintType={row.hintType}
+                                hintText={row.hintText}
+                            />
+                        );
+                    })}
+                </tbody>
+            </table>
+        </div>
     );
 }

assets/react/controllers/GameRow.jsx

@@ -1,22 +1,37 @@
-import React, { useRef, useCallback } from 'react';
+import React, { useRef, useCallback, useMemo } from 'react';
 import LetterInput from './LetterInput';
 import ActorPopover from './ActorPopover';
 
-export default function GameRow({ actorName, pos, colStart, totalWidth }) {
+function isLetter(ch) {
+    return /[a-zA-Z]/.test(ch);
+}
+
+export default function GameRow({ actorName, pos, colStart, totalWidth, hintType, hintText }) {
     const inputRefs = useRef([]);
+    const letters = actorName.split('');
+
+    const letterIndices = useMemo(
+        () => letters.reduce((acc, ch, i) => { if (isLetter(ch)) acc.push(i); return acc; }, []),
+        [actorName]
+    );
 
     const setInputRef = useCallback((index) => (el) => {
         inputRefs.current[index] = el;
     }, []);
 
-    const focusInput = useCallback((index) => {
-        inputRefs.current[index]?.focus();
-    }, []);
-
-    const letters = actorName.split('');
+    const focusNextInput = useCallback((charIndex, direction) => {
+        const currentPos = letterIndices.indexOf(charIndex);
+        const nextPos = currentPos + direction;
+        if (nextPos >= 0 && nextPos < letterIndices.length) {
+            inputRefs.current[letterIndices[nextPos]]?.focus();
+        }
+    }, [letterIndices]);
 
     return (
         <tr>
+            <td className="hint-cell">
+                <ActorPopover hintType={hintType} hintText={hintText} />
+            </td>
             {Array.from({ length: totalWidth + 1 }, (_, colIndex) => {
                 const charIndex = colIndex - colStart;
                 const isInRange = charIndex >= 0 && charIndex < letters.length;
@@ -25,19 +40,26 @@ export default function GameRow({ actorName, pos, colStart, totalWidth }) {
                     return <td key={colIndex} />;
                 }
 
+                const ch = letters[charIndex];
+
+                if (!isLetter(ch)) {
+                    return (
+                        <td key={colIndex} className="letter-static">
+                            {ch}
+                        </td>
+                    );
+                }
+
                 return (
                     <LetterInput
                         key={colIndex}
                         highlighted={charIndex === pos}
                         inputRef={setInputRef(charIndex)}
-                        onNext={() => focusInput(charIndex + 1)}
-                        onPrev={() => focusInput(charIndex - 1)}
+                        onNext={() => focusNextInput(charIndex, 1)}
+                        onPrev={() => focusNextInput(charIndex, -1)}
                     />
                 );
             })}
-            <td>
-                <ActorPopover actorName={actorName} />
-            </td>
         </tr>
     );
 }

config/packages/doctrine.yaml

@@ -33,6 +33,11 @@ doctrine:
             numeric_functions:
                 Random: App\Doctrine\Extension\Random
 
+when@test:
+    doctrine:
+        dbal:
+            dbname: app_test
+
 when@prod:
     doctrine:
         orm:

config/packages/security.yaml

@@ -25,6 +25,8 @@ security:
     access_control:
         - { path: ^/login, roles: PUBLIC_ACCESS }
         - { path: ^/register, roles: PUBLIC_ACCESS }
+        - { path: ^/$, roles: PUBLIC_ACCESS }
+        - { path: ^/game, roles: PUBLIC_ACCESS }
         - { path: ^/, roles: ROLE_USER }
 
 when@test:

designs/sunrise-charte.md

@@ -0,0 +1,194 @@
+# Charte graphique — Sunrise
+
+Thème lumineux, éditorial, chaleureux. Inspiré des tons ambrés du petit matin.
+Sobre sans être froid, accessible sans être infantile.
+
+---
+
+## Couleurs
+
+### Palette principale
+
+| Token         | Hex       | Usage                                      |
+|---------------|-----------|--------------------------------------------|
+| `--bg`        | `#fef6ee` | Fond de page — crème orangé très doux      |
+| `--surface`   | `#ffffff` | Cartes, navbar, modals                     |
+| `--surface-warm` | `#fff7ed` | Fond de champ input, surfaces secondaires |
+| `--surface-tint` | `#ffedd5` | Hover sur items de dropdown, fond actif  |
+
+### Orange
+
+| Token            | Hex       | Usage                                           |
+|------------------|-----------|-------------------------------------------------|
+| `--orange`       | `#ea580c` | Couleur principale — boutons, liens, logo       |
+| `--orange-mid`   | `#f97316` | Hover sur boutons primaires                     |
+| `--orange-light` | `#fed7aa` | Fond cellule surlignée (grille de jeu)          |
+| `--orange-pale`  | `#fff7ed` | Fond très pâle — identique à `--surface-warm`   |
+
+> La couleur d'accentuation unique est l'orange `#ea580c` (orange-600 Tailwind).
+> Ne pas introduire de seconde couleur d'accentuation.
+
+### Texte
+
+| Token           | Hex       | Usage                                     |
+|-----------------|-----------|-------------------------------------------|
+| `--text`        | `#1c1917` | Corps de texte, labels, titres            |
+| `--text-muted`  | `#78716c` | Texte secondaire, descriptions            |
+| `--text-faint`  | `#a8a29e` | Placeholders, métadonnées, separateurs    |
+
+### Bordures et ombres
+
+| Token            | Valeur                          | Usage                             |
+|------------------|---------------------------------|-----------------------------------|
+| `--border`       | `#e8d5c0`                       | Bordures standard — chaudes       |
+| `--border-warm`  | `#fdba74`                       | Bordure cellule active (grille)   |
+| `--shadow-warm`  | `rgba(180, 100, 30, 0.08)`      | Ombre douce sur cartes et navbar  |
+
+---
+
+## Typographie
+
+### Polices
+
+| Rôle          | Famille          | Google Fonts                        |
+|---------------|------------------|-------------------------------------|
+| Titres / Logo | **Fraunces**     | Sérif optique, poids 400 et 700     |
+| Corps         | **Inter**        | Sans-serif, poids 400, 500, 600, 700 |
+
+```html
+<link href="https://fonts.googleapis.com/css2?family=Fraunces:ital,opsz,wght@0,9..144,400;0,9..144,700;1,9..144,400&family=Inter:wght@400;500;600;700&display=swap" rel="stylesheet">
+```
+
+### Hiérarchie
+
+| Niveau     | Police     | Taille | Poids | Utilisation                          |
+|------------|------------|--------|-------|--------------------------------------|
+| H1 page    | Fraunces   | 26px   | 700   | Titre de page (login, register)      |
+| H2 modal   | Inter      | 18px   | 700   | Titres de modals                     |
+| Logo       | Fraunces   | 22px   | 700   | Navbar brand                         |
+| Corps      | Inter      | 15px   | 400   | Texte courant, inputs                |
+| Label      | Inter      | 13px   | 600   | Labels de formulaire                 |
+| Secondaire | Inter      | 14px   | 400   | Items dropdown, descriptions         |
+| Micro      | Inter      | 11–12px| 600   | Badges, headers dropdown, métadonnées|
+
+### Règles typographiques
+
+- Titres Fraunces : `letter-spacing: -0.3px` pour un rendu serré et élégant
+- Pas de `text-transform: uppercase` sauf pour des labels discrets (taille ≤ 12px, spacing ≥ 0.5px)
+- Interlignage corps : `1.5` minimum
+- Taille minimale affichée : `11px`
+
+---
+
+## Rayons (Border radius)
+
+| Token         | Valeur | Usage                                        |
+|---------------|--------|----------------------------------------------|
+| `--radius-sm` | `6px`  | Inputs, cellules grille, petits éléments     |
+| `--radius-md` | `10px` | Dropdowns, popovers, tooltips                |
+| `--radius-lg` | `18px` | Cartes auth, modals                          |
+| Pilule        | `100px`| Bouton primaire, bouton submit               |
+
+> Le bouton primaire utilise systématiquement `border-radius: 100px` (forme pilule).
+> Les champs de saisie utilisent `--radius-sm` (6px), jamais la pilule.
+
+---
+
+## Composants
+
+### Bouton primaire
+
+```css
+background: #ea580c;
+color: #ffffff;
+border-radius: 100px;
+padding: 9px 20px;
+font-size: 14px;
+font-weight: 600;
+```
+
+**Hover :** `background: #f97316` + `transform: translateY(-1px)` + `box-shadow: 0 4px 16px rgba(234,88,12,0.25)`
+
+### Navbar
+
+- Hauteur : `64px`
+- Fond : `#ffffff`
+- Bordure basse : `1px solid #e8d5c0`
+- Ombre : `0 2px 12px rgba(180,100,30,0.08)`
+- Padding horizontal : `40px`
+- Logo (Fraunces, 22px, `#ea580c`) à gauche
+- Actions à droite — icônes rondes (`border-radius: 50%`), hover sur fond `--surface-tint`
+
+### Champ de formulaire
+
+```css
+background: #fff7ed;
+border: 1.5px solid #e8d5c0;
+border-radius: 6px;
+padding: 11px 14px;
+font-size: 15px;
+```
+
+**Focus :** `border-color: #ea580c` + `box-shadow: 0 0 0 3px rgba(234,88,12,0.12)`
+
+### Cellule de grille (lettre)
+
+- Taille : `38 × 38px`
+- Fond normal : `#ffffff`, bordure `#e8d5c0`
+- Fond rempli : `#fff7ed`, bordure `#fdba74`
+- **Surlignée** (lettre cible) : fond `#fed7aa`, bordure `#ea580c`, texte `#ea580c`
+- Focus : bordure `#ea580c` + ring `rgba(234,88,12,0.15)`
+- Espacement entre cellules (`border-spacing`) : `5px`
+
+### Dropdown
+
+- Fond : `#ffffff`
+- Bordure : `1px solid #e8d5c0`
+- Rayon : `10px`
+- Ombre : `0 8px 32px rgba(180,100,30,0.08), 0 2px 8px rgba(0,0,0,0.06)`
+- Item hover : fond `#ffedd5`, couleur `#ea580c`
+- Header : `11px`, uppercase, `#a8a29e`, séparateur bas
+
+### Badge notification
+
+```css
+background: #ea580c;
+color: #ffffff;
+border-radius: 8px;
+font-size: 10px;
+font-weight: 700;
+min-width: 16px;
+height: 16px;
+```
+
+### Modal
+
+- Fond : `#ffffff`
+- Rayon : `12px` (légèrement plus petit que `--radius-lg` pour la hiérarchie visuelle)
+- Ombre : `0 8px 24px rgba(0,0,0,0.12)`
+- Overlay : `rgba(0,0,0,0.4)`
+
+---
+
+## Ombres
+
+Toutes les ombres sont **chaudes** (teinte orange-brun), jamais neutres grises.
+
+| Niveau       | Valeur CSS                                                       |
+|--------------|------------------------------------------------------------------|
+| Légère       | `0 1px 3px rgba(180,100,30,0.08)`                                |
+| Navbar       | `0 2px 12px rgba(180,100,30,0.08)`                               |
+| Carte        | `0 4px 32px rgba(180,100,30,0.08)`                               |
+| Dropdown     | `0 8px 32px rgba(180,100,30,0.08), 0 2px 8px rgba(0,0,0,0.06)`  |
+| Bouton hover | `0 4px 16px rgba(234,88,12,0.25)`                                |
+
+---
+
+## Règles d'usage
+
+1. **Orange réservé à l'accentuation.** Ne pas l'utiliser pour du texte courant de longue lecture.
+2. **Fond de page ≠ blanc.** Toujours `#fef6ee` pour le fond, `#ffffff` pour les surfaces élevées (cartes, navbar).
+3. **Ombres chaudes uniquement.** Aucune ombre `rgba(0,0,0,X)` seule sur des surfaces visibles — toujours teintée.
+4. **Bouton primaire = pilule.** Boutons destructifs ou secondaires peuvent utiliser `--radius-sm`.
+5. **Fraunces uniquement pour les titres de page et le logo.** Pas dans le corps, pas dans les labels.
+6. **Pas de couleur rouge** pour les erreurs — utiliser `#b45309` (ambre foncé) ou `#dc2626` uniquement pour les messages d'erreur critiques, jamais comme couleur d'interface.

designs/sunrise.html

@@ -0,0 +1,515 @@
+<!DOCTYPE html>
+<html lang="fr">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Actorle — Design "Sunrise" (lumineux, éditorial)</title>
+<link rel="preconnect" href="https://fonts.googleapis.com">
+<link href="https://fonts.googleapis.com/css2?family=Fraunces:ital,opsz,wght@0,9..144,400;0,9..144,700;1,9..144,400&family=Inter:wght@400;500;600;700&display=swap" rel="stylesheet">
+<style>
+/* ============================================================
+   SUNRISE — Lumineux, éditorial, chaleureux
+   Typographie sérif pour le titre, sans-serif pour le corps
+   ============================================================ */
+
+*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+
+:root {
+  --bg:           #fef6ee;
+  --surface:      #ffffff;
+  --surface-warm: #fff7ed;
+  --surface-tint: #ffedd5;
+  --orange:       #ea580c;
+  --orange-mid:   #f97316;
+  --orange-light: #fed7aa;
+  --orange-pale:  #fff7ed;
+  --text:         #1c1917;
+  --text-muted:   #78716c;
+  --text-faint:   #a8a29e;
+  --border:       #e8d5c0;
+  --border-warm:  #fdba74;
+  --shadow-warm:  rgba(180, 100, 30, 0.08);
+  --radius-sm:    6px;
+  --radius-md:    10px;
+  --radius-lg:    18px;
+}
+
+body {
+  background-color: var(--bg);
+  font-family: 'Inter', sans-serif;
+  color: var(--text);
+  min-height: 100vh;
+}
+
+/* ── Navbar ── */
+.navbar {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  padding: 0 40px;
+  height: 64px;
+  background: var(--surface);
+  border-bottom: 1px solid var(--border);
+  box-shadow: 0 1px 0 var(--border), 0 2px 12px var(--shadow-warm);
+}
+
+.navbar-brand {
+  font-family: 'Fraunces', serif;
+  font-weight: 700;
+  font-size: 22px;
+  letter-spacing: -0.3px;
+  color: var(--orange);
+  text-decoration: none;
+}
+
+.navbar-right {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+}
+
+.navbar-icon {
+  background: none;
+  border: none;
+  cursor: pointer;
+  padding: 8px;
+  border-radius: 50%;
+  color: var(--text-muted);
+  display: flex;
+  align-items: center;
+  transition: background 0.15s, color 0.15s;
+}
+.navbar-icon:hover {
+  background: var(--surface-tint);
+  color: var(--orange);
+}
+
+.btn {
+  padding: 9px 20px;
+  border: none;
+  border-radius: 100px;
+  font-size: 14px;
+  font-weight: 600;
+  cursor: pointer;
+  transition: all 0.2s;
+  text-decoration: none;
+  display: inline-flex;
+  align-items: center;
+  font-family: inherit;
+}
+
+.btn-primary {
+  background: var(--orange);
+  color: #fff;
+}
+.btn-primary:hover {
+  background: var(--orange-mid);
+  transform: translateY(-1px);
+  box-shadow: 0 4px 16px rgba(234,88,12,0.25);
+}
+
+/* ── Game grid ── */
+.game-wrapper {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  padding: 56px 24px;
+}
+
+.game-header {
+  font-family: 'Fraunces', serif;
+  font-size: 15px;
+  color: var(--text-muted);
+  margin-bottom: 32px;
+  letter-spacing: 0.3px;
+}
+.game-header em {
+  font-style: italic;
+  color: var(--orange);
+}
+
+table#actors {
+  border-collapse: separate;
+  border-spacing: 5px;
+}
+
+#actors td {
+  width: 38px;
+  height: 38px;
+  text-align: center;
+  vertical-align: middle;
+}
+
+.letter-input {
+  width: 38px;
+  height: 38px;
+  text-align: center;
+  font-size: 15px;
+  font-weight: 700;
+  border: 2px solid var(--border);
+  border-radius: var(--radius-sm);
+  text-transform: uppercase;
+  padding: 0;
+  background: var(--surface);
+  color: var(--text);
+  transition: border-color 0.15s, box-shadow 0.15s, background 0.15s;
+  font-family: inherit;
+  box-shadow: 0 1px 3px var(--shadow-warm);
+}
+
+.letter-input:focus {
+  outline: none;
+  border-color: var(--orange);
+  box-shadow: 0 0 0 3px rgba(234,88,12,0.15);
+}
+
+.letter-input.filled {
+  background: var(--surface-warm);
+  border-color: var(--border-warm);
+  color: var(--text);
+}
+
+.letter-highlighted {
+  background: var(--orange-light) !important;
+  border-color: var(--orange) !important;
+  color: var(--orange) !important;
+}
+
+/* ── Popover ── */
+.popover-trigger {
+  width: 28px;
+  height: 28px;
+  border-radius: 50%;
+  border: 1.5px solid var(--border);
+  background: var(--surface);
+  cursor: pointer;
+  font-size: 12px;
+  font-weight: 600;
+  color: var(--text-muted);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  transition: all 0.15s;
+  box-shadow: 0 1px 3px var(--shadow-warm);
+}
+.popover-trigger:hover {
+  border-color: var(--orange);
+  color: var(--orange);
+  background: var(--surface-tint);
+}
+
+.actor-popover {
+  background: var(--surface);
+  border: 1px solid var(--border);
+  border-radius: var(--radius-md);
+  padding: 10px 16px;
+  box-shadow: 0 4px 20px var(--shadow-warm);
+  z-index: 100;
+  font-size: 13px;
+  color: var(--text);
+}
+
+/* ── Auth ── */
+.page-auth {
+  display: flex;
+  justify-content: center;
+  padding: 56px 24px;
+}
+
+.auth-container {
+  width: 100%;
+  max-width: 420px;
+  background: var(--surface);
+  border: 1px solid var(--border);
+  border-radius: var(--radius-lg);
+  padding: 40px;
+  box-shadow: 0 4px 32px var(--shadow-warm);
+}
+
+.auth-container h1 {
+  font-family: 'Fraunces', serif;
+  font-size: 26px;
+  font-weight: 700;
+  text-align: center;
+  margin-bottom: 8px;
+  color: var(--text);
+}
+
+.auth-subtitle {
+  text-align: center;
+  color: var(--text-muted);
+  font-size: 14px;
+  margin-bottom: 28px;
+}
+
+.auth-container label {
+  display: block;
+  margin-bottom: 6px;
+  font-size: 13px;
+  font-weight: 600;
+  color: var(--text);
+}
+
+.auth-container input[type="email"],
+.auth-container input[type="password"] {
+  width: 100%;
+  padding: 11px 14px;
+  margin-bottom: 16px;
+  border: 1.5px solid var(--border);
+  border-radius: var(--radius-sm);
+  font-size: 15px;
+  background: var(--surface-warm);
+  color: var(--text);
+  transition: border-color 0.15s, box-shadow 0.15s;
+  font-family: inherit;
+}
+.auth-container input:focus {
+  outline: none;
+  border-color: var(--orange);
+  box-shadow: 0 0 0 3px rgba(234,88,12,0.12);
+}
+
+.auth-container button[type="submit"] {
+  width: 100%;
+  padding: 12px;
+  background: var(--orange);
+  color: white;
+  border: none;
+  border-radius: 100px;
+  font-size: 15px;
+  font-weight: 700;
+  cursor: pointer;
+  transition: all 0.2s;
+  font-family: inherit;
+  letter-spacing: 0.2px;
+}
+.auth-container button[type="submit"]:hover {
+  background: var(--orange-mid);
+  transform: translateY(-1px);
+  box-shadow: 0 6px 20px rgba(234,88,12,0.3);
+}
+
+.auth-divider {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  margin: 20px 0;
+  color: var(--text-faint);
+  font-size: 12px;
+}
+.auth-divider::before, .auth-divider::after {
+  content: '';
+  flex: 1;
+  height: 1px;
+  background: var(--border);
+}
+
+.auth-link {
+  text-align: center;
+  margin-top: 20px;
+  font-size: 13px;
+  color: var(--text-muted);
+}
+.auth-link a { color: var(--orange); text-decoration: none; font-weight: 600; }
+.auth-link a:hover { text-decoration: underline; }
+
+/* ── Dropdown ── */
+.navbar-item { position: relative; }
+
+.dropdown-menu {
+  position: absolute;
+  top: calc(100% + 8px);
+  right: 0;
+  background: var(--surface);
+  border: 1px solid var(--border);
+  border-radius: var(--radius-md);
+  box-shadow: 0 8px 32px var(--shadow-warm), 0 2px 8px rgba(0,0,0,0.06);
+  min-width: 210px;
+  z-index: 200;
+  padding: 6px;
+  overflow: hidden;
+}
+
+.dropdown-header {
+  padding: 8px 12px;
+  font-weight: 600;
+  font-size: 11px;
+  color: var(--text-faint);
+  text-transform: uppercase;
+  letter-spacing: 0.8px;
+  border-bottom: 1px solid var(--border);
+  margin-bottom: 4px;
+}
+
+.dropdown-item {
+  display: block;
+  width: 100%;
+  padding: 9px 12px;
+  text-align: left;
+  background: none;
+  border: none;
+  cursor: pointer;
+  font-size: 14px;
+  color: var(--text);
+  text-decoration: none;
+  border-radius: var(--radius-sm);
+  transition: background 0.12s;
+  font-family: inherit;
+}
+.dropdown-item:hover { background: var(--surface-tint); color: var(--orange); }
+
+/* ── Badge ── */
+.badge {
+  position: absolute;
+  top: 2px; right: 2px;
+  background: var(--orange);
+  color: white;
+  font-size: 10px;
+  font-weight: 700;
+  min-width: 16px;
+  height: 16px;
+  border-radius: 8px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 0 4px;
+}
+
+/* ── Demo helpers ── */
+.demo-section { margin: 40px auto; max-width: 900px; padding: 0 24px; }
+.demo-label {
+  font-size: 11px;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 1px;
+  color: var(--text-faint);
+  margin-bottom: 12px;
+  padding-bottom: 8px;
+  border-bottom: 1px solid var(--border);
+}
+</style>
+</head>
+<body>
+
+<!-- NAVBAR — Connecté -->
+<nav class="navbar">
+  <a href="#" class="navbar-brand">Actorle</a>
+  <div class="navbar-right">
+    <div class="navbar-item">
+      <button class="navbar-icon">
+        <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+          <path d="M18 8A6 6 0 0 0 6 8c0 7-3 9-3 9h18s-3-2-3-9"/>
+          <path d="M13.73 21a2 2 0 0 1-3.46 0"/>
+        </svg>
+        <span class="badge">3</span>
+      </button>
+    </div>
+    <div class="navbar-item">
+      <button class="navbar-icon">
+        <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+          <path d="M20 21v-2a4 4 0 0 0-4-4H8a4 4 0 0 0-4 4v2"/>
+          <circle cx="12" cy="7" r="4"/>
+        </svg>
+      </button>
+    </div>
+  </div>
+</nav>
+
+<!-- NAVBAR — Non connecté -->
+<div class="demo-section" style="margin-top:24px;">
+  <div class="demo-label">Navbar — non connecté</div>
+  <nav class="navbar" style="position:relative;">
+    <a href="#" class="navbar-brand">Actorle</a>
+    <div class="navbar-right">
+      <a href="#" class="btn btn-primary">Se connecter</a>
+    </div>
+  </nav>
+</div>
+
+<!-- DROPDOWN (toujours visible en preview) -->
+<div class="demo-section">
+  <div class="demo-label">Menu utilisateur</div>
+  <div class="dropdown-menu" style="position:relative; display:block; top:auto;">
+    <div class="dropdown-header">Compte</div>
+    <button class="dropdown-item">Importer ses films</button>
+    <a href="#" class="dropdown-item">Se déconnecter</a>
+  </div>
+</div>
+
+<!-- GAME GRID -->
+<div class="demo-section">
+  <div class="demo-label">Grille de jeu</div>
+  <div class="game-wrapper" style="padding:24px 0;">
+    <p class="game-header">Trouvez l'acteur — <em>4 indices</em></p>
+    <table id="actors">
+      <tbody>
+        <tr>
+          <td><input class="letter-input letter-highlighted" maxlength="1" value="M" readonly></td>
+          <td><input class="letter-input filled" maxlength="1" value="A" readonly></td>
+          <td><input class="letter-input filled" maxlength="1" value="R" readonly></td>
+          <td><input class="letter-input filled" maxlength="1" value="G" readonly></td>
+          <td><input class="letter-input filled" maxlength="1" value="O" readonly></td>
+          <td><input class="letter-input filled" maxlength="1" value="T" readonly></td>
+          <td><input class="letter-input" maxlength="1" readonly></td>
+          <td><input class="letter-input" maxlength="1" readonly></td>
+          <td><button class="popover-trigger">?</button></td>
+        </tr>
+        <tr>
+          <td><input class="letter-input" maxlength="1" readonly></td>
+          <td><input class="letter-input filled" maxlength="1" value="B" readonly></td>
+          <td><input class="letter-input filled" maxlength="1" value="R" readonly></td>
+          <td><input class="letter-input letter-highlighted" maxlength="1" value="A" readonly></td>
+          <td><input class="letter-input filled" maxlength="1" value="D" readonly></td>
+          <td><input class="letter-input" maxlength="1" readonly></td>
+          <td><input class="letter-input" maxlength="1" readonly></td>
+          <td><input class="letter-input" maxlength="1" readonly></td>
+          <td><button class="popover-trigger">?</button></td>
+        </tr>
+        <tr>
+          <td><input class="letter-input" maxlength="1" readonly></td>
+          <td><input class="letter-input" maxlength="1" readonly></td>
+          <td><input class="letter-input" maxlength="1" readonly></td>
+          <td><input class="letter-input letter-highlighted" maxlength="1" readonly></td>
+          <td><input class="letter-input" maxlength="1" readonly></td>
+          <td><input class="letter-input" maxlength="1" readonly></td>
+          <td><input class="letter-input" maxlength="1" readonly></td>
+          <td><input class="letter-input" maxlength="1" readonly></td>
+          <td><button class="popover-trigger">?</button></td>
+        </tr>
+        <tr>
+          <td><input class="letter-input" maxlength="1" readonly></td>
+          <td><input class="letter-input" maxlength="1" readonly></td>
+          <td><input class="letter-input" maxlength="1" readonly></td>
+          <td><input class="letter-input letter-highlighted" maxlength="1" readonly></td>
+          <td><input class="letter-input" maxlength="1" readonly></td>
+          <td><input class="letter-input" maxlength="1" readonly></td>
+          <td><input class="letter-input" maxlength="1" readonly></td>
+          <td><input class="letter-input" maxlength="1" readonly></td>
+          <td><button class="popover-trigger">?</button></td>
+        </tr>
+      </tbody>
+    </table>
+  </div>
+</div>
+
+<!-- AUTH FORM -->
+<div class="demo-section">
+  <div class="demo-label">Formulaire de connexion</div>
+  <div class="auth-container">
+    <h1>Bon retour</h1>
+    <p class="auth-subtitle">Connectez-vous pour suivre vos scores</p>
+    <label>Email</label>
+    <input type="email" placeholder="vous@exemple.fr">
+    <label>Mot de passe</label>
+    <input type="password" placeholder="••••••••">
+    <button type="submit">Connexion</button>
+    <div class="auth-link" style="margin-top:16px;">
+      Pas encore de compte ? <a href="#">S'inscrire</a>
+    </div>
+  </div>
+</div>
+
+<div style="height:60px;"></div>
+
+</body>
+</html>

docker-compose.override.yaml

@@ -8,9 +8,13 @@ services:
       APP_ENV: dev
     volumes:
       - .:/app
-      - vendor:/app/vendor
     ports:
-      - "80:80"
+        - "${PORT_80:-80}:80"
+
+  messenger:
+    command: ["php", "-d", "memory_limit=512M", "bin/console", "messenger:consume", "async", "--time-limit=3600", "--memory-limit=256M", "-vv", "--no-debug"]
+    volumes:
+      - .:/app
 
   database:
     ports:
@@ -24,13 +28,11 @@ services:
     image: git.lclr.dev/thibaud-lclr/ltbxd-actorle/node:latest
     volumes:
       - .:/app
-      - vendor:/app/vendor
       - node_modules:/app/node_modules
     ports:
-      - "5173:5173"
+        - "${PORT_5173:-5173}:5173"
     depends_on:
       - app
 
 volumes:
-  vendor:
   node_modules:

docker-compose.yaml

@@ -8,9 +8,9 @@ services:
         node-build: docker/node
     image: git.lclr.dev/thibaud-lclr/ltbxd-actorle/app:latest
     ports:
-      - "80:80"
-      - "443:443"
-      - "443:443/udp"
+      - "${PORT_80:-80}:80"
+      - "${PORT_443:-443}:443"
+      - "${PORT_443:-443}:443/udp"
     volumes:
       - caddy_data:/data
       - caddy_config:/config

docs/superpowers/plans/2026-03-30-game-hints.md

@@ -0,0 +1,571 @@
+# Game Hints System Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Each game row displays a typed hint (film, character, award) about the main actor, replacing the "?" popover button with a type-specific icon.
+
+**Architecture:** Two new columns (`hint_type`, `hint_data`) on `GameRow`. Hints are generated at game creation time in `GameGridGenerator`. A new `WikidataAwardGateway` service fetches awards via SPARQL. The React `ActorPopover` component shows a type icon instead of "?" and displays the resolved hint text in the popover.
+
+**Tech Stack:** Symfony 8 / Doctrine ORM (backend), React 19 (frontend), Wikidata SPARQL API (awards), Font Awesome (icons)
+
+---
+
+### Task 1: Add `hintType` and `hintData` columns to `GameRow` entity
+
+**Files:**
+- Modify: `src/Entity/GameRow.php`
+
+- [ ] **Step 1: Add properties and mapping to `GameRow`**
+
+Add after the `$rowOrder` property (line 30):
+
+```php
+#[ORM\Column(length: 20)]
+private ?string $hintType = null;
+
+#[ORM\Column(length: 255)]
+private ?string $hintData = null;
+```
+
+Add getters and setters after `setRowOrder()`:
+
+```php
+public function getHintType(): ?string
+{
+    return $this->hintType;
+}
+
+public function setHintType(string $hintType): static
+{
+    $this->hintType = $hintType;
+
+    return $this;
+}
+
+public function getHintData(): ?string
+{
+    return $this->hintData;
+}
+
+public function setHintData(string $hintData): static
+{
+    $this->hintData = $hintData;
+
+    return $this;
+}
+```
+
+- [ ] **Step 2: Generate and run migration**
+
+```bash
+php bin/console doctrine:migrations:diff
+php bin/console doctrine:migrations:migrate --no-interaction
+```
+
+Expected: new migration adding `hint_type` and `hint_data` columns to `game_row`.
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add src/Entity/GameRow.php migrations/
+git commit -m "feat: add hintType and hintData columns to GameRow entity"
+```
+
+---
+
+### Task 2: Add `MovieRoleRepository::findOneRandomByActor()` method
+
+**Files:**
+- Modify: `src/Repository/MovieRoleRepository.php`
+
+- [ ] **Step 1: Write the repository method**
+
+Replace the commented-out methods with:
+
+```php
+/**
+ * @param list<int> $excludeMovieRoleIds MovieRole IDs to exclude
+ * @return MovieRole|null
+ */
+public function findOneRandomByActor(int $actorId, array $excludeMovieRoleIds = []): ?MovieRole
+{
+    $qb = $this->createQueryBuilder('mr')
+        ->andWhere('mr.actor = :actorId')
+        ->setParameter('actorId', $actorId);
+
+    if (!empty($excludeMovieRoleIds)) {
+        $qb->andWhere('mr.id NOT IN (:excludeIds)')
+            ->setParameter('excludeIds', $excludeMovieRoleIds);
+    }
+
+    return $qb
+        ->orderBy('RANDOM()')
+        ->setMaxResults(1)
+        ->getQuery()
+        ->getOneOrNullResult();
+}
+```
+
+- [ ] **Step 2: Commit**
+
+```bash
+git add src/Repository/MovieRoleRepository.php
+git commit -m "feat: add findOneRandomByActor to MovieRoleRepository"
+```
+
+---
+
+### Task 3: Create `WikidataAwardGateway` service
+
+**Files:**
+- Create: `src/Service/WikidataAwardGateway.php`
+
+- [ ] **Step 1: Create the gateway service**
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace App\Service;
+
+use App\Entity\Actor;
+use Symfony\Contracts\HttpClient\HttpClientInterface;
+
+class WikidataAwardGateway
+{
+    private const SPARQL_ENDPOINT = 'https://query.wikidata.org/sparql';
+
+    public function __construct(
+        private readonly HttpClientInterface $httpClient,
+    ) {}
+
+    /**
+     * Fetch awards for an actor from Wikidata.
+     *
+     * @return list<array{name: string, year: int}>
+     */
+    public function getAwards(Actor $actor): array
+    {
+        $sparql = $this->buildQuery($actor->getName());
+
+        $response = $this->httpClient->request('GET', self::SPARQL_ENDPOINT, [
+            'query' => [
+                'query' => $sparql,
+                'format' => 'json',
+            ],
+            'headers' => [
+                'Accept' => 'application/sparql-results+json',
+                'User-Agent' => 'LtbxdActorle/1.0',
+            ],
+        ]);
+
+        $data = $response->toArray();
+        $awards = [];
+
+        foreach ($data['results']['bindings'] ?? [] as $binding) {
+            $name = $binding['awardLabel']['value'] ?? null;
+            $year = $binding['year']['value'] ?? null;
+
+            if ($name && $year) {
+                $awards[] = [
+                    'name' => $name,
+                    'year' => (int) substr($year, 0, 4),
+                ];
+            }
+        }
+
+        return $awards;
+    }
+
+    private function buildQuery(string $actorName): string
+    {
+        $escaped = str_replace('"', '\\"', $actorName);
+
+        return <<<SPARQL
+        SELECT ?awardLabel ?year WHERE {
+          ?person rdfs:label "{$escaped}"@en .
+          ?person wdt:P31 wd:Q5 .
+          ?person p:P166 ?awardStatement .
+          ?awardStatement ps:P166 ?award .
+          ?awardStatement pq:P585 ?date .
+          BIND(YEAR(?date) AS ?year)
+          SERVICE wikibase:label { bd:serviceParam wikibase:language "fr,en" . }
+        }
+        ORDER BY DESC(?year)
+        SPARQL;
+    }
+}
+```
+
+- [ ] **Step 2: Verify the service is autowired**
+
+```bash
+php bin/console debug:container WikidataAwardGateway
+```
+
+Expected: service `App\Service\WikidataAwardGateway` is listed.
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add src/Service/WikidataAwardGateway.php
+git commit -m "feat: add WikidataAwardGateway for actor awards from Wikidata SPARQL"
+```
+
+---
+
+### Task 4: Integrate hint generation into `GameGridGenerator`
+
+**Files:**
+- Modify: `src/Service/GameGridGenerator.php`
+
+- [ ] **Step 1: Add dependencies to constructor**
+
+Update the constructor at line 16-19:
+
+```php
+public function __construct(
+    private readonly ActorRepository $actorRepository,
+    private readonly MovieRoleRepository $movieRoleRepository,
+    private readonly WikidataAwardGateway $wikidataAwardGateway,
+    private readonly EntityManagerInterface $em,
+) {}
+```
+
+Add the import at the top:
+
+```php
+use App\Repository\MovieRoleRepository;
+```
+
+- [ ] **Step 2: Add hint generation methods**
+
+Add these private methods after `computeGridData()`:
+
+```php
+/**
+ * @param list<int> $usedMovieRoleIds MovieRole IDs already used (for DB exclusion)
+ * @param list<string> $usedHintKeys Semantic keys like "film:42" to avoid duplicate hints
+ * @return array{type: string, data: string}|null
+ */
+private function generateHint(Actor $mainActor, array &$usedMovieRoleIds, array &$usedHintKeys): ?array
+{
+    $types = ['film', 'character', 'award'];
+    shuffle($types);
+
+    foreach ($types as $type) {
+        $hint = $this->resolveHint($type, $mainActor, $usedMovieRoleIds, $usedHintKeys);
+        if ($hint !== null) {
+            return $hint;
+        }
+    }
+
+    return null;
+}
+
+/**
+ * @param list<int> $usedMovieRoleIds
+ * @param list<string> $usedHintKeys
+ * @return array{type: string, data: string}|null
+ */
+private function resolveHint(string $type, Actor $mainActor, array &$usedMovieRoleIds, array &$usedHintKeys): ?array
+{
+    switch ($type) {
+        case 'film':
+            $role = $this->movieRoleRepository->findOneRandomByActor(
+                $mainActor->getId(),
+                $usedMovieRoleIds,
+            );
+            if ($role === null) {
+                return null;
+            }
+            $movieId = (string) $role->getMovie()->getId();
+            $key = 'film:' . $movieId;
+            if (in_array($key, $usedHintKeys)) {
+                return null;
+            }
+            $usedMovieRoleIds[] = $role->getId();
+            $usedHintKeys[] = $key;
+            return ['type' => 'film', 'data' => $movieId];
+
+        case 'character':
+            $role = $this->movieRoleRepository->findOneRandomByActor(
+                $mainActor->getId(),
+                $usedMovieRoleIds,
+            );
+            if ($role === null) {
+                return null;
+            }
+            $roleId = (string) $role->getId();
+            $key = 'character:' . $roleId;
+            if (in_array($key, $usedHintKeys)) {
+                return null;
+            }
+            $usedMovieRoleIds[] = $role->getId();
+            $usedHintKeys[] = $key;
+            return ['type' => 'character', 'data' => $roleId];
+
+        case 'award':
+            try {
+                $awards = $this->wikidataAwardGateway->getAwards($mainActor);
+            } catch (\Throwable) {
+                return null;
+            }
+            foreach ($awards as $award) {
+                $text = $award['name'] . ' (' . $award['year'] . ')';
+                $key = 'award:' . $text;
+                if (!in_array($key, $usedHintKeys)) {
+                    $usedHintKeys[] = $key;
+                    return ['type' => 'award', 'data' => $text];
+                }
+            }
+            return null;
+    }
+
+    return null;
+}
+```
+
+- [ ] **Step 3: Wire hint generation into `generate()`**
+
+Add `$usedMovieRoleIds = [];` and `$usedHintKeys = [];` after `$rowOrder = 0;` (line 31), and add hint assignment after `$row->setRowOrder($rowOrder);` (line 51):
+
+```php
+$hint = $this->generateHint($mainActor, $usedMovieRoleIds, $usedHintKeys);
+if ($hint !== null) {
+    $row->setHintType($hint['type']);
+    $row->setHintData($hint['data']);
+}
+```
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add src/Service/GameGridGenerator.php
+git commit -m "feat: generate hints per row in GameGridGenerator"
+```
+
+---
+
+### Task 5: Resolve hint display text in `computeGridData()`
+
+**Files:**
+- Modify: `src/Service/GameGridGenerator.php`
+
+- [ ] **Step 1: Add repositories needed for resolution**
+
+Add import:
+
+```php
+use App\Repository\MovieRepository;
+```
+
+Update constructor:
+
+```php
+public function __construct(
+    private readonly ActorRepository $actorRepository,
+    private readonly MovieRoleRepository $movieRoleRepository,
+    private readonly MovieRepository $movieRepository,
+    private readonly WikidataAwardGateway $wikidataAwardGateway,
+    private readonly EntityManagerInterface $em,
+) {}
+```
+
+- [ ] **Step 2: Add hint data to grid output in `computeGridData()`**
+
+In the `computeGridData()` method, update the `$grid[]` assignment (around line 105-109) to include hint data:
+
+```php
+$hintText = $this->resolveHintText($row);
+
+$grid[] = [
+    'actorName' => $actor->getName(),
+    'actorId' => $actor->getId(),
+    'pos' => $pos,
+    'hintType' => $row->getHintType(),
+    'hintText' => $hintText,
+];
+```
+
+- [ ] **Step 3: Add `resolveHintText()` method**
+
+```php
+private function resolveHintText(GameRow $row): ?string
+{
+    $type = $row->getHintType();
+    $data = $row->getHintData();
+
+    if ($type === null || $data === null) {
+        return null;
+    }
+
+    return match ($type) {
+        'film' => $this->movieRepository->find((int) $data)?->getTitle(),
+        'character' => $this->movieRoleRepository->find((int) $data)?->getCharacter(),
+        'award' => $data,
+        default => null,
+    };
+}
+```
+
+- [ ] **Step 4: Update the return type docblock**
+
+Update the `@return` annotation of `computeGridData()`:
+
+```php
+/**
+ * Compute display data (grid, width, middle) from a Game entity for the React component.
+ *
+ * @return array{grid: list<array{actorName: string, actorId: int, pos: int, hintType: ?string, hintText: ?string}>, width: int, middle: int}
+ */
+```
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add src/Service/GameGridGenerator.php src/Repository/MovieRepository.php
+git commit -m "feat: resolve hint display text in computeGridData"
+```
+
+---
+
+### Task 6: Install Font Awesome and update `ActorPopover` component
+
+**Files:**
+- Modify: `assets/react/controllers/ActorPopover.jsx`
+- Modify: `assets/react/controllers/GameGrid.jsx`
+- Modify: `assets/react/controllers/GameRow.jsx`
+
+- [ ] **Step 1: Install Font Awesome**
+
+```bash
+cd /home/thibaud/ltbxd-actorle && npm install @fortawesome/fontawesome-free
+```
+
+- [ ] **Step 2: Import Font Awesome CSS in the app entrypoint**
+
+Check the main JS entrypoint:
+
+```bash
+head -5 assets/app.js
+```
+
+Add at the top of `assets/app.js`:
+
+```js
+import '@fortawesome/fontawesome-free/css/all.min.css';
+```
+
+- [ ] **Step 3: Update `ActorPopover` to accept hint props**
+
+Replace the full content of `assets/react/controllers/ActorPopover.jsx`:
+
+```jsx
+import React, { useState } from 'react';
+import { useFloating, useClick, useDismiss, useInteractions, offset, flip, shift } from '@floating-ui/react';
+
+const HINT_ICONS = {
+    film: 'fa-solid fa-film',
+    character: 'fa-solid fa-masks-theater',
+    award: 'fa-solid fa-trophy',
+};
+
+export default function ActorPopover({ hintType, hintText }) {
+    const [isOpen, setIsOpen] = useState(false);
+
+    const { refs, floatingStyles, context } = useFloating({
+        open: isOpen,
+        onOpenChange: setIsOpen,
+        middleware: [offset(8), flip(), shift()],
+        placement: 'left',
+    });
+
+    const click = useClick(context);
+    const dismiss = useDismiss(context);
+    const { getReferenceProps, getFloatingProps } = useInteractions([click, dismiss]);
+
+    const iconClass = HINT_ICONS[hintType] || 'fa-solid fa-circle-question';
+
+    return (
+        <>
+            <button
+                ref={refs.setReference}
+                {...getReferenceProps()}
+                className="popover-trigger"
+                type="button"
+            >
+                <i className={iconClass}></i>
+            </button>
+            {isOpen && (
+                <div
+                    ref={refs.setFloating}
+                    style={floatingStyles}
+                    {...getFloatingProps()}
+                    className="actor-popover"
+                >
+                    {hintText}
+                </div>
+            )}
+        </>
+    );
+}
+```
+
+- [ ] **Step 4: Update `GameRow` to pass hint props**
+
+In `assets/react/controllers/GameRow.jsx`, update the component signature (line 9):
+
+```jsx
+export default function GameRow({ actorName, pos, colStart, totalWidth, hintType, hintText }) {
+```
+
+Update the `ActorPopover` usage (line 33):
+
+```jsx
+<ActorPopover hintType={hintType} hintText={hintText} />
+```
+
+- [ ] **Step 5: Update `GameGrid` to pass hint props**
+
+In `assets/react/controllers/GameGrid.jsx`, update the `GameRow` rendering (lines 27-33):
+
+```jsx
+<GameRow
+    key={rowIndex}
+    actorName={row.actorName}
+    pos={row.pos}
+    colStart={middle - row.pos}
+    totalWidth={width}
+    hintType={row.hintType}
+    hintText={row.hintText}
+/>
+```
+
+- [ ] **Step 6: Commit**
+
+```bash
+git add assets/ package.json package-lock.json
+git commit -m "feat: replace ? button with hint type icons in ActorPopover"
+```
+
+---
+
+### Task 7: Manual end-to-end verification
+
+- [ ] **Step 1: Build frontend assets**
+
+```bash
+cd /home/thibaud/ltbxd-actorle && npm run build
+```
+
+- [ ] **Step 2: Start a new game and verify**
+
+Open the app in a browser, start a new game. Verify:
+- Each row has an icon (film, masks, or trophy) instead of "?"
+- Clicking the icon opens a popover with the hint text
+- Different rows can have different hint types
+- Award hints show the format "Nom du prix (année)"
+
+- [ ] **Step 3: Final commit if any adjustments needed**

docs/superpowers/plans/2026-03-30-game-persistence.md

@@ -0,0 +1,846 @@
+# Game Grid Persistence — Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Persist game grids in the database so players can resume their current game, start new games explicitly, and abandon games in progress.
+
+**Architecture:** Two new Doctrine entities (`Game`, `GameRow`) store the grid definition. A `GameGridGenerator` service encapsulates grid creation logic extracted from `HomepageController`. The homepage checks for an active game (via User or session) and renders either the grid or a "Start a game" button. A `GameController` handles start/abandon actions.
+
+**Tech Stack:** Symfony 8, Doctrine ORM, PostgreSQL, Twig, React (unchanged components)
+
+---
+
+### Task 1: Create the `Game` entity
+
+**Files:**
+- Create: `src/Entity/Game.php`
+
+- [ ] **Step 1: Create the Game entity**
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace App\Entity;
+
+use App\Repository\GameRepository;
+use Doctrine\Common\Collections\ArrayCollection;
+use Doctrine\Common\Collections\Collection;
+use Doctrine\ORM\Mapping as ORM;
+
+#[ORM\Entity(repositoryClass: GameRepository::class)]
+class Game
+{
+    public const string STATUS_IN_PROGRESS = 'in_progress';
+    public const string STATUS_ABANDONED = 'abandoned';
+
+    #[ORM\Id]
+    #[ORM\GeneratedValue]
+    #[ORM\Column]
+    private ?int $id = null;
+
+    #[ORM\ManyToOne(targetEntity: User::class)]
+    #[ORM\JoinColumn(nullable: true)]
+    private ?User $user = null;
+
+    #[ORM\ManyToOne(targetEntity: Actor::class)]
+    #[ORM\JoinColumn(nullable: false)]
+    private ?Actor $mainActor = null;
+
+    #[ORM\Column(length: 20)]
+    private string $status = self::STATUS_IN_PROGRESS;
+
+    #[ORM\Column]
+    private \DateTimeImmutable $startedAt;
+
+    #[ORM\Column(nullable: true)]
+    private ?\DateTimeImmutable $endedAt = null;
+
+    /** @var Collection<int, GameRow> */
+    #[ORM\OneToMany(targetEntity: GameRow::class, mappedBy: 'game', cascade: ['persist'], orphanRemoval: true)]
+    #[ORM\OrderBy(['rowOrder' => 'ASC'])]
+    private Collection $rows;
+
+    public function __construct()
+    {
+        $this->startedAt = new \DateTimeImmutable();
+        $this->rows = new ArrayCollection();
+    }
+
+    public function getId(): ?int
+    {
+        return $this->id;
+    }
+
+    public function getUser(): ?User
+    {
+        return $this->user;
+    }
+
+    public function setUser(?User $user): static
+    {
+        $this->user = $user;
+
+        return $this;
+    }
+
+    public function getMainActor(): ?Actor
+    {
+        return $this->mainActor;
+    }
+
+    public function setMainActor(Actor $mainActor): static
+    {
+        $this->mainActor = $mainActor;
+
+        return $this;
+    }
+
+    public function getStatus(): string
+    {
+        return $this->status;
+    }
+
+    public function setStatus(string $status): static
+    {
+        $this->status = $status;
+
+        return $this;
+    }
+
+    public function getStartedAt(): \DateTimeImmutable
+    {
+        return $this->startedAt;
+    }
+
+    public function getEndedAt(): ?\DateTimeImmutable
+    {
+        return $this->endedAt;
+    }
+
+    public function setEndedAt(?\DateTimeImmutable $endedAt): static
+    {
+        $this->endedAt = $endedAt;
+
+        return $this;
+    }
+
+    /** @return Collection<int, GameRow> */
+    public function getRows(): Collection
+    {
+        return $this->rows;
+    }
+
+    public function addRow(GameRow $row): static
+    {
+        if (!$this->rows->contains($row)) {
+            $this->rows->add($row);
+            $row->setGame($this);
+        }
+
+        return $this;
+    }
+
+    public function abandon(): static
+    {
+        $this->status = self::STATUS_ABANDONED;
+        $this->endedAt = new \DateTimeImmutable();
+
+        return $this;
+    }
+}
+```
+
+- [ ] **Step 2: Commit**
+
+```bash
+git add src/Entity/Game.php
+git commit -m "feat: add Game entity"
+```
+
+---
+
+### Task 2: Create the `GameRow` entity
+
+**Files:**
+- Create: `src/Entity/GameRow.php`
+
+- [ ] **Step 1: Create the GameRow entity**
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace App\Entity;
+
+use App\Repository\GameRowRepository;
+use Doctrine\ORM\Mapping as ORM;
+
+#[ORM\Entity(repositoryClass: GameRowRepository::class)]
+class GameRow
+{
+    #[ORM\Id]
+    #[ORM\GeneratedValue]
+    #[ORM\Column]
+    private ?int $id = null;
+
+    #[ORM\ManyToOne(targetEntity: Game::class, inversedBy: 'rows')]
+    #[ORM\JoinColumn(nullable: false)]
+    private ?Game $game = null;
+
+    #[ORM\ManyToOne(targetEntity: Actor::class)]
+    #[ORM\JoinColumn(nullable: false)]
+    private ?Actor $actor = null;
+
+    #[ORM\Column]
+    private int $position;
+
+    #[ORM\Column]
+    private int $rowOrder;
+
+    public function getId(): ?int
+    {
+        return $this->id;
+    }
+
+    public function getGame(): ?Game
+    {
+        return $this->game;
+    }
+
+    public function setGame(Game $game): static
+    {
+        $this->game = $game;
+
+        return $this;
+    }
+
+    public function getActor(): ?Actor
+    {
+        return $this->actor;
+    }
+
+    public function setActor(Actor $actor): static
+    {
+        $this->actor = $actor;
+
+        return $this;
+    }
+
+    public function getPosition(): int
+    {
+        return $this->position;
+    }
+
+    public function setPosition(int $position): static
+    {
+        $this->position = $position;
+
+        return $this;
+    }
+
+    public function getRowOrder(): int
+    {
+        return $this->rowOrder;
+    }
+
+    public function setRowOrder(int $rowOrder): static
+    {
+        $this->rowOrder = $rowOrder;
+
+        return $this;
+    }
+}
+```
+
+- [ ] **Step 2: Commit**
+
+```bash
+git add src/Entity/GameRow.php
+git commit -m "feat: add GameRow entity"
+```
+
+---
+
+### Task 3: Create the repositories
+
+**Files:**
+- Create: `src/Repository/GameRepository.php`
+- Create: `src/Repository/GameRowRepository.php`
+
+- [ ] **Step 1: Create GameRepository with findActiveForUser method**
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace App\Repository;
+
+use App\Entity\Game;
+use App\Entity\User;
+use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
+use Doctrine\Persistence\ManagerRegistry;
+
+/**
+ * @extends ServiceEntityRepository<Game>
+ */
+class GameRepository extends ServiceEntityRepository
+{
+    public function __construct(ManagerRegistry $registry)
+    {
+        parent::__construct($registry, Game::class);
+    }
+
+    public function findActiveForUser(User $user): ?Game
+    {
+        return $this->createQueryBuilder('g')
+            ->andWhere('g.user = :user')
+            ->andWhere('g.status = :status')
+            ->setParameter('user', $user)
+            ->setParameter('status', Game::STATUS_IN_PROGRESS)
+            ->setMaxResults(1)
+            ->getQuery()
+            ->getOneOrNullResult();
+    }
+}
+```
+
+- [ ] **Step 2: Create GameRowRepository (empty, standard)**
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace App\Repository;
+
+use App\Entity\GameRow;
+use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
+use Doctrine\Persistence\ManagerRegistry;
+
+/**
+ * @extends ServiceEntityRepository<GameRow>
+ */
+class GameRowRepository extends ServiceEntityRepository
+{
+    public function __construct(ManagerRegistry $registry)
+    {
+        parent::__construct($registry, GameRow::class);
+    }
+}
+```
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add src/Repository/GameRepository.php src/Repository/GameRowRepository.php
+git commit -m "feat: add Game and GameRow repositories"
+```
+
+---
+
+### Task 4: Generate and run the database migration
+
+**Files:**
+- Create: `migrations/Version2026033000001.php` (auto-generated)
+
+- [ ] **Step 1: Generate the migration**
+
+```bash
+make db:migration
+```
+
+Expected: A new migration file is created in `migrations/` with `CREATE TABLE game` and `CREATE TABLE game_row` statements plus foreign keys.
+
+- [ ] **Step 2: Review the generated migration**
+
+Read the generated migration file. Verify it contains:
+- `game` table with columns: `id`, `user_id` (nullable FK → user), `main_actor_id` (FK → actor), `status`, `started_at`, `ended_at` (nullable)
+- `game_row` table with columns: `id`, `game_id` (FK → game), `actor_id` (FK → actor), `position`, `row_order`
+- Proper foreign key constraints
+
+- [ ] **Step 3: Run the migration**
+
+```bash
+make db:migrate
+```
+
+Expected: Migration executes successfully.
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add migrations/
+git commit -m "feat: add migration for game and game_row tables"
+```
+
+---
+
+### Task 5: Create the `GameGridGenerator` service
+
+**Files:**
+- Create: `src/Service/GameGridGenerator.php`
+
+This extracts the grid generation logic from `HomepageController::index` (lines 25-72) into a dedicated service that creates and persists a `Game` with its `GameRow` entities.
+
+- [ ] **Step 1: Create the service**
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace App\Service;
+
+use App\Entity\Actor;
+use App\Entity\Game;
+use App\Entity\GameRow;
+use App\Entity\User;
+use App\Repository\ActorRepository;
+use Doctrine\ORM\EntityManagerInterface;
+
+class GameGridGenerator
+{
+    public function __construct(
+        private readonly ActorRepository $actorRepository,
+        private readonly EntityManagerInterface $em,
+    ) {}
+
+    public function generate(?User $user = null): Game
+    {
+        $mainActor = $this->actorRepository->findOneRandom(4);
+
+        $game = new Game();
+        $game->setMainActor($mainActor);
+        $game->setUser($user);
+
+        $usedActors = [$mainActor->getId()];
+        $rowOrder = 0;
+
+        foreach (str_split(strtolower($mainActor->getName())) as $char) {
+            if (!preg_match('/[a-z]/', $char)) {
+                continue;
+            }
+
+            $tryFindActor = 0;
+            do {
+                $actor = $this->actorRepository->findOneRandom(4, $char);
+                ++$tryFindActor;
+            } while (
+                in_array($actor->getId(), $usedActors)
+                || $tryFindActor < 5
+            );
+
+            $usedActors[] = $actor->getId();
+
+            $row = new GameRow();
+            $row->setActor($actor);
+            $row->setPosition(strpos(strtolower($actor->getName()), $char));
+            $row->setRowOrder($rowOrder);
+
+            $game->addRow($row);
+            ++$rowOrder;
+        }
+
+        $this->em->persist($game);
+        $this->em->flush();
+
+        return $game;
+    }
+
+    /**
+     * Compute display data (grid, width, middle) from a Game entity for the React component.
+     *
+     * @return array{grid: list<array{actorName: string, actorId: int, pos: int}>, width: int, middle: int}
+     */
+    public function computeGridData(Game $game): array
+    {
+        $leftSize = 0;
+        $rightSize = 0;
+        $grid = [];
+
+        foreach ($game->getRows() as $row) {
+            $actor = $row->getActor();
+            $pos = $row->getPosition();
+
+            if ($leftSize < $pos) {
+                $leftSize = $pos;
+            }
+
+            $rightSizeActor = strlen($actor->getName()) - $pos - 1;
+            if ($rightSize < $rightSizeActor) {
+                $rightSize = $rightSizeActor;
+            }
+
+            $grid[] = [
+                'actorName' => $actor->getName(),
+                'actorId' => $actor->getId(),
+                'pos' => $pos,
+            ];
+        }
+
+        return [
+            'grid' => $grid,
+            'width' => $rightSize + $leftSize + 1,
+            'middle' => $leftSize,
+        ];
+    }
+}
+```
+
+- [ ] **Step 2: Commit**
+
+```bash
+git add src/Service/GameGridGenerator.php
+git commit -m "feat: add GameGridGenerator service"
+```
+
+---
+
+### Task 6: Create the `GameController`
+
+**Files:**
+- Create: `src/Controller/GameController.php`
+- Modify: `config/packages/security.yaml` (add `/game` routes as PUBLIC_ACCESS)
+
+- [ ] **Step 1: Create the controller**
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace App\Controller;
+
+use App\Entity\Game;
+use App\Entity\User;
+use App\Repository\GameRepository;
+use App\Service\GameGridGenerator;
+use Doctrine\ORM\EntityManagerInterface;
+use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+use Symfony\Component\HttpFoundation\Request;
+use Symfony\Component\HttpFoundation\Response;
+use Symfony\Component\Routing\Attribute\Route;
+
+class GameController extends AbstractController
+{
+    #[Route('/game/start', name: 'app_game_start', methods: ['POST'])]
+    public function start(
+        Request $request,
+        GameGridGenerator $generator,
+        GameRepository $gameRepository,
+    ): Response {
+        $this->validateCsrfToken('game_start', $request);
+
+        /** @var User|null $user */
+        $user = $this->getUser();
+
+        // Check no game already in progress
+        if ($user) {
+            $existing = $gameRepository->findActiveForUser($user);
+        } else {
+            $gameId = $request->getSession()->get('current_game_id');
+            $existing = $gameId ? $gameRepository->find($gameId) : null;
+            if ($existing && $existing->getStatus() !== Game::STATUS_IN_PROGRESS) {
+                $existing = null;
+            }
+        }
+
+        if ($existing) {
+            return $this->redirectToRoute('app_homepage');
+        }
+
+        $game = $generator->generate($user);
+
+        if (!$user) {
+            $request->getSession()->set('current_game_id', $game->getId());
+        }
+
+        return $this->redirectToRoute('app_homepage');
+    }
+
+    #[Route('/game/{id}/abandon', name: 'app_game_abandon', methods: ['POST'])]
+    public function abandon(
+        Game $game,
+        Request $request,
+        EntityManagerInterface $em,
+    ): Response {
+        $this->validateCsrfToken('game_abandon', $request);
+
+        /** @var User|null $user */
+        $user = $this->getUser();
+
+        // Verify ownership
+        if ($user) {
+            if ($game->getUser() !== $user) {
+                throw $this->createAccessDeniedException();
+            }
+        } else {
+            $sessionGameId = $request->getSession()->get('current_game_id');
+            if ($game->getId() !== $sessionGameId) {
+                throw $this->createAccessDeniedException();
+            }
+        }
+
+        $game->abandon();
+        $em->flush();
+
+        if (!$user) {
+            $request->getSession()->remove('current_game_id');
+        }
+
+        return $this->redirectToRoute('app_homepage');
+    }
+
+    private function validateCsrfToken(string $tokenId, Request $request): void
+    {
+        $token = $request->request->get('_token');
+        if (!$this->isCsrfTokenValid($tokenId, $token)) {
+            throw $this->createAccessDeniedException('Invalid CSRF token.');
+        }
+    }
+}
+```
+
+- [ ] **Step 2: Add `/game` routes to security access_control**
+
+In `config/packages/security.yaml`, add a rule so `/game` routes are accessible to anonymous users (the controller handles auth logic itself):
+
+```yaml
+    access_control:
+        - { path: ^/login, roles: PUBLIC_ACCESS }
+        - { path: ^/register, roles: PUBLIC_ACCESS }
+        - { path: ^/$, roles: PUBLIC_ACCESS }
+        - { path: ^/game, roles: PUBLIC_ACCESS }
+        - { path: ^/, roles: ROLE_USER }
+```
+
+The new line `- { path: ^/game, roles: PUBLIC_ACCESS }` must go **before** the catch-all `^/` rule.
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add src/Controller/GameController.php config/packages/security.yaml
+git commit -m "feat: add GameController with start and abandon actions"
+```
+
+---
+
+### Task 7: Update `HomepageController` to use persisted games
+
+**Files:**
+- Modify: `src/Controller/HomepageController.php`
+
+Replace the on-the-fly grid generation with a lookup of the active game.
+
+- [ ] **Step 1: Rewrite HomepageController::index**
+
+Replace the entire content of `src/Controller/HomepageController.php` with:
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace App\Controller;
+
+use App\Entity\Game;
+use App\Entity\User;
+use App\Repository\GameRepository;
+use App\Service\GameGridGenerator;
+use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+use Symfony\Component\HttpFoundation\Request;
+use Symfony\Component\HttpFoundation\Response;
+use Symfony\Component\Routing\Attribute\Route;
+
+class HomepageController extends AbstractController
+{
+    #[Route('/', name: 'app_homepage')]
+    public function index(
+        Request $request,
+        GameRepository $gameRepository,
+        GameGridGenerator $gridGenerator,
+    ): Response {
+        /** @var User|null $user */
+        $user = $this->getUser();
+
+        $game = null;
+
+        if ($user) {
+            $game = $gameRepository->findActiveForUser($user);
+        } else {
+            $gameId = $request->getSession()->get('current_game_id');
+            if ($gameId) {
+                $game = $gameRepository->find($gameId);
+                if (!$game || $game->getStatus() !== Game::STATUS_IN_PROGRESS) {
+                    $request->getSession()->remove('current_game_id');
+                    $game = null;
+                }
+            }
+        }
+
+        if (!$game) {
+            return $this->render('homepage/index.html.twig', [
+                'game' => null,
+            ]);
+        }
+
+        $gridData = $gridGenerator->computeGridData($game);
+
+        return $this->render('homepage/index.html.twig', [
+            'game' => $game,
+            'grid' => $gridData['grid'],
+            'width' => $gridData['width'],
+            'middle' => $gridData['middle'],
+        ]);
+    }
+}
+```
+
+- [ ] **Step 2: Commit**
+
+```bash
+git add src/Controller/HomepageController.php
+git commit -m "refactor: use persisted games in HomepageController"
+```
+
+---
+
+### Task 8: Update the homepage template
+
+**Files:**
+- Modify: `templates/homepage/index.html.twig`
+- Modify: `assets/styles/app.css` (add game action bar styles)
+
+- [ ] **Step 1: Update the template for 3 states**
+
+Replace the content of `templates/homepage/index.html.twig` with:
+
+```twig
+{% extends 'base.html.twig' %}
+
+{% block body %}
+    {% if game %}
+        <div class="game-actions">
+            <form method="post" action="{{ path('app_game_abandon', {id: game.id}) }}">
+                <input type="hidden" name="_token" value="{{ csrf_token('game_abandon') }}">
+                <button type="submit" class="btn btn-abandon">Abandonner</button>
+            </form>
+        </div>
+
+        <div {{ react_component('GameGrid', {
+            grid: grid,
+            width: width,
+            middle: middle,
+        }) }}></div>
+    {% else %}
+        <div class="game-start-container">
+            <form method="post" action="{{ path('app_game_start') }}">
+                <input type="hidden" name="_token" value="{{ csrf_token('game_start') }}">
+                <button type="submit" class="btn btn-primary btn-start">Commencer une partie</button>
+            </form>
+        </div>
+    {% endif %}
+{% endblock %}
+```
+
+- [ ] **Step 2: Add CSS for game action bar and start button**
+
+Add the following at the end of `assets/styles/app.css`:
+
+```css
+/* ── Game actions ── */
+
+.game-actions {
+    display: flex;
+    justify-content: flex-end;
+    padding: 12px 40px 0;
+}
+
+.btn-abandon {
+    padding: 7px 16px;
+    background: none;
+    color: var(--text-muted);
+    border: 1.5px solid var(--border);
+    border-radius: 100px;
+    font-family: 'Inter', sans-serif;
+    font-size: 13px;
+    font-weight: 600;
+    cursor: pointer;
+    transition: border-color 0.15s, color 0.15s, background 0.15s;
+}
+
+.btn-abandon:hover {
+    border-color: #dc2626;
+    color: #dc2626;
+    background: #fef2f2;
+}
+
+.game-start-container {
+    display: flex;
+    justify-content: center;
+    align-items: center;
+    min-height: calc(100vh - 64px - 80px);
+}
+
+.btn-start {
+    padding: 14px 32px;
+    font-size: 16px;
+}
+```
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add templates/homepage/index.html.twig assets/styles/app.css
+git commit -m "feat: update homepage template with start/abandon game UI"
+```
+
+---
+
+### Task 9: Manual verification
+
+- [ ] **Step 1: Start the dev environment**
+
+```bash
+make dev:up
+```
+
+- [ ] **Step 2: Run the migration**
+
+```bash
+make db:migrate
+```
+
+- [ ] **Step 3: Test the flow as anonymous user**
+
+1. Open `http://localhost` — should see "Commencer une partie" button
+2. Click the button — should see a game grid with "Abandonner" button above
+3. Refresh the page — the same grid should still be there
+4. Click "Abandonner" — should redirect to homepage with the "Commencer une partie" button
+
+- [ ] **Step 4: Test the flow as connected user**
+
+1. Log in
+2. Should see "Commencer une partie" button
+3. Start a game — grid appears with "Abandonner"
+4. Refresh — same grid persisted
+5. Abandon — back to "Commencer une partie"
+
+- [ ] **Step 5: Verify database**
+
+```bash
+docker compose exec app php bin/console doctrine:query:sql "SELECT id, user_id, main_actor_id, status, started_at, ended_at FROM game ORDER BY id DESC LIMIT 5"
+```
+
+Verify games have correct status (`in_progress` → `abandoned` after abandon), timestamps, and user_id (null for anonymous, set for connected).
+
+- [ ] **Step 6: Final commit (if any fixes needed)**
+
+```bash
+git add -A
+git commit -m "fix: address issues found during manual verification"
+```

docs/superpowers/plans/2026-04-01-awards-bdd.md

@@ -0,0 +1,881 @@
+# Awards en BDD — Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Persist actor awards in the database during film import and use them for hint generation instead of live Wikidata calls.
+
+**Architecture:** Two new Doctrine entities (`AwardType`, `Award`) plus a `awardsImported` flag on `Actor`. A new `AwardImporter` service handles Wikidata fetching + pattern-based type resolution during the existing batch import flow. `GameGridGenerator` switches from Wikidata calls to DB queries for award hints.
+
+**Tech Stack:** Symfony 7, Doctrine ORM, PHPUnit 12, PostgreSQL (RANDOM() function used in existing queries)
+
+---
+
+## File Structure
+
+| Action | Path | Responsibility |
+|--------|------|---------------|
+| Create | `src/Entity/AwardType.php` | Doctrine entity for award types |
+| Create | `src/Entity/Award.php` | Doctrine entity for individual awards |
+| Create | `src/Repository/AwardTypeRepository.php` | AwardType queries |
+| Create | `src/Repository/AwardRepository.php` | Award queries (random by actor) |
+| Create | `src/Service/AwardImporter.php` | Orchestrates Wikidata fetch + type resolution + persist |
+| Create | `tests/Service/AwardImporterTest.php` | Unit tests for import logic |
+| Create | `tests/Service/GameGridGeneratorTest.php` | Unit tests for updated hint generation |
+| Modify | `src/Entity/Actor.php` | Add `awardsImported` bool field + `awards` collection |
+| Modify | `src/MessageHandler/ImportFilmsBatchMessageHandler.php` | Call `AwardImporter` after actor sync |
+| Modify | `src/Service/GameGridGenerator.php` | Replace Wikidata call with DB query |
+| Create | `migrations/VersionXXX.php` | Generated by doctrine:migrations:diff |
+
+---
+
+### Task 1: Create `AwardType` entity
+
+**Files:**
+- Create: `src/Entity/AwardType.php`
+- Create: `src/Repository/AwardTypeRepository.php`
+
+- [ ] **Step 1: Create the entity**
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace App\Entity;
+
+use App\Repository\AwardTypeRepository;
+use Doctrine\Common\Collections\ArrayCollection;
+use Doctrine\Common\Collections\Collection;
+use Doctrine\ORM\Mapping as ORM;
+
+#[ORM\Entity(repositoryClass: AwardTypeRepository::class)]
+class AwardType
+{
+    #[ORM\Id]
+    #[ORM\GeneratedValue]
+    #[ORM\Column]
+    private ?int $id = null;
+
+    #[ORM\Column(length: 255)]
+    private string $name;
+
+    #[ORM\Column(length: 255)]
+    private string $pattern;
+
+    /** @var Collection<int, Award> */
+    #[ORM\OneToMany(targetEntity: Award::class, mappedBy: 'awardType')]
+    private Collection $awards;
+
+    public function __construct()
+    {
+        $this->awards = new ArrayCollection();
+    }
+
+    public function getId(): ?int
+    {
+        return $this->id;
+    }
+
+    public function getName(): string
+    {
+        return $this->name;
+    }
+
+    public function setName(string $name): static
+    {
+        $this->name = $name;
+
+        return $this;
+    }
+
+    public function getPattern(): string
+    {
+        return $this->pattern;
+    }
+
+    public function setPattern(string $pattern): static
+    {
+        $this->pattern = $pattern;
+
+        return $this;
+    }
+
+    /** @return Collection<int, Award> */
+    public function getAwards(): Collection
+    {
+        return $this->awards;
+    }
+}
+```
+
+- [ ] **Step 2: Create the repository**
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace App\Repository;
+
+use App\Entity\AwardType;
+use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
+use Doctrine\Persistence\ManagerRegistry;
+
+/** @extends ServiceEntityRepository<AwardType> */
+class AwardTypeRepository extends ServiceEntityRepository
+{
+    public function __construct(ManagerRegistry $registry)
+    {
+        parent::__construct($registry, AwardType::class);
+    }
+
+    /** @return list<AwardType> */
+    public function findAll(): array
+    {
+        return parent::findAll();
+    }
+}
+```
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add src/Entity/AwardType.php src/Repository/AwardTypeRepository.php
+git commit -m "feat: add AwardType entity and repository"
+```
+
+---
+
+### Task 2: Create `Award` entity
+
+**Files:**
+- Create: `src/Entity/Award.php`
+- Create: `src/Repository/AwardRepository.php`
+
+- [ ] **Step 1: Create the entity**
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace App\Entity;
+
+use App\Repository\AwardRepository;
+use Doctrine\ORM\Mapping as ORM;
+
+#[ORM\Entity(repositoryClass: AwardRepository::class)]
+class Award
+{
+    #[ORM\Id]
+    #[ORM\GeneratedValue]
+    #[ORM\Column]
+    private ?int $id = null;
+
+    #[ORM\ManyToOne(targetEntity: AwardType::class, inversedBy: 'awards')]
+    #[ORM\JoinColumn(nullable: false)]
+    private AwardType $awardType;
+
+    #[ORM\ManyToOne(targetEntity: Actor::class, inversedBy: 'awards')]
+    #[ORM\JoinColumn(nullable: false)]
+    private Actor $actor;
+
+    #[ORM\Column(length: 255)]
+    private string $name;
+
+    #[ORM\Column(nullable: true)]
+    private ?int $year = null;
+
+    public function getId(): ?int
+    {
+        return $this->id;
+    }
+
+    public function getAwardType(): AwardType
+    {
+        return $this->awardType;
+    }
+
+    public function setAwardType(AwardType $awardType): static
+    {
+        $this->awardType = $awardType;
+
+        return $this;
+    }
+
+    public function getActor(): Actor
+    {
+        return $this->actor;
+    }
+
+    public function setActor(Actor $actor): static
+    {
+        $this->actor = $actor;
+
+        return $this;
+    }
+
+    public function getName(): string
+    {
+        return $this->name;
+    }
+
+    public function setName(string $name): static
+    {
+        $this->name = $name;
+
+        return $this;
+    }
+
+    public function getYear(): ?int
+    {
+        return $this->year;
+    }
+
+    public function setYear(?int $year): static
+    {
+        $this->year = $year;
+
+        return $this;
+    }
+}
+```
+
+- [ ] **Step 2: Create the repository with `findOneRandomByActor`**
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace App\Repository;
+
+use App\Entity\Award;
+use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
+use Doctrine\Persistence\ManagerRegistry;
+
+/** @extends ServiceEntityRepository<Award> */
+class AwardRepository extends ServiceEntityRepository
+{
+    public function __construct(ManagerRegistry $registry)
+    {
+        parent::__construct($registry, Award::class);
+    }
+
+    public function findOneRandomByActor(int $actorId): ?Award
+    {
+        return $this->createQueryBuilder('a')
+            ->andWhere('a.actor = :actorId')
+            ->setParameter('actorId', $actorId)
+            ->orderBy('RANDOM()')
+            ->setMaxResults(1)
+            ->getQuery()
+            ->getOneOrNullResult();
+    }
+}
+```
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add src/Entity/Award.php src/Repository/AwardRepository.php
+git commit -m "feat: add Award entity and repository"
+```
+
+---
+
+### Task 3: Add `awardsImported` flag and `awards` collection to `Actor`
+
+**Files:**
+- Modify: `src/Entity/Actor.php`
+
+- [ ] **Step 1: Add the `awardsImported` column and `awards` OneToMany relation**
+
+Add these properties after the existing `$tmdbId` property:
+
+```php
+#[ORM\Column(options: ['default' => false])]
+private bool $awardsImported = false;
+
+/** @var Collection<int, Award> */
+#[ORM\OneToMany(targetEntity: Award::class, mappedBy: 'actor')]
+private Collection $awards;
+```
+
+Add `use App\Entity\Award;` import if not already present (it's in the same namespace, so not needed).
+
+In the constructor, add:
+
+```php
+$this->awards = new ArrayCollection();
+```
+
+Add these methods at the end of the class:
+
+```php
+public function isAwardsImported(): bool
+{
+    return $this->awardsImported;
+}
+
+public function setAwardsImported(bool $awardsImported): static
+{
+    $this->awardsImported = $awardsImported;
+
+    return $this;
+}
+
+/** @return Collection<int, Award> */
+public function getAwards(): Collection
+{
+    return $this->awards;
+}
+```
+
+- [ ] **Step 2: Commit**
+
+```bash
+git add src/Entity/Actor.php
+git commit -m "feat: add awardsImported flag and awards relation to Actor"
+```
+
+---
+
+### Task 4: Generate and run the migration
+
+**Files:**
+- Create: `migrations/VersionXXX.php` (auto-generated)
+
+- [ ] **Step 1: Generate the migration**
+
+```bash
+php bin/console doctrine:migrations:diff
+```
+
+Expected: a new migration file is created in `migrations/` with CREATE TABLE for `award_type` and `award`, and ALTER TABLE for `actor` adding `awards_imported`.
+
+- [ ] **Step 2: Review the generated migration**
+
+Open the generated file and verify it contains:
+- `CREATE TABLE award_type (id SERIAL, name VARCHAR(255), pattern VARCHAR(255), PRIMARY KEY(id))`
+- `CREATE TABLE award (id SERIAL, award_type_id INT NOT NULL, actor_id INT NOT NULL, name VARCHAR(255), year INT DEFAULT NULL, PRIMARY KEY(id))` with foreign keys
+- `ALTER TABLE actor ADD awards_imported BOOLEAN NOT NULL DEFAULT false`
+
+- [ ] **Step 3: Run the migration**
+
+```bash
+php bin/console doctrine:migrations:migrate --no-interaction
+```
+
+Expected: migration executes successfully.
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add migrations/
+git commit -m "feat: add migration for award_type, award tables and actor.awards_imported"
+```
+
+---
+
+### Task 5: Create `AwardImporter` service
+
+**Files:**
+- Create: `src/Service/AwardImporter.php`
+
+- [ ] **Step 1: Write the failing test**
+
+Create `tests/Service/AwardImporterTest.php`:
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tests\Service;
+
+use App\Entity\Actor;
+use App\Entity\Award;
+use App\Entity\AwardType;
+use App\Gateway\WikidataGateway;
+use App\Repository\AwardTypeRepository;
+use App\Service\AwardImporter;
+use Doctrine\ORM\EntityManagerInterface;
+use PHPUnit\Framework\TestCase;
+
+class AwardImporterTest extends TestCase
+{
+    private AwardImporter $importer;
+    private WikidataGateway&\PHPUnit\Framework\MockObject\MockObject $wikidataGateway;
+    private AwardTypeRepository&\PHPUnit\Framework\MockObject\MockObject $awardTypeRepository;
+    private EntityManagerInterface&\PHPUnit\Framework\MockObject\MockObject $em;
+
+    protected function setUp(): void
+    {
+        $this->wikidataGateway = $this->createMock(WikidataGateway::class);
+        $this->awardTypeRepository = $this->createMock(AwardTypeRepository::class);
+        $this->em = $this->createMock(EntityManagerInterface::class);
+
+        $this->importer = new AwardImporter(
+            $this->wikidataGateway,
+            $this->awardTypeRepository,
+            $this->em,
+        );
+    }
+
+    public function testSkipsActorWithAwardsAlreadyImported(): void
+    {
+        $actor = $this->createActorWithFlag(awardsImported: true);
+
+        $this->wikidataGateway->expects($this->never())->method('getAwards');
+
+        $this->importer->importForActor($actor);
+    }
+
+    public function testImportsAwardsAndSetsFlag(): void
+    {
+        $actor = $this->createActorWithFlag(awardsImported: false);
+
+        $this->wikidataGateway->method('getAwards')->willReturn([
+            ['name' => 'Academy Award for Best Actor', 'year' => 2020],
+        ]);
+
+        $existingType = new AwardType();
+        $existingType->setName('Oscar')->setPattern('Academy Award');
+
+        $this->awardTypeRepository->method('findAll')->willReturn([$existingType]);
+
+        $persisted = [];
+        $this->em->method('persist')->willReturnCallback(function ($entity) use (&$persisted) {
+            $persisted[] = $entity;
+        });
+
+        $this->importer->importForActor($actor);
+
+        $this->assertTrue($actor->isAwardsImported());
+        $this->assertCount(1, $persisted);
+        $this->assertInstanceOf(Award::class, $persisted[0]);
+        $this->assertSame('Academy Award for Best Actor', $persisted[0]->getName());
+        $this->assertSame(2020, $persisted[0]->getYear());
+        $this->assertSame($existingType, $persisted[0]->getAwardType());
+        $this->assertSame($actor, $persisted[0]->getActor());
+    }
+
+    public function testCreatesNewAwardTypeWhenNoPatternMatches(): void
+    {
+        $actor = $this->createActorWithFlag(awardsImported: false);
+
+        $this->wikidataGateway->method('getAwards')->willReturn([
+            ['name' => 'Screen Actors Guild Award for Outstanding Performance', 'year' => 2019],
+        ]);
+
+        $this->awardTypeRepository->method('findAll')->willReturn([]);
+
+        $persisted = [];
+        $this->em->method('persist')->willReturnCallback(function ($entity) use (&$persisted) {
+            $persisted[] = $entity;
+        });
+
+        $this->importer->importForActor($actor);
+
+        $this->assertTrue($actor->isAwardsImported());
+        // Should persist both a new AwardType and the Award
+        $this->assertCount(2, $persisted);
+
+        $newType = $persisted[0];
+        $this->assertInstanceOf(AwardType::class, $newType);
+        $this->assertSame('Screen Actors Guild Award', $newType->getName());
+        $this->assertSame('Screen Actors Guild Award', $newType->getPattern());
+
+        $award = $persisted[1];
+        $this->assertInstanceOf(Award::class, $award);
+        $this->assertSame($newType, $award->getAwardType());
+    }
+
+    public function testDoesNotSetFlagOnWikidataError(): void
+    {
+        $actor = $this->createActorWithFlag(awardsImported: false);
+
+        $this->wikidataGateway->method('getAwards')
+            ->willThrowException(new \RuntimeException('Wikidata timeout'));
+
+        $this->importer->importForActor($actor);
+
+        $this->assertFalse($actor->isAwardsImported());
+    }
+
+    public function testHandlesActorWithNoAwards(): void
+    {
+        $actor = $this->createActorWithFlag(awardsImported: false);
+
+        $this->wikidataGateway->method('getAwards')->willReturn([]);
+        $this->awardTypeRepository->method('findAll')->willReturn([]);
+
+        $this->em->expects($this->never())->method('persist');
+
+        $this->importer->importForActor($actor);
+
+        $this->assertTrue($actor->isAwardsImported());
+    }
+
+    private function createActorWithFlag(bool $awardsImported): Actor
+    {
+        $actor = new Actor();
+        $actor->setName('Test Actor');
+        $actor->setAwardsImported($awardsImported);
+
+        return $actor;
+    }
+}
+```
+
+- [ ] **Step 2: Run the test to verify it fails**
+
+```bash
+php bin/phpunit tests/Service/AwardImporterTest.php
+```
+
+Expected: FAIL — `AwardImporter` class not found.
+
+- [ ] **Step 3: Write the implementation**
+
+Create `src/Service/AwardImporter.php`:
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace App\Service;
+
+use App\Entity\Actor;
+use App\Entity\Award;
+use App\Entity\AwardType;
+use App\Gateway\WikidataGateway;
+use App\Repository\AwardTypeRepository;
+use Doctrine\ORM\EntityManagerInterface;
+use Psr\Log\LoggerInterface;
+
+readonly class AwardImporter
+{
+    public function __construct(
+        private WikidataGateway $wikidataGateway,
+        private AwardTypeRepository $awardTypeRepository,
+        private EntityManagerInterface $em,
+        private ?LoggerInterface $logger = null,
+    ) {}
+
+    public function importForActor(Actor $actor): void
+    {
+        if ($actor->isAwardsImported()) {
+            return;
+        }
+
+        try {
+            $wikidataAwards = $this->wikidataGateway->getAwards($actor);
+        } catch (\Throwable $e) {
+            $this->logger?->warning('Failed to fetch awards from Wikidata', [
+                'actor' => $actor->getName(),
+                'error' => $e->getMessage(),
+            ]);
+
+            return;
+        }
+
+        $knownTypes = $this->awardTypeRepository->findAll();
+
+        foreach ($wikidataAwards as $wikidataAward) {
+            $awardType = $this->resolveAwardType($wikidataAward['name'], $knownTypes);
+
+            $award = new Award();
+            $award->setName($wikidataAward['name']);
+            $award->setYear($wikidataAward['year']);
+            $award->setActor($actor);
+            $award->setAwardType($awardType);
+
+            $this->em->persist($award);
+        }
+
+        $actor->setAwardsImported(true);
+    }
+
+    /**
+     * @param list<AwardType> $knownTypes
+     */
+    private function resolveAwardType(string $awardName, array &$knownTypes): AwardType
+    {
+        foreach ($knownTypes as $type) {
+            if (str_contains($awardName, $type->getPattern())) {
+                return $type;
+            }
+        }
+
+        $newType = new AwardType();
+        $prefix = $this->extractPrefix($awardName);
+        $newType->setName($prefix);
+        $newType->setPattern($prefix);
+
+        $this->em->persist($newType);
+        $knownTypes[] = $newType;
+
+        return $newType;
+    }
+
+    private function extractPrefix(string $awardName): string
+    {
+        // Extract text before " for " or " pour " (common patterns in award names)
+        if (preg_match('/^(.+?)\s+(?:for|pour)\s+/i', $awardName, $matches)) {
+            return trim($matches[1]);
+        }
+
+        return $awardName;
+    }
+}
+```
+
+- [ ] **Step 4: Run the tests to verify they pass**
+
+```bash
+php bin/phpunit tests/Service/AwardImporterTest.php
+```
+
+Expected: all 5 tests PASS.
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add src/Service/AwardImporter.php tests/Service/AwardImporterTest.php
+git commit -m "feat: add AwardImporter service with tests"
+```
+
+---
+
+### Task 6: Integrate `AwardImporter` into the import batch handler
+
+**Files:**
+- Modify: `src/MessageHandler/ImportFilmsBatchMessageHandler.php`
+
+- [ ] **Step 1: Add `AwardImporter` dependency**
+
+In the constructor, add:
+
+```php
+private AwardImporter $awardImporter,
+```
+
+Add the import at the top:
+
+```php
+use App\Service\AwardImporter;
+```
+
+- [ ] **Step 2: Call `AwardImporter` after actor sync**
+
+In the `__invoke` method, after `$this->actorSyncer->syncActorsForMovie($movie);` (line 63) and **before** the existing `$this->em->flush()` (line 77), add:
+
+```php
+$this->actorSyncer->syncActorsForMovie($movie);
+
+// Import awards for actors of this movie
+foreach ($movie->getActors() as $role) {
+    $this->awardImporter->importForActor($role->getActor());
+}
+```
+
+`Movie::getActors()` returns `Collection<MovieRole>`. The `ActorSyncer` persists actors/roles in memory before flush, so the collection is hydrated at this point. The existing `$this->em->flush()` on line 77 will persist both the roles and the new awards in a single flush. The `$this->em->clear()` on line 87 happens after, so all entities are still available.
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add src/MessageHandler/ImportFilmsBatchMessageHandler.php
+git commit -m "feat: import actor awards during film batch import"
+```
+
+---
+
+### Task 7: Update `GameGridGenerator` to use DB for award hints
+
+**Files:**
+- Modify: `src/Service/GameGridGenerator.php`
+
+- [ ] **Step 1: Write the failing test**
+
+Create `tests/Service/GameGridGeneratorTest.php` — test only the hint resolution, not the full game generation (which requires DB):
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tests\Service;
+
+use App\Entity\Actor;
+use App\Entity\Award;
+use App\Entity\AwardType;
+use App\Entity\GameRow;
+use App\Repository\ActorRepository;
+use App\Repository\AwardRepository;
+use App\Repository\MovieRepository;
+use App\Repository\MovieRoleRepository;
+use App\Service\GameGridGenerator;
+use Doctrine\ORM\EntityManagerInterface;
+use PHPUnit\Framework\TestCase;
+
+class GameGridGeneratorTest extends TestCase
+{
+    public function testResolveHintTextForAward(): void
+    {
+        $awardType = new AwardType();
+        $awardType->setName('Oscar')->setPattern('Academy Award');
+
+        $actor = new Actor();
+        $actor->setName('Test Actor');
+
+        $award = new Award();
+        $award->setName('Academy Award for Best Actor');
+        $award->setYear(2020);
+        $award->setActor($actor);
+        $award->setAwardType($awardType);
+
+        $awardRepository = $this->createMock(AwardRepository::class);
+        $awardRepository->method('find')->with(42)->willReturn($award);
+
+        $generator = new GameGridGenerator(
+            $this->createMock(ActorRepository::class),
+            $this->createMock(MovieRoleRepository::class),
+            $this->createMock(MovieRepository::class),
+            $awardRepository,
+            $this->createMock(EntityManagerInterface::class),
+        );
+
+        $row = new GameRow();
+        $row->setHintType('award');
+        $row->setHintData('42');
+
+        // Use reflection to test the private resolveHintText method
+        $method = new \ReflectionMethod($generator, 'resolveHintText');
+        $result = $method->invoke($generator, $row);
+
+        $this->assertSame('Academy Award for Best Actor (2020)', $result);
+    }
+}
+```
+
+- [ ] **Step 2: Run the test to verify it fails**
+
+```bash
+php bin/phpunit tests/Service/GameGridGeneratorTest.php
+```
+
+Expected: FAIL — constructor signature mismatch (no `AwardRepository` param yet).
+
+- [ ] **Step 3: Update `GameGridGenerator`**
+
+Replace `WikidataGateway` with `AwardRepository` in the constructor. Full changes to `src/Service/GameGridGenerator.php`:
+
+**Replace the imports:**
+- Remove: `use App\Gateway\WikidataGateway;`
+- Add: `use App\Repository\AwardRepository;`
+
+**Replace the constructor:**
+
+```php
+public function __construct(
+    private readonly ActorRepository $actorRepository,
+    private readonly MovieRoleRepository $movieRoleRepository,
+    private readonly MovieRepository $movieRepository,
+    private readonly AwardRepository $awardRepository,
+    private readonly EntityManagerInterface $em,
+) {}
+```
+
+**Replace the `case 'award':` block in `resolveHint()`** (lines 175-185):
+
+```php
+case 'award':
+    $award = $this->awardRepository->findOneRandomByActor($rowActor->getId());
+    if ($award === null) {
+        return null;
+    }
+    return ['type' => 'award', 'data' => (string) $award->getId()];
+```
+
+**Replace the `'award'` case in `resolveHintText()`** (line 203):
+
+```php
+'award' => $this->resolveAwardHintText((int) $data),
+```
+
+**Add this private method:**
+
+```php
+private function resolveAwardHintText(int $awardId): ?string
+{
+    $award = $this->awardRepository->find($awardId);
+    if ($award === null) {
+        return null;
+    }
+
+    $text = $award->getName();
+    if ($award->getYear() !== null) {
+        $text .= ' (' . $award->getYear() . ')';
+    }
+
+    return $text;
+}
+```
+
+- [ ] **Step 4: Run the tests**
+
+```bash
+php bin/phpunit tests/Service/GameGridGeneratorTest.php
+```
+
+Expected: PASS.
+
+- [ ] **Step 5: Run all tests**
+
+```bash
+php bin/phpunit
+```
+
+Expected: all tests PASS.
+
+- [ ] **Step 6: Commit**
+
+```bash
+git add src/Service/GameGridGenerator.php tests/Service/GameGridGeneratorTest.php
+git commit -m "feat: use DB awards instead of live Wikidata calls for hint generation"
+```
+
+---
+
+### Task 8: Manual verification
+
+- [ ] **Step 1: Verify the schema is in sync**
+
+```bash
+php bin/console doctrine:schema:validate
+```
+
+Expected: schema is in sync with mapping files.
+
+- [ ] **Step 2: Verify the app boots**
+
+```bash
+php bin/console cache:clear
+```
+
+Expected: no errors.
+
+- [ ] **Step 3: Run all tests one final time**
+
+```bash
+php bin/phpunit
+```
+
+Expected: all tests PASS.
+
+- [ ] **Step 4: Final commit if any fixes were needed**
+
+Only if adjustments were made during verification.

docs/superpowers/specs/2026-03-30-game-hints-design.md

@@ -0,0 +1,71 @@
+# Game Hints System — Design Spec
+
+## Summary
+
+Each row of the game grid provides a hint about the main actor to guess. Hints are pre-generated when the grid is created and stored on `GameRow`. Each hint has a type (film, character, award) represented by a distinct icon. Clicking the icon opens a popover showing the hint text.
+
+## Data Model
+
+Two new columns on `game_row`:
+
+| Column | Type | Description |
+|--------|------|-------------|
+| `hint_type` | `VARCHAR(20)`, NOT NULL | One of: `film`, `character`, `award` |
+| `hint_data` | `VARCHAR(255)`, NOT NULL | film → `movie.id`, character → `movie_role.id`, award → text "Nom du prix (année)" |
+
+No foreign key constraints on `hint_data` — the column stores either an id (resolved at read time) or raw text depending on `hint_type`.
+
+## Hint Generation
+
+Happens in `GameGridGenerator::generate()`, for each `GameRow`:
+
+1. Pick a random type from `[film, character, award]`
+2. Resolve based on type:
+   - **film**: pick a random `MovieRole` of the main actor → store `movie.id` in `hint_data`
+   - **character**: pick a random `MovieRole` of the main actor → store `movieRole.id` in `hint_data`
+   - **award**: call `WikidataAwardGateway` to fetch an award → store `"Nom du prix (année)"` in `hint_data`
+3. If the chosen type yields no result (e.g., no awards found), fallback to another random type
+4. Avoid duplicate hints across rows (don't show the same film/character/award twice)
+
+## Wikidata Award Gateway
+
+New service: `WikidataAwardGateway`
+
+- Input: actor (name or `tmdb_id`)
+- Output: list of awards, each with name and year
+- Uses Wikidata SPARQL API to query awards associated with the person
+- Storage format in `hint_data`: `"Oscar du meilleur second rôle (2014)"`
+- Results can be cached to avoid repeated Wikidata queries
+
+## Frontend
+
+### Icon Button
+
+The current "?" button in `ActorPopover` is replaced by an icon representing the hint type:
+
+| hint_type | Icon | Font Awesome class |
+|-----------|------|--------------------|
+| `film` | Film/clap | `fa-film` |
+| `character` | Theater masks | `fa-masks-theater` |
+| `award` | Trophy | `fa-trophy` |
+
+### Popover Content
+
+On click, the popover displays only the hint text:
+- **film**: movie title (resolved from `movie.id`)
+- **character**: character name (resolved from `movie_role.id`)
+- **award**: the raw text from `hint_data`
+
+### Data Flow
+
+1. Backend resolves `hint_data` to display text in `GameGridGenerator::computeGridData()`
+2. Hint type + resolved text are passed to the Twig template as part of the grid data
+3. Twig passes them as props to the React `GameGrid` component
+4. `ActorPopover` receives `hintType` and `hintText` props instead of `actorName`
+
+## Future Extensibility
+
+New hint types can be added by:
+1. Adding a new value for `hint_type`
+2. Adding resolution logic in `GameGridGenerator`
+3. Adding a new icon mapping in the frontend

docs/superpowers/specs/2026-03-30-game-persistence-design.md

@@ -0,0 +1,108 @@
+# Game Grid Persistence
+
+## Problem
+
+Game grids are currently generated on the fly at every page load in `HomepageController`. There is no persistence — refreshing the page gives a new grid. Players cannot resume a game.
+
+## Goal
+
+Persist game grids so players can resume their current game. Display a "Start a game" button when no game is in progress. Allow players to abandon a game.
+
+## Scope
+
+- Grid generation and persistence only
+- No win/loss logic (will be added later)
+- No saving of player input (filled letters)
+
+## Data Model
+
+### Entity: `Game`
+
+| Field       | Type                    | Description                                    |
+|-------------|-------------------------|------------------------------------------------|
+| `id`        | int (auto)              | Primary key                                    |
+| `user`      | ManyToOne → User, nullable | Null for anonymous players                  |
+| `mainActor` | ManyToOne → Actor       | The actor to guess                             |
+| `status`    | string                  | `in_progress` or `abandoned` (extensible to `won` later) |
+| `startedAt` | DateTimeImmutable       | When the game started                          |
+| `endedAt`   | DateTimeImmutable, nullable | When the game ended (abandon or win)       |
+
+### Entity: `GameRow`
+
+| Field      | Type               | Description                                    |
+|------------|--------------------|------------------------------------------------|
+| `id`       | int (auto)         | Primary key                                    |
+| `game`     | ManyToOne → Game   | Parent game                                    |
+| `actor`    | ManyToOne → Actor  | The actor for this row                         |
+| `position` | int                | Index of the target letter in the actor's name |
+| `rowOrder` | int                | Order of this row in the grid                  |
+
+`GameRow` is a separate entity (not JSON) to allow attaching hints/clues per row in a future iteration.
+
+## Service: `GameGridGenerator`
+
+Extracted from the current `HomepageController::index` logic:
+
+1. Select a random main actor via `ActorRepository::findOneRandom()`
+2. For each letter (a-z) in the main actor's name, find a random actor containing that letter
+3. Create a `Game` entity with `status = in_progress` and `startedAt = now`
+4. Create `GameRow` entities with the actor, letter position, and row order
+5. Persist and flush
+6. Return the `Game` entity
+
+Also provides a method to compute grid display data (width, middle) from a `Game` and its rows, for passing to the React component.
+
+## Routes
+
+### `GET /` — Homepage (modified)
+
+Current behavior replaced:
+
+1. If user is connected → query `GameRepository` for a `Game` with `status = in_progress` for this user
+2. If anonymous → get `current_game_id` from the Symfony session, then look up the `Game` in DB
+3. If a game is found and still `in_progress` → render the grid with an "Abandon" button above it
+4. If no game is found → render a "Start a game" button
+
+### `POST /game/start` — Start a new game (new)
+
+1. Verify no game is already in progress for this player (connected or session)
+2. Call `GameGridGenerator` to create the game
+3. If user is connected → the game is linked to the user
+4. If anonymous → store `$game->getId()` in session key `current_game_id`
+5. Redirect to `/`
+
+### `POST /game/{id}/abandon` — Abandon a game (new)
+
+1. Verify the game belongs to the current player (user match or session match)
+2. Set `status = abandoned` and `endedAt = now`
+3. If anonymous → remove `current_game_id` from session
+4. Redirect to `/`
+
+Both POST routes use CSRF protection.
+
+## Anonymous Session Handling
+
+- Session key: `current_game_id` (stores the `Game` ID)
+- Set on game creation, removed on abandon
+- On homepage load: if the stored game ID no longer exists or is not `in_progress`, clean up the session key
+- No migration of anonymous games on login — the anonymous game is lost when the user logs in. Acceptable since we don't save letter input.
+
+## Frontend
+
+### Template changes (`homepage/index.html.twig`)
+
+Three states:
+
+1. **No game in progress**: centered "Start a game" button (Twig form, POST to `/game/start`)
+2. **Game in progress**: action bar above the grid with an "Abandon" button (Twig form, POST to `/game/{id}/abandon` with CSRF token), then the React `GameGrid` component below
+3. **After abandon**: redirect to `/`, which shows state 1
+
+### React components
+
+No changes to `GameGrid`, `GameRow`, `LetterInput`, or `ActorPopover`. They receive the same props (`grid`, `width`, `middle`) — the data source changes from on-the-fly generation to database lookup.
+
+## Future Extensibility
+
+- **Win logic**: add `won` to the status enum, set `endedAt` on win
+- **Hints/clues per row**: add a relation on `GameRow` (e.g., `GameRowHint` entity)
+- **Game history/stats**: query `Game` entities by user with status filters

docs/superpowers/specs/2026-04-01-awards-bdd-design.md

@@ -0,0 +1,93 @@
+# Awards en BDD — Design Spec
+
+## Contexte
+
+Actuellement, les récompenses des acteurs sont récupérées à la volée depuis Wikidata (SPARQL) lors de la génération d'une partie. Elles ne sont pas persistées en base de données, ce qui rend le système fragile (dépendance réseau à chaque partie) et empêche tout filtrage par type de récompense.
+
+## Objectifs
+
+1. Stocker les awards en BDD dès l'import des films
+2. Introduire une notion de type de récompense (Oscar, Golden Globe, BAFTA...)
+3. Adapter la génération des indices pour piocher en BDD au lieu d'appeler Wikidata
+4. Préparer le terrain pour un futur filtrage par type (choix du joueur avant la partie) — hors scope de cette itération
+
+## Modèle de données
+
+### Nouvelle entité : `AwardType`
+
+| Champ     | Type       | Description                                                        |
+|-----------|------------|--------------------------------------------------------------------|
+| `id`      | int (PK)   | Auto-increment                                                     |
+| `name`    | string     | Nom affiché, ex: "Oscar", "Golden Globe", "BAFTA", "César"        |
+| `pattern` | string     | Préfixe/mot-clé pour le matching sur les noms Wikidata, ex: "Academy Award" |
+
+### Nouvelle entité : `Award`
+
+| Champ       | Type              | Description                                                  |
+|-------------|-------------------|--------------------------------------------------------------|
+| `id`        | int (PK)          | Auto-increment                                               |
+| `awardType` | ManyToOne → AwardType | Type de la récompense                                   |
+| `actor`     | ManyToOne → Actor | Acteur récompensé                                            |
+| `name`      | string            | Nom complet Wikidata, ex: "Academy Award for Best Actor"     |
+| `year`      | int (nullable)    | Année de la récompense                                       |
+
+### Modification entité `Actor`
+
+| Champ            | Type | Description                                      |
+|------------------|------|--------------------------------------------------|
+| `awardsImported` | bool | `false` par défaut. Passe à `true` après import. |
+
+### Relations
+
+- `Actor` OneToMany → `Award`
+- `AwardType` OneToMany → `Award`
+
+## Flux d'import des awards
+
+L'import se greffe sur le batch existant (`ImportFilmsBatchMessageHandler`), après `ActorSyncer::syncActorsForMovie()`.
+
+### Étapes pour chaque acteur du film importé
+
+1. Vérifier `actor.awardsImported`
+2. Si `true` → skip
+3. Si `false` → appeler `WikidataGateway::getAwards(actor)`
+4. Pour chaque award retourné :
+   - Parcourir les `AwardType` existants et matcher le nom de l'award contre leur `pattern`
+   - Si un `AwardType` matche → l'utiliser
+   - Si aucun ne matche → créer un nouvel `AwardType` dynamiquement en extrayant le préfixe commun du nom (ex: "Screen Actors Guild Award for Outstanding Performance..." → type "Screen Actors Guild Award")
+   - Créer l'entité `Award` (name, year, actor, awardType)
+5. Passer `actor.awardsImported = true`
+6. Flush
+
+### Gestion d'erreur
+
+Si Wikidata est indisponible ou retourne une erreur :
+- Ne **pas** mettre `awardsImported = true`
+- L'import du film continue normalement (les awards seront retentés au prochain import contenant cet acteur)
+- Log de l'erreur
+
+## Génération des indices (hints)
+
+### Changements dans `GameGridGenerator`
+
+**Avant** : appel à `WikidataGateway::getAwards()` à la volée pour chaque acteur du grid.
+
+**Après** :
+1. Pour un hint de type "award", requêter les `Award` en BDD pour l'acteur
+2. Si l'acteur a des awards → en choisir un au hasard
+3. Si l'acteur n'a pas d'awards → fallback sur les types "film" ou "character" (comportement existant quand Wikidata échouait)
+
+### Stockage du hint
+
+- `GameRow.hintData` stocke l'**ID de l'`Award`** (au lieu d'une string brute comme avant)
+- `resolveHintText()` récupère le nom complet + année depuis l'entité `Award`
+
+### Pas de filtrage par `AwardType`
+
+Pour cette itération, on pioche dans tous les awards de l'acteur sans filtrer par type. Le filtrage (choix du joueur : "mode Oscars", "mode Golden Globes"...) sera ajouté ultérieurement.
+
+## Hors scope
+
+- UI de choix du type de récompense avant la partie
+- Filtrage des awards par type lors de la génération des indices
+- Commande de re-sync des awards pour les acteurs déjà importés

docs/superpowers/specs/2026-04-01-game-config-panel-design.md

@@ -0,0 +1,119 @@
+# Game Configuration Panel
+
+## Summary
+
+Add a configuration panel above the "Commencer une partie" button on the homepage, allowing players to customize game generation parameters before starting.
+
+## Parameters
+
+### Films vus (toggle on/off)
+
+- **Visible only** for authenticated users
+- Default: off
+- When enabled: all actors in the grid (main actor + hint actors) must appear in at least one film marked as watched by the user
+- When disabled: no filtering, any actor can appear
+
+### Paramètres des indices (checkboxes)
+
+Three checkboxes controlling which hint types can appear in the grid:
+
+- **Film** (default: checked) — hint shows a film the actor appeared in
+- **Rôle** (default: checked) — hint shows a character name the actor played
+- **Récompense** (default: checked) — hint shows an award the actor received
+
+**Constraint:** at least one must remain checked. The UI prevents unchecking the last one.
+
+### Récompenses (multi-select checkboxes)
+
+- **Visible only** when "Récompense" is checked
+- Lists all `AwardType` entities that have 5+ distinct actors in the database
+- A "Toutes les récompenses" option at the top that toggles all
+- Default: all checked (= "Toutes" checked)
+- Unchecking an individual item unchecks "Toutes"; rechecking all rechecks "Toutes"
+- Selected AwardType IDs are sent as `award_types[]` in the form POST
+
+## UI Layout
+
+```
+┌─────────────────────────────────┐
+│  Films vus         [ toggle ]   │  ← auth users only
+├─────────────────────────────────┤
+│  Paramètres des indices         │
+│                                 │
+│  ☑ Film   ☑ Rôle   ☑ Récompense│
+│                                 │
+│  Récompenses :                  │  ← visible if Récompense checked
+│  ┌───────────────────────┐      │
+│  │ ☑ Toutes les récomp.  │      │
+│  │ ☑ Academy Awards      │      │
+│  │ ☑ Golden Globes       │      │
+│  │ ☑ César               │      │
+│  │ ...                   │      │
+│  └───────────────────────┘      │
+├─────────────────────────────────┤
+│    [ Commencer une partie ]     │
+│                                 │
+│  Connectez-vous pour importer...│
+└─────────────────────────────────┘
+```
+
+## Form Fields
+
+All parameters are fields within the existing start game `<form>`:
+
+| Field name | Type | Value |
+|---|---|---|
+| `watched_only` | hidden + checkbox | `"1"` if checked, absent otherwise |
+| `hint_film` | checkbox | `"1"` if checked |
+| `hint_character` | checkbox | `"1"` if checked |
+| `hint_award` | checkbox | `"1"` if checked |
+| `award_types[]` | checkbox (multiple) | Array of AwardType IDs |
+
+## Backend Changes
+
+### HomepageController
+
+- Query `AwardTypeRepository::findWithMinActors(5)` to get eligible AwardType list
+- Pass to template for rendering the multi-select
+
+### GameController (POST /game/start)
+
+- Extract config parameters from the Request
+- Pass config to `GameGridProvider::generate()`
+
+### GameGridProvider::generate()
+
+Receives a config array/object with:
+
+- `watchedOnly` (bool) — filter actors to those in user's watched films
+- `hintTypes` (array) — subset of `['film', 'character', 'award']` based on checked boxes
+- `awardTypeIds` (array|null) — list of selected AwardType IDs, null = all
+
+Generation logic changes:
+
+- **Actor selection:** if `watchedOnly` is true, only pick actors with a MovieRole in a film watched by the authenticated user
+- **Hint selection:** only use hint types present in `hintTypes`
+- **Award hints:** only pick awards whose AwardType ID is in `awardTypeIds`
+- **Retry mechanism:** if generation fails (cannot find a valid hint for every row), retry up to 5 times. After 5 failures, redirect to homepage with a flash error message explaining the grid could not be generated with the chosen parameters.
+
+### AwardTypeRepository
+
+New method: `findWithMinActors(int $minActors): array` — returns AwardType entities having at least `$minActors` distinct actors.
+
+## Frontend Changes
+
+### Stimulus controller: `game-config`
+
+Registered on the config panel container. Handles:
+
+1. **Award section visibility:** show/hide the AwardType checkbox list when "Récompense" is toggled
+2. **Minimum one hint type:** prevent unchecking the last remaining hint checkbox
+3. **"Toutes les récompenses" toggle:** check/uncheck all AwardType checkboxes; sync state when individual items change
+
+### CSS (in app.css)
+
+- **Toggle switch:** CSS-only using `appearance: none` on checkbox, `::before` pseudo-element for the sliding circle, `--orange` when active, `--border` when inactive
+- **Hint checkboxes:** `accent-color: var(--orange)`
+- **AwardType list:** border `var(--border)`, `border-radius: var(--radius-sm)`, `max-height: 150px`, `overflow-y: auto`
+- **Section labels:** `color: var(--text-muted)`, `font-size: 13px`, `text-transform: uppercase`
+- No new CSS or JS files — everything in existing `app.css` and a new Stimulus controller file

migrations/Version20260330174355.php

@@ -0,0 +1,57 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DoctrineMigrations;
+
+use Doctrine\DBAL\Schema\Schema;
+use Doctrine\Migrations\AbstractMigration;
+
+/**
+ * Auto-generated Migration: Please modify to your needs!
+ */
+final class Version20260330174355 extends AbstractMigration
+{
+    public function getDescription(): string
+    {
+        return '';
+    }
+
+    public function up(Schema $schema): void
+    {
+        // this up() migration is auto-generated, please modify it to your needs
+        $this->addSql('CREATE TABLE game (id INT GENERATED BY DEFAULT AS IDENTITY NOT NULL, status VARCHAR(20) NOT NULL, started_at TIMESTAMP(0) WITHOUT TIME ZONE NOT NULL, ended_at TIMESTAMP(0) WITHOUT TIME ZONE DEFAULT NULL, user_id INT DEFAULT NULL, main_actor_id INT NOT NULL, PRIMARY KEY (id))');
+        $this->addSql('CREATE INDEX IDX_232B318CA76ED395 ON game (user_id)');
+        $this->addSql('CREATE INDEX IDX_232B318CC9F8E33F ON game (main_actor_id)');
+        $this->addSql('CREATE TABLE game_row (id INT GENERATED BY DEFAULT AS IDENTITY NOT NULL, position INT NOT NULL, row_order INT NOT NULL, game_id INT NOT NULL, actor_id INT NOT NULL, PRIMARY KEY (id))');
+        $this->addSql('CREATE INDEX IDX_9F6AE51EE48FD905 ON game_row (game_id)');
+        $this->addSql('CREATE INDEX IDX_9F6AE51E10DAF24A ON game_row (actor_id)');
+        $this->addSql('ALTER TABLE game ADD CONSTRAINT FK_232B318CA76ED395 FOREIGN KEY (user_id) REFERENCES "user" (id) NOT DEFERRABLE');
+        $this->addSql('ALTER TABLE game ADD CONSTRAINT FK_232B318CC9F8E33F FOREIGN KEY (main_actor_id) REFERENCES actor (id) NOT DEFERRABLE');
+        $this->addSql('ALTER TABLE game_row ADD CONSTRAINT FK_9F6AE51EE48FD905 FOREIGN KEY (game_id) REFERENCES game (id) NOT DEFERRABLE');
+        $this->addSql('ALTER TABLE game_row ADD CONSTRAINT FK_9F6AE51E10DAF24A FOREIGN KEY (actor_id) REFERENCES actor (id) NOT DEFERRABLE');
+        $this->addSql('COMMENT ON COLUMN import.created_at IS \'\'');
+        $this->addSql('COMMENT ON COLUMN import.completed_at IS \'\'');
+        $this->addSql('ALTER TABLE notification ALTER is_read DROP DEFAULT');
+        $this->addSql('COMMENT ON COLUMN notification.created_at IS \'\'');
+        $this->addSql('ALTER INDEX idx_a6b68b33a76ed395 RENAME TO IDX_FF9C0937A76ED395');
+        $this->addSql('ALTER INDEX idx_a6b68b338f93b6fc RENAME TO IDX_FF9C09378F93B6FC');
+    }
+
+    public function down(Schema $schema): void
+    {
+        // this down() migration is auto-generated, please modify it to your needs
+        $this->addSql('ALTER TABLE game DROP CONSTRAINT FK_232B318CA76ED395');
+        $this->addSql('ALTER TABLE game DROP CONSTRAINT FK_232B318CC9F8E33F');
+        $this->addSql('ALTER TABLE game_row DROP CONSTRAINT FK_9F6AE51EE48FD905');
+        $this->addSql('ALTER TABLE game_row DROP CONSTRAINT FK_9F6AE51E10DAF24A');
+        $this->addSql('DROP TABLE game');
+        $this->addSql('DROP TABLE game_row');
+        $this->addSql('COMMENT ON COLUMN import.created_at IS \'(DC2Type:datetime_immutable)\'');
+        $this->addSql('COMMENT ON COLUMN import.completed_at IS \'(DC2Type:datetime_immutable)\'');
+        $this->addSql('ALTER TABLE notification ALTER is_read SET DEFAULT false');
+        $this->addSql('COMMENT ON COLUMN notification.created_at IS \'(DC2Type:datetime_immutable)\'');
+        $this->addSql('ALTER INDEX idx_ff9c09378f93b6fc RENAME TO idx_a6b68b338f93b6fc');
+        $this->addSql('ALTER INDEX idx_ff9c0937a76ed395 RENAME TO idx_a6b68b33a76ed395');
+    }
+}

migrations/Version20260330203017.php

@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DoctrineMigrations;
+
+use Doctrine\DBAL\Schema\Schema;
+use Doctrine\Migrations\AbstractMigration;
+
+/**
+ * Auto-generated Migration: Please modify to your needs!
+ */
+final class Version20260330203017 extends AbstractMigration
+{
+    public function getDescription(): string
+    {
+        return '';
+    }
+
+    public function up(Schema $schema): void
+    {
+        // this up() migration is auto-generated, please modify it to your needs
+        $this->addSql('ALTER TABLE game_row ADD hint_type VARCHAR(20) DEFAULT NULL');
+        $this->addSql('ALTER TABLE game_row ADD hint_data VARCHAR(255) DEFAULT NULL');
+    }
+
+    public function down(Schema $schema): void
+    {
+        // this down() migration is auto-generated, please modify it to your needs
+        $this->addSql('ALTER TABLE game_row DROP hint_type');
+        $this->addSql('ALTER TABLE game_row DROP hint_data');
+    }
+}

migrations/Version20260331000001.php

@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DoctrineMigrations;
+
+use Doctrine\DBAL\Schema\Schema;
+use Doctrine\Migrations\AbstractMigration;
+
+final class Version20260331000001 extends AbstractMigration
+{
+    public function getDescription(): string
+    {
+        return 'Drop notification table';
+    }
+
+    public function up(Schema $schema): void
+    {
+        $this->addSql('DROP TABLE IF EXISTS notification');
+    }
+
+    public function down(Schema $schema): void
+    {
+        $this->addSql(<<<'SQL'
+            CREATE TABLE notification (
+                id SERIAL PRIMARY KEY,
+                user_id INT NOT NULL REFERENCES "user"(id),
+                message VARCHAR(255) NOT NULL,
+                is_read BOOLEAN NOT NULL DEFAULT FALSE,
+                created_at TIMESTAMP(0) WITHOUT TIME ZONE NOT NULL
+            )
+        SQL);
+        $this->addSql('COMMENT ON COLUMN notification.created_at IS \'(DC2Type:datetime_immutable)\'');
+    }
+}

migrations/Version20260331000002.php

@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DoctrineMigrations;
+
+use Doctrine\DBAL\Schema\Schema;
+use Doctrine\Migrations\AbstractMigration;
+
+final class Version20260331000002 extends AbstractMigration
+{
+    public function getDescription(): string
+    {
+        return 'Add year column to movie table';
+    }
+
+    public function up(Schema $schema): void
+    {
+        $this->addSql('ALTER TABLE movie ADD year INT DEFAULT NULL');
+    }
+
+    public function down(Schema $schema): void
+    {
+        $this->addSql('ALTER TABLE movie DROP COLUMN year');
+    }
+}

migrations/Version20260401000001.php

@@ -0,0 +1,32 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DoctrineMigrations;
+
+use Doctrine\DBAL\Schema\Schema;
+use Doctrine\Migrations\AbstractMigration;
+
+final class Version20260401000001 extends AbstractMigration
+{
+    public function getDescription(): string
+    {
+        return 'Add award_type, award tables and actor.awards_imported column';
+    }
+
+    public function up(Schema $schema): void
+    {
+        $this->addSql('CREATE TABLE award_type (id SERIAL PRIMARY KEY, name VARCHAR(255) NOT NULL, pattern VARCHAR(255) NOT NULL)');
+        $this->addSql('CREATE TABLE award (id SERIAL PRIMARY KEY, award_type_id INT NOT NULL, actor_id INT NOT NULL, name VARCHAR(255) NOT NULL, year INT DEFAULT NULL, CONSTRAINT fk_award_award_type FOREIGN KEY (award_type_id) REFERENCES award_type (id), CONSTRAINT fk_award_actor FOREIGN KEY (actor_id) REFERENCES actor (id))');
+        $this->addSql('CREATE INDEX idx_award_award_type ON award (award_type_id)');
+        $this->addSql('CREATE INDEX idx_award_actor ON award (actor_id)');
+        $this->addSql('ALTER TABLE actor ADD awards_imported BOOLEAN NOT NULL DEFAULT false');
+    }
+
+    public function down(Schema $schema): void
+    {
+        $this->addSql('DROP TABLE award');
+        $this->addSql('DROP TABLE award_type');
+        $this->addSql('ALTER TABLE actor DROP COLUMN awards_imported');
+    }
+}

migrations/Version20260401000002.php

@@ -0,0 +1,30 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DoctrineMigrations;
+
+use Doctrine\DBAL\Schema\Schema;
+use Doctrine\Migrations\AbstractMigration;
+
+final class Version20260401000002 extends AbstractMigration
+{
+    public function getDescription(): string
+    {
+        return 'Add processed_films column to import table';
+    }
+
+    public function up(Schema $schema): void
+    {
+        $this->addSql('ALTER TABLE import ADD processed_films INT NOT NULL DEFAULT 0');
+        $this->addSql('ALTER TABLE import DROP COLUMN total_batches');
+        $this->addSql('ALTER TABLE import DROP COLUMN processed_batches');
+    }
+
+    public function down(Schema $schema): void
+    {
+        $this->addSql('ALTER TABLE import DROP COLUMN processed_films');
+        $this->addSql('ALTER TABLE import ADD total_batches INT NOT NULL DEFAULT 0');
+        $this->addSql('ALTER TABLE import ADD processed_batches INT NOT NULL DEFAULT 0');
+    }
+}

package-lock.json

@@ -7,6 +7,7 @@
       "name": "ltbxd-actorle",
       "dependencies": {
         "@floating-ui/react": "^0.27",
+        "@fortawesome/fontawesome-free": "^7.2.0",
         "@hotwired/stimulus": "^3.2",
         "@hotwired/turbo": "^7.3",
         "@symfony/stimulus-bundle": "file:vendor/symfony/stimulus-bundle/assets",
@@ -952,6 +953,15 @@
       "integrity": "sha512-RiB/yIh78pcIxl6lLMG0CgBXAZ2Y0eVHqMPYugu+9U0AeT6YBeiJpf7lbdJNIugFP5SIjwNRgo4DhR1Qxi26Gg==",
       "license": "MIT"
     },
+    "node_modules/@fortawesome/fontawesome-free": {
+      "version": "7.2.0",
+      "resolved": "https://registry.npmjs.org/@fortawesome/fontawesome-free/-/fontawesome-free-7.2.0.tgz",
+      "integrity": "sha512-3DguDv/oUE+7vjMeTSOjCSG+KeawgVQOHrKRnvUuqYh1mfArrh7s+s8hXW3e4RerBA1+Wh+hBqf8sJNpqNrBWg==",
+      "license": "(CC-BY-4.0 AND OFL-1.1 AND MIT)",
+      "engines": {
+        "node": ">=6"
+      }
+    },
     "node_modules/@hotwired/stimulus": {
       "version": "3.2.2",
       "resolved": "https://registry.npmjs.org/@hotwired/stimulus/-/stimulus-3.2.2.tgz",

package.json

@@ -7,6 +7,7 @@
   },
   "dependencies": {
     "@floating-ui/react": "^0.27",
+    "@fortawesome/fontawesome-free": "^7.2.0",
     "@hotwired/stimulus": "^3.2",
     "@hotwired/turbo": "^7.3",
     "@symfony/stimulus-bundle": "file:vendor/symfony/stimulus-bundle/assets",

src/Command/SyncActorsCommand.php

@@ -1,37 +0,0 @@
-<?php
-
-namespace App\Command;
-
-use App\Entity\Movie;
-use App\Exception\GatewayException;
-use App\Service\ActorSyncer;
-use Doctrine\ORM\EntityManagerInterface;
-use Symfony\Component\Console\Attribute\AsCommand;
-use Symfony\Component\Console\Command\Command;
-use Symfony\Component\Console\Output\OutputInterface;
-
-#[AsCommand('app:sync-actors')]
-readonly class SyncActorsCommand
-{
-    public function __construct(
-        private ActorSyncer $actorSyncer,
-        private EntityManagerInterface $em,
-    ) {}
-
-    public function __invoke(OutputInterface $output): int
-    {
-        foreach ($this->em->getRepository(Movie::class)->findAll() as $film) {
-            try {
-                $output->writeln('Syncing cast for '.$film->getTitle());
-                $this->actorSyncer->syncActorsForMovie($film);
-            } catch (GatewayException $e) {
-                $output->writeln('/!\ '.$e->getMessage());
-                continue;
-            }
-
-            $this->em->flush();
-        }
-
-        return Command::SUCCESS;
-    }
-}

src/Command/SyncFilmsCommands.php

@@ -1,57 +0,0 @@
-<?php
-
-namespace App\Command;
-
-use App\Exception\GatewayException;
-use App\Gateway\LtbxdGateway;
-use App\Service\FilmImporter;
-use Doctrine\ORM\EntityManagerInterface;
-use Symfony\Component\Console\Attribute\AsCommand;
-use Symfony\Component\Console\Command\Command;
-use Symfony\Component\Console\Output\OutputInterface;
-
-#[AsCommand('app:sync-films')]
-readonly class SyncFilmsCommands
-{
-    public function __construct(
-        private LtbxdGateway $ltbxdGateway,
-        private FilmImporter $filmImporter,
-        private EntityManagerInterface $em,
-    ) {}
-
-    public function __invoke(OutputInterface $output): int
-    {
-        try {
-            $ltbxdMovies = $this->ltbxdGateway->parseFile();
-        } catch (GatewayException $e) {
-            $output->writeln('/!\ '.$e->getMessage());
-
-            return Command::FAILURE;
-        }
-
-        $i = 0;
-        foreach ($ltbxdMovies as $ltbxdMovie) {
-            try {
-                $movie = $this->filmImporter->importFromLtbxdMovie($ltbxdMovie);
-                if ($movie) {
-                    $output->writeln('* Found '.$ltbxdMovie->getName());
-                }
-            } catch (GatewayException $e) {
-                $output->writeln('/!\ '.$e->getMessage());
-
-                return Command::FAILURE;
-            }
-
-            ++$i;
-            if (0 === $i % 50) {
-                $this->em->flush();
-            }
-        }
-
-        $this->em->flush();
-
-        $output->writeln('Films synced');
-
-        return Command::SUCCESS;
-    }
-}

src/Controller/GameController.php

@@ -0,0 +1,127 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Controller;
+
+use App\Entity\Game;
+use App\Entity\User;
+use App\Repository\GameRepository;
+use App\Provider\GameGridProvider;
+use Doctrine\ORM\EntityManagerInterface;
+use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+use Symfony\Component\HttpFoundation\Request;
+use Symfony\Component\HttpFoundation\Response;
+use Symfony\Component\Routing\Attribute\Route;
+
+class GameController extends AbstractController
+{
+    #[Route('/game/start', name: 'app_game_start', methods: ['POST'])]
+    public function start(
+        Request $request,
+        GameGridProvider $generator,
+        GameRepository $gameRepository,
+    ): Response {
+        $this->validateCsrfToken('game_start', $request);
+
+        /** @var User|null $user */
+        $user = $this->getUser();
+
+        // Check no game already in progress
+        if ($user) {
+            $existing = $gameRepository->findActiveForUser($user);
+        } else {
+            $gameId = $request->getSession()->get('current_game_id');
+            $existing = $gameId ? $gameRepository->find($gameId) : null;
+            if ($existing && $existing->getStatus() !== Game::STATUS_IN_PROGRESS) {
+                $existing = null;
+            }
+        }
+
+        if ($existing) {
+            return $this->redirectToRoute('app_homepage');
+        }
+
+        // Build config from form parameters
+        $config = [];
+
+        if ($user && $request->request->getBoolean('watched_only')) {
+            $config['watchedOnly'] = true;
+        }
+
+        $hintTypes = [];
+        if ($request->request->getBoolean('hint_film', true)) {
+            $hintTypes[] = 'film';
+        }
+        if ($request->request->getBoolean('hint_character', true)) {
+            $hintTypes[] = 'character';
+        }
+        if ($request->request->getBoolean('hint_award', true)) {
+            $hintTypes[] = 'award';
+        }
+        if (empty($hintTypes)) {
+            $hintTypes = ['film', 'character', 'award'];
+        }
+        $config['hintTypes'] = $hintTypes;
+
+        /** @var list<string> $awardTypeIds */
+        $awardTypeIds = $request->request->all('award_types');
+        if (!empty($awardTypeIds) && in_array('award', $hintTypes)) {
+            $config['awardTypeIds'] = array_map('intval', $awardTypeIds);
+        }
+
+        $game = $generator->generate($user, $config);
+
+        if ($game === null) {
+            $this->addFlash('error', 'Impossible de générer une grille avec ces paramètres. Essayez avec des critères moins restrictifs.');
+            return $this->redirectToRoute('app_homepage');
+        }
+
+        if (!$user) {
+            $request->getSession()->set('current_game_id', $game->getId());
+        }
+
+        return $this->redirectToRoute('app_homepage');
+    }
+
+    #[Route('/game/{id}/abandon', name: 'app_game_abandon', methods: ['POST'])]
+    public function abandon(
+        Game $game,
+        Request $request,
+        EntityManagerInterface $em,
+    ): Response {
+        $this->validateCsrfToken('game_abandon', $request);
+
+        /** @var User|null $user */
+        $user = $this->getUser();
+
+        // Verify ownership
+        if ($user) {
+            if ($game->getUser() !== $user) {
+                throw $this->createAccessDeniedException();
+            }
+        } else {
+            $sessionGameId = $request->getSession()->get('current_game_id');
+            if ($game->getId() !== $sessionGameId) {
+                throw $this->createAccessDeniedException();
+            }
+        }
+
+        $game->abandon();
+        $em->flush();
+
+        if (!$user) {
+            $request->getSession()->remove('current_game_id');
+        }
+
+        return $this->redirectToRoute('app_homepage');
+    }
+
+    private function validateCsrfToken(string $tokenId, Request $request): void
+    {
+        $token = $request->request->get('_token');
+        if (!$this->isCsrfTokenValid($tokenId, $token)) {
+            throw $this->createAccessDeniedException('Invalid CSRF token.');
+        }
+    }
+}

src/Controller/HomepageController.php

@@ -4,77 +4,57 @@ declare(strict_types=1);
 
 namespace App\Controller;
 
-use App\Gateway\TMDBGateway;
-use App\Repository\ActorRepository;
-use App\Repository\MovieRepository;
+use App\Entity\Game;
+use App\Entity\User;
+use App\Repository\AwardTypeRepository;
+use App\Repository\GameRepository;
+use App\Provider\GameGridProvider;
 use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+use Symfony\Component\HttpFoundation\Request;
 use Symfony\Component\HttpFoundation\Response;
 use Symfony\Component\Routing\Attribute\Route;
-use Symfony\Component\Serializer\SerializerInterface;
 
 class HomepageController extends AbstractController
 {
-    public function __construct(
-        private readonly ActorRepository $actorRepository
-    ) {}
-
     #[Route('/', name: 'app_homepage')]
-    public function index(SerializerInterface $serializer): Response
-    {
-        // Final actor to be guessed
-        $mainActor = $this->actorRepository->findOneRandom(4);
+    public function index(
+        Request $request,
+        GameRepository $gameRepository,
+        GameGridProvider $gridGenerator,
+        AwardTypeRepository $awardTypeRepository,
+    ): Response {
+        /** @var User|null $user */
+        $user = $this->getUser();
 
-        // Actors for the grid
-        $actors = [];
-        $leftSize = 0;
-        $rightSize = 0;
-        foreach (str_split(strtolower($mainActor->getName())) as $char) {
-            if (!preg_match('/[a-z]/', $char)) {
-                continue;
+        $game = null;
+
+        if ($user) {
+            $game = $gameRepository->findActiveForUser($user);
+        } else {
+            $gameId = $request->getSession()->get('current_game_id');
+            if ($gameId) {
+                $game = $gameRepository->find($gameId);
+                if (!$game || $game->getStatus() !== Game::STATUS_IN_PROGRESS) {
+                    $request->getSession()->remove('current_game_id');
+                    $game = null;
+                }
             }
-
-            $tryFindActor = 0;
-            do {
-                $actor = $this->actorRepository->findOneRandom(4, $char);
-                ++$tryFindActor;
-            } while (
-                $actor === $mainActor
-                || in_array($actor, array_map(fn ($actorMap) => $actorMap['actor'], $actors))
-                || $tryFindActor < 5
-            );
-
-            $actorData = [
-                'actor' => $actor,
-                'pos' => strpos($actor->getName(), $char),
-            ];
-
-            if ($leftSize < $actorData['pos']) {
-                $leftSize = $actorData['pos'];
-            }
-
-            $rightSizeActor = strlen($actor->getName()) - $actorData['pos'] - 1;
-            if ($rightSize < $rightSizeActor) {
-                $rightSize = $rightSizeActor;
-            }
-
-            $actors[] = $actorData;
         }
 
-        // Predict grid size
-        $width = $rightSize + $leftSize + 1;
-        $middle = $leftSize;
+        if (!$game) {
+            return $this->render('homepage/index.html.twig', [
+                'game' => null,
+                'awardTypes' => $awardTypeRepository->findWithMinActors(5),
+            ]);
+        }
 
-        // Build JSON-serializable grid for React
-        $grid = array_map(fn (array $actorData) => [
-            'actorName' => $actorData['actor']->getName(),
-            'actorId' => $actorData['actor']->getId(),
-            'pos' => $actorData['pos'],
-        ], $actors);
+        $gridData = $gridGenerator->computeGridData($game);
 
         return $this->render('homepage/index.html.twig', [
-            'grid' => $grid,
-            'width' => $width,
-            'middle' => $middle,
+            'game' => $game,
+            'grid' => $gridData['grid'],
+            'width' => $gridData['width'],
+            'middle' => $gridData['middle'],
         ]);
     }
 }

src/Controller/ImportController.php

@@ -7,6 +7,7 @@ namespace App\Controller;
 use App\Entity\Import;
 use App\Entity\User;
 use App\Message\ProcessImportMessage;
+use App\Repository\ImportRepository;
 use Doctrine\ORM\EntityManagerInterface;
 use League\Flysystem\FilesystemOperator;
 use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
@@ -19,14 +20,44 @@ use Symfony\Component\Security\Http\Attribute\IsGranted;
 
 class ImportController extends AbstractController
 {
+    #[Route('/api/imports/latest', methods: ['GET'])]
+    #[IsGranted('ROLE_USER')]
+    public function latest(ImportRepository $importRepository): JsonResponse
+    {
+        /** @var User $user */
+        $user = $this->getUser();
+
+        $import = $importRepository->findLatestForUser($user);
+
+        if (!$import) {
+            return $this->json(null);
+        }
+
+        return $this->json([
+            'id' => $import->getId(),
+            'status' => $import->getStatus(),
+            'totalFilms' => $import->getTotalFilms(),
+            'processedFilms' => $import->getProcessedFilms(),
+            'failedFilms' => $import->getFailedFilms(),
+        ]);
+    }
+
     #[Route('/api/imports', methods: ['POST'])]
     #[IsGranted('ROLE_USER')]
     public function create(
         Request $request,
         FilesystemOperator $defaultStorage,
         EntityManagerInterface $em,
+        ImportRepository $importRepository,
         MessageBusInterface $bus,
     ): JsonResponse {
+        /** @var User $user */
+        $user = $this->getUser();
+
+        if ($importRepository->hasActiveImport($user)) {
+            return $this->json(['error' => 'Un import est déjà en cours.'], Response::HTTP_CONFLICT);
+        }
+
         $file = $request->files->get('file');
 
         if (!$file) {
@@ -41,9 +72,6 @@ class ImportController extends AbstractController
             return $this->json(['error' => 'File too large (max 5 MB).'], Response::HTTP_UNPROCESSABLE_ENTITY);
         }
 
-        /** @var User $user */
-        $user = $this->getUser();
-
         $import = new Import();
         $import->setUser($user);
         $import->setFilePath('pending');

src/Controller/NotificationController.php

@@ -1,49 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Controller;
-
-use App\Entity\User;
-use App\Repository\NotificationRepository;
-use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-use Symfony\Component\HttpFoundation\JsonResponse;
-use Symfony\Component\HttpFoundation\Response;
-use Symfony\Component\Routing\Attribute\Route;
-use Symfony\Component\Security\Http\Attribute\IsGranted;
-
-class NotificationController extends AbstractController
-{
-    #[Route('/api/notifications', methods: ['GET'])]
-    #[IsGranted('ROLE_USER')]
-    public function index(NotificationRepository $notificationRepository): JsonResponse
-    {
-        /** @var User $user */
-        $user = $this->getUser();
-
-        $notifications = $notificationRepository->findRecentForUser($user);
-        $unreadCount = $notificationRepository->countUnreadForUser($user);
-
-        return $this->json([
-            'unreadCount' => $unreadCount,
-            'notifications' => array_map(fn ($n) => [
-                'id' => $n->getId(),
-                'message' => $n->getMessage(),
-                'read' => $n->isRead(),
-                'createdAt' => $n->getCreatedAt()->format('c'),
-            ], $notifications),
-        ]);
-    }
-
-    #[Route('/api/notifications/read', methods: ['POST'])]
-    #[IsGranted('ROLE_USER')]
-    public function markRead(NotificationRepository $notificationRepository): Response
-    {
-        /** @var User $user */
-        $user = $this->getUser();
-
-        $notificationRepository->markAllReadForUser($user);
-
-        return new Response('', Response::HTTP_NO_CONTENT);
-    }
-}

src/Entity/Actor.php

@@ -30,9 +30,17 @@ class Actor
     #[ORM\Column(nullable: true)]
     private ?int $tmdbId = null;
 
+    #[ORM\Column(options: ['default' => false])]
+    private bool $awardsImported = false;
+
+    /** @var Collection<int, Award> */
+    #[ORM\OneToMany(targetEntity: Award::class, mappedBy: 'actor')]
+    private Collection $awards;
+
     public function __construct()
     {
         $this->movieRoles = new ArrayCollection();
+        $this->awards = new ArrayCollection();
     }
 
     public function getId(): ?int
@@ -105,4 +113,22 @@ class Actor
 
         return $this;
     }
+
+    public function isAwardsImported(): bool
+    {
+        return $this->awardsImported;
+    }
+
+    public function setAwardsImported(bool $awardsImported): static
+    {
+        $this->awardsImported = $awardsImported;
+
+        return $this;
+    }
+
+    /** @return Collection<int, Award> */
+    public function getAwards(): Collection
+    {
+        return $this->awards;
+    }
 }

src/Entity/Award.php

@@ -0,0 +1,84 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Entity;
+
+use App\Repository\AwardRepository;
+use Doctrine\ORM\Mapping as ORM;
+
+#[ORM\Entity(repositoryClass: AwardRepository::class)]
+class Award
+{
+    #[ORM\Id]
+    #[ORM\GeneratedValue]
+    #[ORM\Column]
+    private ?int $id = null;
+
+    #[ORM\ManyToOne(targetEntity: AwardType::class, inversedBy: 'awards')]
+    #[ORM\JoinColumn(nullable: false)]
+    private AwardType $awardType;
+
+    #[ORM\ManyToOne(targetEntity: Actor::class, inversedBy: 'awards')]
+    #[ORM\JoinColumn(nullable: false)]
+    private Actor $actor;
+
+    #[ORM\Column(length: 255)]
+    private string $name;
+
+    #[ORM\Column(nullable: true)]
+    private ?int $year = null;
+
+    public function getId(): ?int
+    {
+        return $this->id;
+    }
+
+    public function getAwardType(): AwardType
+    {
+        return $this->awardType;
+    }
+
+    public function setAwardType(AwardType $awardType): static
+    {
+        $this->awardType = $awardType;
+
+        return $this;
+    }
+
+    public function getActor(): Actor
+    {
+        return $this->actor;
+    }
+
+    public function setActor(Actor $actor): static
+    {
+        $this->actor = $actor;
+
+        return $this;
+    }
+
+    public function getName(): string
+    {
+        return $this->name;
+    }
+
+    public function setName(string $name): static
+    {
+        $this->name = $name;
+
+        return $this;
+    }
+
+    public function getYear(): ?int
+    {
+        return $this->year;
+    }
+
+    public function setYear(?int $year): static
+    {
+        $this->year = $year;
+
+        return $this;
+    }
+}

src/Entity/AwardType.php

@@ -0,0 +1,69 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Entity;
+
+use App\Repository\AwardTypeRepository;
+use Doctrine\Common\Collections\ArrayCollection;
+use Doctrine\Common\Collections\Collection;
+use Doctrine\ORM\Mapping as ORM;
+
+#[ORM\Entity(repositoryClass: AwardTypeRepository::class)]
+class AwardType
+{
+    #[ORM\Id]
+    #[ORM\GeneratedValue]
+    #[ORM\Column]
+    private ?int $id = null;
+
+    #[ORM\Column(length: 255)]
+    private string $name;
+
+    #[ORM\Column(length: 255)]
+    private string $pattern;
+
+    /** @var Collection<int, Award> */
+    #[ORM\OneToMany(targetEntity: Award::class, mappedBy: 'awardType')]
+    private Collection $awards;
+
+    public function __construct()
+    {
+        $this->awards = new ArrayCollection();
+    }
+
+    public function getId(): ?int
+    {
+        return $this->id;
+    }
+
+    public function getName(): string
+    {
+        return $this->name;
+    }
+
+    public function setName(string $name): static
+    {
+        $this->name = $name;
+
+        return $this;
+    }
+
+    public function getPattern(): string
+    {
+        return $this->pattern;
+    }
+
+    public function setPattern(string $pattern): static
+    {
+        $this->pattern = $pattern;
+
+        return $this;
+    }
+
+    /** @return Collection<int, Award> */
+    public function getAwards(): Collection
+    {
+        return $this->awards;
+    }
+}

src/Entity/Game.php

@@ -0,0 +1,132 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Entity;
+
+use App\Repository\GameRepository;
+use Doctrine\Common\Collections\ArrayCollection;
+use Doctrine\Common\Collections\Collection;
+use Doctrine\ORM\Mapping as ORM;
+
+#[ORM\Entity(repositoryClass: GameRepository::class)]
+class Game
+{
+    public const string STATUS_IN_PROGRESS = 'in_progress';
+    public const string STATUS_ABANDONED = 'abandoned';
+
+    #[ORM\Id]
+    #[ORM\GeneratedValue]
+    #[ORM\Column]
+    private ?int $id = null;
+
+    #[ORM\ManyToOne(targetEntity: User::class)]
+    #[ORM\JoinColumn(nullable: true)]
+    private ?User $user = null;
+
+    #[ORM\ManyToOne(targetEntity: Actor::class)]
+    #[ORM\JoinColumn(nullable: false)]
+    private ?Actor $mainActor = null;
+
+    #[ORM\Column(length: 20)]
+    private string $status = self::STATUS_IN_PROGRESS;
+
+    #[ORM\Column]
+    private \DateTimeImmutable $startedAt;
+
+    #[ORM\Column(nullable: true)]
+    private ?\DateTimeImmutable $endedAt = null;
+
+    /** @var Collection<int, GameRow> */
+    #[ORM\OneToMany(targetEntity: GameRow::class, mappedBy: 'game', cascade: ['persist'], orphanRemoval: true)]
+    #[ORM\OrderBy(['rowOrder' => 'ASC'])]
+    private Collection $rows;
+
+    public function __construct()
+    {
+        $this->startedAt = new \DateTimeImmutable();
+        $this->rows = new ArrayCollection();
+    }
+
+    public function getId(): ?int
+    {
+        return $this->id;
+    }
+
+    public function getUser(): ?User
+    {
+        return $this->user;
+    }
+
+    public function setUser(?User $user): static
+    {
+        $this->user = $user;
+
+        return $this;
+    }
+
+    public function getMainActor(): ?Actor
+    {
+        return $this->mainActor;
+    }
+
+    public function setMainActor(Actor $mainActor): static
+    {
+        $this->mainActor = $mainActor;
+
+        return $this;
+    }
+
+    public function getStatus(): string
+    {
+        return $this->status;
+    }
+
+    public function setStatus(string $status): static
+    {
+        $this->status = $status;
+
+        return $this;
+    }
+
+    public function getStartedAt(): \DateTimeImmutable
+    {
+        return $this->startedAt;
+    }
+
+    public function getEndedAt(): ?\DateTimeImmutable
+    {
+        return $this->endedAt;
+    }
+
+    public function setEndedAt(?\DateTimeImmutable $endedAt): static
+    {
+        $this->endedAt = $endedAt;
+
+        return $this;
+    }
+
+    /** @return Collection<int, GameRow> */
+    public function getRows(): Collection
+    {
+        return $this->rows;
+    }
+
+    public function addRow(GameRow $row): static
+    {
+        if (!$this->rows->contains($row)) {
+            $this->rows->add($row);
+            $row->setGame($this);
+        }
+
+        return $this;
+    }
+
+    public function abandon(): static
+    {
+        $this->status = self::STATUS_ABANDONED;
+        $this->endedAt = new \DateTimeImmutable();
+
+        return $this;
+    }
+}

src/Entity/GameRow.php

@@ -0,0 +1,114 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Entity;
+
+use App\Repository\GameRowRepository;
+use Doctrine\ORM\Mapping as ORM;
+
+#[ORM\Entity(repositoryClass: GameRowRepository::class)]
+class GameRow
+{
+    #[ORM\Id]
+    #[ORM\GeneratedValue]
+    #[ORM\Column]
+    private ?int $id = null;
+
+    #[ORM\ManyToOne(targetEntity: Game::class, inversedBy: 'rows')]
+    #[ORM\JoinColumn(nullable: false)]
+    private ?Game $game = null;
+
+    #[ORM\ManyToOne(targetEntity: Actor::class)]
+    #[ORM\JoinColumn(nullable: false)]
+    private ?Actor $actor = null;
+
+    #[ORM\Column]
+    private int $position;
+
+    #[ORM\Column]
+    private int $rowOrder;
+
+    #[ORM\Column(length: 20, nullable: true)]
+    private ?string $hintType = null;
+
+    #[ORM\Column(length: 255, nullable: true)]
+    private ?string $hintData = null;
+
+    public function getId(): ?int
+    {
+        return $this->id;
+    }
+
+    public function getGame(): ?Game
+    {
+        return $this->game;
+    }
+
+    public function setGame(Game $game): static
+    {
+        $this->game = $game;
+
+        return $this;
+    }
+
+    public function getActor(): ?Actor
+    {
+        return $this->actor;
+    }
+
+    public function setActor(Actor $actor): static
+    {
+        $this->actor = $actor;
+
+        return $this;
+    }
+
+    public function getPosition(): int
+    {
+        return $this->position;
+    }
+
+    public function setPosition(int $position): static
+    {
+        $this->position = $position;
+
+        return $this;
+    }
+
+    public function getRowOrder(): int
+    {
+        return $this->rowOrder;
+    }
+
+    public function setRowOrder(int $rowOrder): static
+    {
+        $this->rowOrder = $rowOrder;
+
+        return $this;
+    }
+
+    public function getHintType(): ?string
+    {
+        return $this->hintType;
+    }
+
+    public function setHintType(string $hintType): static
+    {
+        $this->hintType = $hintType;
+
+        return $this;
+    }
+
+    public function getHintData(): ?string
+    {
+        return $this->hintData;
+    }
+
+    public function setHintData(string $hintData): static
+    {
+        $this->hintData = $hintData;
+
+        return $this;
+    }
+}

src/Entity/Import.php

@@ -30,15 +30,12 @@ class Import
     #[ORM\Column(length: 20)]
     private string $status = self::STATUS_PENDING;
 
-    #[ORM\Column]
-    private int $totalBatches = 0;
-
-    #[ORM\Column]
-    private int $processedBatches = 0;
-
     #[ORM\Column]
     private int $totalFilms = 0;
 
+    #[ORM\Column]
+    private int $processedFilms = 0;
+
     #[ORM\Column]
     private int $failedFilms = 0;
 
@@ -91,25 +88,14 @@ class Import
         return $this;
     }
 
-    public function getTotalBatches(): int
+    public function getProcessedFilms(): int
     {
-        return $this->totalBatches;
+        return $this->processedFilms;
     }
 
-    public function setTotalBatches(int $totalBatches): static
+    public function setProcessedFilms(int $processedFilms): static
     {
-        $this->totalBatches = $totalBatches;
-        return $this;
-    }
-
-    public function getProcessedBatches(): int
-    {
-        return $this->processedBatches;
-    }
-
-    public function setProcessedBatches(int $processedBatches): static
-    {
-        $this->processedBatches = $processedBatches;
+        $this->processedFilms = $processedFilms;
         return $this;
     }
 

src/Entity/Movie.php

@@ -24,6 +24,9 @@ class Movie
     #[ORM\Column(length: 255)]
     private ?string $title = null;
 
+    #[ORM\Column(nullable: true)]
+    private ?int $year = null;
+
     /**
      * @var Collection<int, MovieRole>
      */
@@ -76,6 +79,18 @@ class Movie
         return $this;
     }
 
+    public function getYear(): ?int
+    {
+        return $this->year;
+    }
+
+    public function setYear(?int $year): static
+    {
+        $this->year = $year;
+
+        return $this;
+    }
+
     /**
      * @return Collection<int, MovieRole>
      */

src/Entity/Notification.php

@@ -1,78 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Entity;
-
-use App\Repository\NotificationRepository;
-use Doctrine\ORM\Mapping as ORM;
-
-#[ORM\Entity(repositoryClass: NotificationRepository::class)]
-class Notification
-{
-    #[ORM\Id]
-    #[ORM\GeneratedValue]
-    #[ORM\Column]
-    private ?int $id = null;
-
-    #[ORM\ManyToOne(targetEntity: User::class)]
-    #[ORM\JoinColumn(nullable: false)]
-    private ?User $user = null;
-
-    #[ORM\Column(length: 255)]
-    private ?string $message = null;
-
-    #[ORM\Column(name: 'is_read')]
-    private bool $read = false;
-
-    #[ORM\Column]
-    private \DateTimeImmutable $createdAt;
-
-    public function __construct()
-    {
-        $this->createdAt = new \DateTimeImmutable();
-    }
-
-    public function getId(): ?int
-    {
-        return $this->id;
-    }
-
-    public function getUser(): ?User
-    {
-        return $this->user;
-    }
-
-    public function setUser(?User $user): static
-    {
-        $this->user = $user;
-        return $this;
-    }
-
-    public function getMessage(): ?string
-    {
-        return $this->message;
-    }
-
-    public function setMessage(string $message): static
-    {
-        $this->message = $message;
-        return $this;
-    }
-
-    public function isRead(): bool
-    {
-        return $this->read;
-    }
-
-    public function setRead(bool $read): static
-    {
-        $this->read = $read;
-        return $this;
-    }
-
-    public function getCreatedAt(): \DateTimeImmutable
-    {
-        return $this->createdAt;
-    }
-}

src/EventListener/AbandonAnonymousGameOnLoginListener.php

@@ -0,0 +1,39 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\EventListener;
+
+use App\Entity\Game;
+use App\Repository\GameRepository;
+use Doctrine\ORM\EntityManagerInterface;
+use Symfony\Component\EventDispatcher\Attribute\AsEventListener;
+use Symfony\Component\Security\Http\Event\LoginSuccessEvent;
+
+#[AsEventListener]
+class AbandonAnonymousGameOnLoginListener
+{
+    public function __construct(
+        private readonly GameRepository $gameRepository,
+        private readonly EntityManagerInterface $em,
+    ) {}
+
+    public function __invoke(LoginSuccessEvent $event): void
+    {
+        $session = $event->getRequest()->getSession();
+        $gameId = $session->get('current_game_id');
+
+        if (!$gameId) {
+            return;
+        }
+
+        $game = $this->gameRepository->find($gameId);
+
+        if ($game && $game->getStatus() === Game::STATUS_IN_PROGRESS) {
+            $game->abandon();
+            $this->em->flush();
+        }
+
+        $session->remove('current_game_id');
+    }
+}

src/Gateway/WikidataGateway.php

@@ -0,0 +1,111 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Gateway;
+
+use App\Entity\Actor;
+use Symfony\Contracts\HttpClient\HttpClientInterface;
+
+class WikidataGateway
+{
+    private const SPARQL_ENDPOINT = 'https://query.wikidata.org/sparql';
+
+    public function __construct(
+        private readonly HttpClientInterface $httpClient,
+    ) {}
+
+    /**
+     * Fetch awards for an actor from Wikidata.
+     *
+     * @return list<array{name: string, year: int}>
+     */
+    public function getAwards(Actor $actor): array
+    {
+        return $this->getAwardsForActors([$actor])[$actor->getName()] ?? [];
+    }
+
+    /**
+     * Fetch awards for multiple actors in a single SPARQL query.
+     *
+     * @param list<Actor> $actors
+     *
+     * @return array<string, list<array{name: string, year: int}>>
+     */
+    public function getAwardsForActors(array $actors): array
+    {
+        if ([] === $actors) {
+            return [];
+        }
+
+        $sparql = $this->buildBatchQuery($actors);
+
+        $response = $this->httpClient->request('GET', self::SPARQL_ENDPOINT, [
+            'query' => [
+                'query' => $sparql,
+                'format' => 'json',
+            ],
+            'headers' => [
+                'Accept' => 'application/sparql-results+json',
+                'User-Agent' => 'LtbxdActorle/1.0',
+            ],
+            'timeout' => 10,
+        ]);
+
+        $data = $response->toArray();
+        $awards = [];
+
+        foreach ($data['results']['bindings'] ?? [] as $binding) {
+            $actorName = $binding['name']['value'] ?? null;
+            $awardName = $binding['awardLabel']['value'] ?? null;
+            $year = $binding['year']['value'] ?? null;
+
+            if ($actorName && $awardName && $year) {
+                $awards[$actorName][] = [
+                    'name' => $awardName,
+                    'year' => (int) substr($year, 0, 4),
+                ];
+            }
+        }
+
+        return $awards;
+    }
+
+    /**
+     * @param list<Actor> $actors
+     */
+    private function buildBatchQuery(array $actors): string
+    {
+        $values = implode(' ', array_map(function (Actor $actor) {
+            $escaped = str_replace(['\\', '"', "\n", "\r"], ['\\\\', '\\"', '\\n', '\\r'], $actor->getName());
+
+            return '"'.$escaped.'"@en';
+        }, $actors));
+
+        return <<<SPARQL
+        SELECT ?name ?awardLabel ?year WHERE {
+          VALUES ?name { {$values} }
+          ?person rdfs:label ?name .
+          ?person wdt:P31 wd:Q5 .
+          ?person p:P166 ?awardStatement .
+          ?awardStatement ps:P166 ?award .
+          ?awardStatement pq:P585 ?date .
+          BIND(YEAR(?date) AS ?year)
+
+          # Only keep entertainment awards (film, TV, music, theater, performing arts)
+          VALUES ?awardSuperclass {
+            wd:Q4220920    # film award
+            wd:Q1407443    # television award
+            wd:Q2235858    # music award
+            wd:Q15056993   # film festival award
+            wd:Q15383322   # theater award
+            wd:Q29461289   # performing arts award
+          }
+          ?award wdt:P31/wdt:P279* ?awardSuperclass .
+
+          SERVICE wikibase:label { bd:serviceParam wikibase:language "fr,en" . }
+        }
+        ORDER BY ?name DESC(?year)
+        SPARQL;
+    }
+}

src/Import/ActorSyncer.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace App\Service;
+namespace App\Import;
 
 use App\Entity\Actor;
 use App\Entity\Movie;

src/Import/AwardImporter.php

@@ -0,0 +1,231 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Import;
+
+use App\Entity\Actor;
+use App\Entity\Award;
+use App\Entity\AwardType;
+use App\Gateway\WikidataGateway;
+use App\Repository\AwardTypeRepository;
+use Doctrine\ORM\EntityManagerInterface;
+use Psr\Log\LoggerInterface;
+
+readonly class AwardImporter
+{
+    /**
+     * Canonical award name => keywords to match (case-insensitive).
+     * Checked in order — first match wins.
+     */
+    private const AWARD_MAP = [
+        'Oscar' => ['Academy Award', 'Oscar'],
+        'Golden Globe' => ['Golden Globe', 'Golden Globes'],
+        'BAFTA' => ['BAFTA', 'British Academy Film Award', 'British Academy Television Award', 'British Academy Games Award'],
+        'César' => ['César'],
+        'SAG' => ['Screen Actors Guild'],
+        'Emmy' => ['Emmy Award', 'Primetime Emmy'],
+        'Tony' => ['Tony Award', 'Tony award'],
+        'Grammy' => ['Grammy'],
+        'Cannes' => ['Festival de Cannes', 'Cannes', "Palme d'or", "Caméra d'or"],
+        'Sundance' => ['Sundance'],
+        'Berlinale' => ['Berlinale', 'Berliner Bär', "Ours d'argent", "Ours d'or"],
+        'Mostra de Venise' => ['Mostra', 'Venice Film Festival', 'Coupe Volpi', "Lion d'or"],
+        'Saturn' => ['Saturn Award'],
+        'MTV' => ['MTV Movie', 'MTV Video'],
+        "Critics' Choice" => ["Critics' Choice"],
+        'Independent Spirit' => ['Independent Spirit'],
+        'Annie' => ['Annie Award'],
+        'Goya' => ['prix Goya', 'Goya Award'],
+        'Laurence Olivier' => ['Laurence Olivier', 'Olivier Award'],
+        'David di Donatello' => ['David di Donatello'],
+        'Gotham' => ['Gotham Award', 'Gotham Independent'],
+        'NAACP Image' => ['NAACP Image'],
+        "People's Choice" => ["People's Choice"],
+        'Teen Choice' => ['Teen Choice'],
+        'BET' => ['BET Award', 'BET Her', 'BET YoungStars'],
+        'Black Reel' => ['Black Reel'],
+        'National Board of Review' => ['National Board of Review'],
+        'New York Film Critics Circle' => ['New York Film Critics Circle'],
+        'Los Angeles Film Critics' => ['Los Angeles Film Critics'],
+        'San Sebastián' => ['Donostia', 'San Sebastián'],
+        'Sitges' => ['Sitges'],
+        'Satellite' => ['Satellite Award'],
+        'Lucille Lortel' => ['Lucille Lortel'],
+        'Golden Raspberry' => ['Golden Raspberry', 'Razzie'],
+        'Drama Desk' => ['Drama Desk'],
+        'Genie' => ['Genie Award'],
+        'European Film Award' => ['prix du cinéma européen', 'European Film Award'],
+        'AACTA' => ['AACTA'],
+    ];
+
+    /**
+     * Keywords indicating non-entertainment awards (case-insensitive).
+     * These slip through even with the SPARQL filter.
+     */
+    private const EXCLUDED_KEYWORDS = [
+        // National orders and decorations
+        'chevalier', 'officier', 'commandeur', 'compagnon',
+        'ordre du', 'ordre de', 'order of the',
+        'grand-croix', 'grand officier', 'grand cordon',
+        'Knight Bachelor', 'Knight Commander',
+        'croix d\'',
+        // Honorary degrees and memberships
+        'honoris causa',
+        'membre de l\'', 'membre de la', 'membre honoraire', 'membre associé', 'membre élu',
+        'Fellow of', 'fellow de',
+        // Scholarships
+        'bourse ',
+        // Medals (military, scientific, etc.)
+        'médaille', 'Medal',
+        // Other non-entertainment
+        'Time 100', '100 Women', 'All-NBA',
+        'étoile du Hollywood Walk of Fame',
+        'allée des célébrités',
+    ];
+
+    public function __construct(
+        private WikidataGateway $wikidataGateway,
+        private AwardTypeRepository $awardTypeRepository,
+        private EntityManagerInterface $em,
+        private ?LoggerInterface $logger = null,
+    ) {}
+
+    public function importForActor(Actor $actor): void
+    {
+        $this->importForActors([$actor]);
+    }
+
+    /**
+     * @param list<Actor> $actors
+     */
+    public function importForActors(array $actors): void
+    {
+        $actorsToFetch = array_filter($actors, fn (Actor $a) => !$a->isAwardsImported());
+
+        if ([] === $actorsToFetch) {
+            return;
+        }
+
+        try {
+            $allAwards = $this->wikidataGateway->getAwardsForActors(array_values($actorsToFetch));
+        } catch (\Throwable $e) {
+            $this->logger?->warning('Failed to fetch awards from Wikidata', [
+                'actors' => array_map(fn (Actor $a) => $a->getName(), $actorsToFetch),
+                'error' => $e->getMessage(),
+            ]);
+
+            return;
+        }
+
+        $knownTypes = $this->awardTypeRepository->findAll();
+
+        foreach ($actorsToFetch as $actor) {
+            $wikidataAwards = $allAwards[$actor->getName()] ?? [];
+
+            foreach ($wikidataAwards as $wikidataAward) {
+                if ($this->isExcluded($wikidataAward['name'])) {
+                    continue;
+                }
+
+                $awardType = $this->resolveAwardType($wikidataAward['name'], $knownTypes);
+
+                $award = new Award();
+                $award->setName($wikidataAward['name']);
+                $award->setYear($wikidataAward['year']);
+                $award->setActor($actor);
+                $award->setAwardType($awardType);
+
+                $this->em->persist($award);
+            }
+
+            $actor->setAwardsImported(true);
+        }
+    }
+
+    /**
+     * @param list<AwardType> $knownTypes
+     */
+    private function resolveAwardType(string $awardName, array &$knownTypes): AwardType
+    {
+        // 1. Try canonical map first
+        $canonicalName = $this->findCanonicalName($awardName);
+
+        if (null !== $canonicalName) {
+            foreach ($knownTypes as $type) {
+                if ($type->getName() === $canonicalName) {
+                    return $type;
+                }
+            }
+
+            $newType = new AwardType();
+            $newType->setName($canonicalName);
+            $newType->setPattern($canonicalName);
+            $this->em->persist($newType);
+            $knownTypes[] = $newType;
+
+            return $newType;
+        }
+
+        // 2. Fall back to existing pattern matching
+        foreach ($knownTypes as $type) {
+            if (str_contains($awardName, $type->getPattern())) {
+                return $type;
+            }
+        }
+
+        // 3. Create new type with prefix extraction
+        $newType = new AwardType();
+        $prefix = $this->extractPrefix($awardName);
+        $newType->setName($prefix);
+        $newType->setPattern($prefix);
+
+        $this->em->persist($newType);
+        $knownTypes[] = $newType;
+
+        return $newType;
+    }
+
+    private function findCanonicalName(string $awardName): ?string
+    {
+        $normalized = mb_strtolower($awardName);
+
+        foreach (self::AWARD_MAP as $canonical => $keywords) {
+            foreach ($keywords as $keyword) {
+                if (str_contains($normalized, mb_strtolower($keyword))) {
+                    return $canonical;
+                }
+            }
+        }
+
+        return null;
+    }
+
+    private function isExcluded(string $awardName): bool
+    {
+        $normalized = mb_strtolower($awardName);
+
+        foreach (self::EXCLUDED_KEYWORDS as $keyword) {
+            if (str_contains($normalized, mb_strtolower($keyword))) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+
+    private function extractPrefix(string $awardName): string
+    {
+        // "X for Y", "X pour Y", "X du Y", "X de la Y", "X de l'Y", "X des Y"
+        if (preg_match('/^(.+?)\s+(?:for|pour|du|de la|de l\'|des)\s+/iu', $awardName, $matches)) {
+            return trim($matches[1]);
+        }
+
+        // "... festival de cinéma de X" or "... festival de X"
+        if (preg_match('/festival\s+(?:de\s+(?:cinéma\s+de\s+)?)?(.+?)$/iu', $awardName, $matches)) {
+            return trim($matches[1]);
+        }
+
+        return $awardName;
+    }
+}

src/Import/FilmImporter.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace App\Service;
+namespace App\Import;
 
 use App\Entity\Movie;
 use App\Exception\GatewayException;
@@ -38,7 +38,8 @@ readonly class FilmImporter
         $movie = new Movie()
             ->setLtbxdRef($ltbxdMovie->getLtbxdRef())
             ->setTitle($ltbxdMovie->getName())
-            ->setTmdbId($tmdbMovie->getId());
+            ->setTmdbId($tmdbMovie->getId())
+            ->setYear($ltbxdMovie->getYear());
 
         $this->em->persist($movie);
 

src/Message/ImportFilmsBatchMessage.php

@@ -6,9 +6,11 @@ namespace App\Message;
 
 readonly class ImportFilmsBatchMessage
 {
+    /**
+     * @param list<array{name: string, year: int, ltbxdUri: string, date: string}> $films
+     */
     public function __construct(
         public int $importId,
-        public int $offset,
-        public int $limit,
+        public array $films,
     ) {}
 }

src/MessageHandler/ImportFilmsBatchMessageHandler.php

@@ -5,16 +5,14 @@ declare(strict_types=1);
 namespace App\MessageHandler;
 
 use App\Entity\Import;
-use App\Entity\Notification;
 use App\Entity\UserMovie;
-use App\Exception\GatewayException;
-use App\Gateway\LtbxdGateway;
 use App\Message\ImportFilmsBatchMessage;
+use App\Model\Ltbxd\LtbxdMovie;
 use App\Repository\ImportRepository;
-use App\Service\ActorSyncer;
-use App\Service\FilmImporter;
+use App\Import\ActorSyncer;
+use App\Import\AwardImporter;
+use App\Import\FilmImporter;
 use Doctrine\ORM\EntityManagerInterface;
-use League\Flysystem\FilesystemOperator;
 use Psr\Log\LoggerInterface;
 use Symfony\Component\Messenger\Attribute\AsMessageHandler;
 
@@ -23,11 +21,10 @@ readonly class ImportFilmsBatchMessageHandler
 {
     public function __construct(
         private EntityManagerInterface $em,
-        private FilesystemOperator $defaultStorage,
-        private LtbxdGateway $ltbxdGateway,
         private FilmImporter $filmImporter,
         private ActorSyncer $actorSyncer,
         private ImportRepository $importRepository,
+        private AwardImporter $awardImporter,
         private LoggerInterface $logger,
     ) {}
 
@@ -40,71 +37,62 @@ readonly class ImportFilmsBatchMessageHandler
             return;
         }
 
-        $csvContent = $this->defaultStorage->read($import->getFilePath());
-        $tmpFile = tempnam(sys_get_temp_dir(), 'import_');
-        file_put_contents($tmpFile, $csvContent);
-
-        try {
-            $ltbxdMovies = $this->ltbxdGateway->parseFileFromPath($tmpFile);
-        } finally {
-            unlink($tmpFile);
-        }
-
-        $batch = array_slice($ltbxdMovies, $message->offset, $message->limit);
-        $user = $import->getUser();
+        $batch = array_map(
+            fn (array $film) => new LtbxdMovie(
+                date: new \DateTime($film['date']),
+                name: $film['name'],
+                year: $film['year'],
+                ltbxdUri: $film['ltbxdUri'],
+            ),
+            $message->films,
+        );
+        $userId = $import->getUser()->getId();
+        $importId = $import->getId();
 
         foreach ($batch as $ltbxdMovie) {
             try {
                 $movie = $this->filmImporter->importFromLtbxdMovie($ltbxdMovie);
                 if (!$movie) {
                     $this->importRepository->incrementFailedFilms($import);
-                    continue;
+                } else {
+                    $this->actorSyncer->syncActorsForMovie($movie);
+
+                    $actors = array_map(fn ($role) => $role->getActor(), $movie->getActors()->toArray());
+                    $this->awardImporter->importForActors($actors);
+
+                    $user = $this->em->getReference(\App\Entity\User::class, $userId);
+                    $existingLink = $this->em->getRepository(UserMovie::class)->findOneBy([
+                        'user' => $user,
+                        'movie' => $movie,
+                    ]);
+                    if (!$existingLink) {
+                        $userMovie = new UserMovie();
+                        $userMovie->setUser($user);
+                        $userMovie->setMovie($movie);
+                        $this->em->persist($userMovie);
+                    }
+
+                    $this->em->flush();
                 }
-
-                $this->actorSyncer->syncActorsForMovie($movie);
-
-                $existingLink = $this->em->getRepository(UserMovie::class)->findOneBy([
-                    'user' => $user,
-                    'movie' => $movie,
-                ]);
-                if (!$existingLink) {
-                    $userMovie = new UserMovie();
-                    $userMovie->setUser($user);
-                    $userMovie->setMovie($movie);
-                    $this->em->persist($userMovie);
-                }
-
-                $this->em->flush();
             } catch (\Throwable $e) {
                 $this->logger->warning('Failed to import film', [
                     'film' => $ltbxdMovie->getName(),
-                    'importId' => $import->getId(),
+                    'importId' => $importId,
                     'error' => $e->getMessage(),
                 ]);
                 $this->importRepository->incrementFailedFilms($import);
             }
-        }
 
-        $processedBatches = $this->importRepository->incrementProcessedBatches($import);
+            $processedFilms = $this->importRepository->incrementProcessedFilms($import);
 
-        if ($processedBatches >= $import->getTotalBatches()) {
-            // Refresh the entity to get updated failedFilms from DB
-            $this->em->refresh($import);
+            $this->em->clear();
+            $import = $this->em->getRepository(Import::class)->find($importId);
 
-            $import->setStatus(Import::STATUS_COMPLETED);
-            $import->setCompletedAt(new \DateTimeImmutable());
-            $this->em->flush();
-
-            $imported = $import->getTotalFilms() - $import->getFailedFilms();
-            $notification = new Notification();
-            $notification->setUser($user);
-            $notification->setMessage(sprintf(
-                'Import terminé : %d/%d films importés.',
-                $imported,
-                $import->getTotalFilms()
-            ));
-            $this->em->persist($notification);
-            $this->em->flush();
+            if ($processedFilms >= $import->getTotalFilms()) {
+                $import->setStatus(Import::STATUS_COMPLETED);
+                $import->setCompletedAt(new \DateTimeImmutable());
+                $this->em->flush();
+            }
         }
     }
 }

src/MessageHandler/ProcessImportMessageHandler.php

@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace App\MessageHandler;
 
 use App\Entity\Import;
-use App\Entity\Notification;
 use App\Gateway\LtbxdGateway;
 use App\Message\ImportFilmsBatchMessage;
 use App\Message\ProcessImportMessage;
@@ -50,18 +49,23 @@ readonly class ProcessImportMessageHandler
             }
 
             $totalFilms = count($ltbxdMovies);
-            $totalBatches = (int) ceil($totalFilms / self::BATCH_SIZE);
 
             $import->setTotalFilms($totalFilms);
-            $import->setTotalBatches($totalBatches);
             $import->setStatus(Import::STATUS_PROCESSING);
             $this->em->flush();
 
-            for ($i = 0; $i < $totalBatches; $i++) {
+            $batches = array_chunk($ltbxdMovies, self::BATCH_SIZE);
+            foreach ($batches as $batch) {
+                $films = array_map(fn ($movie) => [
+                    'name' => $movie->getName(),
+                    'year' => $movie->getYear(),
+                    'ltbxdUri' => $movie->getLtbxdUri(),
+                    'date' => $movie->getDate()->format('Y-m-d'),
+                ], $batch);
+
                 $this->bus->dispatch(new ImportFilmsBatchMessage(
                     importId: $import->getId(),
-                    offset: $i * self::BATCH_SIZE,
-                    limit: self::BATCH_SIZE,
+                    films: $films,
                 ));
             }
         } catch (\Throwable $e) {
@@ -72,12 +76,6 @@ readonly class ProcessImportMessageHandler
 
             $import->setStatus(Import::STATUS_FAILED);
             $this->em->flush();
-
-            $notification = new Notification();
-            $notification->setUser($import->getUser());
-            $notification->setMessage('L\'import a échoué.');
-            $this->em->persist($notification);
-            $this->em->flush();
         }
     }
 }

src/Provider/GameGridProvider.php

@@ -0,0 +1,279 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Provider;
+
+use App\Entity\Actor;
+use App\Entity\Game;
+use App\Entity\GameRow;
+use App\Entity\User;
+use App\Repository\ActorRepository;
+use App\Repository\MovieRepository;
+use App\Repository\MovieRoleRepository;
+use App\Repository\AwardRepository;
+use Doctrine\ORM\EntityManagerInterface;
+
+class GameGridProvider
+{
+    public function __construct(
+        private readonly ActorRepository $actorRepository,
+        private readonly MovieRoleRepository $movieRoleRepository,
+        private readonly MovieRepository $movieRepository,
+        private readonly AwardRepository $awardRepository,
+        private readonly EntityManagerInterface $em,
+    ) {}
+
+    /**
+     * @param array{watchedOnly?: bool, hintTypes?: list<string>, awardTypeIds?: list<int>|null} $config
+     */
+    public function generate(?User $user = null, array $config = []): ?Game
+    {
+        $watchedOnly = $config['watchedOnly'] ?? false;
+        $hintTypes = $config['hintTypes'] ?? ['film', 'character', 'award'];
+        $awardTypeIds = $config['awardTypeIds'] ?? null;
+
+        for ($attempt = 0; $attempt < 5; $attempt++) {
+            $game = $this->tryGenerate($user, $watchedOnly, $hintTypes, $awardTypeIds);
+            if ($game !== null) {
+                return $game;
+            }
+        }
+
+        return null;
+    }
+
+    /**
+     * @param list<string> $hintTypes
+     * @param list<int>|null $awardTypeIds
+     */
+    private function tryGenerate(?User $user, bool $watchedOnly, array $hintTypes, ?array $awardTypeIds): ?Game
+    {
+        if ($watchedOnly && $user !== null) {
+            $mainActor = $this->actorRepository->findOneRandomInWatchedFilms($user, 4);
+        } else {
+            $mainActor = $this->actorRepository->findOneRandom(4);
+        }
+
+        if ($mainActor === null) {
+            return null;
+        }
+
+        $game = new Game();
+        $game->setMainActor($mainActor);
+        $game->setUser($user);
+
+        $usedActors = [$mainActor->getId()];
+        $rowOrder = 0;
+
+        foreach (str_split(strtolower($mainActor->getName())) as $char) {
+            if (!preg_match('/[a-z]/', $char)) {
+                continue;
+            }
+
+            $actor = null;
+            for ($try = 0; $try < 5; $try++) {
+                if ($watchedOnly && $user !== null) {
+                    $candidate = $this->actorRepository->findOneRandomInWatchedFilms($user, 4, $char);
+                } else {
+                    $candidate = $this->actorRepository->findOneRandom(4, $char);
+                }
+
+                if ($candidate !== null && !in_array($candidate->getId(), $usedActors)) {
+                    $actor = $candidate;
+                    break;
+                }
+            }
+
+            if ($actor === null) {
+                return null;
+            }
+
+            $usedActors[] = $actor->getId();
+
+            $row = new GameRow();
+            $row->setActor($actor);
+            $row->setPosition(strpos(strtolower($actor->getName()), $char));
+            $row->setRowOrder($rowOrder);
+
+            $hint = $this->generateHint($actor, $hintTypes, $awardTypeIds);
+            if ($hint === null) {
+                return null; // Every row must have a hint
+            }
+            $row->setHintType($hint['type']);
+            $row->setHintData($hint['data']);
+
+            $game->addRow($row);
+            ++$rowOrder;
+        }
+
+        $this->em->persist($game);
+        $this->em->flush();
+
+        return $game;
+    }
+
+    /**
+     * Compute display data (grid, width, middle) from a Game entity for the React component.
+     *
+     * @return array{grid: list<array{actorName: string, actorId: int, pos: int, hintType: ?string, hintText: ?string}>, width: int, middle: int}
+     */
+    public function computeGridData(Game $game): array
+    {
+        $leftSize = 0;
+        $rightSize = 0;
+        $grid = [];
+
+        $mainActorChars = str_split($game->getMainActor()->getName());
+        $rows = $game->getRows()->toArray();
+        $rowIndex = 0;
+
+        foreach ($mainActorChars as $char) {
+            if (!preg_match('/[a-zA-Z]/', $char)) {
+                $grid[] = [
+                    'separator' => $char,
+                ];
+                continue;
+            }
+
+            $row = $rows[$rowIndex] ?? null;
+            ++$rowIndex;
+
+            if ($row === null) {
+                continue;
+            }
+
+            $actor = $row->getActor();
+            $pos = $row->getPosition();
+
+            if ($leftSize < $pos) {
+                $leftSize = $pos;
+            }
+
+            $rightSizeActor = strlen($actor->getName()) - $pos - 1;
+            if ($rightSize < $rightSizeActor) {
+                $rightSize = $rightSizeActor;
+            }
+
+            $hintText = $this->resolveHintText($row);
+
+            $grid[] = [
+                'actorName' => $actor->getName(),
+                'actorId' => $actor->getId(),
+                'pos' => $pos,
+                'hintType' => $row->getHintType(),
+                'hintText' => $hintText,
+            ];
+        }
+
+        return [
+            'grid' => $grid,
+            'width' => $rightSize + $leftSize + 1,
+            'middle' => $leftSize,
+        ];
+    }
+
+    /**
+     * @param list<string> $allowedTypes
+     * @param list<int>|null $awardTypeIds
+     * @return array{type: string, data: string}|null
+     */
+    private function generateHint(Actor $rowActor, array $allowedTypes = ['film', 'character', 'award'], ?array $awardTypeIds = null): ?array
+    {
+        $types = $allowedTypes;
+        shuffle($types);
+
+        foreach ($types as $type) {
+            $hint = $this->resolveHint($type, $rowActor, $awardTypeIds);
+            if ($hint !== null) {
+                return $hint;
+            }
+        }
+
+        return null;
+    }
+
+    /**
+     * @param list<int>|null $awardTypeIds
+     * @return array{type: string, data: string}|null
+     */
+    private function resolveHint(string $type, Actor $rowActor, ?array $awardTypeIds = null): ?array
+    {
+        $actorId = $rowActor->getId();
+        if ($actorId === null) {
+            return null;
+        }
+
+        switch ($type) {
+            case 'film':
+                $role = $this->movieRoleRepository->findOneRandomByActor($actorId);
+                if ($role === null) {
+                    return null;
+                }
+                return ['type' => 'film', 'data' => (string) $role->getMovie()->getId()];
+
+            case 'character':
+                $role = $this->movieRoleRepository->findOneRandomByActor($actorId);
+                if ($role === null) {
+                    return null;
+                }
+                return ['type' => 'character', 'data' => (string) $role->getId()];
+
+            case 'award':
+                $award = $this->awardRepository->findOneRandomByActorAndTypes($actorId, $awardTypeIds);
+                if ($award === null) {
+                    return null;
+                }
+                return ['type' => 'award', 'data' => (string) $award->getId()];
+        }
+
+        return null;
+    }
+
+    private function resolveHintText(GameRow $row): ?string
+    {
+        $type = $row->getHintType();
+        $data = $row->getHintData();
+
+        if ($type === null || $data === null) {
+            return null;
+        }
+
+        return match ($type) {
+            'film' => $this->resolveFilmHintText((int) $data),
+            'character' => $this->movieRoleRepository->find((int) $data)?->getCharacter(),
+            'award' => $this->resolveAwardHintText((int) $data),
+            default => null,
+        };
+    }
+
+    private function resolveFilmHintText(int $movieId): ?string
+    {
+        $movie = $this->movieRepository->find($movieId);
+        if ($movie === null) {
+            return null;
+        }
+
+        $title = $movie->getTitle();
+        if ($movie->getYear() !== null) {
+            $title .= ' (' . $movie->getYear() . ')';
+        }
+
+        return $title;
+    }
+
+    private function resolveAwardHintText(int $awardId): ?string
+    {
+        $award = $this->awardRepository->find($awardId);
+        if ($award === null) {
+            return null;
+        }
+
+        $text = $award->getName();
+        if ($award->getYear() !== null) {
+            $text .= ' (' . $award->getYear() . ')';
+        }
+
+        return $text;
+    }
+}

src/Repository/ActorRepository.php

@@ -3,6 +3,8 @@
 namespace App\Repository;
 
 use App\Entity\Actor;
+use App\Entity\User;
+use App\Entity\UserMovie;
 use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
 use Doctrine\Persistence\ManagerRegistry;
 
@@ -38,4 +40,29 @@ class ActorRepository extends ServiceEntityRepository
             ->getOneOrNullResult()
         ;
     }
+
+    public function findOneRandomInWatchedFilms(User $user, ?float $popularity = null, ?string $char = null): ?Actor
+    {
+        $qb = $this->createQueryBuilder('a')
+            ->join('a.movieRoles', 'mr')
+            ->join('mr.movie', 'm')
+            ->join(UserMovie::class, 'um', 'WITH', 'um.movie = m AND um.user = :user')
+            ->setParameter('user', $user);
+
+        if (!empty($popularity)) {
+            $qb->andWhere('a.popularity >= :popularity')
+                ->setParameter('popularity', $popularity);
+        }
+
+        if (!empty($char)) {
+            $qb->andWhere('LOWER(a.name) LIKE LOWER(:name)')
+                ->setParameter('name', '%' . $char . '%');
+        }
+
+        return $qb
+            ->orderBy('RANDOM()')
+            ->setMaxResults(1)
+            ->getQuery()
+            ->getOneOrNullResult();
+    }
 }

src/Repository/AwardRepository.php

@@ -0,0 +1,54 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Repository;
+
+use App\Entity\Award;
+use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
+use Doctrine\Persistence\ManagerRegistry;
+
+/** @extends ServiceEntityRepository<Award> */
+class AwardRepository extends ServiceEntityRepository
+{
+    public function __construct(ManagerRegistry $registry)
+    {
+        parent::__construct($registry, Award::class);
+    }
+
+    public function findOneRandomByActor(int $actorId): ?Award
+    {
+        return $this->createQueryBuilder('a')
+            ->andWhere('a.actor = :actorId')
+            ->setParameter('actorId', $actorId)
+            ->orderBy('RANDOM()')
+            ->setMaxResults(1)
+            ->getQuery()
+            ->getOneOrNullResult();
+    }
+
+    /**
+     * @param list<int>|null $awardTypeIds null means all types
+     */
+    public function findOneRandomByActorAndTypes(int $actorId, ?array $awardTypeIds): ?Award
+    {
+        $qb = $this->createQueryBuilder('a')
+            ->andWhere('a.actor = :actorId')
+            ->setParameter('actorId', $actorId);
+
+        if ($awardTypeIds !== null && empty($awardTypeIds)) {
+            return null;
+        }
+
+        if ($awardTypeIds !== null) {
+            $qb->andWhere('a.awardType IN (:typeIds)')
+                ->setParameter('typeIds', $awardTypeIds);
+        }
+
+        return $qb
+            ->orderBy('RANDOM()')
+            ->setMaxResults(1)
+            ->getQuery()
+            ->getOneOrNullResult();
+    }
+}

src/Repository/AwardTypeRepository.php

@@ -0,0 +1,37 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Repository;
+
+use App\Entity\AwardType;
+use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
+use Doctrine\Persistence\ManagerRegistry;
+
+/** @extends ServiceEntityRepository<AwardType> */
+class AwardTypeRepository extends ServiceEntityRepository
+{
+    public function __construct(ManagerRegistry $registry)
+    {
+        parent::__construct($registry, AwardType::class);
+    }
+
+    /** @return list<AwardType> */
+    public function findAll(): array
+    {
+        return parent::findAll();
+    }
+
+    /** @return list<AwardType> */
+    public function findWithMinActors(int $minActors): array
+    {
+        return $this->createQueryBuilder('at')
+            ->join('at.awards', 'a')
+            ->groupBy('at.id')
+            ->having('COUNT(DISTINCT a.actor) >= :minActors')
+            ->setParameter('minActors', $minActors)
+            ->orderBy('COUNT(DISTINCT a.actor)', 'DESC')
+            ->getQuery()
+            ->getResult();
+    }
+}

src/Repository/GameRepository.php

@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Repository;
+
+use App\Entity\Game;
+use App\Entity\User;
+use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
+use Doctrine\Persistence\ManagerRegistry;
+
+/**
+ * @extends ServiceEntityRepository<Game>
+ */
+class GameRepository extends ServiceEntityRepository
+{
+    public function __construct(ManagerRegistry $registry)
+    {
+        parent::__construct($registry, Game::class);
+    }
+
+    public function findActiveForUser(User $user): ?Game
+    {
+        return $this->createQueryBuilder('g')
+            ->andWhere('g.user = :user')
+            ->andWhere('g.status = :status')
+            ->setParameter('user', $user)
+            ->setParameter('status', Game::STATUS_IN_PROGRESS)
+            ->setMaxResults(1)
+            ->getQuery()
+            ->getOneOrNullResult();
+    }
+}

src/Repository/GameRowRepository.php

@@ -0,0 +1,20 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Repository;
+
+use App\Entity\GameRow;
+use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
+use Doctrine\Persistence\ManagerRegistry;
+
+/**
+ * @extends ServiceEntityRepository<GameRow>
+ */
+class GameRowRepository extends ServiceEntityRepository
+{
+    public function __construct(ManagerRegistry $registry)
+    {
+        parent::__construct($registry, GameRow::class);
+    }
+}

src/Repository/ImportRepository.php

@@ -18,10 +18,10 @@ class ImportRepository extends ServiceEntityRepository
         parent::__construct($registry, Import::class);
     }
 
-    public function incrementProcessedBatches(Import $import): int
+    public function incrementProcessedFilms(Import $import): int
     {
         return (int) $this->getEntityManager()->getConnection()->fetchOne(
-            'UPDATE import SET processed_batches = processed_batches + 1 WHERE id = :id RETURNING processed_batches',
+            'UPDATE import SET processed_films = processed_films + 1 WHERE id = :id RETURNING processed_films',
             ['id' => $import->getId()]
         );
     }
@@ -33,4 +33,27 @@ class ImportRepository extends ServiceEntityRepository
             ['id' => $import->getId()]
         );
     }
+
+    public function findLatestForUser(\App\Entity\User $user): ?Import
+    {
+        return $this->createQueryBuilder('i')
+            ->andWhere('i.user = :user')
+            ->setParameter('user', $user)
+            ->orderBy('i.createdAt', 'DESC')
+            ->setMaxResults(1)
+            ->getQuery()
+            ->getOneOrNullResult();
+    }
+
+    public function hasActiveImport(\App\Entity\User $user): bool
+    {
+        return (int) $this->createQueryBuilder('i')
+            ->select('COUNT(i.id)')
+            ->andWhere('i.user = :user')
+            ->andWhere('i.status IN (:statuses)')
+            ->setParameter('user', $user)
+            ->setParameter('statuses', [Import::STATUS_PENDING, Import::STATUS_PROCESSING])
+            ->getQuery()
+            ->getSingleScalarResult() > 0;
+    }
 }

src/Repository/MovieRoleRepository.php

@@ -16,28 +16,25 @@ class MovieRoleRepository extends ServiceEntityRepository
         parent::__construct($registry, MovieRole::class);
     }
 
-//    /**
-//     * @return MovieRole[] Returns an array of MovieRole objects
-//     */
-//    public function findByExampleField($value): array
-//    {
-//        return $this->createQueryBuilder('m')
-//            ->andWhere('m.exampleField = :val')
-//            ->setParameter('val', $value)
-//            ->orderBy('m.id', 'ASC')
-//            ->setMaxResults(10)
-//            ->getQuery()
-//            ->getResult()
-//        ;
-//    }
+    /**
+     * @param list<int> $excludeMovieRoleIds MovieRole IDs to exclude
+     * @return MovieRole|null
+     */
+    public function findOneRandomByActor(int $actorId, array $excludeMovieRoleIds = []): ?MovieRole
+    {
+        $qb = $this->createQueryBuilder('mr')
+            ->andWhere('mr.actor = :actorId')
+            ->setParameter('actorId', $actorId);
 
-//    public function findOneBySomeField($value): ?MovieRole
-//    {
-//        return $this->createQueryBuilder('m')
-//            ->andWhere('m.exampleField = :val')
-//            ->setParameter('val', $value)
-//            ->getQuery()
-//            ->getOneOrNullResult()
-//        ;
-//    }
+        if (!empty($excludeMovieRoleIds)) {
+            $qb->andWhere('mr.id NOT IN (:excludeIds)')
+                ->setParameter('excludeIds', $excludeMovieRoleIds);
+        }
+
+        return $qb
+            ->orderBy('RANDOM()')
+            ->setMaxResults(1)
+            ->getQuery()
+            ->getOneOrNullResult();
+    }
 }

src/Repository/NotificationRepository.php

@@ -1,54 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Repository;
-
-use App\Entity\Notification;
-use App\Entity\User;
-use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
-use Doctrine\Persistence\ManagerRegistry;
-
-/**
- * @extends ServiceEntityRepository<Notification>
- */
-class NotificationRepository extends ServiceEntityRepository
-{
-    public function __construct(ManagerRegistry $registry)
-    {
-        parent::__construct($registry, Notification::class);
-    }
-
-    /**
-     * @return Notification[]
-     */
-    public function findRecentForUser(User $user, int $limit = 20): array
-    {
-        return $this->createQueryBuilder('n')
-            ->andWhere('n.user = :user')
-            ->setParameter('user', $user)
-            ->orderBy('n.createdAt', 'DESC')
-            ->setMaxResults($limit)
-            ->getQuery()
-            ->getResult();
-    }
-
-    public function countUnreadForUser(User $user): int
-    {
-        return $this->count(['user' => $user, 'read' => false]);
-    }
-
-    public function markAllReadForUser(User $user): void
-    {
-        $this->createQueryBuilder('n')
-            ->update()
-            ->set('n.read', ':true')
-            ->where('n.user = :user')
-            ->andWhere('n.read = :false')
-            ->setParameter('true', true)
-            ->setParameter('false', false)
-            ->setParameter('user', $user)
-            ->getQuery()
-            ->execute();
-    }
-}

src/Twig/AppExtension.php

@@ -1,21 +0,0 @@
-<?php
-
-namespace App\Twig;
-
-use Twig\Extension\AbstractExtension;
-use Twig\TwigFilter;
-
-class AppExtension extends AbstractExtension
-{
-    public function getFilters(): array
-    {
-        return [
-            new TwigFilter('match', [$this, 'match']),
-        ];
-    }
-
-    public function match(string $string, string $pattern): bool
-    {
-        return preg_match($pattern, $string);
-    }
-}

templates/_navbar.html.twig

@@ -1,29 +1,19 @@
 {% if app.user %}
-<div data-controller="import-modal">
-<nav class="navbar" data-controller="notifications">
+<div data-controller="import-modal import-help">
+<nav class="navbar">
     <div class="navbar-left">
-        <a href="{{ path('app_homepage') }}" class="navbar-brand">Actorle</a>
+        <a href="{{ path('app_homepage') }}" class="navbar-brand"><span class="brand-prefix">Ltbxd</span>Actorle</a>
     </div>
     <div class="navbar-right">
-        {# Notifications #}
-        <div class="navbar-item" data-controller="dropdown">
-            <button class="navbar-icon" data-action="click->dropdown#toggle click->notifications#markRead" data-dropdown-target="trigger">
-                <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
-                    <path d="M18 8A6 6 0 0 0 6 8c0 7-3 9-3 9h18s-3-2-3-9"/>
-                    <path d="M13.73 21a2 2 0 0 1-3.46 0"/>
-                </svg>
-                <span class="badge" data-notifications-target="badge" hidden></span>
-            </button>
-            <div class="dropdown-menu" data-dropdown-target="menu" hidden>
-                <div class="dropdown-header">Notifications</div>
-                <div data-notifications-target="list" class="notifications-list">
-                    <p class="dropdown-empty">Aucune notification</p>
-                </div>
-            </div>
-        </div>
+        {# Gitea repo #}
+        <a href="https://git.lclr.dev/thibaud-lclr/ltbxd-actorle" class="navbar-icon" target="_blank" rel="noopener noreferrer" title="Code source">
+            <svg width="20" height="20" viewBox="0 0 92 92" fill="currentColor">
+                <path d="M90.156 41.965 50.036 1.848a5.918 5.918 0 0 0-8.372 0l-8.328 8.332 10.566 10.566a7.03 7.03 0 0 1 7.23 1.684 7.034 7.034 0 0 1 1.669 7.277l10.187 10.184a7.028 7.028 0 0 1 7.278 1.672 7.04 7.04 0 0 1 0 9.957 7.05 7.05 0 0 1-9.965 0 7.044 7.044 0 0 1-1.528-7.66l-9.5-9.497V59.36a7.04 7.04 0 0 1 1.86 11.29 7.04 7.04 0 0 1-9.957 0 7.04 7.04 0 0 1 0-9.958 7.06 7.06 0 0 1 2.304-1.539V33.926a7.049 7.049 0 0 1-3.82-9.234L29.242 14.272 1.73 41.777a5.925 5.925 0 0 0 0 8.371L41.852 90.27a5.925 5.925 0 0 0 8.37 0l39.934-39.934a5.925 5.925 0 0 0 0-8.371"/>
+            </svg>
+        </a>
 
         {# User menu #}
-        <div class="navbar-item" data-controller="dropdown">
+        <div class="navbar-item" data-controller="dropdown import-status">
             <button class="navbar-icon" data-action="click->dropdown#toggle" data-dropdown-target="trigger">
                 <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
                     <path d="M20 21v-2a4 4 0 0 0-4-4H8a4 4 0 0 0-4 4v2"/>
@@ -31,7 +21,16 @@
                 </svg>
             </button>
             <div class="dropdown-menu" data-dropdown-target="menu" hidden>
-                <button class="dropdown-item" data-action="click->import-modal#open">Importer ses films</button>
+                <div class="import-status-item" data-import-status-target="item">
+                    <div class="dropdown-item-row">
+                        <button class="dropdown-item" data-action="click->import-modal#open" data-import-status-target="importBtn">
+                            Importer ses films
+                        </button>
+                        <button class="info-btn" data-action="click->import-help#open" title="Comment exporter depuis Letterboxd">
+                            i
+                        </button>
+                    </div>
+                </div>
                 <a href="{{ path('app_logout') }}" class="dropdown-item">Se déconnecter</a>
             </div>
         </div>
@@ -57,5 +56,38 @@
         </div>
     </div>
 </div>
+{# Help Modal #}
+<div class="modal-overlay" data-import-help-target="overlay" data-action="click->import-help#closeOnBackdrop" hidden>
+    <div class="modal">
+        <div class="modal-header">
+            <h2>Comment exporter ses films</h2>
+            <button class="modal-close" data-action="click->import-help#close">&times;</button>
+        </div>
+        <div class="modal-body">
+            <ol class="help-steps">
+                <li>Connectez-vous à votre compte <a href="https://letterboxd.com" target="_blank" rel="noopener noreferrer">Letterboxd</a></li>
+                <li>Allez dans <strong>Settings</strong> (Paramètres)</li>
+                <li>Cliquez sur l'onglet <strong>Import &amp; Export</strong></li>
+                <li>Cliquez sur <strong>Export Your Data</strong></li>
+                <li>Un fichier ZIP sera téléchargé. Décompressez-le.</li>
+                <li>Utilisez le fichier <code>watched.csv</code> pour l'import.</li>
+            </ol>
+        </div>
+    </div>
 </div>
+</div>
+{% else %}
+<nav class="navbar">
+    <div class="navbar-left">
+        <a href="{{ path('app_homepage') }}" class="navbar-brand"><span class="brand-prefix">Ltbxd</span>Actorle</a>
+    </div>
+    <div class="navbar-right">
+        <a href="https://git.lclr.dev/thibaud-lclr/ltbxd-actorle" class="navbar-icon" target="_blank" rel="noopener noreferrer" title="Code source">
+            <svg width="20" height="20" viewBox="0 0 92 92" fill="currentColor">
+                <path d="M90.156 41.965 50.036 1.848a5.918 5.918 0 0 0-8.372 0l-8.328 8.332 10.566 10.566a7.03 7.03 0 0 1 7.23 1.684 7.034 7.034 0 0 1 1.669 7.277l10.187 10.184a7.028 7.028 0 0 1 7.278 1.672 7.04 7.04 0 0 1 0 9.957 7.05 7.05 0 0 1-9.965 0 7.044 7.044 0 0 1-1.528-7.66l-9.5-9.497V59.36a7.04 7.04 0 0 1 1.86 11.29 7.04 7.04 0 0 1-9.957 0 7.04 7.04 0 0 1 0-9.958 7.06 7.06 0 0 1 2.304-1.539V33.926a7.049 7.049 0 0 1-3.82-9.234L29.242 14.272 1.73 41.777a5.925 5.925 0 0 0 0 8.371L41.852 90.27a5.925 5.925 0 0 0 8.37 0l39.934-39.934a5.925 5.925 0 0 0 0-8.371"/>
+            </svg>
+        </a>
+        <a href="{{ path('app_login') }}" class="btn btn-primary">Se connecter</a>
+    </div>
+</nav>
 {% endif %}

templates/base.html.twig

@@ -2,8 +2,11 @@
 <html>
     <head>
         <meta charset="UTF-8">
-        <title>{% block title %}Welcome!{% endblock %}</title>
+        <title>{% block title %}LtbxdActorle{% endblock %}</title>
         <link rel="icon" href="data:image/svg+xml,<svg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 128 128%22><text y=%221.2em%22 font-size=%2296%22>⚫️</text><text y=%221.3em%22 x=%220.2em%22 font-size=%2276%22 fill=%22%23fff%22>sf</text></svg>">
+        <link rel="preconnect" href="https://fonts.googleapis.com">
+        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+        <link href="https://fonts.googleapis.com/css2?family=Fraunces:ital,opsz,wght@0,9..144,400;0,9..144,700;1,9..144,400&family=Inter:wght@400;500;600;700&display=swap" rel="stylesheet">
         {% block stylesheets %}
             {{ vite_entry_link_tags('app') }}
         {% endblock %}
@@ -14,6 +17,8 @@
     </head>
     <body>
         {% include '_navbar.html.twig' %}
-        {% block body %}{% endblock %}
+        <div class="page-body">
+            {% block body %}{% endblock %}
+        </div>
     </body>
 </html>

templates/homepage/index.html.twig

@@ -1,9 +1,140 @@
 {% extends 'base.html.twig' %}
 
 {% block body %}
-    <div {{ react_component('GameGrid', {
-        grid: grid,
-        width: width,
-        middle: middle,
-    }) }}></div>
+    {% if game %}
+        <div class="game-container">
+            <div class="game-actions">
+                <div class="abandon-wrapper">
+                    <button type="button" class="btn btn-abandon" id="abandon-trigger">Abandonner</button>
+                    <div class="abandon-popover" id="abandon-popover">
+                        <p class="abandon-popover-text">Êtes-vous sûr de vouloir abandonner ?</p>
+                        <div class="abandon-popover-actions">
+                            <form method="post" action="{{ path('app_game_abandon', {id: game.id}) }}">
+                                <input type="hidden" name="_token" value="{{ csrf_token('game_abandon') }}">
+                                <button type="submit" class="btn btn-abandon-confirm">Abandonner</button>
+                            </form>
+                            <button type="button" class="btn btn-abandon-cancel" id="abandon-cancel">Non, continuer</button>
+                        </div>
+                    </div>
+                </div>
+                <script>
+                    (function() {
+                        var trigger = document.getElementById('abandon-trigger');
+                        var popover = document.getElementById('abandon-popover');
+                        var cancel = document.getElementById('abandon-cancel');
+                        trigger.addEventListener('click', function() {
+                            popover.classList.toggle('open');
+                        });
+                        cancel.addEventListener('click', function() {
+                            popover.classList.remove('open');
+                        });
+                        document.addEventListener('click', function(e) {
+                            if (!popover.contains(e.target) && e.target !== trigger) {
+                                popover.classList.remove('open');
+                            }
+                        });
+                    })();
+                </script>
+            </div>
+
+            <div {{ react_component('GameGrid', {
+                grid: grid,
+                width: width,
+                middle: middle,
+            }) }}></div>
+
+            <div class="game-footer">
+                <a href="https://git.lclr.dev/thibaud-lclr/ltbxd-actorle/issues/new?template=.gitea%2fissue_template%2fbug_report.yaml&title={{ ('Bug — Game #' ~ game.id)|url_encode }}" class="btn-bug-report" target="_blank" rel="noopener">
+                    <svg width="14" height="14" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round">
+                        <circle cx="8" cy="8" r="7"/>
+                        <line x1="8" y1="5" x2="8" y2="9"/>
+                        <circle cx="8" cy="11.5" r="0.5" fill="currentColor" stroke="none"/>
+                    </svg>
+                    Signaler un bug
+                </a>
+            </div>
+        </div>
+    {% else %}
+        <div class="game-start-container">
+            <form method="post" action="{{ path('app_game_start') }}" id="start-form"
+                  data-controller="game-config">
+                <input type="hidden" name="_token" value="{{ csrf_token('game_start') }}">
+
+                <div class="config-panel">
+                    {% if app.user %}
+                        <div class="config-section">
+                            <label class="config-toggle">
+                                <span class="config-toggle-label">Films vus</span>
+                                <input type="checkbox" name="watched_only" value="1" class="toggle-switch">
+                            </label>
+                        </div>
+                    {% endif %}
+
+                    <div class="config-section">
+                        <div class="config-section-title">Paramètres des indices</div>
+                        <div class="config-hint-types">
+                            <label class="config-checkbox">
+                                <input type="checkbox" name="hint_film" value="1" checked
+                                       data-game-config-target="hintType"
+                                       data-action="change->game-config#enforceMinOneChecked">
+                                Film
+                            </label>
+                            <label class="config-checkbox">
+                                <input type="checkbox" name="hint_character" value="1" checked
+                                       data-game-config-target="hintType"
+                                       data-action="change->game-config#enforceMinOneChecked">
+                                Rôle
+                            </label>
+                            <label class="config-checkbox">
+                                <input type="checkbox" name="hint_award" value="1" checked
+                                       data-game-config-target="hintType"
+                                       data-action="change->game-config#enforceMinOneChecked">
+                                Récompense
+                            </label>
+                        </div>
+
+                        <div class="config-award-types" data-game-config-target="awardSection">
+                            <div class="config-section-subtitle">Récompenses</div>
+                            <div class="config-award-list">
+                                <label class="config-checkbox">
+                                    <input type="checkbox" checked
+                                           data-game-config-target="allAwards"
+                                           data-action="change->game-config#toggleAllAwards">
+                                    Toutes les récompenses
+                                </label>
+                                {% for awardType in awardTypes %}
+                                    <label class="config-checkbox">
+                                        <input type="checkbox" name="award_types[]"
+                                               value="{{ awardType.id }}" checked
+                                               data-game-config-target="awardType"
+                                               data-action="change->game-config#syncAllAwards">
+                                        {{ awardType.name }}
+                                    </label>
+                                {% endfor %}
+                            </div>
+                        </div>
+                    </div>
+                </div>
+
+                <button type="submit" class="btn btn-primary btn-start">Commencer une partie</button>
+            </form>
+            <div class="start-loader" id="start-loader"></div>
+            {% if not app.user %}
+                <p class="start-login-hint">
+                    <a href="{{ path('app_login') }}">Connectez-vous</a> pour importer vos propres films
+                </p>
+            {% endif %}
+
+            {% for message in app.flashes('error') %}
+                <div class="flash-error">{{ message }}</div>
+            {% endfor %}
+
+            <script>
+                document.getElementById('start-form').addEventListener('submit', function () {
+                    this.style.display = 'none';
+                    document.getElementById('start-loader').style.display = 'block';
+                });
+            </script>
+        </div>
+    {% endif %}
 {% endblock %}

templates/security/login.html.twig

@@ -1,10 +1,10 @@
 {% extends 'base.html.twig' %}
 
-{% block title %}Log in{% endblock %}
+{% block title %}Connexion — LtbxdActorle{% endblock %}
 
 {% block body %}
 <div class="auth-container">
-    <h1>Log in</h1>
+    <h1>Se connecter</h1>
 
     {% if error %}
         <div class="auth-error">{{ error.messageKey|trans(error.messageData, 'security') }}</div>
@@ -14,14 +14,14 @@
         <label for="inputEmail">Email</label>
         <input type="email" value="{{ last_username }}" name="_username" id="inputEmail" autocomplete="email" required autofocus>
 
-        <label for="inputPassword">Password</label>
+        <label for="inputPassword">Mot de passe</label>
         <input type="password" name="_password" id="inputPassword" autocomplete="current-password" required>
 
         <input type="hidden" name="_csrf_token" value="{{ csrf_token('authenticate') }}">
 
-        <button type="submit">Sign in</button>
+        <button type="submit">Connexion</button>
     </form>
 
-    <p class="auth-link">No account yet? <a href="{{ path('app_register') }}">Register</a></p>
+    <p class="auth-link">Pas encore de compte ? <a href="{{ path('app_register') }}">S'inscrire</a></p>
 </div>
 {% endblock %}

templates/security/register.html.twig

@@ -1,19 +1,19 @@
 {% extends 'base.html.twig' %}
 
-{% block title %}Register{% endblock %}
+{% block title %}Inscription — LtbxdActorle{% endblock %}
 
 {% block body %}
 <div class="auth-container">
-    <h1>Register</h1>
+    <h1>Créer un compte</h1>
 
     {{ form_start(registrationForm) }}
         {{ form_row(registrationForm.email) }}
         {{ form_row(registrationForm.plainPassword.first) }}
         {{ form_row(registrationForm.plainPassword.second) }}
 
-        <button type="submit">Create account</button>
+        <button type="submit">S'inscrire</button>
     {{ form_end(registrationForm) }}
 
-    <p class="auth-link">Already have an account? <a href="{{ path('app_login') }}">Log in</a></p>
+    <p class="auth-link">Déjà un compte ? <a href="{{ path('app_login') }}">Se connecter</a></p>
 </div>
 {% endblock %}

tests/Import/AwardImporterTest.php

@@ -0,0 +1,281 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tests\Import;
+
+use App\Entity\Actor;
+use App\Entity\Award;
+use App\Entity\AwardType;
+use App\Gateway\WikidataGateway;
+use App\Repository\AwardTypeRepository;
+use App\Import\AwardImporter;
+use Doctrine\ORM\EntityManagerInterface;
+use PHPUnit\Framework\TestCase;
+
+class AwardImporterTest extends TestCase
+{
+    private AwardImporter $importer;
+    private WikidataGateway&\PHPUnit\Framework\MockObject\MockObject $wikidataGateway;
+    private AwardTypeRepository&\PHPUnit\Framework\MockObject\MockObject $awardTypeRepository;
+    private EntityManagerInterface&\PHPUnit\Framework\MockObject\MockObject $em;
+
+    protected function setUp(): void
+    {
+        $this->wikidataGateway = $this->createMock(WikidataGateway::class);
+        $this->awardTypeRepository = $this->createMock(AwardTypeRepository::class);
+        $this->em = $this->createMock(EntityManagerInterface::class);
+
+        $this->importer = new AwardImporter(
+            $this->wikidataGateway,
+            $this->awardTypeRepository,
+            $this->em,
+        );
+    }
+
+    public function testSkipsActorWithAwardsAlreadyImported(): void
+    {
+        $actor = $this->createActorWithFlag('Already Imported', awardsImported: true);
+
+        $this->wikidataGateway->expects($this->never())->method('getAwardsForActors');
+
+        $this->importer->importForActors([$actor]);
+    }
+
+    public function testImportsAwardsAndSetsFlag(): void
+    {
+        $actor = $this->createActorWithFlag('Test Actor', awardsImported: false);
+
+        $this->wikidataGateway->method('getAwardsForActors')->willReturn([
+            'Test Actor' => [
+                ['name' => 'Academy Award for Best Actor', 'year' => 2020],
+            ],
+        ]);
+
+        $existingType = new AwardType();
+        $existingType->setName('Oscar')->setPattern('Oscar');
+
+        $this->awardTypeRepository->method('findAll')->willReturn([$existingType]);
+
+        $persisted = [];
+        $this->em->method('persist')->willReturnCallback(function ($entity) use (&$persisted) {
+            $persisted[] = $entity;
+        });
+
+        $this->importer->importForActors([$actor]);
+
+        $this->assertTrue($actor->isAwardsImported());
+        $this->assertCount(1, $persisted);
+        $this->assertInstanceOf(Award::class, $persisted[0]);
+        $this->assertSame('Academy Award for Best Actor', $persisted[0]->getName());
+        $this->assertSame(2020, $persisted[0]->getYear());
+        $this->assertSame($existingType, $persisted[0]->getAwardType());
+        $this->assertSame($actor, $persisted[0]->getActor());
+    }
+
+    public function testCanonicalMapGroupsRelatedAwards(): void
+    {
+        $actor = $this->createActorWithFlag('Test Actor', awardsImported: false);
+
+        $this->wikidataGateway->method('getAwardsForActors')->willReturn([
+            'Test Actor' => [
+                ['name' => 'Screen Actors Guild Award for Outstanding Performance', 'year' => 2019],
+            ],
+        ]);
+
+        $this->awardTypeRepository->method('findAll')->willReturn([]);
+
+        $persisted = [];
+        $this->em->method('persist')->willReturnCallback(function ($entity) use (&$persisted) {
+            $persisted[] = $entity;
+        });
+
+        $this->importer->importForActors([$actor]);
+
+        $this->assertTrue($actor->isAwardsImported());
+        // Should persist both a new AwardType and the Award
+        $this->assertCount(2, $persisted);
+
+        $newType = $persisted[0];
+        $this->assertInstanceOf(AwardType::class, $newType);
+        $this->assertSame('SAG', $newType->getName());
+        $this->assertSame('SAG', $newType->getPattern());
+
+        $award = $persisted[1];
+        $this->assertInstanceOf(Award::class, $award);
+        $this->assertSame($newType, $award->getAwardType());
+    }
+
+    public function testFallsBackToExtractPrefixWhenNotInCanonicalMap(): void
+    {
+        $actor = $this->createActorWithFlag('Test Actor', awardsImported: false);
+
+        $this->wikidataGateway->method('getAwardsForActors')->willReturn([
+            'Test Actor' => [
+                ['name' => 'Bambi for Best Film', 'year' => 2019],
+            ],
+        ]);
+
+        $this->awardTypeRepository->method('findAll')->willReturn([]);
+
+        $persisted = [];
+        $this->em->method('persist')->willReturnCallback(function ($entity) use (&$persisted) {
+            $persisted[] = $entity;
+        });
+
+        $this->importer->importForActors([$actor]);
+
+        $newType = $persisted[0];
+        $this->assertInstanceOf(AwardType::class, $newType);
+        $this->assertSame('Bambi', $newType->getName());
+    }
+
+    public function testExcludesNonEntertainmentAwards(): void
+    {
+        $actor = $this->createActorWithFlag('Test Actor', awardsImported: false);
+
+        $this->wikidataGateway->method('getAwardsForActors')->willReturn([
+            'Test Actor' => [
+                ['name' => 'chevalier de la Légion d\'honneur', 'year' => 2015],
+                ['name' => 'docteur honoris causa', 'year' => 2018],
+                ['name' => 'bourse Rhodes', 'year' => 2010],
+                ['name' => 'Oscar du meilleur acteur', 'year' => 2020],
+            ],
+        ]);
+
+        $this->awardTypeRepository->method('findAll')->willReturn([]);
+
+        $persisted = [];
+        $this->em->method('persist')->willReturnCallback(function ($entity) use (&$persisted) {
+            $persisted[] = $entity;
+        });
+
+        $this->importer->importForActors([$actor]);
+
+        // Only the Oscar should be persisted (1 AwardType + 1 Award)
+        $this->assertCount(2, $persisted);
+        $this->assertInstanceOf(AwardType::class, $persisted[0]);
+        $this->assertSame('Oscar', $persisted[0]->getName());
+        $this->assertInstanceOf(Award::class, $persisted[1]);
+    }
+
+    public function testDoesNotSetFlagOnWikidataError(): void
+    {
+        $actor = $this->createActorWithFlag('Test Actor', awardsImported: false);
+
+        $this->wikidataGateway->method('getAwardsForActors')
+            ->willThrowException(new \RuntimeException('Wikidata timeout'));
+
+        $this->importer->importForActors([$actor]);
+
+        $this->assertFalse($actor->isAwardsImported());
+    }
+
+    public function testHandlesActorWithNoAwards(): void
+    {
+        $actor = $this->createActorWithFlag('Test Actor', awardsImported: false);
+
+        $this->wikidataGateway->method('getAwardsForActors')->willReturn([]);
+        $this->awardTypeRepository->method('findAll')->willReturn([]);
+
+        $this->em->expects($this->never())->method('persist');
+
+        $this->importer->importForActors([$actor]);
+
+        $this->assertTrue($actor->isAwardsImported());
+    }
+
+    public function testBatchImportsMultipleActors(): void
+    {
+        $actor1 = $this->createActorWithFlag('Actor One', awardsImported: false);
+        $actor2 = $this->createActorWithFlag('Actor Two', awardsImported: false);
+        $alreadyImported = $this->createActorWithFlag('Actor Three', awardsImported: true);
+
+        $this->wikidataGateway->expects($this->once())->method('getAwardsForActors')
+            ->with($this->callback(fn (array $actors) => 2 === \count($actors)))
+            ->willReturn([
+                'Actor One' => [['name' => 'Academy Award for Best Actor', 'year' => 2020]],
+                'Actor Two' => [['name' => 'Golden Globe for Best Actor', 'year' => 2021]],
+            ]);
+
+        $existingType = new AwardType();
+        $existingType->setName('Oscar')->setPattern('Oscar');
+
+        $this->awardTypeRepository->method('findAll')->willReturn([$existingType]);
+
+        $persisted = [];
+        $this->em->method('persist')->willReturnCallback(function ($entity) use (&$persisted) {
+            $persisted[] = $entity;
+        });
+
+        $this->importer->importForActors([$actor1, $actor2, $alreadyImported]);
+
+        $this->assertTrue($actor1->isAwardsImported());
+        $this->assertTrue($actor2->isAwardsImported());
+        // 2 Awards + 1 new AwardType (Golden Globe)
+        $this->assertCount(3, $persisted);
+    }
+
+    public function testExtractPrefixHandlesFrenchPatterns(): void
+    {
+        $actor = $this->createActorWithFlag('Test Actor', awardsImported: false);
+
+        $this->wikidataGateway->method('getAwardsForActors')->willReturn([
+            'Test Actor' => [
+                ['name' => 'Bodil du meilleur acteur', 'year' => 2019],
+            ],
+        ]);
+
+        $this->awardTypeRepository->method('findAll')->willReturn([]);
+
+        $persisted = [];
+        $this->em->method('persist')->willReturnCallback(function ($entity) use (&$persisted) {
+            $persisted[] = $entity;
+        });
+
+        $this->importer->importForActors([$actor]);
+
+        $newType = $persisted[0];
+        $this->assertInstanceOf(AwardType::class, $newType);
+        $this->assertSame('Bodil', $newType->getName());
+    }
+
+    public function testCanonicalMapReusesExistingType(): void
+    {
+        $actor = $this->createActorWithFlag('Test Actor', awardsImported: false);
+
+        $this->wikidataGateway->method('getAwardsForActors')->willReturn([
+            'Test Actor' => [
+                ['name' => 'oscar du meilleur acteur', 'year' => 2020],
+                ['name' => 'Oscar de la meilleure actrice', 'year' => 2021],
+            ],
+        ]);
+
+        $existingOscar = new AwardType();
+        $existingOscar->setName('Oscar')->setPattern('Oscar');
+
+        $this->awardTypeRepository->method('findAll')->willReturn([$existingOscar]);
+
+        $persisted = [];
+        $this->em->method('persist')->willReturnCallback(function ($entity) use (&$persisted) {
+            $persisted[] = $entity;
+        });
+
+        $this->importer->importForActors([$actor]);
+
+        // Both awards should reuse the same "Oscar" type — only 2 Awards persisted, no new AwardType
+        $this->assertCount(2, $persisted);
+        $this->assertContainsOnlyInstancesOf(Award::class, $persisted);
+        $this->assertSame($existingOscar, $persisted[0]->getAwardType());
+        $this->assertSame($existingOscar, $persisted[1]->getAwardType());
+    }
+
+    private function createActorWithFlag(string $name, bool $awardsImported): Actor
+    {
+        $actor = new Actor();
+        $actor->setName($name);
+        $actor->setAwardsImported($awardsImported);
+
+        return $actor;
+    }
+}

tests/Provider/GameGridProviderTest.php

@@ -0,0 +1,83 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tests\Provider;
+
+use App\Entity\Actor;
+use App\Entity\Award;
+use App\Entity\AwardType;
+use App\Entity\GameRow;
+use App\Repository\ActorRepository;
+use App\Repository\AwardRepository;
+use App\Repository\MovieRepository;
+use App\Repository\MovieRoleRepository;
+use App\Provider\GameGridProvider;
+use Doctrine\ORM\EntityManagerInterface;
+use PHPUnit\Framework\TestCase;
+
+class GameGridProviderTest extends TestCase
+{
+    public function testResolveHintTextForAward(): void
+    {
+        $awardType = new AwardType();
+        $awardType->setName('Oscar')->setPattern('Academy Award');
+
+        $actor = new Actor();
+        $actor->setName('Test Actor');
+
+        $award = new Award();
+        $award->setName('Academy Award for Best Actor');
+        $award->setYear(2020);
+        $award->setActor($actor);
+        $award->setAwardType($awardType);
+
+        $awardRepository = $this->createMock(AwardRepository::class);
+        $awardRepository->method('find')->with(42)->willReturn($award);
+
+        $generator = new GameGridProvider(
+            $this->createMock(ActorRepository::class),
+            $this->createMock(MovieRoleRepository::class),
+            $this->createMock(MovieRepository::class),
+            $awardRepository,
+            $this->createMock(EntityManagerInterface::class),
+        );
+
+        $row = new GameRow();
+        $row->setHintType('award');
+        $row->setHintData('42');
+
+        // Use reflection to test the private resolveHintText method
+        $method = new \ReflectionMethod($generator, 'resolveHintText');
+        $result = $method->invoke($generator, $row);
+
+        $this->assertSame('Academy Award for Best Actor (2020)', $result);
+    }
+
+    public function testGenerateHintRespectsAllowedTypes(): void
+    {
+        $movieRoleRepo = $this->createMock(MovieRoleRepository::class);
+        $movieRoleRepo->method('findOneRandomByActor')->willReturn(null);
+
+        $awardRepo = $this->createMock(AwardRepository::class);
+        $awardRepo->method('findOneRandomByActor')->willReturn(null);
+        $awardRepo->method('findOneRandomByActorAndTypes')->willReturn(null);
+
+        $generator = new GameGridProvider(
+            $this->createMock(ActorRepository::class),
+            $movieRoleRepo,
+            $this->createMock(MovieRepository::class),
+            $awardRepo,
+            $this->createMock(EntityManagerInterface::class),
+        );
+
+        $actor = new Actor();
+        $actor->setName('Test');
+
+        // Only allow 'award' type, but no awards exist → should return null
+        $method = new \ReflectionMethod($generator, 'generateHint');
+        $result = $method->invoke($generator, $actor, ['award'], null);
+
+        $this->assertNull($result);
+    }
+}

tests/Repository/ActorRepositoryTest.php

@@ -0,0 +1,82 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tests\Repository;
+
+use App\Entity\Actor;
+use App\Entity\Movie;
+use App\Entity\MovieRole;
+use App\Entity\User;
+use App\Entity\UserMovie;
+use App\Repository\ActorRepository;
+use Doctrine\ORM\EntityManagerInterface;
+use Symfony\Bundle\FrameworkBundle\Test\KernelTestCase;
+
+class ActorRepositoryTest extends KernelTestCase
+{
+    private EntityManagerInterface $em;
+    private ActorRepository $repo;
+
+    protected function setUp(): void
+    {
+        self::bootKernel();
+        $this->em = self::getContainer()->get(EntityManagerInterface::class);
+        $this->repo = self::getContainer()->get(ActorRepository::class);
+    }
+
+    public function testFindOneRandomInWatchedFilmsReturnsOnlyWatchedActors(): void
+    {
+        $user = new User();
+        $user->setEmail('test-watched-' . uniqid() . '@example.com');
+        $user->setPassword('test');
+        $this->em->persist($user);
+
+        $watchedActor = new Actor();
+        $watchedActor->setName('Watched Actor');
+        $watchedActor->setPopularity(10.0);
+        $this->em->persist($watchedActor);
+
+        $movie = new Movie();
+        $movie->setTmdbId(99990);
+        $movie->setLtbxdRef('watched-test');
+        $movie->setTitle('Watched Film');
+        $this->em->persist($movie);
+
+        $role = new MovieRole();
+        $role->setActor($watchedActor);
+        $role->setMovie($movie);
+        $role->setCharacter('Hero');
+        $this->em->persist($role);
+
+        $userMovie = new UserMovie();
+        $userMovie->setUser($user);
+        $userMovie->setMovie($movie);
+        $this->em->persist($userMovie);
+
+        $unwatchedActor = new Actor();
+        $unwatchedActor->setName('Unwatched Actor');
+        $unwatchedActor->setPopularity(10.0);
+        $this->em->persist($unwatchedActor);
+
+        $movie2 = new Movie();
+        $movie2->setTmdbId(99991);
+        $movie2->setLtbxdRef('unwatched-test');
+        $movie2->setTitle('Unwatched Film');
+        $this->em->persist($movie2);
+
+        $role2 = new MovieRole();
+        $role2->setActor($unwatchedActor);
+        $role2->setMovie($movie2);
+        $role2->setCharacter('Villain');
+        $this->em->persist($role2);
+
+        $this->em->flush();
+
+        for ($i = 0; $i < 10; $i++) {
+            $result = $this->repo->findOneRandomInWatchedFilms($user, 0, 'w');
+            $this->assertNotNull($result);
+            $this->assertSame($watchedActor->getId(), $result->getId());
+        }
+    }
+}

tests/Repository/AwardRepositoryTest.php

@@ -0,0 +1,63 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tests\Repository;
+
+use App\Entity\Actor;
+use App\Entity\Award;
+use App\Entity\AwardType;
+use App\Repository\AwardRepository;
+use Doctrine\ORM\EntityManagerInterface;
+use Symfony\Bundle\FrameworkBundle\Test\KernelTestCase;
+
+class AwardRepositoryTest extends KernelTestCase
+{
+    private EntityManagerInterface $em;
+    private AwardRepository $repo;
+
+    protected function setUp(): void
+    {
+        self::bootKernel();
+        $this->em = self::getContainer()->get(EntityManagerInterface::class);
+        $this->repo = self::getContainer()->get(AwardRepository::class);
+    }
+
+    public function testFindOneRandomByActorAndTypesFiltersCorrectly(): void
+    {
+        $actor = new Actor();
+        $actor->setName('Award Actor Test');
+        $this->em->persist($actor);
+
+        $oscarType = new AwardType();
+        $oscarType->setName('Oscar')->setPattern('oscar');
+        $this->em->persist($oscarType);
+
+        $globeType = new AwardType();
+        $globeType->setName('Golden Globe')->setPattern('globe');
+        $this->em->persist($globeType);
+
+        $oscar = new Award();
+        $oscar->setName('Best Actor Oscar');
+        $oscar->setActor($actor);
+        $oscar->setAwardType($oscarType);
+        $this->em->persist($oscar);
+
+        $globe = new Award();
+        $globe->setName('Best Actor Globe');
+        $globe->setActor($actor);
+        $globe->setAwardType($globeType);
+        $this->em->persist($globe);
+
+        $this->em->flush();
+
+        for ($i = 0; $i < 10; $i++) {
+            $result = $this->repo->findOneRandomByActorAndTypes($actor->getId(), [$oscarType->getId()]);
+            $this->assertNotNull($result);
+            $this->assertSame('Best Actor Oscar', $result->getName());
+        }
+
+        $result = $this->repo->findOneRandomByActorAndTypes($actor->getId(), null);
+        $this->assertNotNull($result);
+    }
+}

tests/Repository/AwardTypeRepositoryTest.php

@@ -0,0 +1,67 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tests\Repository;
+
+use App\Entity\Actor;
+use App\Entity\Award;
+use App\Entity\AwardType;
+use App\Repository\AwardTypeRepository;
+use Doctrine\ORM\EntityManagerInterface;
+use Symfony\Bundle\FrameworkBundle\Test\KernelTestCase;
+
+class AwardTypeRepositoryTest extends KernelTestCase
+{
+    private EntityManagerInterface $em;
+    private AwardTypeRepository $repo;
+
+    protected function setUp(): void
+    {
+        self::bootKernel();
+        $this->em = self::getContainer()->get(EntityManagerInterface::class);
+        $this->repo = self::getContainer()->get(AwardTypeRepository::class);
+
+        // Clean award data (order matters for FK constraints)
+        $this->em->createQuery('DELETE FROM App\Entity\Award')->execute();
+        $this->em->createQuery('DELETE FROM App\Entity\AwardType')->execute();
+    }
+
+    public function testFindWithMinActorsFiltersCorrectly(): void
+    {
+        $smallType = new AwardType();
+        $smallType->setName('Small Award')->setPattern('small');
+        $this->em->persist($smallType);
+
+        $bigType = new AwardType();
+        $bigType->setName('Big Award')->setPattern('big');
+        $this->em->persist($bigType);
+
+        for ($i = 0; $i < 6; $i++) {
+            $actor = new Actor();
+            $actor->setName("Actor $i");
+            $this->em->persist($actor);
+
+            $award = new Award();
+            $award->setName("Big Award $i");
+            $award->setActor($actor);
+            $award->setAwardType($bigType);
+            $this->em->persist($award);
+
+            if ($i < 3) {
+                $awardSmall = new Award();
+                $awardSmall->setName("Small Award $i");
+                $awardSmall->setActor($actor);
+                $awardSmall->setAwardType($smallType);
+                $this->em->persist($awardSmall);
+            }
+        }
+
+        $this->em->flush();
+
+        $result = $this->repo->findWithMinActors(5);
+
+        $this->assertCount(1, $result);
+        $this->assertSame('Big Award', $result[0]->getName());
+    }
+}