diff --git a/.dockerignore b/.dockerignore new file mode 100644 index 0000000..b71b62e --- /dev/null +++ b/.dockerignore @@ -0,0 +1,11 @@ +**/node_modules +**/dist +**/.turbo +**/uploads +.git +.github +**/*.log +**/.env +**/.env.* +!**/.env.example +**/.DS_Store diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..6286014 --- /dev/null +++ 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 diff --git a/README.md b/README.md index cf72be1..898fb46 100644 --- 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). diff --git a/apps/server/Dockerfile b/apps/server/Dockerfile new file mode 100644 index 0000000..0fdac43 --- /dev/null +++ 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"] diff --git a/apps/server/package.json b/apps/server/package.json index c2e5525..a50afb6 100644 --- 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": { diff --git a/apps/web/Dockerfile b/apps/web/Dockerfile new file mode 100644 index 0000000..ba9a281 --- /dev/null +++ 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 diff --git a/apps/web/nginx.conf b/apps/web/nginx.conf new file mode 100644 index 0000000..9628322 --- /dev/null +++ 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"; + } +} diff --git a/apps/web/package.json b/apps/web/package.json index bbb95dc..4df7ac1 100644 --- 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": { diff --git a/docker-compose.prod.yml b/docker-compose.prod.yml new file mode 100644 index 0000000..d7d3a9c --- /dev/null +++ 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: diff --git a/package.json b/package.json index 51e36c8..0979aee 100644 --- 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", diff --git a/packages/shared/package.json b/packages/shared/package.json index c80f8da..97bb4b8 100644 --- 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": {