Kdovie
La liste de cadeaux qui suit vos événements. Un compte, tous vos événements,
une cagnotte fractionnée pour chaque cadeau.
Stack
- Next.js 16 (App Router) + TypeScript + Tailwind v4
- Supabase (Postgres + Auth + Realtime) — voir
lib/supabase/
- Stripe Connect (Express) pour la cagnotte fractionnée — voir
lib/stripe.ts
- Resend pour les emails transactionnels — voir
lib/resend.ts
- Déploiement prévu sur Vercel
Démarrage local
npm install
cp .env.example .env.local # puis renseigner les clés (voir ci-dessous)
npm run dev
Le site est disponible sur http://localhost:3000.
Configuration des services externes
Supabase : créer un projet sur supabase.com, récupérer l'URL et les clés
dans Project settings > API, les mettre dans .env.local. La clé
service_role ne doit jamais être exposée côté client (utilisée uniquement
dans les Route Handlers Next.js). Appliquer les migrations SQL du dossier
supabase/migrations/ (SQL editor du dashboard, ou supabase db push une
fois le projet lié via supabase link) pour créer la table profiles.
Dans Authentication > URL Configuration, ajouter http://localhost:3000/auth/callback
(et l'équivalent en production) aux Redirect URLs pour que le lien magique
fonctionne.
Stripe : créer un compte Stripe, activer Connect (mode Express), récupérer
les clés de test dans Developers > API keys. Le webhook (STRIPE_WEBHOOK_SECRET)
sera à configurer une fois les Route Handlers de paiement en place (tâche
backlog #18).
Resend : créer un compte sur resend.com, générer une clé API, vérifier le
domaine d'envoi une fois kdovie.fr réservé.
Déploiement
Le projet est prêt pour un déploiement Vercel : connecter le repo GitHub,
renseigner les mêmes variables d'environnement que .env.example dans les
réglages du projet Vercel, déployer.
Structure
app/ Routes (App Router)
lib/ Clients externes (Supabase, Stripe, Resend)
.github/ CI (lint + build sur chaque push/PR)
Suite du chantier
Authentification organisateur en place (lien magique Supabase Auth, table
profiles, middleware de protection des routes /compte). Prochaine étape :
modèle de données (events, gift_items, reservations, contributions).
