Aller au contenu

État de l'industrialisation du frontend

Lecture simple

Cette page suit les travaux destinés à rendre le frontend plus facile à comprendre, tester et maintenir, sans modifier ce que voient les visiteurs.

Baseline protégée

  • branche de référence : main ;
  • tag de référence : frontend-canonical-v1 ;
  • frontend premium et filtres mobiles AJAX validés ;
  • toute extraction doit préserver le comportement public.

État actuel

Galerie produit

Statut : extraite et couverte par les tests.

Emplacements :

includes/frontend/product-gallery-assets.php
includes/frontend/assets/product-gallery.js

Variantes produit

Statut : extraites et couvertes par les tests.

Emplacements :

includes/frontend/product-variants-assets.php
includes/frontend/assets/product-variants.js

Filtres catalogue

Statut : tiroir et auto-submit extraits et couverts par les tests.

Emplacements :

includes/frontend/catalog-filter-assets.php
includes/frontend/assets/catalog-filter-drawer.js
includes/frontend/assets/catalog-filter-autosubmit.js

Le contrôleur mobile AJAX reste volontairement séparé :

includes/frontend/mobile-catalog-filters.php
includes/frontend/mobile-catalog-filters-compat.php

frontend/product-models.php

Statut : en découpage progressif.

Trois blocs JavaScript inline ont été supprimés du monolithe : galerie, variantes et filtres. Le fichier reste responsable du SEO, du routage, du rendu catalogue, des offres et de la fiche produit.

La cartographie détaillée se trouve dans :

docs/architecture/frontend/product-models-responsibility-map.md

Prochaine étape : caractériser puis extraire le domaine SEO/routage sans modifier les hooks WordPress, les URLs, les statuts HTTP ou les balises produites.

Autres monolithes identifiés

  • application/product-models.php ;
  • application/product-model-enrichment.php ;
  • pipeline/90-offers-norm.php ;
  • mapping/row-to-item-helpers.php ;
  • runtime/batch-persister.php ;
  • frontend/assets/catalog.css.

Ils ne doivent pas être refactorés en parallèle. Chaque domaine aura sa propre branche et sa propre PR.

Définition de terminé pour une étape

  • tests verts ;
  • comportement public inchangé ;
  • documentation mise à jour ;
  • responsabilité extraite clairement nommée ;
  • rollback possible par commit ;
  • aucun doublon actif introduit.

Présentation catalogue canonique

Statut : TRANSITIONAL.

La page Smartphones constitue la baseline visuelle CURRENT validée sur le commit b1c7253c. La cible est d’extraire ce langage visuel vers catalog-listing.css sans modifier le rendu Smartphones.

La migration sera réalisée verticale par verticale. Les anciens sélecteurs et styles restent compatibles jusqu’à preuve de non-utilisation.

Décision : ADR 0005.