d3ce52b60a
Back-office (roadmap V1 step 7): - server: token-protected HTTP API under /api/admin (ADMIN_TOKEN), Drizzle-backed CRUD for manual questions — list, create (mcq/truefalse/free, category upsert, dedup on prompt, validation), delete; 401/503 when unauthorized/unconfigured - client: /admin page with token login + TanStack Query (list/create/delete), format-aware form (QCM / vrai-faux / réponse libre) - env: ADMIN_TOKEN README: replace the shadcn template with a real NerdWare overview (stack, structure, getting started, scripts, game modes, back-office). Verified against real Postgres: auth (401), create (201), dedup (409), validation (400), list, delete (200/404). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
96 lines
3.2 KiB
Markdown
96 lines
3.2 KiB
Markdown
# NerdWare
|
|
|
|
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.
|
|
|
|
> Architecture détaillée : [`ARCHITECTURE.md`](./ARCHITECTURE.md) · consignes de
|
|
> dev : [`CLAUDE.md`](./CLAUDE.md).
|
|
|
|
## Stack
|
|
|
|
| Couche | Choix |
|
|
|---|---|
|
|
| Langage | TypeScript (strict, front + back) |
|
|
| Runtime / package manager | **Bun** |
|
|
| Monorepo | Turborepo |
|
|
| Backend | Fastify + Socket.IO |
|
|
| DB | PostgreSQL + Drizzle ORM (contenu quiz + historique ; rooms en mémoire) |
|
|
| Frontend | Vite + React, wouter, Zustand, TanStack Query (back-office) |
|
|
| UI | Tailwind v4 + shadcn/ui, Framer Motion, Lucide |
|
|
| Audio | YouTube IFrame Player API |
|
|
| Avatars | DiceBear (style lorelei), générés en local |
|
|
|
|
## Structure
|
|
|
|
```
|
|
apps/
|
|
web/ Client Vite + React (jeu + back-office)
|
|
server/ Fastify + Socket.IO + Drizzle (moteur de jeu autoritaire)
|
|
packages/
|
|
shared/ Types de domaine + events WS partagés (@nerdware/shared)
|
|
ui/ Composants shadcn/ui (@workspace/ui)
|
|
```
|
|
|
|
Le serveur est **autoritaire** : timer, scores, ordre des manches et tirage du
|
|
DJ sont tranchés côté serveur ; le client n'affiche que l'état reçu. Chaque
|
|
épreuve implémente l'interface `GameRound` (`start / submitAnswer / reveal /
|
|
score`) — ajouter un mode = un module, sans toucher à la plomberie.
|
|
|
|
## Démarrer
|
|
|
|
Prérequis : [Bun](https://bun.sh) ≥ 1.3, et [Docker](https://www.docker.com)
|
|
pour la base (optionnel — sans DB, le quiz tourne sur une banque en dur).
|
|
|
|
```bash
|
|
bun install
|
|
|
|
# (optionnel) base de données
|
|
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
|
|
cd ../..
|
|
|
|
# config client
|
|
cd apps/web && cp .env.example .env && cd ../..
|
|
|
|
# tout lancer (Turborepo)
|
|
bun run dev
|
|
```
|
|
|
|
- Client : http://localhost:5173
|
|
- Serveur : http://localhost:3001
|
|
|
|
Crée une room, choisis ton pseudo, partage le **lien d'invitation**, et lancez
|
|
une partie (quiz, blindtest ou mixte).
|
|
|
|
## Scripts (racine)
|
|
|
|
```bash
|
|
bun run dev # tout en dev
|
|
bun run build # build complet
|
|
bun run lint # lint
|
|
bun run typecheck # type-check
|
|
bun run test # tests (bun test)
|
|
bun run format # prettier
|
|
```
|
|
|
|
Serveur (`apps/server`) : `db:generate`, `db:migrate`, `db:seed`, `db:studio`.
|
|
|
|
## Modes de jeu
|
|
|
|
- **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.
|
|
- **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.
|
|
|
|
## 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`.
|