BrazzaEats

Marketplace multi-restaurant pour Brazzaville (Congo). Stack : React 18 + Vite + Tailwind CSS + Supabase

---

Partie A — Lancer en version web

Prérequis

• Node.js ≥ 18
• Un projet Supabase (gratuit sur supabase.com)

Étapes

1. Cloner le dépôt

git clone https://github.com/votre-compte/brazzaeats.git
cd brazzaeats

2. Installer les dépendances

npm install

3. Configurer les variables d'environnement

cp .env.example .env

Ouvrir .env et renseigner :

VITE_SUPABASE_URL=https://xxxxxxxxxxxxxxxxxxxx.supabase.co
VITE_SUPABASE_ANON_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Ces valeurs se trouvent dans Supabase → Settings → API.

4. Initialiser la base de données

Dans le dashboard Supabase, aller dans SQL Editor et exécuter le fichier schema.sql à la racine du projet.

Ce fichier crée :

• 9 tables (profiles, restaurants, menu_categories, menu_items, orders, order_items, reviews, deliveries, platform_settings)
• Les 6 enums PostgreSQL
• 28 politiques RLS
• Les triggers updated_at
• Les index de performance

5. Lancer le serveur de développement

npm run dev

L'application est accessible sur http://localhost:3000

Commandes utiles

npm run dev      # Développement avec HMR
npm run build    # Build de production (dossier dist/)
npm run preview  # Prévisualiser le build de production

---

Partie B — Compiler en APK Android avec Capacitor

Capacitor empaquette l'application web dans une application Android native. La config (appId: com.zandofood.app, appName: Zandofood, webDir: dist, StatusBar/SplashScreen aux couleurs de la marque) est déjà écrite dans capacitor.config.ts à la racine — pas besoin de cap init.

Prérequis supplémentaires

• Android Studio installé
• JDK 17+ (le JDK fourni avec Android Studio, Android Studio.app/Contents/jbr, fonctionne — le JDK système peut être trop récent pour Gradle)
• SDK Android (API 33+)

Étapes

1. Construire l'application

npm run build

2. Ajouter la plateforme Android (première fois uniquement)

npx cap add android

3. Régénérer les icônes/splash si assets/icon.png change

npx @capacitor/assets generate --android --iconBackgroundColor '#E85D26' --splashBackgroundColor '#E85D26'

assets/icon.png est pour l'instant un placeholder (monogramme "Z") — à remplacer par le vrai logo avant toute publication.

4. Synchroniser le build web vers le projet natif

npx cap sync android

(cap sync, pas cap copy — nécessaire dès qu'un plugin natif comme StatusBar/SplashScreen est utilisé.)

5. Ouvrir Android Studio

npx cap open android

6. Générer l'APK signé

Dans Android Studio :

1. Menu Build → Generate Signed Bundle / APK
2. Choisir APK
3. Créer ou utiliser un keystore existant
4. Sélectionner le variant release
5. Cliquer Finish

L'APK est généré dans android/app/release/app-release.apk

Distribution de l'APK

Pour la distribution officielle, privilégier le Google Play Store (compte développeur requis), avec la piste tests internes pour valider avant publication publique.

Pour des tests rapides en interne uniquement, l'APK peut aussi être partagé directement (WhatsApp, Drive, Firebase App Distribution) — activer Paramètres → Sécurité → Sources inconnues sur l'appareil pour l'installer hors Play Store. À réserver aux tests, pas à la distribution aux utilisateurs finaux.

---

Structure du projet

brazzaeats/
├── public/
│   ├── manifest.json       # Manifest PWA
│   ├── sw.js               # Service Worker (géré par VitePWA)
│   └── icons/              # Icônes PWA (192x192, 512x512…)
├── src/
│   ├── components/
│   │   ├── layout/         # Navbar, BottomNav, Sidebar, RestaurantLayout
│   │   ├── shared/         # RestaurantCard, MenuItemCard, OrderCard
│   │   └── ui/             # Button, Badge, Modal, Spinner, Skeleton, InstallBanner
│   ├── hooks/              # useAuth, useCart, useMyRestaurant, useRealtime
│   ├── pages/
│   │   ├── auth/           # Login, Register
│   │   ├── client/         # Home, Restaurant, Cart, Checkout, Tracking, Orders
│   │   ├── restaurant/     # Dashboard, Orders, Menu, Profile, Reviews
│   │   ├── livreur/        # Dashboard, Available, History
│   │   └── admin/          # Dashboard, Restaurants, Users, Settings
│   ├── services/           # restaurantService, orderService, menuService, livreurService, adminService
│   ├── supabase/           # client.js
│   └── utils/              # constants, formatCurrency, notificationSound, whatsappMessage
├── schema.sql              # Schéma complet Supabase
├── .env.example            # Variables d'environnement à copier
└── vite.config.js          # Config Vite + PWA

---

Rôles utilisateurs

Rôle	Accès	Assignation
client	Interface de commande	Auto à l'inscription
restaurant	Dashboard vendeur	Par l'admin
livreur	App de livraison	Par l'admin
admin	Back-office complet	Manuellement en base

Pour créer un compte admin manuellement :

UPDATE profiles SET role = 'admin' WHERE id = 'uuid-de-l-utilisateur';