Skip to content

Un buzzer en temps réel, un quiz/quizz palpitant et un blindtest endiablé : ce dépôt est la clé pour dynamiser vos sessions de jeu.

License

Notifications You must be signed in to change notification settings

NapoSky/rdv-buzzer

Repository files navigation

🎙️ RDV-Buzzer : Vue d'ensemble

Ce dépôt contient deux applications principales qui forment un système complet de quiz avec buzzer en temps réel :


1. RDV-Buzzer Frontend

  • Type : Application React
  • Fonctionnalités clés :
    • 🚀 Création et gestion de salles avec codes
    • 🔔 Système de buzzer en temps réel
    • 📊 Suivi des scores et mode admin
    • 🌓 Thème clair/sombre

Installation & Lancement

  1. Installer les dépendances :
    npm install
  2. Copier le fichier `.env.example` vers `.env` et ajuster les variables.
  3. Démarrer en mode développement :
    npm run dev

2. RDV-Buzzer Backend

  • Type : Serveur Node.js (Express + Socket.IO)
  • Fonctionnalités clés :
    • 🏗️ Création et gestion de salles
    • 🔄 Gestion du buzzer en temps réel
    • 🌐 API REST et WebSockets
    • 🎵 Intégration de services externes (ex. Spotify)

Installation & Lancement

  1. Installer les dépendances :
    npm install
  2. Copier le fichier `.env.example` vers `.env` et ajuster les variables.
  3. Démarrer en mode développement :
    npm run dev

Utilisation "out-of-the-box"

Déploiement via Docker Compose

Vous disposez d’un fichier docker-compose.example.yml à la racine du dépôt. Pour lancer l’application grâce à Docker Compose, placez-vous dans le répertoire racine, puis exécutez :

cp docker-compose.example.yml docker-compose.yml
docker-compose up -d --build

Architecture Globale

  1. Frontend gère l’interface utilisateur et communique avec le Backend via HTTP et WebSockets.
  2. Backend assure la logique métier (buzzer, sessions de quiz, scores) et expose des routes API ainsi qu’un serveur WebSocket.

Assurez-vous de configurer correctement les variables d’environnement pour que les deux parties puissent communiquer et partager la même clé de sécurité (APP_SECRET / REACT_APP_APP_SECRET).

About

Un buzzer en temps réel, un quiz/quizz palpitant et un blindtest endiablé : ce dépôt est la clé pour dynamiser vos sessions de jeu.

Topics

Resources

License

Stars

Watchers

Forks

Languages