2026-06-11 18:36:42 +00:00
11 changed files with 220 additions and 9 deletions
--- a/.dockerignore
+++ b/.dockerignore
@ -0,0 +1,11 @@
+**/node_modules
+**/dist
+**/.turbo
+**/uploads
+.git
+.github
+**/*.log
+**/.env
+**/.env.*
+!**/.env.example
+**/.DS_Store
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@ -0,0 +1,34 @@
+# Changelog
+
+Toutes les évolutions notables de NerdWare. Format basé sur
+[Keep a Changelog](https://keepachangelog.com/fr/1.1.0/), versionné en
+[SemVer](https://semver.org/lang/fr/).
+
+## [0.1.0] — 2026-06-11
+
+Première version déployable. Cycle de jeu temps réel complet (lobby → manches →
+fin), trois modes, back-office et internationalisation.
+
+### Ajouté
+
+- **Temps réel** : rooms en mémoire, synchronisation Socket.IO, serveur
+  autoritaire (timer, scores, ordre des manches), moteur de jeu générique.
+- **Modes de jeu** : Quiz (QCM / vrai-faux / réponse libre), Images (révélation
+  progressive floutée), Blindtest (YouTube, DJ neutre, modes titre & artiste /
+  qui l'a ajouté / mixte), et mode Mixte avec ordre mélangé.
+- **Réglages** : compteur par sous-mode, filtre de catégories, durée, titres par
+  joueur, difficulté des bots.
+- **Bots** : joueurs virtuels qui votent automatiquement (jamais DJ).
+- **Fin de partie** : podium animé, récompenses, récapitulatif des manches,
+  export playlist (Spotify / YouTube), copie des résultats.
+- **Reconnexion** : reprise de sa place après un refresh ou une coupure réseau ;
+  bouton « Quitter ».
+- **Back-office** quiz (token) : CRUD des questions, upload d'images, langue,
+  activation/désactivation.
+- **Historique** des parties par room.
+- **i18n** FR / EN de l'interface (détection navigateur + sélecteur).
+- **Persistance** : PostgreSQL + Drizzle (contenu quiz + historique).
+- **Déploiement** : Dockerfiles (serveur Bun, client nginx) + `docker-compose.prod.yml`
+  prêt pour Dokploy.
+
+[0.1.0]: https://git.ayoubbenziza.dev/ayoub/nerdware/src/tag/v0.1.0
--- a/README.md
+++ b/README.md
@ -4,7 +4,9 @@ Party game web multi-épreuves, ambiance WarioWare, centré culture geek (jeux
 vidéo, manga, pop culture). Chaque joueur joue sur son propre PC/téléphone, les
 rooms sont synchronisées en temps réel via Socket.IO.

-**V1 : Quiz culture + Blindtest (YouTube)**, mélangeables dans une même partie.
+**Quiz culture · Images (révélation) · Blindtest (YouTube)**, mélangeables dans
+une même partie. Interface FR / EN, reconnexion après refresh, bots pour jouer à
+plusieurs tout seul.

 > Architecture détaillée : [`ARCHITECTURE.md`](./ARCHITECTURE.md) · consignes de
 > dev : [`CLAUDE.md`](./CLAUDE.md).
@ -52,6 +54,7 @@ docker compose up -d
 cd apps/server && cp .env.example .env
 bun run db:migrate      # applique les migrations
 bun run db:seed         # seed Open Trivia DB (~1 req/5s) + banque FR
+bun run db:seed:images  # (optionnel) seed images via PokéAPI (mode Images)
 cd ../..

 # config client
@ -84,13 +87,53 @@ Serveur (`apps/server`) : `db:generate`, `db:migrate`, `db:seed`, `db:studio`.

 - **Quiz** — QCM, vrai/faux, et réponse libre (matching tolérant). Bonus de
  rapidité. Questions issues d'Open Trivia DB (seed) ou du back-office.
+- **Images** — une image se dé-floute progressivement, on devine le sujet
+  (réponse libre). Seed PokéAPI ou images uploadées dans le back-office.
 - **Blindtest** — chaque joueur soumet des liens YouTube ; un DJ neutre pilote
  la lecture, les autres devinent (titre/artiste, qui l'a ajouté, ou mixte).
-  Nécessite ≥ 3 joueurs. Récap des titres + liens en fin de partie.
- **Mixte** (défaut) — séquence mélangée de manches quiz et blindtest.
+  Nécessite ≥ 3 joueurs **dont 2 réels** (un bot ne peut pas être DJ). Récap des
+  titres + liens en fin de partie.
+- **Mixte** (défaut) — séquence mélangée de manches, par sous-modes au choix.
+
+Filtre par catégories, durée et nombre de manches réglables, et **bots** (niveau
+réglable) pour compléter une partie.

 ## Back-office quiz

 Page protégée `/admin` pour écrire des questions manuelles (QCM, vrai/faux,
-réponse libre). Définir `ADMIN_TOKEN` dans `apps/server/.env` et une `DATABASE_URL`
-valide. Le jeton est demandé à la connexion sur `/admin`.
+réponse libre, image), choisir leur langue et les activer/désactiver. Définir
+`ADMIN_TOKEN` dans `apps/server/.env` et une `DATABASE_URL` valide. Le jeton est
+demandé à la connexion sur `/admin`.
+
+## Déploiement (Dokploy)
+
+La stack de prod est décrite dans
+[`docker-compose.prod.yml`](./docker-compose.prod.yml) : `postgres`, `server`
+(Bun) et `web` (build statique servi par nginx). Voir
+[`.env.production.example`](./.env.production.example) pour les variables.
+
+1. **Dokploy → Create → Compose**, pointant sur ce repo et `docker-compose.prod.yml`.
+2. Renseigner les variables d'environnement : `POSTGRES_PASSWORD`, `ADMIN_TOKEN`,
+   `CORS_ORIGINS` (domaine du client), `VITE_SERVER_URL` (URL publique du serveur).
+3. Assigner les **domaines** via Traefik : le service `web` (port 80) sur le
+   domaine principal, le service `server` (port 3001) sur le sous-domaine d'API.
+   `VITE_SERVER_URL` doit pointer vers ce domaine d'API, et `CORS_ORIGINS` vers
+   celui du client.
+4. Déployer. Les **migrations** s'appliquent automatiquement au démarrage du
+   serveur. Pour peupler le contenu (one-shot) :
+   `docker compose -f docker-compose.prod.yml exec server bun run db:seed`.
+
+Les images uploadées sont persistées dans le volume `uploads`, la base dans
+`pgdata`.
+
+> Test local de la stack de prod :
+> `docker compose -f docker-compose.prod.yml up --build` (après avoir copié
+> `.env.production.example` en `.env`).
+
+## Versionnement & gitflow
+
+- Branches : `main` (production, taguée), `dev` (intégration), `feature/*`,
+  `release/*`.
+- Une **release** se coupe depuis `dev` (`release/x.y.z`), y reçoit le bump de
+  version + le CHANGELOG, puis fusionne dans `main` (taguée `vX.Y.Z`) et revient
+  dans `dev`. Voir [`CHANGELOG.md`](./CHANGELOG.md). Versionnage [SemVer](https://semver.org).
--- a/apps/server/Dockerfile
+++ b/apps/server/Dockerfile
@ -0,0 +1,23 @@
+# Serveur Fastify + Socket.IO (Bun, monorepo). Contexte de build = racine du repo.
+FROM oven/bun:1.3.14-alpine
+
+WORKDIR /app
+
+# Manifests d'abord (cache des dépendances).
+COPY package.json bun.lock turbo.json ./
+COPY apps/server/package.json apps/server/package.json
+COPY apps/web/package.json apps/web/package.json
+COPY packages/shared/package.json packages/shared/package.json
+COPY packages/ui/package.json packages/ui/package.json
+RUN bun install --frozen-lockfile
+
+# Sources nécessaires au serveur (le client n'est pas requis ici).
+COPY packages/shared packages/shared
+COPY apps/server apps/server
+
+WORKDIR /app/apps/server
+ENV NODE_ENV=production
+EXPOSE 3001
+
+# Applique les migrations (idempotent) puis démarre le serveur.
+CMD ["sh", "-c", "bun src/db/migrate.ts && bun src/index.ts"]
--- a/apps/server/package.json
+++ b/apps/server/package.json
@ -1,6 +1,6 @@
 {
  "name": "@nerdware/server",
-  "version": "0.0.1",
+  "version": "0.1.0",
  "type": "module",
  "private": true,
  "scripts": {
--- a/apps/web/Dockerfile
+++ b/apps/web/Dockerfile
@ -0,0 +1,23 @@
+# Client Vite/React : build statique puis service via nginx.
+# Contexte de build = racine du repo. VITE_SERVER_URL est figé au build.
+FROM oven/bun:1.3.14-alpine AS build
+
+WORKDIR /app
+COPY package.json bun.lock turbo.json ./
+COPY apps/web/package.json apps/web/package.json
+COPY apps/server/package.json apps/server/package.json
+COPY packages/shared/package.json packages/shared/package.json
+COPY packages/ui/package.json packages/ui/package.json
+RUN bun install --frozen-lockfile
+
+COPY packages packages
+COPY apps/web apps/web
+
+ARG VITE_SERVER_URL
+ENV VITE_SERVER_URL=$VITE_SERVER_URL
+RUN bun run --filter web build
+
+FROM nginx:1.27-alpine AS runner
+COPY apps/web/nginx.conf /etc/nginx/conf.d/default.conf
+COPY --from=build /app/apps/web/dist /usr/share/nginx/html
+EXPOSE 80
--- a/apps/web/nginx.conf
+++ b/apps/web/nginx.conf
@ -0,0 +1,17 @@
+server {
+  listen 80;
+  server_name _;
+  root /usr/share/nginx/html;
+  index index.html;
+
+  # SPA : toutes les routes (/room/:code, /join/:code, /admin) → index.html
+  location / {
+    try_files $uri $uri/ /index.html;
+  }
+
+  # Cache long pour les assets fingerprintés.
+  location /assets/ {
+    expires 1y;
+    add_header Cache-Control "public, immutable";
+  }
+}
--- a/apps/web/package.json
+++ b/apps/web/package.json
@ -1,6 +1,6 @@
 {
  "name": "web",
-  "version": "0.0.1",
+  "version": "0.1.0",
  "type": "module",
  "private": true,
  "scripts": {
--- a/docker-compose.prod.yml
+++ b/docker-compose.prod.yml
@ -0,0 +1,60 @@
+# Stack de production NerdWare (postgres + serveur + client).
+# Pensé pour Dokploy (assigne les domaines via Traefik) ou un `docker compose up`.
+#
+# Variables attendues (UI Dokploy ou fichier .env à côté de ce fichier) :
+#   POSTGRES_PASSWORD   mot de passe Postgres
+#   ADMIN_TOKEN         jeton du back-office quiz
+#   CORS_ORIGINS        domaine(s) du client, ex. https://nerdware.example.com
+#   VITE_SERVER_URL     URL publique du serveur, ex. https://api.nerdware.example.com
+services:
+  postgres:
+    image: postgres:17-alpine
+    restart: unless-stopped
+    environment:
+      POSTGRES_USER: ${POSTGRES_USER:-nerdware}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-nerdware}
+      POSTGRES_DB: ${POSTGRES_DB:-nerdware}
+    volumes:
+      - pgdata:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-nerdware} -d ${POSTGRES_DB:-nerdware}"]
+      interval: 5s
+      timeout: 5s
+      retries: 5
+
+  server:
+    build:
+      context: .
+      dockerfile: apps/server/Dockerfile
+    restart: unless-stopped
+    depends_on:
+      postgres:
+        condition: service_healthy
+    environment:
+      NODE_ENV: production
+      HOST: 0.0.0.0
+      PORT: 3001
+      DATABASE_URL: postgres://${POSTGRES_USER:-nerdware}:${POSTGRES_PASSWORD:-nerdware}@postgres:5432/${POSTGRES_DB:-nerdware}
+      ADMIN_TOKEN: ${ADMIN_TOKEN}
+      CORS_ORIGINS: ${CORS_ORIGINS}
+      UPLOADS_DIR: /data/uploads
+    volumes:
+      - uploads:/data/uploads
+    expose:
+      - "3001"
+
+  web:
+    build:
+      context: .
+      dockerfile: apps/web/Dockerfile
+      args:
+        VITE_SERVER_URL: ${VITE_SERVER_URL}
+    restart: unless-stopped
+    depends_on:
+      - server
+    expose:
+      - "80"
+
+volumes:
+  pgdata:
+  uploads:
--- a/package.json
+++ b/package.json
@ -1,6 +1,6 @@
 {
  "name": "nerdware",
-  "version": "0.0.1",
+  "version": "0.1.0",
  "private": true,
  "scripts": {
    "build": "turbo build",
--- a/packages/shared/package.json
+++ b/packages/shared/package.json
@ -1,6 +1,6 @@
 {
  "name": "@nerdware/shared",
-  "version": "0.0.1",
+  "version": "0.1.0",
  "type": "module",
  "private": true,
  "scripts": {