Rituels

Rituels est un jeu de cartes en ligne gratuit de déduction pour 2 à 4 joueurs, inspiré de l'expérience de superstition du pigeon de B.F. Skinner. Les règles changent à chaque partie : déduisez la logique cachée du système en jouant vos cartes et récoltez vos graines avant les autres.

🌐 Jouer en ligne : https://rituels.xiao-web.com/

🚀 Fonctionnalités

• Multijoueur en temps réel : Synchronisation fluide des parties grâce à Socket.io.
• Logique de jeu sécurisée : Les calculs de score et la génération de cartes sont entièrement gérés côté serveur. Le serveur identifie chaque joueur par son socket (jamais par un id envoyé par le client), vérifie le tour et que la carte jouée est bien dans son deck (anti-triche). Un joueur ne peut être que dans une seule partie à la fois (création et adhésion refusées sinon). Les règles secrètes, les mains des autres joueurs et les identifiants de session ne sont jamais envoyés aux clients : les règles ne sont révélées qu'à la fin de la partie.
• Chat intégré : Discutez avec les autres joueurs dans le lobby et pendant la partie (avec défilement automatique). Les pseudos (10 caractères max) et messages (300 max, 1 par seconde) sont modérés par un LLM (Groq).
• Interface dynamique et réactive : Animations fluides avec Framer Motion et design moderne.
• Système de sessions : Sauvegarde locale de votre pseudonyme et détection automatique des nouveaux joueurs pour l'animation d'introduction.
• Page légale indexable : mentions légales, politique de confidentialité, charte et crédits sont servis sur une vraie URL, /mentions-legales, présente dans le sitemap (le jeu lui-même reste une page unique à /).

🛠️ Stack Technique

• Frontend : Next.js (React), TypeScript, Tailwind CSS, Framer Motion, Socket.io-client.
• Backend : Node.js, Express, Socket.io, Groq (modération).

💻 Installation et Lancement local

Prérequis

• Node.js (v18 ou supérieur recommandé)
• npm ou yarn

1. Démarrer le Backend (Serveur)

Ouvrez un terminal à la racine du projet :

cd backend
npm install
npm run dev

Variables d'environnement du backend :

• GROQ_API_KEY (obligatoire) : clé API Groq pour la modération ; GROQ_MODEL (optionnel).
• PORT (défaut 4000) ; ALLOWED_ORIGINS (optionnel, origines CORS séparées par des virgules).

Le frontend contacte le backend via NEXT_PUBLIC_SOCKET_URL (défaut http://localhost:4000).

Tests du backend : npm test (à la racine du projet ou dans backend/). Tests du frontend : npm test dans frontend/ (hooks et gestion des events serveur ; les écrans sont vérifiés à la main).

2. Démarrer le Frontend (Client)

Ouvrez un nouveau terminal :

cd frontend
npm install
npm run dev

L'application frontend sera accessible sur http://localhost:3000.

📄 Licence

Le code source est publié sous licence ISC.

Cette licence ne couvre pas les ressources du dossier frontend/public/ et la police : illustrations, cartes, animations, musique, effets sonores et typographie restent soumis à leurs propres droits (voir la section Crédits du site). Ne les réutilisez pas sans autorisation.

🌍 Déploiement

• Hébergement : Le frontend et le backend sont hébergés chez Hostinger. (Note : Le backend utilise directement les variables process.env en production).