Pourquoi ce document
Le premier prototype a prouvé le moteur (commandes, stock, paiement à la remise, emails). Mais il lui manquait le cœur d'un vrai back-office : on ne pouvait pas ajouter d'images aux produits, pas de variantes taille/couleur, pas de vue d'ensemble de toutes les boutiques, pas d'import de catalogue. Ce CDC corrige le tir et fixe le contrat de construction.
Décision structurante : on ne repart pas de zéro — le socle solide est conservé, on bâtit par-dessus un vrai domaine catalogue (produit → variante → stock → médias), en migrant en douceur pour ne jamais casser une commande en cours.
La direction artistique : la maquette de Teva
L'univers (mots de Teva) : girly, couleurs pastel, doux et moderne, chaleureux, animations fluides, icônes kawaii. « Le site ne devra jamais paraître statique. »
Typo arrondie kawaii (Fredoka/Baloo + Nunito), boutons pilule, ombres roses douces, sparkles et cœurs décoratifs. Prix affichés en FCFP.
Les 4 décisions irréversibles (figées)
- Produit ≠ Variante ≠ Stock. Le prix, le SKU et le stock vivent sur la variante (taille/couleur). Une commande garde un instantané figé de ce qui a été acheté.
- Vraie arborescence de catégories (parent/enfant), plus une simple étiquette de texte.
- Médias structurés : images stockées proprement, ordre, légende, plusieurs formats optimisés (WebP).
- Multi-boutiques : chaque donnée appartient à une boutique ; le back-office peut tout voir en agrégé. L'isolation est garantie côté serveur.
- Le stock a une seule source de vérité (disponible = en stock − réservé) — jamais deux compteurs qui divergent.
- Réservation du stock dès la commande (avant paiement virement), libérée si annulation/expiration — anti-survente réel.
- La commande archive sa décomposition financière (prix catalogue, remise, taxe, net payé) — impossible à recalculer plus tard.
- Migration par wrapper compatible : le tunnel d'achat live n'est jamais cassé pendant la bascule.
La vitrine KOKO POP (conforme à la maquette)
| Élément | État |
|---|---|
| Barre d'annonce dégradé rose (nouveautés / livraison 3000F / tél) | À FINIR |
| Header logo bubble + navigation + panier | À FINIR |
| Hero dégradé + baseline + 2 CTA + visuel produit + badge « À SEULEMENT 1000F » | À FINIR |
| 3 bandeaux réassurance (retrait Paea / livraison offerte / infos) | À FINIR |
| Catégories en cards rondes avec vraies images | À FINIR |
| Nouveautés : fiches produit (vraie image, badge, prix FCFP, panier) | À FINIR |
| Fiche produit : galerie + sélecteur de variante + prix par variante + WhatsApp | À FINIR |
| Pages catégorie, recherche, panier, checkout, suivi commande | FAIT (à re-styler) |
| Animations fluides (reveal, hover kawaii, sparkles) — « jamais statique » | À FINIR |
| Chatbot IA conseil produit (widget flottant) | À FINIR |
Le back-office — le cœur du chantier
Catalogue
| Fonction | État |
|---|---|
| Upload d'images produit (multi-images, réordonnable, compression WebP) | À FINIR ← le trou n°1 |
| Variantes produit (taille/couleur → SKU/prix/stock par variante) | À FINIR |
| Catégories imbriquées (arborescence, réordonnable) | À FINIR |
| Actions en masse (publier / prix ±% / catégorie sur une sélection) | À FINIR |
| Édition rapide du prix/stock directement dans la liste | À FINIR |
| Liste produits pro : recherche + filtres + tri + pagination | À FINIR |
| Import catalogue CSV/Excel (mapping colonnes, images par URL) — catalogue Chine | À FINIR |
| Génération de fiche par IA vision (photo → titre/description, validation humaine) | À FINIR |
Opérations
| Fonction | État |
|---|---|
| Commandes : liste + détail + statuts + timeline + commande manuelle + email | FAIT (à étendre variantes) |
| Inventaire par variante (entrepôt Arue) + réservé + alertes stock bas | À FINIR |
| Fournisseurs (référence, coût d'achat, délai) | À FINIR |
| Clients / CRM (historique, RGPD) | FAIT |
| Codes promo | FAIT |
| Réglages boutique (logo, contact, réseaux, livraison, domaine, devise, légal) | FAIT (+ logo upload) |
Vue globale multi-boutiques
| Fonction | État |
|---|---|
| Sélecteur de boutique (boutique active) | À FINIR |
| Vue globale agrégée : toutes les boutiques, CA/commandes/stock, filtrable | À FINIR |
| Tableau de bord : CA réel, commandes à traiter, stock bas | À FINIR |
Studio design + IA
| Fonction | État |
|---|---|
| Studio design IA (presets + génération) aligné sur la DA KOKO POP | FAIT (+ preset maquette) |
| Chatbot IA produit (conseil sur le vrai catalogue, garde-fous anti-invention) | À FINIR |
| Crédits IA (page + historique + recharge) | FAIT |
Le modèle de données cible
Migration en douceur depuis le modèle à plat actuel : chaque produit existant reçoit une variante « par défaut », les commandes passées restent intactes.
produits → types d'options (Taille, Couleur) → valeurs (M, Rouge)
→ VARIANTES (SKU, prix, position) ← le vrai article vendable
→ médias (images, ordre, légende)
→ catégories (arbre parent/enfant)
stock = inventaire par variante : disponible = en_stock − réservé
+ réservations (liées aux commandes, avec expiration)
+ mouvements (journal append-only, traçabilité)
commande → lignes figées (nom, SKU, prix catalogue, remise, taxe, net payé)
→ historique de statuts (qui, quand, pourquoi)
+ embeddings produits (chatbot) + vue agrégée multi-boutiques
Jalons de construction
J0 · Contrat & migration répétée
Décisions figées, migration testée sur copie, rollback prêt, politique de réservation du stock.
J1 · Tranche verticale démontrable valeur client
Un produit multi-variantes, upload d'images, sélection de variante en vitrine, achat complet sans survente. Le trou n°1 comblé de bout en bout.
J2 · Vitrine à la DA de la maquette validation Teva
Re-style complet conforme à la maquette (couleurs, typo, animations, logo, FCFP) sur données réelles — validé par Teva tôt.
J3 · Back-office opérationnel
Inventaire + réservations + édition + actions en masse, puis import catalogue + fournisseurs.
J4 · Vue globale puis IA
Sélecteur de boutique + vue agrégée + tableau de bord, puis chatbot produit + fiches par IA.
J5 · Prêt pour la production & paiement
Paiement PayZen, SEO, domaine propre, sauvegardes/monitoring, audit complet.
À caler avec Teva (avant/pendant le build)
- Échantillon du catalogue réel (avec variantes + images) — pour valider le modèle sur du vrai.
- Paiement : PayZen (le paiement carte n'est pas disponible via nos outils habituels pour les biens physiques). Démarrage possible en paiement à la remise / virement sans attendre.
- Livraison, retours, taxes : zones réelles, TVA/DICP applicable, prix TTC ou HT.
- Boutique BLACK OPS (airsoft / surveillance) : validation juridique requise avant toute construction — hors périmètre de ce CDC.
- Rôles dans le back-office : Teva seul, ou une équipe ?
Hors périmètre assumé de ce document : les autres boutiques (l'architecture les rend possibles, mais on n'en construit qu'une d'abord), la gamification, les comptes clients à mot de passe, le multilingue.
18 juillet 2026 · architecture validée par revue croisée · document de travail évolutif