Compare commits
No commits in common. "65beeff4f01235d4e61bc149a81ec577b33aec5d" and "5d113e1d37cf126a55f7aa8d36097cb455e87317" have entirely different histories.
65beeff4f0
...
5d113e1d37
11 changed files with 9 additions and 220 deletions
|
|
@ -1,11 +0,0 @@
|
||||||
**/node_modules
|
|
||||||
**/dist
|
|
||||||
**/.turbo
|
|
||||||
**/uploads
|
|
||||||
.git
|
|
||||||
.github
|
|
||||||
**/*.log
|
|
||||||
**/.env
|
|
||||||
**/.env.*
|
|
||||||
!**/.env.example
|
|
||||||
**/.DS_Store
|
|
||||||
34
CHANGELOG.md
34
CHANGELOG.md
|
|
@ -1,34 +0,0 @@
|
||||||
# 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
|
|
||||||
53
README.md
53
README.md
|
|
@ -4,9 +4,7 @@ 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
|
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.
|
rooms sont synchronisées en temps réel via Socket.IO.
|
||||||
|
|
||||||
**Quiz culture · Images (révélation) · Blindtest (YouTube)**, mélangeables dans
|
**V1 : Quiz culture + Blindtest (YouTube)**, mélangeables dans une même partie.
|
||||||
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
|
> Architecture détaillée : [`ARCHITECTURE.md`](./ARCHITECTURE.md) · consignes de
|
||||||
> dev : [`CLAUDE.md`](./CLAUDE.md).
|
> dev : [`CLAUDE.md`](./CLAUDE.md).
|
||||||
|
|
@ -54,7 +52,6 @@ docker compose up -d
|
||||||
cd apps/server && cp .env.example .env
|
cd apps/server && cp .env.example .env
|
||||||
bun run db:migrate # applique les migrations
|
bun run db:migrate # applique les migrations
|
||||||
bun run db:seed # seed Open Trivia DB (~1 req/5s) + banque FR
|
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 ../..
|
cd ../..
|
||||||
|
|
||||||
# config client
|
# config client
|
||||||
|
|
@ -87,53 +84,13 @@ Serveur (`apps/server`) : `db:generate`, `db:migrate`, `db:seed`, `db:studio`.
|
||||||
|
|
||||||
- **Quiz** — QCM, vrai/faux, et réponse libre (matching tolérant). Bonus de
|
- **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.
|
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
|
- **Blindtest** — chaque joueur soumet des liens YouTube ; un DJ neutre pilote
|
||||||
la lecture, les autres devinent (titre/artiste, qui l'a ajouté, ou mixte).
|
la lecture, les autres devinent (titre/artiste, qui l'a ajouté, ou mixte).
|
||||||
Nécessite ≥ 3 joueurs **dont 2 réels** (un bot ne peut pas être DJ). Récap des
|
Nécessite ≥ 3 joueurs. Récap des titres + liens en fin de partie.
|
||||||
titres + liens en fin de partie.
|
- **Mixte** (défaut) — séquence mélangée de manches quiz et blindtest.
|
||||||
- **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
|
## Back-office quiz
|
||||||
|
|
||||||
Page protégée `/admin` pour écrire des questions manuelles (QCM, vrai/faux,
|
Page protégée `/admin` pour écrire des questions manuelles (QCM, vrai/faux,
|
||||||
réponse libre, image), choisir leur langue et les activer/désactiver. Définir
|
réponse libre). Définir `ADMIN_TOKEN` dans `apps/server/.env` et une `DATABASE_URL`
|
||||||
`ADMIN_TOKEN` dans `apps/server/.env` et une `DATABASE_URL` valide. Le jeton est
|
valide. Le jeton est demandé à la connexion sur `/admin`.
|
||||||
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).
|
|
||||||
|
|
|
||||||
|
|
@ -1,23 +0,0 @@
|
||||||
# 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"]
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
{
|
{
|
||||||
"name": "@nerdware/server",
|
"name": "@nerdware/server",
|
||||||
"version": "0.1.0",
|
"version": "0.0.1",
|
||||||
"type": "module",
|
"type": "module",
|
||||||
"private": true,
|
"private": true,
|
||||||
"scripts": {
|
"scripts": {
|
||||||
|
|
|
||||||
|
|
@ -1,23 +0,0 @@
|
||||||
# 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
|
|
||||||
|
|
@ -1,17 +0,0 @@
|
||||||
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";
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
{
|
{
|
||||||
"name": "web",
|
"name": "web",
|
||||||
"version": "0.1.0",
|
"version": "0.0.1",
|
||||||
"type": "module",
|
"type": "module",
|
||||||
"private": true,
|
"private": true,
|
||||||
"scripts": {
|
"scripts": {
|
||||||
|
|
|
||||||
|
|
@ -1,60 +0,0 @@
|
||||||
# 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:
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
{
|
{
|
||||||
"name": "nerdware",
|
"name": "nerdware",
|
||||||
"version": "0.1.0",
|
"version": "0.0.1",
|
||||||
"private": true,
|
"private": true,
|
||||||
"scripts": {
|
"scripts": {
|
||||||
"build": "turbo build",
|
"build": "turbo build",
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
{
|
{
|
||||||
"name": "@nerdware/shared",
|
"name": "@nerdware/shared",
|
||||||
"version": "0.1.0",
|
"version": "0.0.1",
|
||||||
"type": "module",
|
"type": "module",
|
||||||
"private": true,
|
"private": true,
|
||||||
"scripts": {
|
"scripts": {
|
||||||
|
|
|
||||||
Loading…
Add table
Reference in a new issue