Pollenia · Dossier de cadrage projet

Boutique e-commerce custom pour chaussures running

Brief complet destiné à Claude Design et Claude Code : lancer une V1 simple, premium et vendable rapidement, sans Shopify, tout en posant les bases d’une future plateforme e-commerce moderne.

PositionnementCustom premium, rapide, évolutif

Priorité V1Vendre vite sans surconstruire

InterditShopify et marketplace complète dès le départ

Promesse PolleniaSimplicité business, pas démonstration tech

1. Résumé exécutif

Décision recommandée : construire une V1 custom légère, orientée conversion, avec socle technique propre pour évoluer.

Décision projet

Ne pas construire une marketplace complète maintenant. Construire une boutique running premium, rapide, fiable, avec un catalogue simple, un checkout Stripe, un back-office catalogue minimal et des notifications de commande Telegram.

Objectif business

Vendre les premières paires vite, sans bloquer la vision plateforme.

Simple et vendable

Catalogue, fiches produits, panier, paiement, commandes, admin basique. Le client peut vendre rapidement.

Socle

Évolutif sans complexité

Architecture propre, composants réutilisables, base de données structurée, webhooks. Pas de dette bloquante.

Pollenia

Offre récurrente

Maintenance, optimisation conversion, ajouts catalogue, automatisations, reporting mensuel et évolutions V2/V3.

2. Vrai problème business du client

Le sujet n’est pas “avoir un site”. Le sujet est de vendre rapidement, crédibiliser la marque et ne pas perdre de temps sur une usine à gaz.

Problèmes réels

Perte de vitesse commerciale : sans boutique opérationnelle, le client ne peut pas transformer l’intérêt en commandes.
Risque de complexité : viser directement une marketplace ralentit le lancement et dilue le budget.
Manque de crédibilité : dans la running/mode, l’expérience visuelle influence fortement la confiance.
Dépendance à une plateforme : le client refuse Shopify et veut posséder son socle.
Besoin d’apprentissage marché : il faut valider produits, prix, tailles, best-sellers, panier moyen avant d’élargir.

Réponse Pollenia

Vendre une première version claire : boutique custom premium, rapide à mettre en ligne, pensée comme une fondation. Pas de promesse technique inutile. Le client achète un outil de vente, pas un chantier logiciel.

Vendre vite Rester propriétaire Tester le marché Préparer la suite

3. Objectif V1

La V1 doit être assez premium pour vendre, assez simple pour sortir vite, assez propre pour évoluer.

Conversion

Transformer visiteurs en commandes avec un parcours court.

Confiance

Design premium, pages rassurantes, paiement sécurisé.

Opérations

Ajouter des produits, suivre les commandes, recevoir les alertes.

Évolution

Préparer catégories, variantes, stocks, automatisations et futures intégrations.

4. Vision long terme

La future plateforme peut devenir plus large, mais elle doit être construite par étapes business.

V1 — Boutique running premium

Vente directe d’un catalogue limité, checkout fiable, admin minimal, notifications Telegram.

V2 — Optimisation commerciale

Filtres avancés, recommandations, codes promo, avis clients, relances panier, analytics conversion, emails transactionnels renforcés.

V3 — Plateforme élargie

Multi-marques, stock avancé, comptes clients, programme fidélité, segmentation, automatisations n8n, éventuellement logique marketplace si traction prouvée.

5. Fonctionnalités V1 et reports V2/V3

Découpage pour éviter de financer une plateforme avant d’avoir validé la demande.

À faire en V1

Page accueil premium avec sélection produits.
Catalogue chaussures running avec catégories simples.
Fiche produit : photos, prix, tailles, stock, bénéfices, livraison/retour.
Panier simple.
Checkout Stripe.
Confirmation commande.
Admin catalogue minimal protégé.
Gestion commandes : statut, coordonnées, produits commandés.
Notification Telegram à chaque commande.
Préparation webhooks pour automatisations futures.

À repousser

Marketplace multi-vendeurs.
Comptes vendeurs et commissions.
Application mobile.
Programme fidélité avancé.
Recommandations IA complexes.
Gestion entrepôt poussée.
Retours automatisés complets.
Multi-devise / multi-pays.
Blog média running complet.
Personnalisation avancée par profil coureur.

