Site web et app Flutter de tirage produits aléatoire sur catalogue

# 1. Objectif du projet

Développer une app Flutter (Web + iOS + Android) pour vendre des produits mystère via catalogue interne, avec :

- Système de crédits virtuels
- Tirages aléatoires sur inventaire réel
- Déduction auto du stock
- Commandes agrégées
- Dashboard admin complet
- Module comptable (TVA, marge brute, CMUP, export)

Plateforme fluide, rapide et automatisée.

---

# 2. Fonctionnalités Utilisateurs

## 2.1 Authentification
- Connexion obligatoire
- Méthodes : Google / Email OTP / Téléphone OTP
- Création auto du compte au 1er login

## 2.2 Crédits Virtuels / débit immédiat
- Achat via Revolut Pay (API officielle) avec trois options :
- Crédit virtuel : recharge par CB par palier et débit auto des crédits
- Paiement CB : → après premier paiement débit auto pour tous les suivants (expérience immédiate)
- Google Pay : paiement rapide via wallet
- Historique crédit/débit et no de transaction
- Tirage impossible sans solde suffisant

## 2.3 Page Catégories
- Grille responsive :
- Desktop : 3/ligne
- Mobile : 1/ligne
- Par catégorie :
- Titre, image principale, prix crédits
- Demi-roue graphique en fond
- Bouton “Acheter”

## 2.4 Tirage
- Paiement CB /Débit crédits → tirage aléatoire → animation → résultat
- Probabilité uniforme par unité disponible
- Popup final : image, nom, “Félicitations”
- Déduction auto stock
- Rattachement à commande ouverte

## 2.5 Commandes
- 1 commande ouverte/user
- Ajout items tant que “open”
- Passage “préparation” → nouvelle commande auto
- Commande = liste produits tirés
- Futur : choix point relais Sendcloud (API)

## 2.6 Espace Client
- Solde crédits
- Système fidélité
- Parrainage
- Historique tirages
- Commandes & statuts
- Infos perso
- Factures PDF

---

# 3. Fonctionnalités Admin

## 3.1 Catalogue Produits
- CRUD produits
- Champs : nom, prix achat HT, prix TTC, TVA, image, poids, catégorie, stock
- Stock auto à chaque tirage

## 3.2 Catégories
- CRUD + position
- Prix/tirage, image, activer/désactiver

## 3.3 Commandes
- Liste filtrée (statut, date, user)
- Détail : produits + logs tirages
- Actions : open → préparation → expédiée, n° suivi, export CSV

## 3.4 Outil Comptable (1 clic)
- Période choisie :
- CA
- Crédits vendus (base comptable)
- Coût produits consommés (sortis × achat HT)
- Marge brute = CA – coût
- TVA collectée par taux
- TVA déductible (opt.)
- Δ stock
- Liste produits tirés + valeurs HT/TTC + marge unitaire
- Export PDF/CSV

---

# 4. Base de Données (schéma)

Table users : id, email, phone, display_name, created_at

Table wallets : id, user_id, balance

Table wallet_transactions : id, user_id, type, amount, payment_id, created_at

Table categories : id, title, price_per_draw, main_image, position, active

Table products : id, name, category_id, purchase_price_ht, price_ttc, tva_rate, weight, image_url

Table inventory : product_id, quantity

Table draws : id, user_id, product_id, category_id, transaction_id, order_id, created_at

Table orders : id, user_id, status, created_at

Table order_items : id, order_id, product_id, draw_id, quantity

---

# 5. Exigences Techniques

## 5.1 Front Flutter
- Web + iOS + Android
- Animations fluides (roue, popup)
- Cache optimisé
- PWA installable

## 5.2 Backend
- Recommandé : Supabase (PostgreSQL + Auth + Storage)
- Alt. : Node.js + PostgreSQL

## 5.3 Paiement
- Revolut Pay pour crédits
- Webhooks obligatoires (validation → ajout crédits)

## 5.4 Sécurité
- Vérifs backend systématiques
- Anti-double tirage (atomicité)
- Logs erreurs
- Chaque mouvement → wallet_transaction

---

# 6. Livrables
- Code Flutter (web + mobile)
- Backend + DB + migrations
- Doc installation / API
- Diagramme DB
- Exports comptables
- Tests :
- Tirage aléatoire
- Déduction stock
- Agrégation commandes
- Calcul marge + TVA