56115b5a9f
- packages/shared (@nerdware/shared): domain model (Room, Player, Settings, Round, votes, scores) + fully typed Socket.IO events, consumed as source - apps/server (@nerdware/server): Fastify boot + /health, typed Socket.IO attached to the HTTP server, env config, graceful shutdown - gitignore: allow .env.example to be committed Roadmap V1 step 1. Room logic (room:create/join) comes next. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
89 lines
2.7 KiB
TypeScript
89 lines
2.7 KiB
TypeScript
// Modèle de domaine partagé entre client et serveur.
|
|
// Le serveur est la source de vérité ; le client n'affiche qu'un état reçu.
|
|
|
|
/** Statut courant d'une room (machine à états du jeu). */
|
|
export type RoomStatus = "lobby" | "in_round" | "reveal" | "scores" | "ended"
|
|
|
|
/** Types d'épreuves disponibles. Étendre = ajouter une valeur + un module GameRound. */
|
|
export type RoundType = "blindtest" | "quiz"
|
|
|
|
/** Modes de blindtest, déterminent la forme du vote et le barème. */
|
|
export type BlindtestMode = "title_artist" | "who_added" | "mixed"
|
|
|
|
/** Formats de question quiz. */
|
|
export type QuizFormat = "mcq" | "truefalse" | "free" | "image_reveal"
|
|
|
|
/** Joueur connecté à une room. */
|
|
export interface Player {
|
|
id: string
|
|
name: string
|
|
connected: boolean
|
|
}
|
|
|
|
/** Configuration d'une épreuve planifiée dans la séquence de la partie. */
|
|
export interface RoundConfig {
|
|
type: RoundType
|
|
}
|
|
|
|
/** Réglages de la room, modifiables dans le lobby par l'hôte. */
|
|
export interface RoomSettings {
|
|
blindtestMode: BlindtestMode
|
|
/** Durée d'une manche en secondes (def. 60). */
|
|
roundDuration: number
|
|
/** Séquence d'épreuves de la partie. */
|
|
rounds: RoundConfig[]
|
|
}
|
|
|
|
/** Réglages par défaut d'une nouvelle room. */
|
|
export const DEFAULT_ROOM_SETTINGS: RoomSettings = {
|
|
blindtestMode: "title_artist",
|
|
roundDuration: 60,
|
|
rounds: [],
|
|
}
|
|
|
|
// --- Votes ---------------------------------------------------------------
|
|
|
|
/** Vote blindtest, forme selon RoomSettings.blindtestMode. */
|
|
export type BlindtestAnswer =
|
|
| { title: string; artist: string }
|
|
| { guessedPlayerId: string }
|
|
| { title: string; artist: string; guessedPlayerId: string }
|
|
|
|
/** Vote quiz, forme selon le format de la question. */
|
|
export type QuizAnswer = { choiceIndex: number } | { text: string }
|
|
|
|
/** Réponse soumise par un joueur pour la manche en cours. */
|
|
export type Answer = BlindtestAnswer | QuizAnswer
|
|
|
|
// --- Scores --------------------------------------------------------------
|
|
|
|
/** Score d'un joueur. */
|
|
export interface PlayerScore {
|
|
playerId: string
|
|
score: number
|
|
}
|
|
|
|
/** Variation de score appliquée à l'issue d'une manche. */
|
|
export interface ScoreDelta {
|
|
playerId: string
|
|
delta: number
|
|
}
|
|
|
|
// --- Snapshot diffusé au client (room:state) -----------------------------
|
|
|
|
/**
|
|
* Vue publique de la room poussée à tous les clients.
|
|
* Ne contient JAMAIS de réponse non révélée ni d'info secrète (ex: submittedBy).
|
|
*/
|
|
export interface RoomSnapshot {
|
|
code: string
|
|
status: RoomStatus
|
|
hostId: string
|
|
players: Player[]
|
|
settings: RoomSettings
|
|
scores: PlayerScore[]
|
|
/** Index de la manche en cours, -1 dans le lobby. */
|
|
currentRound: number
|
|
/** Nombre total de manches planifiées. */
|
|
totalRounds: number
|
|
}
|