6. Architecture technique recommandée

Une architecture custom moderne, pas surdimensionnée, mais compatible avec une future plateforme.

Frontend / App

Next.js recommandé pour performance, SEO, routing propre et expérience e-commerce moderne.

App Router
Server Components quand utile
Composants UI réutilisables
Pages rapides et SEO-friendly

Données

PostgreSQL + Prisma pour structurer produits, variantes, commandes et préparer l’évolution.

Products
Variants / sizes
Orders
Order items
Admin users

Services

Stripe pour paiement, Telegram Bot API pour alertes, futur n8n via webhooks.

Stripe Checkout ou Payment Element
Webhook Stripe sécurisé
Telegram order alert
Webhook internal events

Recommandation pragmatique

Pour une V1 rapide : Next.js + PostgreSQL + Prisma + Stripe Checkout + admin minimal dans l’application. Éviter un headless CMS si le besoin admin est simple. Ajouter n8n après les premières commandes, quand les vrais workflows sont connus.

7. Pages du site

Structure minimale pour vendre et inspirer confiance.

Accueil

Hero premium, bénéfices, best-sellers, catégories, preuve de confiance, CTA catalogue.

Catalogue

Liste produits, filtres simples : homme/femme, route/trail, prix, tailles disponibles.

Fiche produit

Photos, prix, tailles, stock, bénéfices coureur, guide taille, livraison/retours, CTA achat.

Panier

Produits, tailles, quantités, total, frais livraison estimés, CTA paiement.

Checkout / confirmation

Paiement Stripe, confirmation commande, message clair sur prochaine étape.

Pages confiance

Livraison, retours, contact, mentions légales, politique confidentialité, CGV.

Admin produits

Connexion, liste produits, création/édition, tailles, prix, stock, activation.

Admin commandes

Liste commandes, détails client, statut, montant, produits, lien Stripe.

404 / erreurs

Pages propres, rassurantes, redirection vers catalogue.

8. Direction artistique

Premium sportif, pas gadget. Le design doit donner confiance et créer l’envie d’achat.

Territoire visuel

Univers running moderne : vitesse, performance, précision.
Premium accessible : pas luxe froid, pas marketplace low-cost.
Palette sobre : noir profond, blanc cassé, gris techniques, accent énergique orange/rouge ou vert acide.
Typographie sans-serif forte, lisible, avec titres condensés ou très structurés.
Grandes photos produits, cards nettes, hiérarchie prix/tailles très visible.

À éviter

Look template Shopify générique.
Marketplace complète dès la V1.
Effets visuels lourds qui ralentissent le site.
Faux chiffres, faux avis, storytelling vide.
Navigation complexe ou filtres trop avancés en V1.

9. Expérience utilisateur

Le visiteur doit comprendre, choisir une pointure, payer et être rassuré en moins de friction possible.

Parcours principal

Accueil → catalogue → fiche produit → choix taille → panier → paiement → confirmation.

Décision rapide

Prix, disponibilité, livraison, retour et bénéfice produit visibles au-dessus de la ligne de flottaison.

Mobile-first

Cards produits lisibles, CTA sticky sur fiche produit, tailles faciles à toucher, panier clair.

Réassurance

Paiement sécurisé, livraison, retours, contact, statut commande, confirmation immédiate.

Performance

Images optimisées, pages statiques ou server-rendered, pas de scripts inutiles.

Accessibilité

Contrastes corrects, focus visible, labels formulaires, navigation clavier minimale.

10. Admin catalogue

L’admin V1 doit permettre de vendre, pas de gérer une usine logistique.

Fonctions nécessaires

Connexion administrateur.
Créer / modifier / désactiver un produit.
Gérer nom, slug, description courte, description longue, prix, marque, catégorie.
Gérer images produits.
Gérer variantes : taille, stock, SKU simple.
Marquer best-seller / nouveau / promo si nécessaire.

À garder simple

Pas de rôles complexes en V1.
Pas de workflows de validation.
Pas de PIM avancé.
Pas de gestion multi-entrepôt.
Prévoir les champs proprement pour extension future.

11. Paiement

Paiement fiable et rapide à mettre en production. Stripe est le choix pragmatique.

Solution V1

