Setup & Démarrage

Prérequis

• Node.js (LTS)
• pnpm
• Compte Supabase (clé dans .env.local)

Installation

pnpm install

Lancer le serveur de dev

pnpm dev

Lint & format

pnpm lint
pnpm format

Build

pnpm build

Déploiement

• Vercel (voir vercel.json)
• Variables d’environnement dans .env.local

Firebase / FCM (push Android natif)

Pour envoyer des notifications vers l’app Android (FCM), le serveur a besoin d’un service account Firebase Admin.

• Côté Android, android/app/google-services.json sert uniquement à configurer l’app.
• Côté serveur (Next.js), il faut fournir une variable d’environnement :
  • FIREBASE_ADMIN_SERVICE_ACCOUNT_JSON : JSON complet du service account (ou sa version base64).

Note: ne commit jamais ce JSON dans le repo.

Supabase (migrations)

• Les évolutions de schéma sont versionnées dans /supabase/migrations/.
• Si une feature semble “cassée” uniquement sur un environnement, vérifier en priorité que les migrations ont bien été appliquées (drift possible entre environnements).

Notifications (cloche / inbox)

• La cloche lit les entrées dans la table public.notification_logs.
• La colonne type doit exister et être non vide.
• Si tu vois une erreur du type notification_logs_type_check ou un insert qui échoue côté test-push, applique la migration qui relaxe la contrainte pour accepter de nouveaux types.

Structure recommandée

• Pages : /src/app/
• Composants : /src/components/
• Libs : /src/lib/
• Types : /src/types/
• Docs : /docs/