From b216d59b945ee24d081be14c43dd6eceadf2b2ea Mon Sep 17 00:00:00 2001 From: Valentin ROBIN Date: Sat, 11 Jul 2026 11:00:23 +0200 Subject: [PATCH] first commit --- README.md | 153 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 153 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..d2589f0 --- /dev/null +++ b/README.md @@ -0,0 +1,153 @@ +# Le Tribunal + +Application web pour animer et scorer le jeu **« Le Tribunal »** entre amis pendant une semaine de vacances : comptes, profils et leaderboard. Le socle est **ré-thématisable par édition** (un thème différent chaque année). + +> **État actuel : V1** — le périmètre se limite à l'authentification, aux profils et au leaderboard. Le jeu lui-même (le bus, la roulette, l'ostracisme, etc.) arrivera dans des versions suivantes (voir la [roadmap](#roadmap)). + +--- + +## Fonctionnalités (V1) + +- 🔐 **Création de compte** avec pseudo, mot de passe et photo de profil +- 👤 **Connexion / déconnexion** par pseudo + mot de passe (pas d'email visible) +- 🖼️ **Profil éditable** : changer son pseudo et sa photo +- 🏆 **Leaderboard** de tous les inscrits, trié par points (rang · photo · pseudo · points) +- 📱 **Responsive**, pensé mobile-first et propre sur ordinateur + +--- + +## Stack technique + +| Rôle | Techno | +|--------------------------|---------------------------------| +| Framework | Next.js (App Router) + TypeScript | +| Style | Tailwind CSS | +| Auth · Base · Stockage | Supabase (Auth, Postgres, Storage) | +| Déploiement | Vercel + Supabase (managé) | + +--- + +## Prérequis + +- [Node.js](https://nodejs.org/) 18 ou supérieur +- Un compte [Supabase](https://supabase.com/) (offre gratuite suffisante) +- Un compte [Vercel](https://vercel.com/) pour le déploiement (optionnel en local) + +--- + +## Installation + +### 1. Cloner et installer + +```bash +git clone https://github.com//le-tribunal.git +cd le-tribunal +npm install +``` + +### 2. Créer le projet Supabase + +1. Créez un nouveau projet sur [supabase.com](https://supabase.com/). +2. Dans **SQL Editor**, exécutez le contenu de [`supabase/schema.sql`](supabase/schema.sql) (table `profiles` + policies RLS). +3. Dans **Storage**, créez un bucket **public** nommé `avatars`. +4. Récupérez l'URL du projet et la clé `anon` dans **Project Settings → API**. + +### 3. Variables d'environnement + +Copiez le fichier d'exemple et renseignez vos valeurs : + +```bash +cp .env.local.example .env.local +``` + +```env +NEXT_PUBLIC_SUPABASE_URL=https://xxxxxxxx.supabase.co +NEXT_PUBLIC_SUPABASE_ANON_KEY=votre_cle_anon +``` + +> ⚠️ Ne mettez **jamais** la clé `service_role` dans le front ni dans le dépôt. + +### 4. Lancer en local + +```bash +npm run dev +``` + +L'application tourne sur [http://localhost:3000](http://localhost:3000). + +--- + +## Scripts + +| Commande | Description | +|------------------|------------------------------------| +| `npm run dev` | Serveur de développement | +| `npm run build` | Build de production | +| `npm run start` | Lance le build de production | +| `npm run lint` | Vérification du code (ESLint) | + +--- + +## Déploiement (Vercel) + +1. Importez le dépôt dans Vercel. +2. Renseignez les variables d'environnement (`NEXT_PUBLIC_SUPABASE_URL`, `NEXT_PUBLIC_SUPABASE_ANON_KEY`). +3. Déployez. Vercel rebuild automatiquement à chaque push sur la branche principale. + +--- + +## Structure du projet + +``` +le-tribunal/ +├─ app/ +│ ├─ login/page.tsx # Connexion (pseudo + mot de passe) +│ ├─ signup/page.tsx # Création de compte + upload photo +│ ├─ leaderboard/page.tsx # Classement de tous les inscrits +│ ├─ profile/page.tsx # Édition du profil + déconnexion +│ ├─ layout.tsx # Layout + navigation +│ └─ page.tsx # Redirection selon l'état de connexion +├─ components/ # Composants UI réutilisables +├─ lib/supabase/ # Clients Supabase (browser / server) +├─ supabase/schema.sql # Schéma + policies RLS (versionné) +├─ middleware.ts # Protection des routes + session +├─ .env.local.example +└─ README.md +``` + +--- + +## Authentification + +La connexion se fait par **pseudo + mot de passe**, sans email visible. En interne, un email technique est dérivé du pseudo (`slug@letribunal.local`) pour s'appuyer sur Supabase Auth. Le pseudo affiché est stocké dans la table `profiles`, et son unicité est vérifiée à l'inscription. + +> Pas de réinitialisation de mot de passe par email en V1 (cercle d'amis, pas d'email réel collecté). Un administrateur peut réinitialiser un mot de passe depuis la console Supabase si nécessaire. + +--- + +## Sécurité + +- Mots de passe hachés et gérés par Supabase Auth (jamais stockés en clair). +- **Row Level Security** activée : chacun ne peut modifier que son propre profil, et **les points ne sont pas modifiables** depuis l'application (gestion admin prévue plus tard). +- Lecture des profils réservée aux utilisateurs authentifiés (nécessaire pour le leaderboard). + +--- + +## Ré-thématisation + +Les couleurs sont définies comme **design tokens** (variables CSS), afin de pouvoir changer l'habillage d'une édition à l'autre sans toucher aux composants. Palette par défaut : navy `#0F2748`, or `#C9A227`, ivoire `#F4ECD8`, encre `#2A2116`. + +--- + +## Roadmap + +- [ ] **Rôles admin / juges** — attribution de points, modération +- [ ] **Éditions & thèmes** — année, nom du thème, mood board, vocabulaire configurable +- [ ] **Le jeu du Tribunal** — le Char, batailles de cul sec, ostracisme, roulette, timer du Gardien +- [ ] **Temps réel** — leaderboard et fil d'événements live, mode « grand écran » pour vidéoprojecteur + +--- + +## Licence + +Projet personnel et privé, destiné à un usage entre amis. \ No newline at end of file