MODULE 32 / 72
✅
Architecture & qualité projet : la checklist Supabase
Une app qui tient la route se voit dans le projet avant même de lancer le serveur. Cette checklist couvre les décisions d'architecture, de sécurité et de qualité qui distinguent un projet maintenable d'un projet jetable. Elle est orientée stack Supabase + TypeScript, mais les principes s'appliquent à toute stack moderne.
Must-have vs good-to-have. Must-have : non négociable. Un projet sans ces éléments a une dette technique active — chaque jour sans eux coûte plus cher à corriger. Good-to-have : fortement recommandé, notamment si l'app dure plus de 3 mois ou est reprise par quelqu'un d'autre. Nice-to-have : selon le contexte.
Découpage par feature, pas par type technique. L'organisation classique (dossiers `controllers/`, `models/`, `views/`) impose de naviguer entre 3 dossiers pour modifier une feature. L'organisation par feature (`features/auth/`, `features/teams/`, `features/billing/`) garde tout ce qui concerne une feature au même endroit. Quand vous supprimez une feature, vous supprimez un dossier.
RLS activé sur toutes les tables Supabase. Row Level Security = chaque requête SQL est filtrée selon l'identité de l'utilisateur. Sans RLS, n'importe qui avec votre clé anon peut lire toutes les données de toutes les tables. Ce n'est pas une option — c'est le mécanisme de sécurité fondamental de Supabase.
Service role key : jamais côté client. La service_role key de Supabase bypasse le RLS. Si elle est dans votre frontend, n'importe qui peut inspecter le réseau et accéder à l'intégralité de votre BDD. Elle ne doit exister que dans les Edge Functions et les environnements serveur avec accès restreint.
TanStack Query pour la gestion du cache. TanStack Query (ex React Query) gère automatiquement le cache, les états loading/error, la revalidation et les mutations. Un hook par domaine (useTeams, useMatches) isole la logique de fetching et rend les composants purs. Sans ça : des useEffect imbriqués, des race conditions, et des états loading gérés à la main partout.
Checklist WeWeb + Supabase : uniquement la clé publishable/anon dans le front ; Security Advisor Supabase au vert ; clé secrète uniquement dans Make, n8n ou Edge Functions.
⚡ ANALOGIE — LES FONDATIONS D'UNE MAISON
Cette checklist, c'est l'inspection des fondations avant d'emménager. Le RLS = les serrures sur chaque porte (pas seulement la porte d'entrée). La service_role key en public = laisser le passe-partout sous le paillasson. Le découpage par feature = ranger chaque pièce avec tout ce dont elle a besoin (la cuisine a ses ustensiles, la salle de bain ses produits). Les types générés automatiquement = un plan d'architecte qui se met à jour automatiquement quand vous modifiez les murs. Un README = le manuel d'utilisation pour le prochain habitant.
📐 SCHÉMA
🗂 Project Setup
TypeScript strict mode activé (strict: true dans tsconfig)
must-have
.env.example committé avec toutes les variables (sans valeurs)
must-have
.gitignore inclut .env, node_modules, .expo, dist
must-have
README.md avec installation, variables d'env, commandes de démarrage
must-have
Linter configuré (ESLint + règles TS)
good
🏛 Architecture
Découpage par feature, pas par type technique
must-have
Logique pure isolée dans lib/domain/ — sans effets de bord, testable
must-have
Composants UI sans logique métier
must-have
State global Zustand découpé par domaine (authStore, teamStore…)
good
ARCHITECTURE.md documentant les couches et flux de données
good
🗄 Supabase / Base de données
RLS (Row Level Security) activé sur toutes les tables
must-have
Migrations versionnées dans supabase/migrations/
must-have
Types générés via supabase gen types typescript (jamais écrits à la main)
must-have
Secrets hors repo — via Dashboard ou supabase secrets set
must-have
Service role key uniquement dans les Edge Functions, jamais côté client
must-have
seed.sql pour les données de test
good
🔒 Sécurité
Clé anon publique uniquement côté client
must-have
Validation JWT dans chaque Edge Function
must-have
CORS configuré explicitement dans les Edge Functions
must-have
Variables d'env validées au démarrage (ex: Zod)
good
📡 Data Fetching
TanStack Query pour tous les appels distants
must-have
Un hook par domaine (useTeams, useMatches…)
must-have
invalidateQueries après chaque mutation
must-have
Gestion des états loading / error dans chaque hook
good
✅ Qualité Code
Zéro erreur TypeScript (tsc --noEmit propre)
must-have
Pas de any sauf cas documentés
good
Tests unitaires sur la logique pure (lib/domain/)
good
Monitoring erreurs prod (Sentry ou équivalent)
good
must-have
Non négociablegood
Fortement recommandénice
Selon contexte💬 QUESTION INTERACTIVE
1/5
"Pourquoi le RLS doit être activé sur TOUTES les tables, même celles qui semblent publiques ?"
🎯 PIÈGE / QUESTION D'ENTRETIEN
On a activé RLS sur toutes les tables. On est sécurisés ?