ModuleLivréIsoléL · 1 à 2 semainescommerce.ecommerce-core

Boutique e-commerce

Vendre un catalogue physique de la fiche produit au suivi de commande, sur une vitrine adaptee a la marque.

Le problème qu'il règle

Le marchand gere encore catalogue, prix, commandes et stock dans plusieurs outils sans source de verite commune.

Preuve — Livré

Déployé et remis. L'usage par le client n'est pas prouvé.

Empaquetage — Isolé

Dans son propre dossier. Reste à généraliser.

Les écrans

Back-office · 4

Route	Écran	Ce qu'on y fait	La forme	Les états
`/b/[slug]/products`	Produits	Administrer catalogue, medias, prix et stock.	Table dense, filtres, edition inline, fiche et actions groupees.	Vide, import, conflit de version, erreur upload, succes.
`/b/[slug]/orders`	Commandes	Traiter les commandes web et manuelles.	Liste filtrable, detail, timeline et selecteur de statut.	A traiter, en preparation, livree, annulee, email en erreur.
`/b/[slug]/categories`	Categories	Structurer la navigation du catalogue.	Liste hierarchique et formulaire d'edition.	Vide, slug en conflit, categorie utilisee.
`/b/[slug]/settings`	Reglages boutique	Configurer marque, contact, livraison, paiement et legal.	Sections de reglages et checklist pret a vendre.	Incomplet, non enregistrable, sauvegarde, danger.

Site public · 7

Route	Écran	Ce qu'on y fait	La forme	Les états
`/`	Accueil boutique	Presenter la marque, les categories et les nouveautes.	Hero editorial, reassurance, categories imagees et grille produits.	Catalogue vide, image absente, categorie inactive, succes.
`/c/[categorie]`	Categorie	Parcourir et filtrer une famille de produits.	Grille produits, tri, filtres et pagination.	Vide, aucun resultat, chargement, erreur.
`/p/[produit]`	Fiche produit	Choisir une variante et ajouter au panier.	Galerie, selecteurs, stock, prix, offres, sticky buy bar mobile.	Epuise, variante indisponible, image manquante, ajout confirme.
`/recherche`	Recherche	Retrouver un article par nom ou categorie.	Recherche avec resultats en grille.	Requete vide, aucun resultat, erreur.
`/panier`	Panier	Verifier les lignes, quantites, remises et suggestions.	Lignes editables, total serveur, cross-sell et CTA checkout.	Vide, article retire, prix modifie, stock insuffisant.
`/checkout`	Caisse	Choisir livraison ou retrait et creer la commande.	Formulaire sectionne avec recapitulatif fixe.	Validation, recalcul, doublon, erreur reseau, succes.
`/merci/[token]`	Confirmation	Confirmer la creation et orienter la suite.	Recapitulatif, statut paiement et suggestion post-achat.	Confirmee, annulee, paiement demo, paiement en attente.

Espace client · 1

Route	Écran	Ce qu'on y fait	La forme	Les états
`/commande/[token]`	Suivi commande	Suivre la preparation sans compte.	Timeline de statut et informations pratiques.	Recue, preparee, livree, annulee, token invalide.

Ce qui tourne tout seul

Déclencheur	Effet	Comment
Commande creee	Reserver/decrementer le stock et envoyer la confirmation	RPC Postgres + Brevo
Commande annulee	Restituer le stock de maniere atomique	RPC ke_cancel_order
Image importee	Verifier les octets et produire les derives	Route Handler + Sharp + Supabase Storage

Ce qu'on peut activer dedans

Catalogue

catalogue

Produits, categories, medias, statuts et SEO.

Variantes

variantes

SKU, prix et stock par taille, couleur ou modele.

Panier

panier

Panier persistant, tiroir et page recapitulatif.

Checkout

checkout

Coordonnees, retrait/livraison, promo et confirmation.

Suivi tokenise

suivi

Etat de commande sans imposer un compte client.

Favoris

favoris

Liste locale rattachee a la vitrine.

Sous le capot

Données

ke_stores
ke_products
ke_categories
ke_skus
ke_stock_ledger
ke_orders
ke_order_items
ke_order_adjustments

Composants réutilisables

ProductGallery
AddToCart
MiniPanier
CheckoutClient
StickyBuyBar
OrderStatusSelect
ProductImagesManager
VariantesManager

Services externes

· Supabase
· Brevo
· Lyra/SystemPay/PayZen
· Caddy

Rôles et droits

· Visiteur storefront
· Administrateur marchand
· Service de paiement

Ce qu'il faut autour

Il exige

Il ne cohabite pas avec

Aucun conflit connu.

D'autres en dépendent

Les pièges

Chacun vient d'un incident réel, relevé dans les commentaires du code d'origine. C'est la partie du catalogue qui vaut le plus cher : elle évite de repayer la même leçon.

Le total et le stock doivent toujours etre recalcules cote serveur.
Koko Pop prouve le rendu et le parcours, pas encore un paiement carte reel.
Le back-office actuel utilise un administrateur unique, sans RBAC marchand complet.

Ce qu'il ne fait pas, et ce qui reste à faire

Hors périmètre

· Achats fournisseurs
· Retours/RMA
· Expedition transporteur
· Comptabilite generale

Pour le mettre vraiment sur étagère

· Extraire le coeur commande/pricing dans un package versionne.
· Ajouter RBAC marchand et tests multi-tenant automatises.
· Livrer un rail de paiement reel prouve en sandbox puis en production.
· Ajouter retours, remboursements et factures fiscales generiques.

Où c'est prouvé

Koko Engine

Livré

Moteur, back-office, storefront, schema et integrations.

/home/jordy/projects/koko-engine

Koko Pop

Livré

Implementation kawaii, CDC, direction artistique et configuration tenant.

/home/jordy/projects/TEVA/KOKO POP

Vérifié contre le code le 2026-08-27. Au-delà de quatre-vingt-dix jours sans revérification, une fiche décrit un souvenir, pas un dépôt.

commerceretailmodebeautealimentaireartisanat