Architecture¶

Statut : brouillon

Volontairement simple : Shopify fait l'essentiel. Ce qu'on construit, c'est un thème, des données et quelques scripts.

Contexte (niveau 1)¶

flowchart LR
  C[Client] --> S[Boutique Shopify]
  Pro[Professionnel] --> S
  AI[Assistants IA / moteurs] --> S
  S --> Pay[Paiement]
  S --> Log[Transporteurs / logisticien]
  S --> Rev[Revendeur canadien]
  S --> An[Analytics, Search Console, Merchant Center]
  Team[Équipe] --> S

Conteneurs (niveau 2)¶

flowchart TD
  Repo[(Repo Git: docs, theme, scripts, data)] -->|Shopify CLI / intégration GitHub| Theme[Thème Online Store 2.0]
  Repo -->|scripts d'import| Admin[Shopify Admin: produits, métachamps, métaobjets]
  Admin --> Theme
  Theme --> Browser[Navigateur du client: Liquid rendu serveur + JS léger]
  CSV[compatibilite.csv] -->|import| Admin
  CSV -->|tests| Tests[Tests automatisés]

Ce qui est dans le repo¶

docs/ : connaissance (source de vérité).
theme/ : thème Shopify (sections, snippets, assets, locales).
scripts/ : vérification de la doc, import des données, génération de métachamps.
tests/ : tests des règles de compatibilité, du prix et du JSON-LD.

Ce qui n'est pas dans le repo¶

Commandes, clients, paramètres de paiement et de taxes : dans Shopify, hors code.

Principes¶

Données d'abord : les règles vivent dans le CSV et les métachamps, le code les lit.
Rendu serveur pour tout contenu important (SEO, IA).
JavaScript léger et progressif : la page produit reste utilisable sans JS.
Aucune dépendance externe sans ADR.

« Previous Next »