Aller au contenu principal

Processus Complet E-Commerce avec Endpoints

Ce document présente le schéma complet du parcours client du e-commerce, depuis la sélection d'un produit jusqu'à la livraison finale, avec tous les endpoints et systèmes externes impliqués.

Vue d'ensemble du processus​

Flux détaillé avec tous les endpoints​

1️⃣ Phase d'Authentification​

Endpoints authentification :

  • POST /api/auth/register - Inscription nouveau client
  • POST /api/auth/login - Connexion client existant
  • POST /api/auth/set-password - Définir mot de passe (pour clients venant de Fidélité)
  • GET /api/auth/me - Récupérer profil (+ sync avec Fidélité)
  • POST /api/auth/logout - Déconnexion

2️⃣ Phase de Navigation & Sélection Produits​

Endpoints catalogue & stocks :

  • GET /api/publique/produits - Liste tous les produits
  • GET /api/publique/produits/{id} - Détails d'un produit
  • GET /api/publique/produits/search/sku?sku={sku} - Recherche par SKU
  • GET /api/publique/categories - Liste des catégories
  • GET /api/publique/fournisseurs - Liste des fournisseurs
  • GET /api/publique/fournisseurs/{id} - Détails fournisseur
  • GET /api/publique/stocks - Liste de tous les stocks
  • GET /api/publique/stocks/{id} - Stock d'un produit spécifique

3️⃣ Phase de Checkout & Calcul Promotions​

Endpoints promotions & checkout :

  • POST /api/publique/promotions/calculer-panier - Calcule total après promotions
    • Body : {idClient: string, articles: [{id, quantite, prixUnitaireCents}]}
    • Response : {totalApresPromo: number}

4️⃣ Phase de Création de Commande​

Endpoint création commande :

  • POST /api/commandes - Crée une nouvelle commande
    • Body : {clientId, articles, montantTotalCents, adresseLivraison, clientInfo}
    • Response : {ordreId, statut, montantTotalCents, createdAt}

5️⃣ Phase de Paiement​

Endpoints paiement :

  • POST /api/publique/interface-paiement - Génère URL de paiement
    • Body : {orderId, amount, customerEmail, returnUrl}
    • Response : {paymentUrl, sessionId}
  • POST /api/commandes/{ordreId}/confirmer-paiement - Confirme le paiement
    • Body : {transactionId, authorizationId, amount}
    • Response : {ordreId, statut, message}

6️⃣ Phase de Traitement Post-Paiement​

Endpoints mise à jour commande :

  • PATCH /api/commandes/{ordreId}/statut - Met à jour le statut
    • Body : {nouveauStatut, trackingNumber?, commentaire?}
    • Values : EN_PREPARATION | EXPEDIEE | LIVREE | ANNULEE
    • Response : {ordreId, statut, message}

Queues RabbitMQ :

  • logistique.ordre-preparation - Nouvelle commande à préparer
  • fidelite.historique-commande - Historique commande pour analyse
  • fidelite.commande-livree - Attribution des points de fidélité

7️⃣ Phase de Suivi Client​

Endpoints consultation :

  • GET /api/commandes/{ordreId} - Détails d'une commande
  • GET /api/commandes/user/{userId} - Toutes les commandes d'un user
    • Query params optionnels : ?statut=EXPEDIEE&limit=10&offset=0

Statuts de Commande et Transitions​

Ressources Complémentaires​

Dernière mise à jour : 25 novembre 2025