Aller au contenu

ADR 0005 — Canonical Catalog Presentation System

Status: ACCEPTED

Contexte

Les catalogues Product Models doivent partager une identité visuelle cohérente sans dupliquer le CSS entre verticales.

La page Smartphones constitue la baseline visuelle validée pour cette industrialisation.

Décision

Un seul système de présentation catalogue devient la cible canonique.

Il possède : - layout catalogue et responsive ; - sidebar et présentation des filtres ; - toolbar ; - grille et carte produit ; - prix, offres, CTA et favoris ; - espacements, bordures, rayons et typographie.

Les verticales ne dupliquent pas ce CSS.

Elles fournissent uniquement leur hero, leurs facettes, leurs métadonnées de carte et les exceptions visuelles explicitement justifiées.

Architecture cible

catalog.css -> catalog-listing.css -> vertical-specific.css

catalog-listing.css est l’owner visuel commun. Les fichiers verticaux doivent rester minces.

Migration

  1. Smartphones reste la baseline.
  2. Introduction de classes catalogue génériques.
  3. Extraction du CSS commun sans changement visuel.
  4. Validation Smartphones.
  5. Migration d’une seconde verticale pilote.
  6. Migration verticale par verticale.
  7. Suppression du legacy uniquement après preuve de non-utilisation.

Invariants

  • aucune copie du CSS catalogue par verticale ;
  • aucune logique métier dans le CSS ou le renderer ;
  • facettes déclaratives et hero configurable ;
  • une seule carte visuelle canonique ;
  • compatibilité conservée pendant la transition ;
  • rollback, tests et documentation à chaque étape.