Le produitSite public12 min de lecture
Catalogue et recherche
Le catalogue lit ses meubles une fois et juge les filtres en mémoire. Il ne propose que les filtres qui retirent quelque chose, il remplace la pagination par « Voir plus » et sa recherche tourne dans le navigateur.
Le catalogue sert à deux types de visite. Il y a la personne qui flâne (le catalogue entier, un type, une collection) et celle qui cherche une pièce précise (un budget, une cote, une couleur). Le site compte quelques centaines de meubles, quelques milliers au maximum (EXPECTED_MAX_PRODUCTS, apps/site/modules/catalogue/lib/catalogue-query.ts). Cette échelle explique la plupart des choix qui suivent. Avec si peu de meubles, on peut juger les filtres en mémoire et envoyer tout l’index de recherche au navigateur. Avec un catalogue cent fois plus grand, on ne pourrait pas.
Les chemins sans préfixe partent de apps/site/.
| Choix | Problème réglé | Dans le code |
|---|---|---|
| Une seule lecture et une seule règle | une option comptait « 4 » et la liste en montrait 3, ou une table chêne et noir sortait pour « chêne noir » | rankCandidates, countFacetOptions, variantJudge |
| Seulement les filtres utiles | des filtres qui ne retirent rien, ou qui mènent à une liste vide | collectFacets, usefulSuggestions |
| Les filtres dans l’adresse | une sélection perdue au rechargement, au partage ou au retour d’une fiche | parseCatalogueFilters, restrictToFacets |
| « Voir plus » | la pagination perd ce qu’on vient de voir, le défilement infini cache le pied de page et n’a pas d’adresse | mergeFeed, catalogue-return.ts |
| Une recherche dans le navigateur | chaque frappe attendait le réseau | /recherche/index, rankProducts, searchRanking |
Une seule lecture et une seule règle
Un catalogue filtré doit répondre à trois questions en même temps : quelles pièces montrer, quelles options proposer, et combien de pièces chaque option retiendrait. Avec trois requêtes, les trois réponses arrivaient à trois instants différents. Du coup, un compte annonçait quatre pièces et la liste en montrait trois.
Donc on fait une seule lecture par périmètre (le catalogue entier ou une catégorie). Elle rend les meubles publiés avec tout ce qu’il faut pour les juger : prix, stock, couleurs, matières, cotes, marque, collections (getCategoryCandidates, modules/catalogue/data/get-category-facets.ts). Cette lecture est en cache. Ensuite, les filtres se jugent en mémoire, avec une seule règle (modules/catalogue/lib/catalogue-matching.ts).
- Les filtres d’une pièce (couleur, matière, disponibilité, prix, promotion, cotes) se jugent sur une même déclinaison. Une table proposée en chêne blanc et en noyer noir ne sort pas pour « chêne » et « noir ». Et si seul le modèle noir est en stock, elle ne sort pas pour « blanc » et « en stock ».
- Les critères tapés dans la recherche (« moins de 500 € », « en stock », « 160 cm ») se jugent aussi sur cette déclinaison (
variantJudge). Si on filtre sur « Noir » et qu’on cherche « canapé moins de 500 € », le canapé noir à 900 € ne sort pas, même si sa housse blanche tient le budget. - La marque et la collection se jugent sur le meuble.
- Dans un même groupe, deux options cochées s’additionnent (l’une ou l’autre).
- Le compte d’une option ne tient pas compte de son propre groupe. Si on coche « Noir » à côté de « Blanc », ça ajoute les meubles noirs.
Quand personne n’a choisi de tri, la liste suit l’ordre que l’équipe compose dans l’ERP (« Recommandé », Product.position), ou la pertinence s’il y a une recherche. « Nouveautés » trie sur la date de première mise en ligne. C’est la base qui fige cette date (Product.firstPublishedAt), donc republier une fiche ne la fait pas remonter. Les tris par prix lisent le prix que la carte affiche, remise en cours comprise. C’est celui des déclinaisons retenues qu’on peut acheter (offeredVariants). Du coup, une déclinaison épuisée moins chère ne fait pas remonter le meuble à un prix qu’on ne peut plus payer.
La carte suit le filtre. C’est la déclinaison qui a fait ressortir le meuble qui donne à la carte sa photo, son prix, sa remise et sa disponibilité, et la fiche s’ouvre sur elle (?variante=, filteredVariantId, modules/catalogue/lib/filtered-variant.ts). Si on filtre sur « Vert », le canapé ne montre pas sa housse blanche et ne s’ouvre pas sur un « Épuisé ».
Du coup, le compte affiché à côté d’une option, c’est exactement le nombre de meubles qu’on verra en la cochant. La page ne lit en base que les pièces de la page affichée. Le classement entier, lui, a sa propre entrée de cache (fetchRankedIds, modules/catalogue/data/get-products-by-category.ts).
Il y a trois limites.
- Pour juger en mémoire, il faut que le périmètre tienne en mémoire. Au-delà de quelques milliers de meubles, il faudrait descendre les filtres et les comptes dans la base.
- Pendant qu’il se refait, le classement est servi périmé, et il peut nommer une pièce retirée entre-temps. Donc la page ne relit que les meubles encore publiés parmi ceux qu’il désigne.
- Le tri par prix et le filtre « En promotion » dépendent des remises en cours. Donc le cache du classement expire avec la prochaine fin de remise du périmètre (
catalogueLifeUntilDiscountEnds), et pas seulement avec la page.
Seulement les filtres utiles
Un filtre qui ne retire rien, c’est un geste perdu. Par exemple « Chêne massif » dans une catégorie où tous les meubles sont en chêne massif, ou une fourchette de prix quand toutes les déclinaisons coûtent pareil.
Donc on ne propose une option que si certains meubles du périmètre l’ont, mais pas tous (collectFacets). La disponibilité, la marque, la promotion et les cotes n’apparaissent que si elles séparent des pièces. Et quand il n’y a qu’un meuble, il n’y a pas de filtre du tout. Pour la disponibilité, on ne propose que ce qu’on cherche (« En stock », « Sur commande »), parce que personne ne cherche une pièce épuisée. Les couleurs et les matières se proposent par familles, que l’équipe range dans l’ERP (« Noir » plutôt que « Noir mat »).
Sur téléphone, les filtres s’ouvrent dans un tiroir qui remonte du bas (Base UI Drawer), et on y travaille sur un brouillon. Rien ne part tant qu’on n’a pas validé, et le bouton dit combien de pièces la sélection retiendrait (« Afficher 12 meubles »). Ce compte vient d’une route sans cache, /recherche/total, qui applique la même règle sans lire de page de résultats. Le tri est un <select> natif à toutes les largeurs, donc le téléphone ouvre son propre sélecteur.
Quand les filtres ne laissent que quelques pièces (FEW_RESULTS), la liste propose, sous les résultats, de retirer un filtre à la fois. Elle donne le nombre de pièces que chaque retrait rendrait (usefulSuggestions, modules/catalogue/lib/catalogue-relaxations.ts). Une liste vide dit ce qui l’a vidée. Si c’est seulement la recherche, retirer un filtre n’y changerait rien, donc la page ne le propose pas. En bas de liste, on renvoie vers le magasin et le sur-mesure, parce qu’ils s’adressent justement à la personne qui n’a pas trouvé sa pièce.
La limite, c’est qu’une option peut disparaître parce qu’elle ne départage plus rien, et ça peut surprendre quelqu’un qui l’avait vue sur un autre type. C’est le prix à payer pour un panneau court.
Les filtres dans l’adresse
Les filtres, le tri, la recherche et la page sont dans searchParams (?couleur=noir&tri=prix-croissant&page=2), et c’est le serveur qui les lit (parseCatalogueFilters, modules/catalogue/lib/catalogue-filters.ts). On se méfie de ces valeurs quand on les relit. Un slug doit avoir la forme d’un slug. Une liste est plafonnée (MAX_FILTER_VALUES). Et si la borne maximale est sous la minimale, on considère que c’est une faute de frappe et on ne garde que la minimale. Les cotes s’écrivent en centimètres dans l’adresse et se comparent en millimètres, l’unité de la base.
Quand l’ERP range une nuance ou une matière dans une famille, une ancienne adresse (?couleur=noir-mat) retrouve sa sélection sous le nom d’aujourd’hui (?couleur=noir). Elle ne tombe pas sur le catalogue entier (restrictToFacets). Deux adresses qui demandent la même chose ont la même clé de cache.
Du coup, on garde sa sélection après un rechargement, avec un lien envoyé ou avec un favori du navigateur. Les moteurs n’indexent pas une liste filtrée ou triée (Référencement).
En contrepartie, chaque combinaison de filtres est une entrée de cache à part. Il y a beaucoup de combinaisons possibles, mais les vraies visites en touchent peu. Et une combinaison rare se calcule en mémoire sur une lecture déjà en cache.
« Voir plus » plutôt que la pagination
La route rend une page de résultats. « Voir les suivants » est un vrai lien vers ?page=N+1. Donc pour un robot, ou sans script, chaque page reste une page. Avec le script, le fil garde les pages déjà affichées et ajoute la nouvelle à la suite, dans une seule liste (mergeFeed, modules/catalogue/lib/catalogue-feed.ts). Si un meuble est publié entre deux clics, les pages se décalent d’un cran, mais il ne s’affiche qu’une fois, à sa première place.
Au retour d’une fiche, dans le cas courant, il n’y a rien à faire. Avec cacheComponents, Next garde les dernières routes visitées sous <Activity>, DOM et état compris, et le fil revient à la même hauteur. Si le catalogue a été évincé ou l’onglet rechargé, le retour reste juste grâce à deux gestes faits au clic sur une carte. L’adresse prend la page de la carte cliquée, et la carte est notée pour la session. Au retour, le fil la ramène sous les yeux (modules/catalogue/lib/catalogue-return.ts). Sur téléphone, le lien « Retour à la liste » de la fiche ne propose une liste que si on vient d’une liste.
Vers la fiche, la photo de la carte voyage jusqu’à la galerie avec une transition de vue (CoverFlight, modules/catalogue/components/cover-flight.tsx). Elle ne joue que pour cette navigation. Un filtre ou un tri n’anime rien.
Pour l’accessibilité, le focus passe au premier meuble arrivé après « Voir les suivants ». Dans la liste, seul le compte de la barre d’outils parle (role="status"). Les filtres, la recherche et les pages ne l’annoncent pas une seconde fois. Quand on retire une pastille de filtre, elle disparaît sous le focus. Le focus passe alors au compte et ne remonte pas en haut de la page.
La limite, c’est qu’une page cachée sous <Activity> reste dans le document, et ses effets se rejouent à chaque retour. Donc le replacement du fil fait attention à ne pas se rejouer.
Une recherche qui tourne dans le navigateur
La recherche rapide (le champ de la barre, ⌘K) doit répondre à chaque frappe, sur un téléphone en 4G. Elle doit aussi comprendre ce qu’un client tape : « canapé gris moins de 800 € », « table chêne 180 x 90 », « meuble tv 160 cm en stock ».
Donc tout le catalogue publié part au navigateur sous forme d’index compact (getSearchIndex, modules/catalogue/data/get-search-index.ts, au plus SEARCH_INDEX_MAX meubles), et le moteur classe les résultats dans le navigateur à chaque frappe. L’index et le moteur se chargent ensemble au premier signe d’intention (survol, focus ou ouverture du champ, warmSearchIndex). Du coup, ils ne pèsent rien dans le JavaScript de chaque page, et la frappe n’attend pas le réseau.
Le moteur (modules/catalogue/lib/search/) comprend :
- Les critères : un budget (« moins de 800 € », « entre 300 et 600 € »), des cotes (« 160 x 90 », « largeur max 180 »), le stock, la promotion, les petits prix (
readSearch,search-criteria.ts). Un nombre sans « € » n’est un prix que s’il vient après un mot de prix, donc « 3 places » n’est pas un budget. Comme dans le catalogue, le prix, les cotes et le stock se jugent sur une même déclinaison. - Les mots des clients : « sofa » se lit aussi « canapé », « rouge » trouve « Bordeaux », « extensible » trouve les tables à allonges (
SEARCH_LEXICON). Le lexique ajoute des lectures, il n’en retire pas. Les mots distinctifs de la description comptent aussi (textKeywords), et la tuile dit par quel mot elle a été trouvée. - Les fautes de frappe. Il les pardonne sur un mot d’au moins cinq lettres. Par contre, il ne les pardonne jamais sur un chiffre (« MM0003 » n’est pas « MM0005 »), ni quand c’est la première lettre qui est remplacée (« miroir » n’est pas « tiroir »).
- Le cas où rien ne répond à tout. La palette propose alors la saisie la plus proche qui trouve quelque chose, faite avec les mots du client. Elle n’en retire pas toute seule.
Quand on valide la saisie, on arrive sur le catalogue cherché (/catalogue?q=), qui classe avec le même moteur, côté serveur (searchRanking). L’ancienne page /recherche y redirige avant tout rendu (next.config.ts).
Côté fraîcheur, /recherche/index reste en cache une minute au CDN. Ensuite, il est servi périmé une minute de plus pendant qu’il se refait. Le navigateur, lui, ne le garde jamais (app/(site)/recherche/index/route.ts). Un index vide (catalogue fermé, base lue au mauvais moment) ne se garde nulle part. Les remises échues sont soldées avant l’envoi. Comme ça, la palette ne montre pas un prix barré que le panier ne fait plus payer.
Le champ est un combobox. Le focus reste dans le champ, la case active est désignée par aria-activedescendant, et le nombre de résultats s’annonce dans une région status. Au repos, la palette propose les recherches de la visite qui ont mené quelque part. Elles sont dans sessionStorage et ne quittent pas le navigateur. La ligne active précharge sa fiche entière (prefetch={active ? true : "auto"}).
Cette recherche a trois limites.
- L’index part en entier. À quelques milliers de meubles, il pèse encore peu, mais il grossit avec le catalogue. Chaque champ ajouté est téléchargé par chaque visiteur. C’est pour ça que l’index est réduit à l’essentiel (cadrage arrondi, teintes de bord compactées).
- Le CDN ne suit pas l’invalidation par tags. Un prix ou un « Épuisé » peut donc y avoir jusqu’à deux minutes de retard. De toute façon, le panier et le paiement revérifient (Panier et paiement).
- Le lexique et les règles de lecture sont écrits à la main, en français. Un mot de client qui n’est pas dans le lexique ne trouve que les fiches qui le contiennent.