ADR 0004 - Canonical Public URL Strategy¶
Status¶
Accepted
Context¶
La Public Information Architecture v1.0 certifie les surfaces publiques du site.
Une décision explicite est nécessaire pour fixer la grammaire canonique des URLs publiques avant toute convergence du runtime.
La PIA définit les surfaces publiques.
Cette ADR définit leur grammaire d'URL canonique.
Decision¶
Les surfaces de découverte suivent la hiérarchie publique.
La grammaire canonique retenue est :
- accueil :
/ - univers :
/{univers}/ - catégorie :
/{univers}/{categorie}/ - sous-catégorie :
/{univers}/{categorie}/{sous-categorie}/ - marque :
/{univers}/{categorie}/{marque}/ - modèle :
/{univers}/{categorie}/{marque}/{modele}/ - produit :
/produits/{canonical-slug}/ - guide :
/guides/{slug}/ - comparatif :
/comparatifs/{slug}/ - recherche :
/recherche/
Les routes legacy ne sont jamais canoniques.
Options Considered¶
Option A¶
/produit/{ean}
Cette option conserve une URL produit indépendante de la hiérarchie, mais elle reste peu lisible pour le lecteur et trop dépendante d'un identifiant technique comme grammaire publique cible.
Option B¶
/{univers}/{marque-ou-categorie}/{slug-produit}
Cette option est lisible, mais elle dépend trop fortement de la hiérarchie publique et augmente le risque de duplication lorsqu'un même produit peut être atteint par plusieurs chemins de découverte.
Option C¶
/produits/{canonical-slug}
Cette option conserve une URL produit lisible, indépendante de la hiérarchie, compatible avec plusieurs verticales et alignée avec une représentation publique unique du produit.
Cette option est retenue.
Consequences¶
Les surfaces de découverte restent lisibles et alignées sur la hiérarchie publique.
Les produits publics possèdent une grammaire d'URL distincte de la découverte.
La surface produit canonique ne dépend pas d'un univers, d'une catégorie ou d'un marchand.
La séparation entre découverte publique et identité produit publique devient explicite.
Legacy Redirection Rules¶
Toute route legacy doit rediriger vers une surface canonique existante.
Une route legacy ne devient jamais canonique.
Une URL historique ne redevient jamais la source de vérité.
Une redirection legacy préserve l'accès public sans créer une nouvelle surface.