ADR-001 — Thème Online Store 2.0, pas de headless

Statut : proposee

Contexte

Deux personnes, en parallèle d'un emploi. Le catalogue est petit (3 gammes, quelques dizaines de références). Le besoin principal est un configurateur léger, du SEO et un bon contrôle des données structurées.

Options considérées

  1. Thème Online Store 2.0 sur mesure (sections JSON, Liquid, JS natif).
  2. Headless (Hydrogen ou Next.js sur l'API Storefront).
  3. Thème acheté, peu modifié.

Décision

Option 1, à partir d'un thème de référence récent et léger.

Raisons

  • Délai de mise en œuvre court.
  • Toutes les apps Shopify restent compatibles.
  • Maintenance faible : pas d'infrastructure à héberger.
  • Le HTML est rendu côté serveur (utile pour le SEO et les IA).
  • Le configurateur MVP tient dans un thème (ADR-003).

Conséquences

Positives : vitesse de livraison, risque faible. Négatives : liberté d'UX moindre que le headless ; dépendance aux conventions de thème Shopify. À surveiller : si le configurateur V2 dépasse les capacités du thème.

Réversibilité

Migration vers le headless possible plus tard : le catalogue, les métachamps et les données restent dans Shopify.

Liens

NFR-001, NFR-003, F-050.