Checklist (HTML / CSS / JS)

Site statique + fonctions serverless Vercel (/api) + Supabase. Node.js 22+ est nécessaire.

Structure

Fichier	Rôle
index.html	Pages (connexion, liste, formulaire)
style.css	Styles
app.js	Logique client, appelle les endpoints /api/*
api/bootstrap.js	Démarrage : devs, tâches non terminées et terminées des 30 derniers jours, en un appel
api/login.js, api/logout.js	Connexion (limitée à 5 échecs par IP sur 15 min) et déconnexion
api/tasks.js, api/tasks/[id].js	Création, modification (avec détection des modifications concurrentes), suppression ; pages de terminées anciennes
api/devs.js, api/devs/[id].js	Devs : liste, ajout, renommage, suppression
api/comments.js	Commentaires d'une tâche
api/keepalive.js	Requête quotidienne (Vercel Cron) pour éviter la mise en pause du projet Supabase
api/_lib/*.js	Client Supabase admin, session signée, retry, validation des tâches, erreurs
build-config.mjs	Valide au build que les variables d'environnement requises sont présentes
schema.sql	Tables, migrations, index et sécurité (RLS sans policy) — idempotent
vercel.json	Build, région des fonctions, en-têtes de sécurité

Authentification

L'accès n'utilise plus Supabase Auth. La connexion se fait avec APP_LOGIN / APP_PASSWORD, vérifiés côté serveur uniquement par api/login.js. Une fois validés, un cookie de session signé (HttpOnly, Secure, SameSite=Strict, 8 h) autorise l'accès aux endpoints /api/tasks, /api/devs, etc. Toutes les requêtes vers Supabase passent par ces fonctions serverless, qui utilisent la clé secrète (SUPABASE_SECRET_KEY) — jamais exposée au navigateur.

• Après 5 échecs depuis une même IP en 15 minutes, /api/login répond 429 (« Trop de tentatives ») ; une connexion réussie remet le compteur à zéro (table LoginAttempt).
• Quand la session expire, toute requête répond 401 : l'application revient à l'écran de connexion avec « Session expirée, reconnecte-toi ».

Mise en place

1. Supabase → SQL Editor : exécuter schema.sql (voir « Migrations »).
2. Supabase → Settings → API : récupérer l'URL du projet et la clé secrète (service_role / sb_secret_...).
3. Sur Vercel, importer le repo (Framework : Other) et ajouter dans les variables d'environnement du projet :
   • SUPABASE_URL
   • SUPABASE_SECRET_KEY
   • APP_LOGIN
   • APP_PASSWORD
   • SESSION_SECRET (chaîne aléatoire longue, ex. générée avec openssl rand -base64 32)
   • CRON_SECRET (autre chaîne aléatoire longue) : protège /api/keepalive, voir « Mise en pause de Supabase »
4. La commande de build (node build-config.mjs) et le répertoire de sortie (.) sont déjà définis dans vercel.json.

Migrations

schema.sql contient tout le schéma et toutes les migrations, et il est idempotent : on le ré-exécute en entier (Supabase → SQL Editor) à chaque évolution, sans risque pour les données.

Toujours exécuter schema.sql AVANT de déployer une version qui en dépend : le code lit des colonnes et des tables (notes, TaskComment, LoginAttempt, updatedAt mis à jour par trigger…) qui doivent exister. Dans le cas contraire, /api/bootstrap ou /api/login échouent et l'application ne se charge plus.

Ce que le fichier met en place :

• tables Task, Dev, TaskComment, LoginAttempt ;
• clés étrangères vers Dev(name) : Task.assignedTo (renommage répercuté, suppression → non assigné) et TaskComment.author (renommage répercuté, suppression → « Ancien dev ») ;
• trigger qui met à jour Task.updatedAt à chaque modification (utilisé pour détecter les modifications concurrentes et charger les terminées récentes) ;
• index de filtre, de tri et de clés étrangères ;
• RLS activée sans policy, puis rechargement du cache de schéma de l'API (notify pgrst).

Région des fonctions

Chaque action passe par une fonction /api qui interroge Supabase : les fonctions doivent tourner dans la même région que la base, sinon chaque requête traverse l'Europe (ou l'Atlantique) en plus.

1. Supabase → Project Settings → General : lire la région du projet (aussi visible en haut du tableau de bord).
2. Mettre la région Vercel correspondante dans vercel.json ("regions") :

Région Supabase	Région Vercel
West EU (Ireland) — eu-west-1	dub1
West EU (London) — eu-west-2	lhr1
West EU (Paris) — eu-west-3	cdg1
Central EU (Frankfurt) — eu-central-1	fra1
East US (North Virginia) — us-east-1	iad1

Le projet actuel est en eu-west-1 (Irlande) : vercel.json utilise donc dub1. Après déploiement, la région est visible dans Vercel → Deployments → (déploiement) → Functions.

Local

npm install
node build-config.mjs
npx vercel dev

Copier .env.example vers .env et renseigner les variables avant de lancer. npx vercel dev est nécessaire (au lieu de npx serve .) pour exécuter les fonctions /api localement.

여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