Zabelie
Marketplace haïtienne de produits physiques, produits numériques et services, pour les acheteurs en Haïti et dans la diaspora. Les vendeurs organisent la remise des articles physiques ; les fichiers numériques sont accessibles après confirmation du paiement.
Ce dépôt, dont le nom historique est Zabelie-Digi, porte le site https://zabelie.com/. Il ne désigne pas un second projet numérique indépendant. Voir les décisions d’identité actualisées dans CLAUDE.md.
Stack
- Next.js 16 (App Router, TypeScript)
- Tailwind CSS 4
- Supabase (Postgres, Auth, Storage, RLS)
Démarrage
npm install
cp .env.example .env.local # renseigner les clés Supabase / MonCash
npm run dev
App sur http://localhost:3000
Scripts
| Commande | Effet |
|---|
npm run dev | Serveur de développement |
npm run build | Build de production |
npm run typecheck | Vérification TypeScript |
npm test | Tests unitaires (logique paiement pure) |
Structure
app/ Pages (App Router)
page.tsx Landing ultra-moderne
catalogue/ Catalogue produits/talents
produit/[slug]/ Page produit + checkout
components/ Composants UI réutilisables
lib/
sample-data.ts Données d'exemple (à remplacer par Supabase)
supabase/ Clients Supabase (browser + server)
docs/ Contexte produit, PRD, décisions, paiements
Documentation
La source de vérité produit est dans docs/ :
docs/00-CONTEXTE.md — contexte complet (15 sections)docs/01-PRD.md — exigences produit, EPICsdocs/02-DECISIONS.md — décisions verrouillées + ouvertesdocs/03-PAIEMENTS.md — architecture paiement (EPIC 4, critique)
Voir aussi CLAUDE.md (résumé toujours en contexte).
Règles dures
- Paiement : idempotence en base, confirmation serveur-à-serveur, réconciliation.
- Dépendances bloquantes : MonCash ✅ / NatCash ⛔ / BRH ⛔.
- Nommage
zabely/zabelie : coexistent, pas de grep-replace global.
- Décisions ouvertes (D-3 surtout) : ne pas trancher seul.
Catalogue : Supabase ou démo
lib/products.ts lit le catalogue depuis Supabase si les variables d'env sont
présentes ; sinon il retombe sur les données d'exemple (lib/sample-data.ts).
La plateforme est donc démontrable sans base.
Auth & espaces
/connexion — inscription / connexion (Supabase Auth)./vendre — espace créateur : publier un produit + envoyer le fichier livrable./tableau-de-bord — créateur : solde wallet, ventes, produits, édition du profil./createur/[id] — profil public d'un créateur + ses produits./mes-achats — commandes payées + téléchargement (URL signée)./admin — back-office (rôle admin) : modération produits + suivi paiements.
Assets de marque (public/brand/)
Photos du porteur du projet, normalisées (orientation EXIF corrigée) et
optimisées pour le web 3G :
| Fichier | Usage recommandé |
|---|
eliezer-portrait.jpg (900×1200, ~100 Ko) | Portrait officiel — avatar du profil créateur (avatar_url: /brand/eliezer-portrait.jpg), page « à propos » |
eliezer-casual.jpg (900×1200, ~350 Ko) | Photo décontractée — contenus sociaux / à propos |
eliezer-welcome-25x.png | Visuel « Welcome 25X » — référence uniquement (contient une marque tierce, ne pas utiliser dans l'UI) |
⚠️ Ces fichiers sont servis publiquement une fois le site déployé.
Langues
Français (défaut) + Kreyòl ayisyen — bascule FR/KR dans la nav (cookie
zabelie_lang). Dictionnaire maison : lib/i18n.ts (parité des clés testée).
Surfaces acheteur traduites ; espace créateur en FR pour l'instant.
Intégration continue
.github/workflows/ci.yml exécute typecheck, test et build à chaque push
et pull request (Node 22).
Tests
npm test — tests unitaires de la logique paiement pure (idempotence des clés,
statut MonCash, slugify).- Tests SQL money-path (exécutés en CI sur un Postgres jetable) :
DATABASE_URL=postgres://… bash supabase/tests/run.sh — applique les migrations
puis vérifie idempotence (rejeu 3×), montant falsifié rejeté, commission par tier,
maturation J+7 et remboursement sans solde fantôme.
État
🚧 Vague 1 en place : UI, schéma, paiement MonCash (EPIC 4), auth & espaces.
Catalogue branché sur Supabase avec repli démo. Reste à connecter un vrai projet
Supabase + identifiants MonCash sandbox pour un parcours de bout en bout, et
l'upload des fichiers livrables.