Stripe Checkout pour réduire la complexité, sécuriser le paiement, accélérer le lancement et limiter les risques conformité.

Webhook obligatoire

Écouter les événements Stripe confirmant le paiement avant de créer/valider définitivement la commande.

Évolution future

Passage possible à Stripe Payment Element si besoin d’une expérience checkout plus intégrée.

12. Gestion des commandes

La commande doit être lisible, exploitable et traçable.

Statuts V1

pending_payment : paiement initié.
paid : paiement confirmé par Stripe.
processing : préparation commande.
shipped : expédiée.
cancelled : annulée/remboursée.

Données minimales

Numéro commande.
Client : nom, email, téléphone si fourni.
Adresse livraison.
Produits, tailles, quantités, prix.
Total, devise, référence Stripe.
Date, statut, notes internes.

13. Notification Telegram des commandes

Objectif : le client reçoit instantanément une alerte exploitable sans ouvrir l’admin.

Format recommandé du message Telegram

Nouvelle commande payée
Commande : #RUN-1024
Montant : 149,90 €
Client : Prénom Nom
Email : client@email.com
Produits : 1x Nike Pegasus 41 — Taille 43
Livraison : Adresse courte
Stripe : lien dashboard ou payment_intent
Action : préparer la commande

Technique

Créer un bot Telegram, stocker le token en variable d’environnement, envoyer le message après confirmation paiement Stripe.

Robustesse

Si Telegram échoue, ne pas bloquer la commande. Logger l’erreur et prévoir un retry ou une consultation admin.

14. Préparation future n8n

Ne pas installer une usine d’automatisation maintenant. Préparer les événements propres.

Événements à prévoir

order.created
order.paid
order.shipped
product.low_stock
customer.created

Usages V2

Email post-achat
Relance panier abandonné
Alerte stock bas
Synchronisation Google Sheets
Reporting mensuel

Principe

Exposer des webhooks internes propres ou une table d’événements. Brancher n8n quand les workflows sont validés commercialement.

15. Sécurité minimale

Sécuriser les zones sensibles sans transformer la V1 en projet bancaire.

Indispensable V1

Variables d’environnement pour secrets Stripe, Telegram, base de données.
Admin protégé par authentification solide.
Validation serveur des prix, quantités, stocks.
Vérification signature webhook Stripe.
HTTPS obligatoire en production.
Protection basique anti-CSRF / bonnes pratiques framework.
Ne jamais faire confiance au panier côté client pour les montants.

Points de vigilance

Gestion images upload : taille, type, stockage.
Logs sans données sensibles inutiles.
Sauvegarde base de données.
Pages légales et politique de confidentialité.
Gestion des erreurs paiement claire pour l’utilisateur.

16. ROI client et ROI Pollenia

Le projet doit être vendu comme un actif commercial simple, avec maintenance et amélioration continue.

ROI client

Hypothèse simple

Si marge nette par paire entre 25 € et 60 €, le site doit générer un flux de commandes récurrent pour rentabiliser rapidement la V1.

10 commandes/mois à 40 € de marge = 400 €/mois de marge.
50 commandes/mois à 40 € de marge = 2 000 €/mois de marge.
Le vrai ROI vient aussi de l’actif propriétaire : marque, données clients, SEO, indépendance plateforme.

ROI Pollenia

Modèle recommandé

Setup V1 : cadrage + design + développement + mise en ligne.
Mensuel récurrent : maintenance, sécurité, catalogue, optimisation conversion, reporting, petites évolutions.
V2/V3 vendues par paliers sur la base des ventes réelles.

Positionnement : “on lance vite, puis on améliore ce qui rapporte”.

17. Risques

Risques principaux et réponse projet.

Surconstruction

Risque : construire la marketplace avant les ventes. Réponse : V1 boutique simple, roadmap par traction.

Catalogue incomplet

Risque : pas assez de contenus produits. Réponse : modèle produit clair et checklist photo/copy.

Performance

Risque : design lourd. Réponse : images optimisées, stack sobre, pas de scripts inutiles.

Opérations faibles

Risque : commandes non traitées. Réponse : admin commandes + Telegram immédiat.

Maintenance oubliée

Risque : site qui vieillit. Réponse : abonnement Pollenia obligatoire ou fortement recommandé.

Scope creep

