Arbre public de navigation¶
Statut¶
HISTORICAL / DESIGN DE RÉFÉRENCE.
Cette page conserve l'ancien arbre public documenté de CMonChoix afin de garder la trace des choix de structure qui ont précédé le registre exécutable actuel.
Elle n'est plus la source de vérité CURRENT.
La source canonique actuelle est :
plugins/ccx-feeds-industrial/includes/application/navigation-architecture.php
via :
ccx_navigation_architecture_registry()
Pourquoi conserver cette page¶
Cet ancien arbre reste utile pour :
- comprendre les intentions de navigation qui ont guidé les premiers designs ;
- expliquer certaines anciennes URLs ou redirections ;
- comparer une ancienne arborescence avec le registre actuel ;
- éviter de réintroduire par accident des catégories qui ont été volontairement supprimées ou réorganisées.
Il ne doit pas servir à reconstruire le menu actuel sans vérification dans le code.
Règles historiques encore pertinentes¶
Plusieurs principes de l'ancien design restent compatibles avec l'architecture actuelle :
- la navigation publique décrit des familles de produits ;
- les marchands ne gouvernent pas l'arbre public ;
- une marque, une capacité, une couleur ou une technologie n'est pas automatiquement une catégorie ;
- les états d'offre ne créent pas une nouvelle identité produit ;
- les consommateurs Frontend ne doivent pas maintenir chacun leur propre taxonomie ;
- les redirections legacy sont un filet de sécurité, pas une architecture cible.
Ces principes doivent cependant être relus à la lumière du registre CURRENT.
Ancienne liste d'univers¶
La version historique documentait notamment les univers suivants :
- Smartphones & Objets connectés
- Informatique
- TV & Audio
- Électroménager
- Maison & Habitat
- Gaming
- Photo & Vidéo
- Mobilité
- Beauté & Santé
- Jeux & Jouets
Cette liste ne doit pas être recopiée comme vérité runtime sans comparaison avec ccx_navigation_architecture_registry().
Exemple de divergence avec le CURRENT¶
Le registre PHP actuel contient un commentaire explicite indiquant que plusieurs branches sont intentionnellement absentes, notamment :
- Jardin ;
- mobilier ;
- robots tondeuses ;
- arrosage.
Une ancienne page de design qui mentionnerait l'une de ces branches ne constitue donc pas une raison suffisante pour la réintroduire.
Comment utiliser cet historique¶
Lorsqu'une ancienne URL ou catégorie apparaît dans un ticket, un log ou un ancien template :
- rechercher le slug dans cette page pour comprendre le contexte historique ;
- rechercher ensuite le slug dans
navigation-architecture.php; - vérifier les éventuelles redirections ou compatibilités ;
- ne modifier le Runtime que si le contrat CURRENT le justifie.
Ce qui gouverne aujourd'hui¶
L'ordre d'autorité pour la navigation publique est :
1. registre exécutable CURRENT
navigation-architecture.php
2. contrats et documentation CURRENT
navigation-runtime.md
public-information-architecture.md
3. documents historiques
public-navigation-tree.md
anciennes certifications / anciens templates
Une contradiction doit être résolue en partant du registre exécutable et du comportement réellement observé, pas en restaurant aveuglément un ancien arbre.
Navigation déclarée et navigation visible¶
Le registre CURRENT distingue volontairement :
- les feuilles déclarées à long terme ;
- les feuilles réellement visibles au Runtime.
Une feuille peut exister dans l'architecture tout en restant masquée si aucune offre ou aucun modèle public ne satisfait son contrat, sauf always_visible explicite.
L'ancien arbre documentaire ne décrivait pas toujours cette distinction avec assez de précision.
Ancienne structure détaillée¶
La version v1.0 draft contenait une arborescence beaucoup plus détaillée avec des branches telles que :
Smartphones & Objets connectés
Informatique
TV & Audio
Électroménager
Maison & Habitat
Gaming
Photo & Vidéo
Mobilité
Beauté & Santé
Jeux & Jouets
et de nombreuses sous-catégories techniques.
Cette structure est conservée dans l'historique Git du fichier. Elle n'est volontairement pas reproduite intégralement ici afin d'éviter qu'un futur mainteneur la confonde avec l'état CURRENT.
Pour analyser une ancienne version précise, utiliser Git :
git log -- docs/frontend/public-navigation-tree.md
puis :
git show <commit>:docs/frontend/public-navigation-tree.md
Cas de diagnostic¶
Une catégorie existe dans l'ancien arbre mais pas dans le site¶
Ne pas conclure à une régression.
Vérifier d'abord si elle existe encore dans le registre PHP actuel.
Une catégorie existe dans le registre mais pas dans le site¶
Vérifier son contrat de visibilité, les données publiques, puis la projection/cache/Reader.
Une ancienne URL continue de recevoir du trafic¶
Traiter la compatibilité via les mécanismes de routing ou redirection prévus ; ne recréer pas une branche de navigation uniquement pour préserver une ancienne URL.
Ce qu'il ne faut pas faire¶
Ne pas :
- réinjecter cet arbre dans le thème ;
- générer des seeds depuis cette page ;
- considérer cette page comme plus autoritaire que le code CURRENT ;
- créer une catégorie parce qu'elle figurait dans la v1.0 draft ;
- utiliser l'historique pour contourner les règles actuelles de visibilité.