Le produitSite public7 min de lecture
Référencement
Chaque page a son adresse canonique et les listes filtrées restent hors index. Le balisage et le flux marchand disent exactement ce que la page affiche, et les images de partage n’affichent pas de prix.
Un magasin de meubles, on le trouve d’abord par une recherche : un type de meuble, une matière, une ville. Les moteurs comparent ce que la page affiche, ce que son balisage déclare et ce que le flux marchand annonce. S’il y a un écart entre les trois (un prix, une date, une photo), ça passe pour une incohérence, et le Merchant Center de Google la sanctionne. Du coup, la règle du référencement est la même que celle du paiement : dire aux moteurs ce que la page montre, et rien d’autre.
Les chemins sans préfixe partent de apps/site/.
Les adresses
Chaque page déclare son adresse canonique avec pageMetadata (shared/lib/page-metadata.ts). Une fiche ouverte sur une déclinaison (?variante=) garde comme canonique l’adresse nue de la fiche.
Une liste filtrée, triée ou au-delà de sa dernière page est en noindex, et elle ne désigne aucun canonique. noindex et un canonique vers une autre adresse sont deux signaux contraires, et Google déconseille de les mélanger sur une navigation à facettes (catalogueMetadataVariant, modules/catalogue/lib/catalogue-query.ts). Les pages 2, 3… de la liste nue restent indexées, chacune avec un titre distinct, pour ne pas passer pour le doublon de la première. Le bouton « Voir les suivants » est un vrai lien vers la page suivante (Catalogue et recherche).
Certaines adresses ne s’indexent pas : les devis (leur jeton est un secret), le compte, la commande, sa confirmation et son suivi, une pièce retirée (« plus disponible »). robots.txt écarte l’API et les routes machine de la recherche (app/robots.ts). La liste des routes publiques et de leur indexation est écrite une seule fois (PUBLIC_ROUTES, shared/constants/public-routes.ts). Le plan du site et un test e2e la lisent. Et e2e/pages.spec.ts vérifie, page par page, le titre unique, le canonique et l’indexation déclarée.
Les anciennes adresses /contact et /recherche redirigent de façon permanente avant tout rendu (next.config.ts), et une ancienne valeur de filtre retrouve sa famille (Catalogue et recherche).
Les métadonnées quand la base flanche
Les métadonnées d’une fiche, d’un type ou d’une collection lisent la base. Sauf qu’une erreur levée par generateMetadata échappe à la frontière d’erreur du site. Dès que la base flanchait pendant qu’une page se refaisait, Next servait une coquille d’erreur vide, sans barre ni message. Dans ce cas, resilientMetadata rend les métadonnées de la mise en page racine. Le contenu, qui lit la même pièce, lève une erreur à son tour et tombe dans la frontière du site, avec la barre et le pied autour (shared/lib/resilient-metadata.ts). Au build, l’erreur remonte, donc un build sans base échoue.
Pour sa description, une catégorie prend celle écrite dans l’ERP. S’il n’y en a pas, elle prend une description tirée de ses pièces, et sinon la signature de la maison (get-catalogue-metadata.ts).
Le plan du site
app/sitemap.ts liste les pages publiques, les catégories, les collections et chaque fiche publiée, avec sa date de mise à jour et ses photos. Il ne garde que les adresses indexables. Il refuse de dépasser la limite d’un fichier de plan (50 000 adresses), et son message dit comment le découper.
Le balisage des pages
La mise en page du site déclare le magasin en JSON-LD : coordonnées, horaires, politique de retour (app/(site)/layout.tsx). Si la base ne répond pas, il n’y a aucun balisage, pour ne pas publier des horaires devinés.
Le balisage d’une fiche suit la documentation de Google sur les variantes : une seule page, avec le choix dans l’adresse (modules/products/lib/product-structured-data.ts). Une pièce seule est un Product. Une pièce déclinée est un ProductGroup et un Product par déclinaison. Chaque déclinaison a son offre à sa propre adresse (?variante=), ses photos et ce qui la distingue (variesBy). Ce qui ne varie pas se dit une fois, sur le groupe. Les axes de variation sont la couleur et la matière, jamais size. La « taille » d’une déclinaison, c’est une précision libre sur ses cotes, pas une taille de vêtement (VARIANT_AXES).
L’offre déclare le prix annoncé, la disponibilité, la livraison et la politique de retour. Elle déclare aussi le délai de fabrication plus l’acheminement, quand chacun des modes qui livrent la pièce le renseigne. Les deux se comptent en jours de semaine, du lundi au vendredi, et le balisage le déclare (businessDays). La fabrication part du jour de la visite et mène à la date de la fiche et de la commande : les fériés et les fermetures, que le balisage ne connaît pas, y comptent comme des jours de semaine (leadTimeWeekdays). C’est pour ça que le balisage est lu à la requête, sous son propre Suspense (ProductJsonLd).
Le balisage ne donne un prix barré que si la page le montre (shownDiscount), donc jamais pour une déclinaison épuisée. Le dernier jour du prix réduit (priceValidUntil) est celui que la fiche affiche. La fin d’une remise tombe à minuit, au matin du lendemain. Sans la milliseconde retirée, le balisage promettait le prix réduit un jour de plus que la fiche et le paiement.
Une liste du catalogue se déclare pour ce qu’elle est : une page de collection et la liste ordonnée des fiches qu’elle montre. Elle ne répète pas le balisage Product, qui appartient à chaque fiche (catalogueStructuredData). Une liste filtrée n’a pas de balisage.
Le flux du Merchant Center
app/flux-produits.xml/route.ts publie le catalogue pour Google Merchant Center, à partir des mêmes lectures en cache que la fiche : fermetures, grille de livraison, délai de l’atelier. Du coup, le flux annonce le prix, la livraison et la date que la page d’atterrissage affiche. Chaque déclinaison est un article de son groupe (item_group_id), avec ses propres photos (l’article vert ne montre pas la housse blanche), sa couleur, sa matière, ses cotes et son poids (buildMerchantFeed, modules/products/lib/merchant-product.ts). Ce qui distingue une déclinaison se dit de la même façon dans le balisage et dans le flux (variant-attributes.ts).
Google lit le flux une fois par jour. Sans période, une annonce gardait le prix réduit jusqu’au passage suivant, alors que la fiche et le paiement étaient revenus au prix plein dès minuit. Donc le flux déclare la période du prix réduit (sale_price_effective_date).
Une pièce qu’on ne peut pas annoncer correctement (sans photo, sans description, sans prix) est écartée avec son motif (MERCHANT_INELIGIBILITY). On ne l’annonce pas à moitié.
Le flux reste un quart d’heure en cache au CDN, puis il est servi périmé cinq minutes pendant qu’il se refait. Du coup, les passages répétés d’un robot ne recalculent plus le catalogue, et le flux n’a jamais plus de vingt minutes de retard sur la fiche. On évite un long stale-while-revalidate, parce que le flux est lu une fois par jour et qu’il servirait à chaque fois la copie de la veille.
Les images de partage
Chaque route qui le mérite (l’accueil, le catalogue, un type, une collection, une fiche, l’atelier, la maison) compose son image de partage (opengraph-image.tsx) sur un socle commun (shared/server/share-image/kit.tsx). C’est une planche avec un mur, une ligne de sol, ce que la page montre debout dessus, et la signature de la maison en dessous. Une fiche montre sa pièce debout, son mur prolongé, ses cotes tracées sur ses bords et son nom en affiche.
Ces images n’affichent pas de prix. Une image partagée reste des semaines dans le cache d’un réseau social, et elle afficherait un tarif ou une remise qui ont changé. Le texte du lien, lui, est relu à chaque partage, et c’est lui qui porte le reste.
Le moteur, Satori (next/og), ne lit ni oklch(), ni le woff2, ni la grille CSS, et il ne mesure pas un texte avant de le poser. Du coup, les teintes sont en hexadécimal, les polices sont embarquées en TTF, la mise en page est en flex, et la coupe des titres se décide à l’avance, sur les chasses de la police des titres (heading-fit.ts). Satori ne décode pas non plus le WebP, le format du store des photos, et il le rendait en blanc sans erreur. Donc la photo passe par sharp, qui la réduit et la convertit en JPEG (loadSharePhoto). La planche dessinée, que next/og ne rend qu’en PNG, sort elle aussi en JPEG (shareImage). Avec une photo d’ambiance, le PNG pesait 700 Ko, et c’est trop pour l’aperçu d’une messagerie.
Une pièce retirée, une adresse inconnue, une photo qui tarde ou une lecture en échec donnent l’image de la maison. Comme ça, l’aperçu du lien ne montre jamais un cadre vide (shareImageOrHouse).
Les limites
- Une fiche disparue répond 200 avec
noindex, et pas 404, parce que le flux de la page a déjà commencé quand on découvre que la pièce n’existe pas. Du coup, certains moteurs la classent en « soft 404 » (Next.js et React). - Le CDN ne suit pas l’invalidation par tags. Le flux peut donc avoir vingt minutes de retard, et l’index de recherche deux.
- Le site n’est pas traduit. Tout est en français, sans
hreflang.