Risque : demandes V2 pendant V1. Réponse : backlog strict et arbitrage business.

18. Plan d’exécution

Plan court, séquencé, pour livrer une V1 propre.

Cadrage final — 0,5 à 1 jour

Valider catalogue initial, modes de livraison, zones, prix, taxes, identité visuelle, contraintes légales, accès Stripe/Telegram.

Design Claude Design — 1 à 2 jours

Créer direction artistique, homepage, catalogue, fiche produit, panier, admin minimal, composants clés mobile/desktop.

Socle technique Claude Code — 2 à 4 jours

Initialiser Next.js, Prisma, base de données, modèles produits/commandes, structure pages, auth admin.

Commerce — 2 à 4 jours

Implémenter catalogue, fiche produit, panier, checkout Stripe, webhook, création commande, confirmation.

Ops — 1 à 2 jours

Admin catalogue/commandes, notifications Telegram, états commande, logs utiles.

QA et mise en ligne — 1 à 2 jours

Tests achat sandbox, mobile, performance, sécurité minimale, SEO de base, variables production, déploiement.

19. Prompts séparés pour Claude Design

Prompts prêts à copier pour produire la direction visuelle et les écrans clés. Ne pas coder le site final à cette étape.

Prompt 1 — Direction artistique

Claude Design

Tu es Claude Design. Crée une direction artistique premium pour une boutique e-commerce custom de chaussures running.

Contexte : le client veut vendre rapidement des chaussures running, sans Shopify, avec une V1 simple mais pensée pour évoluer vers une grosse plateforme e-commerce moderne. Pollenia vend de la simplicité, pas de la technologie.

Objectif : proposer 3 directions visuelles distinctes :
1. Premium performance
2. Marketplace running moderne
3. Minimal sportif haut de gamme

Pour chaque direction, fournir : palette, typographie, usage photo, composants clés, niveau de densité, ambiance mobile, risques visuels, recommandation.

Contraintes : éviter le look template Shopify, éviter le blabla, privilégier lisibilité, conversion, vitesse et confiance.

Prompt 2 — Prototype pages clés

Claude Design

Tu es Claude Design. À partir de la direction artistique retenue, produis un prototype HTML haute fidélité, responsive, pour les pages clés d’une boutique running custom.

Pages à concevoir :
- Accueil
- Catalogue
- Fiche produit
- Panier
- Confirmation commande
- Admin catalogue minimal
- Admin commandes minimal

Priorités UX : achat rapide, choix taille simple, réassurance visible, performance perçue, mobile-first.

Le prototype doit montrer les composants réutilisables : header, navigation, card produit, filtres simples, sélecteur taille, CTA, bloc livraison/retour, récapitulatif panier, table admin.

Ne pas créer une marketplace complète. Ne pas ajouter de fonctionnalités non prévues en V1.

Prompt 3 — Design system V1

Claude Design

Tu es Claude Design. Formalise le design system V1 pour une boutique running premium custom.

Livrables attendus :
- Tokens couleurs
- Typographie
- Échelle d’espacement
- Rayons, ombres, bordures
- États hover/focus/disabled/loading
- Composants : bouton, input, card produit, badge stock, sélecteur taille, panier, ligne commande, notification
- Règles mobile
- Règles accessibilité minimales

Le système doit être simple à implémenter dans Next.js et assez robuste pour évoluer vers une plateforme plus large.

20. Prompts séparés pour Claude Code

Prompts prêts à copier pour implémenter la V1 par étapes, avec scope contrôlé.

Prompt 1 — Initialisation projet

Claude Code

Tu es Claude Code. Initialiser une application e-commerce custom pour chaussures running.

Contraintes :
- Pas de Shopify.
- Stack recommandée : Next.js, TypeScript, PostgreSQL, Prisma.
- Site premium, rapide, responsive.
- V1 simple mais architecture évolutive.

Travail demandé :
1. Créer la structure projet propre.
2. Configurer TypeScript, linting, formatting.
3. Configurer Prisma avec modèles initiaux : Product, ProductVariant, Order, OrderItem, AdminUser.
4. Préparer variables d’environnement sans exposer de secrets.
5. Créer layout global et routes principales.
6. Ajouter README avec commandes de dev.

