WorldCup Loyalty — Belchicken
Programme de fidélité communautaire lié à la Coupe du Monde 2026. Les clients forment des communautés autour d'équipes nationales et débloquent des récompenses collectives en commandant directement au restaurant.
Live → worldcup-loyalty.vercel.app
Concept
Chaque commande directe (en salle ou par téléphone) génère automatiquement une récompense en attente composée de 3 couches :
| Couche | Condition | Exemple |
|---|
| Palier solo | Montant de la commande | €25–39 → Finest burger |
| Bonus communautaire | Score de l'équipe + seuil CA restaurant | Score ≥ 3 000 pts → +Churros 12 pcs |
| Récompense d'avancement | Équipe encore en compétition | Quarts de finale → +Finest burger |
Le membre récupère ses cadeaux au comptoir Belchicken à sa prochaine visite.
Stack
- Frontend — Next.js 14 App Router (Server Components + Client Components)
- Backend — Supabase (PostgreSQL, RLS, SECURITY DEFINER triggers, Storage)
- Auth — Supabase Auth (email/password, Google OAuth)
- Deploy — Vercel (un déploiement par établissement)
- OCR — Claude Vision API (validation automatique des tickets de caisse)
Architecture
app/
(auth)/ — login, signup, register (choix équipe)
(member)/ — dashboard, récompenses, micro-rewards, soumission commande
(public)/ — leaderboard, page d'accueil
admin/ — gestion commandes, équipes, seuils CA, cadeaux en attente
api/ — routes API REST
lib/ — supabase client, helpers rewards/thresholds/score
components/ — ScoreCard (realtime), RewardProgressBar, LoginForm
types/ — TypeScript types partagés
docs/
adr/ — 10 ADRs (décisions d'architecture)
m2–m5-*.sql — migrations Supabase
create-issues.sh — script de création des issues GitHub
Score communautaire
score = nombre_de_membres × total_euros_dépensés
Calculé via trigger PostgreSQL à chaque validation de commande. Affiché en points côté client — jamais en euros.
Double verrou
Les bonus communautaires ne se débloquent que si :
- Le score de l'équipe dépasse le seuil du palier
- Le seuil CA restaurant de la période est atteint (validé manuellement par l'admin)
Multi-établissement
Le même codebase est déployé plusieurs fois. Chaque établissement dispose de sa propre URL Vercel et de ses propres variables d'environnement. L'isolation est assurée par restaurant_id sur toutes les tables.
Lancer en local
npm install
cp .env.local.example .env.local
# Remplir les variables dans .env.local
npm run dev
Variables d'environnement
# Supabase
NEXT_PUBLIC_SUPABASE_URL=https://xxxx.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=xxxx
SUPABASE_SERVICE_ROLE_KEY=xxxx
# Établissement
NEXT_PUBLIC_RESTAURANT_ID=molenbeek
NEXT_PUBLIC_RESTAURANT_NAME=Belchicken
# Liens sociaux (micro-récompenses)
NEXT_PUBLIC_GOOGLE_MAPS_URL=
NEXT_PUBLIC_INSTAGRAM_URL=
NEXT_PUBLIC_TIKTOK_URL=
NEXT_PUBLIC_FACEBOOK_URL=
# Programme
NEXT_PUBLIC_PROGRAM_START_DATE=2026-06-01
NEXT_PUBLIC_AUTO_VALIDATE=false
Migrations Supabase
Exécuter dans l'ordre dans le SQL Editor Supabase :
docs/m2-database.sql — schéma initial
docs/m3-micro-rewards-redesign.sql — jetons sociaux + multi-établissement
docs/m4-rewards-redesign.sql — paliers communautaires
docs/m5-pending-rewards.sql — récompenses 3 couches (pending_rewards + trigger)
docs/m6-schema-cibles.sql — schéma cibles ADRs 0001–0009 (manques M2–M5)
docs/m7-referral-links.sql — liens de parrainage WhatsApp (referral_links + referrals)
Roadmap
Voir les issues ouvertes :
| # | Slice | Priorité |
|---|
| #10 | Migrations schéma cibles (ADRs 0001–0009) | Fondation |
| #11 | Google OAuth | Immédiat |
| #12 | Auto-validation OCR + Bestelnummer | Haute |
| #13 | Récompenses 3 couches (refonte trigger) | Haute |
| #14 | Dashboard hero card + gamification | Moyenne |
| #15 | Liens de parrainage WhatsApp | Moyenne |
| #16 | Notifications d'incitation communautaire | Moyenne |
| #17 | Interface admin commandes suspectes | Moyenne |
| #18 | PWA + polish mobile | Finale |
