Medusa.js × Next.js — Refonte headless open source souverain France

#Quand choisir Medusa.js plutôt que Shopify Hydrogen ou CommerceLayer

C'est la première question qui revient en cadrage e-commerce headless. Voici notre filtre de décision.

Medusa.js est le bon choix si l'un de ces trois critères est rempli. Premièrement, ton projet impose un stack 100 % open source ou un hébergement souverain France. Marchés publics, opérateurs de service essentiel, loi SREN, exigence d'un hébergeur qualifié SecNumCloud, gouvernance interne anti-GAFAM : Hydrogen (lié au Storefront API Shopify propriétaire) et CommerceLayer (SaaS américain) ne passent pas. Medusa, en revanche, tourne sur ton infra OVHcloud, Scaleway ou Outscale sans dépendance à un acteur tiers.

Deuxièmement, tu es un distributeur B2B avec tarifications complexes par compte client (grilles tarifaires multiples, remises volumiques, conditions de paiement spécifiques, contrats négociés, multi-établissements, accès catalogue restreint). Medusa expose un modèle data flexible permettant de modéliser ces règles métier sans contorsion. Shopify B2B reste limité ; CommerceLayer demande une couche de logique applicative custom équivalente.

Troisièmement, tu refuses la facture cumulée Shopify Plus. À partir d'un certain chiffre d'affaires, le ticket annuel Shopify Plus (licence mensuelle + transaction fees selon les conditions de l'éditeur) devient un argument de migration. Sur plusieurs années, l'économie cumulée vs Medusa self-hosted peut financer une partie de la refonte : nous la calculons sur vos volumes réels lors du diagnostic.

#Cas marketplace verticale ou modules custom illimités

Medusa redevient incontournable dès que ton modèle impose des workflows commande très spécifiques : panier multi-étapes B2B avec validation hiérarchique, devis en ligne avec versioning, EDI fournisseurs, fiscalité intracommunautaire complexe, marketplace verticale multi-vendeurs avec commissionnement custom, modèle d'abonnement non-standard (B2B contrats annuels révisables).

Hydrogen plafonne sur ces cas car le backend Shopify reste verrouillé. CommerceLayer demande de la custom équivalente. Avec Medusa, tu codes ton workflow directement dans le backend en TypeScript.

#Architecture technique Medusa.js détaillée

Medusa.js repose sur un stack technique simple, mature et souverain. Backend Node.js + framework Medusa core (modules métier natifs catalogue, panier, commande, paiement, fulfillment, fiscalité multi-pays). Base de données Postgres 16 (modèle data relationnel solide pour e-commerce, transactions ACID, performance lecture/écriture excellente). Cache Redis 7 (sessions, panier, queues asynchrones via BullMQ). APIs REST et GraphQL exposées nativement.

Frontend Next.js 16 (App Router, Server Components, ISR, PPR, Suspense streaming). Les Server Components consomment l'API GraphQL Medusa côté serveur, le navigateur ne reçoit qu'un HTML statique optimisé + îlots interactifs. Objectif Core Web Vitals : LCP sous 2,5 s et INP sous 200 ms (seuils « bons » de Google), vérifiés en production.

Intégrations natives ou faciles. Paiements : Stripe, Mollie, Adyen, PayPlug, Lyra (cartes 3DS2, SEPA, virement, BNPL Alma/Klarna). Recherche produit : Algolia, Meilisearch (souverain, hébergeable OVHcloud), Typesense. PIM : Akeneo (l'intégration native est mature, voir notre page dédiée intégration Akeneo PIM).

ERP : SAP S/4HANA, Sage X3, Cegid, Divalto via connecteurs REST/GraphQL custom. Email : Postmark, SendGrid, Brevo. Analytics : GA4, Matomo (souverain), Plausible. Tag management : GTM ou Snowplow (souverain).

Déploiement OVHcloud souverain. Infrastructure recommandée Nehos : OVHcloud Public Cloud (Managed Kubernetes pour Medusa core), Postgres managé OVHcloud, Redis managé, stockage objet S3-compatible OVHcloud Object Storage, CDN OVHcloud, certificats SSL Let's Encrypt automatiques. Hébergement physique France (Roubaix, Strasbourg, Gravelines). Conformité RGPD native, pas de transfert hors UE.

#Avantages économiques et stratégiques de Medusa.js

Open source MIT, gratuit. Pas de licence à payer. Pas de frais commercial sur les transactions (contrairement aux frais de transaction Shopify). Pas d'engagement contractuel multi-année. Tu peux forker le code, modifier le core, contribuer à l'upstream. Le code Medusa appartient à ton entreprise — pas à un éditeur SaaS.

Pas de vendor lock-in. Le frontend Next.js consomme des APIs REST et GraphQL standardisées. Tu peux changer de PIM, d'ERP, de provider paiement, sans réécrire la couche front. Tu peux migrer ultérieurement vers un autre framework headless sans coût catastrophique, car le frontend ne dépend pas d'une API propriétaire.

Hébergement souverain France. OVHcloud Public Cloud, Scaleway, Outscale, Clever Cloud : toutes les options souveraines françaises sont compatibles. Aucune donnée hors UE. Conformité RGPD native. Réponse aux exigences marchés publics, loi SREN, opérateurs de service essentiel. C'est un argument commercial différenciant pour les marques B2B servant des clients publics ou industriels souverains.

Modules custom illimités. Tu codes ce que tu veux directement dans le backend Medusa en TypeScript. Tarifications B2B par compte avec grilles multiples, remises volumiques, conditions de paiement négociées. Connecteur EDI fournisseurs (EDIFACT, XML, API). Marketplace verticale multi-vendeurs avec commissionnement custom. Workflow devis B2B avec versioning et validation hiérarchique. Chaque module est chiffré selon son périmètre. Tu n'es pas limité par les capacités d'un SaaS.

#Limites honnêtes de Medusa.js

Nécessite une équipe tech compétente. Medusa demande de la maîtrise Node.js + TypeScript + Postgres + Redis + DevOps Kubernetes. Une équipe junior ou une absence d'équipe tech interne rend Medusa risqué : la maintenance demande des compétences. Si ton entreprise ne dispose pas d'au moins un CTO ou Lead Dev e-commerce, on déconseille honnêtement Medusa et on oriente vers Shopify Hydrogen (plus simple à maintenir).

Time-to-market plus long vs Shopify Hydrogen. Une refonte Medusa.js demande plus de temps qu'une migration Shopify Liquid → Hydrogen. Cet écart s'explique par le développement backend nécessaire (modules custom, intégrations ERP, workflows métier) que Hydrogen ne demande pas (le backend Shopify est déjà là).

Écosystème app store limité vs Shopify. Shopify App Store : un très grand nombre d'apps, beaucoup de plug-and-play (Klaviyo, Yotpo, Loop Returns, ReCharge installées en quelques clics). Medusa : un écosystème de plugins bien plus restreint. Pour intégrer Klaviyo, Yotpo ou ReCharge dans Medusa, il faut souvent coder le connecteur. C'est tenable, mais c'est du dev — pas du clic.

Capacité de Nehos. Un projet Medusa mobilise des développeurs seniors JavaScript/TypeScript. Nous ne prenons que quelques projets de ce type en parallèle. Si nous sommes en pleine charge, nous le disons : nous décalons ou nous orientons vers Hydrogen si c'est aussi pertinent.

#Méthode Nehos de refonte Medusa.js

Quatre phases, dont la durée dépend du périmètre (B2C ou B2B distributeur).

Phase 1 — Audit existant et cadrage architecture (2 à 3 semaines). Audit du stack actuel (Magento 2, custom PHP, Shopify Liquid, BigCommerce). Crawl Screaming Frog exhaustif. Audit data (modèle catalogue, structures clients, historique commandes, tarifications). Cadrage architecture cible Medusa : modules natifs vs custom, intégrations PIM/ERP, choix providers paiement, choix hébergement souverain. Output : rapport chiffré + scope définitif + chiffrage précis.

Phase 2 — Design system et modélisation data (3 à 4 semaines). Design system Figma complet (tokens, composants atomiques, templates principaux). Modélisation data détaillée : catalogue produit (variantes, options, attributs PIM), tarifications B2B (grilles multiples, remises, contrats), workflows commande spécifiques (devis, validation, EDI). Output : Figma + schéma data + plan modules custom à développer.

Phase 3 — Développement Medusa core + modules custom + frontend Next.js 16 (10 à 16 semaines pour B2C, 14 à 22 semaines pour B2B). Setup Medusa backend. Développement des modules custom (tarifications B2B, EDI, marketplace selon scope). Setup Postgres + Redis. Implémentation frontend Next.js 16 avec App Router, Server Components, streaming.

Intégrations Stripe/Mollie, Algolia/Meilisearch, Akeneo PIM, ERP. Tests E2E Playwright sur les parcours critiques. Setup tracking GA4 + Matomo souverain. Output : staging Medusa complet sur medusa.staging.client.com.

Phase 4 — Intégrations finales, déploiement OVHcloud et hyper-care (2 à 3 semaines). Déploiement production OVHcloud Public Cloud (Managed Kubernetes). Setup monitoring (Sentry, Grafana, Loki). Plan de redirections 301 exhaustif activé en amont. Bascule progressive avec rollback instantané possible. Hyper-care quotidien les 30 premiers jours, hebdomadaire jusqu'à 90 jours.

#Exemple de situation

Ce n'est pas une référence client : c'est une situation type que nous rencontrons.

Un distributeur B2B industriel avec un catalogue de plusieurs milliers de SKU et des centaines de comptes clients professionnels aux tarifs négociés individuellement. Il tourne sur un Magento 2 custom : maintenance lourde, dette technique accumulée, pages catalogue lentes, tarifications complexes saisies à la main par les commerciaux, synchronisation des stocks avec l'ERP différée.

La refonte type : Medusa.js + Next.js 16 + Postgres + Redis + Algolia + Akeneo PIM, un connecteur ERP sur mesure pour des stocks en temps réel, hébergement chez un hébergeur français. Modules custom : tarifications B2B par compte, workflow de devis en ligne avec versioning, EDI fournisseurs, accès catalogue restreint par compte.

On mesure la part des commandes passées en ligne, le LCP, la conversion des comptes pro et la charge du service commercial avant et après, puis on décide de la suite.

#Tarification d'une refonte Medusa.js

Un projet Medusa.js varie fortement selon le périmètre : une boutique B2C ne se chiffre pas comme un distributeur B2B avec tarifications complexes, EDI et intégration ERP. Nous ne publions donc pas de prix « à partir de » et chiffrons sur devis en 48 h après un premier échange, avec périmètre, planning et budget fixés avant de démarrer.

Diagnostic e-commerce headless de 5 jours pour cadrer le scope, valider l'architecture cible (Medusa, Hydrogen, CommerceLayer ou sur-mesure) et chiffrer précisément. Pas d'engagement après le diagnostic : vous repartez avec un rapport actionnable.

Facturation par jalons : lancement, mi-projet (validation Figma + premier sprint Medusa en staging), go-live validé. MCO post-launch en option. Pour des besoins ponctuels, la régie est à 275 € HT par jour.