Ne pas implémenter de marketplace multi-vendeurs. Ne pas surconstruire.

Prompt 2 — Catalogue et fiches produits

Claude Code

Tu es Claude Code. Implémenter le catalogue V1 pour une boutique running.

Fonctionnalités :
- Page accueil avec produits mis en avant.
- Page catalogue avec filtres simples : catégorie, taille disponible, prix.
- Fiche produit avec images, prix, description, tailles, stock, CTA ajouter au panier.
- Panier persistant côté client, mais prix et stock validés côté serveur.
- Composants réutilisables et responsive.

Exigences :
- Ne jamais faire confiance au prix envoyé par le client.
- Prévoir les variantes par taille.
- Garder le code simple, lisible, évolutif.

Prompt 3 — Paiement Stripe et commandes

Claude Code

Tu es Claude Code. Ajouter le paiement Stripe et la gestion des commandes V1.

Fonctionnalités :
- Créer une session Stripe Checkout depuis le panier.
- Recalculer les prix côté serveur depuis la base de données.
- Créer une commande pending_payment.
- Vérifier le webhook Stripe avec signature.
- Passer la commande en paid après paiement confirmé.
- Créer une page confirmation commande.
- Gérer les erreurs paiement proprement.

Sécurité :
- Secrets uniquement en variables d’environnement.
- Validation serveur obligatoire.
- Ne pas exposer les données sensibles.

Prompt 4 — Admin catalogue et commandes

Claude Code

Tu es Claude Code. Créer un admin minimal pour gérer la boutique running V1.

Fonctionnalités :
- Authentification admin simple et sécurisée.
- Liste produits.
- Création / édition / désactivation produit.
- Gestion variantes : taille, stock, SKU, prix si nécessaire.
- Liste commandes.
- Détail commande avec client, produits, montant, statut, référence Stripe.
- Changement manuel de statut : processing, shipped, cancelled.

Contraintes :
- Pas de rôles complexes.
- Pas de PIM avancé.
- UI claire, rapide, utilisable par un non-technicien.

Prompt 5 — Notifications Telegram et préparation n8n

Claude Code

Tu es Claude Code. Ajouter les notifications Telegram et préparer les événements futurs pour n8n.

Fonctionnalités :
- À chaque commande payée, envoyer une notification Telegram au client via Bot API.
- Message clair avec numéro commande, montant, client, produits, tailles, adresse courte, référence Stripe.
- Si Telegram échoue, ne pas bloquer la commande : logger l’erreur.
- Préparer une structure d’événements internes : order.created, order.paid, order.shipped, product.low_stock.
- Prévoir un point d’extension webhook futur pour n8n, sans implémenter tous les workflows maintenant.

Contraintes :
- Token Telegram en variable d’environnement.
- Code robuste, simple, testable.

Prompt 6 — QA, performance, sécurité

Claude Code

Tu es Claude Code. Finaliser la V1 avant mise en ligne.

Checklist :
- Tester parcours achat complet en Stripe sandbox.
- Tester webhook Stripe.
- Tester notification Telegram.
- Vérifier mobile responsive.
- Vérifier accessibilité minimale : labels, focus, contrastes.
- Vérifier performance : images optimisées, bundle raisonnable, pas de scripts inutiles.
- Vérifier sécurité : secrets, auth admin, validation serveur, erreurs propres.
- Ajouter documentation d’exploitation : ajouter produit, traiter commande, modifier stock, consulter logs.

Livrer uniquement une V1 stable, pas une marketplace complète.

21. Recommandation finale

La meilleure stratégie est une V1 vendable, puis une évolution pilotée par les commandes réelles.

Recommandation Pollenia

Vendre au client une offre en deux niveaux : lancement V1 + abonnement d’amélioration mensuelle. La V1 doit permettre de vendre des chaussures rapidement, recevoir les commandes, être alerté sur Telegram et gérer le catalogue sans dépendance Shopify.

La vision marketplace reste dans la roadmap, mais uniquement après validation commerciale : produits qui se vendent, trafic, panier moyen, récurrence, demandes clients, capacité opérationnelle.

Phrase de vente : “On ne construit pas une grosse plateforme dans le vide. On lance une boutique premium qui vend maintenant, puis on transforme ce qui marche en plateforme.”