Le produitSite public11 min de lecture
Fiche produit et déclinaisons
La fiche se rend en trois temps. On choisit sa déclinaison question par question, on a la date de livraison avant de payer, et on vérifie la taille au mètre.
C’est sur la fiche d’un meuble que le client se décide. Un meuble coûte cher, il met plusieurs semaines à arriver et il doit passer une porte. Donc la fiche doit donner le prix, la disponibilité, la date d’arrivée et la taille de la déclinaison choisie. Et tout ça doit être vrai à la minute, parce que le panier et la commande reprendront les mêmes chiffres.
Les chemins sans préfixe partent de apps/site/. Le modèle du catalogue côté ERP (un meuble, des déclinaisons complètes) est décrit dans Catalogue et déclinaisons.
Trois temps de rendu
Sur une fiche, il y a ce qui est commun à tous les visiteurs (la pièce, ses photos, son prix) et ce qui dépend de la visite. La date de livraison se compte à partir d’aujourd’hui, fermetures du magasin comprises. Le panier et les favoris sont ceux de ce navigateur.
Du coup, la page se rend en trois temps (app/(site)/produit/[slug]/_components/published-product.tsx).
- D’abord la pièce, lue en cache (
getProductBySlug) : galerie, nom, cotes, prix, description, déclinaisons. Elle entre dans la coquille prérendue. - Ensuite le bloc d’achat, lu pour la visite sous son propre
Suspense(getProductPurchase) : délai au jour près, dates promises, grille de livraison, horaires du magasin, ce que ce navigateur a déjà au panier et en favori. Ses six lectures partent ensemble. - Enfin les voisines (la collection, ce qui peut remplacer la pièce, les pièces vues), sous la ligne de flottaison, sans réserver de place.
Le bloc d’achat a sa propre frontière d’erreur (ProductOffersErrorBoundary). Du coup, une panne de la grille de livraison n’emporte plus toute la fiche. Le balisage pour les moteurs est lu à la requête, sous son Suspense, parce que son délai de fabrication se compte à partir du jour de la visite (Référencement).
Un meuble qui a été en ligne ne répond jamais introuvable. Une fois retiré, son adresse affiche « Cette pièce n’est plus disponible », hors index, et ce qui peut le remplacer passe devant (archived-product.tsx). Une adresse inconnue, elle, répond la 404.
Une adresse absente du build (un meuble publié depuis) reçoit tout de suite la barre, la transition et le squelette, et la pièce arrive en flux. Ce qui lit l’adresse dans le navigateur le fait sous sa propre frontière (address-reader.tsx), donc la coquille générique se prérend (Next.js et React). Côté limites, comme le flux a déjà commencé quand on découvre que la pièce n’existe pas, une fiche disparue garde le statut 200, avec une balise noindex.
Choisir une déclinaison
Dans l’ERP, une déclinaison est une combinaison complète, avec sa référence, son prix, son stock et ses cotes. Quand on l’affichait telle quelle, une table en deux longueurs et deux finitions donnait quatre puces (« 140 cm chêne naturel », « 140 cm chêne fumé »…), et il fallait lire chaque nom pour comprendre ce qui changeait.
Du coup, la fiche pose des questions (offerQuestions, modules/products/lib/offer-questions.ts). Le plus souvent, il n’y en a qu’une (« Couleur », « Format »). Il y en a une par axe quand plusieurs changent indépendamment (la longueur, puis la finition). Les questions qui contraignent passent d’abord (est-ce que ça rentre ?), et celles qui se voient viennent ensuite. Chaque puce ne dit que ce qui distingue sa réponse : ses couleurs propres, ses cotes, son prix ou son état, quand ils changent (offerChoice). L’équipe peut nommer le choix elle-même dans l’ERP (Product.choiceTerm : « Assise », « Housse »), sinon la fiche le déduit. Au-delà de quelques coloris, les puces deviennent un nuancier, replié derrière « Voir les 18 coloris » quand il est long.
Chaque réponse sélectionne une déclinaison qui existe, celle qui garde le plus du choix en cours. Donc la sélection n’est jamais une combinaison à compléter. Elle a son adresse (?variante=), son prix, son état et son bouton. Parfois une réponse en fait changer une autre, parce qu’aucune déclinaison ne garde tout. Dans ce cas, la fiche le dit en clair sous le choix : « 152 cm n’existe pas en Chêne naturel : la finition passe à Chêne fumé » (followNote). Il n’y a pas de toast, parce que l’écran montre déjà la nouvelle pièce et que la phrase dit pourquoi.
Le prix et l’état suivent le choix. La galerie aussi, mais sans perdre sa place : une déclinaison sans photo propre garde les photos communes, pas celles du coloris qu’on vient de quitter. La photo d’une déclinaison survolée ou focalisée se précharge en priorité basse, pour être déjà là quand on la choisit (warmStagePhoto). Le cœur des favoris garde la déclinaison qu’on regardait.
Le bouton d’achat et les conditions de chaque déclinaison sont rendus sur le serveur (ProductOfferList). Le composant client (ProductOfferPicker) choisit seulement lequel montrer. Le choix est optimiste (useOptimistic), donc la puce répond sans attendre, et l’adresse suit dans une transition. La galerie change dans une transition de vue typée, la seule où sa scène fond d’une finition à l’autre. Une déclinaison venue de l’adresse se pose d’un coup, sans fondu.
Quand les déclinaisons diffèrent par leurs cotes ou leurs matières, un tableau les met côte à côte, une colonne chacune, avec ce qui est commun dans une seule cellule (ProductVariants). Sur un téléphone, la colonne des libellés reste à gauche pendant que le tableau défile, et on peut atteindre au clavier le conteneur qui défile.
Chaque question est un groupe légendé qui dit la réponse prise (« Couleur : Vert sauge »), et le changement de sélection s’annonce dans une région status.
La limite, c’est que le meuble ne nomme qu’un axe de choix (choiceTerm). Les questions multiples se déduisent des lectures qui changent. Et un meuble très configurable, avec des options combinées, se vend sur devis.
La date avant le paiement
Un meuble fabriqué à la commande met plusieurs semaines à arriver. Si on annonce « 7 à 9 semaines », on laisse le client faire le calcul, et ce calcul oublie les fermetures du magasin et les jours fériés. Une analyse de la décision d’achat a montré que la date n’était confirmée qu’après le paiement, quand elle ne pouvait plus aider à décider.
Du coup, la fiche donne une date sous l’état de la déclinaison : « Fabriquée pour vous en 7 à 9 semaines : livrée d’ici mi-janvier », ou « Livrée d’ici fin novembre » pour une pièce en stock (offerDeliveryDates, modules/products/lib/offer-delivery-dates.ts). On la calcule comme la commande (workshopDueDate, deliveryDueDate), avec la même brique de packages/domain (addWorkshopBusinessDays). On part de la borne haute du délai en jours ouvrés, fériés et fermetures exclus. Ensuite on ajoute l’acheminement le plus long des modes qui livrent cette déclinaison. C’est toujours la borne haute, pour que la date annoncée soit respectée, et c’est celle que la commande promettra au paiement (Délais et dates promises).
Si on ne connaît pas l’acheminement de l’un des modes, la date est celle de l’expédition, et la phrase le dit (« expédiée »). Une pièce qu’aucun mode ne livre ne promet pas de livraison. Elle parle du retrait, ou du magasin. Une pièce en stock n’est pas présentée comme « mise de côté », parce qu’elle n’est réservée qu’au paiement et qu’elle se vend aussi au magasin. À l’approche de Noël, la fiche dit jusqu’à quand commander. C’est une date tirée des réglages, sans compte à rebours. Une fois qu’elle est passée, la phrase disparaît.
Le prix de livraison suit le poids de la déclinaison choisie (tranches de poids). Il ne donne pas une fourchette pour tout le meuble (productDelivery, modules/products/lib/purchase-terms.ts). Sous la fourchette, « Chez vous » donne le prix exact pour le code postal de la personne. Tapé une fois, ce code est gardé dans ce navigateur (localStorage, modules/shipping/lib/visitor-postal-code.ts), et le calcul se fait sur place, sur la grille que la page a déjà. Il n’est jamais envoyé au serveur, et la caisse le reprend.
Pour les obligations légales, on trouve sous le bouton la livraison, le retrait, le magasin, les retours et la garantie. Un meuble qui voyage par transporteur dit ce que son renvoi coûterait au maximum en cas de rétractation (article L221-5 du code de la consommation, returnCostMention). La garantie est dite « légale », pour ne pas faire passer une obligation pour un avantage offert par le magasin (article L121-4, WARRANTY_TERM).
La limite, c’est que la date dépend des réglages saisis dans l’ERP (délais, fermetures, acheminement des modes). Si l’acheminement d’un mode n’est pas renseigné, la date de livraison disparaît de toutes les pièces qu’il livre.
Vérifier la taille au mètre
L’acheteur cherche la taille d’un meuble dans ses photos. Sauf qu’un buffet de 180 cm ne se juge pas sur une photo seule.
Sous la description, la déclinaison choisie est dessinée sur le mur de ses photos, debout sur le même sol qu’une personne de 1,70 m, de face et de côté (DimensionPlan). Sur téléphone, les deux vues côte à côte seraient trop petites. Du coup, le plan en montre une au choix, et la personne garde sa taille d’une vue à l’autre. L’échelle est la même pour toutes les déclinaisons, donc si on choisit la grande, elle grandit à l’écran. Un lien posé sur la galerie mène à ce plan, sur téléphone comme sur tablette.
On mesure mal une pièce vide, mais on connaît son canapé. « Comparer avec mon meuble » prend trois cotes, les pose en pointillé sur le plan et dit l’écart en clair. Ces cotes sont gardées dans ce navigateur, par famille de meuble (un canapé se compare à un canapé), et elles reviennent sur les autres fiches de la même famille (modules/products/lib/visitor-furniture.ts).
Sous ce qu’est la pièce, la fiche dit ce que ses cotes veulent dire chez soi : les convives d’une table, le passage d’un canapé, l’écran d’un meuble TV (familyGuide). Chaque repère se vérifie avec un mètre avant de commander.
Le plan ne se dessine que si on connaît les trois cotes de la déclinaison. Sinon, la fiche s’en tient aux cotes écrites.
Acheter depuis la fiche
Le formulaire d’ajout (AddToCartForm, modules/cart/components/add-to-cart-form.tsx) propose une quantité quand la pièce en admet plus d’une. Elle est plafonnée au stock brut, et à dix au plus (MAX_QUANTITY_PER_ORDER), moins ce que le panier en contient déjà. C’est le panier qui retire ensuite les pièces qu’un autre client est en train de payer. Sous le bouton, on voit ce que le panier contient déjà de cette déclinaison, avec de quoi rouvrir le volet. Quand l’ajout réussit, le volet s’ouvre sur la ligne ajoutée, une fois le panier relu, pour ne pas montrer un instant le panier d’avant. Un refus s’affiche sous le bouton.
Sur un téléphone, la photo et le choix repoussent le bouton sous le pli. Du coup, une barre épinglée en bas de l’écran rappelle la pièce, sa déclinaison et son prix, et soumet le même formulaire (AddToCartPinnedBar). Elle publie sa hauteur. Comme ça, les toasts et le pied de page la contournent, et le focus clavier ne reste pas caché dessous (WCAG 2.4.11).
Le cache de la fiche peut annoncer « En stock » pour une pièce vendue au magasin entre-temps. Quand l’ajout bute sur un refus qui prouve que la fiche est périmée (pièce partie, retirée, dépubliée), l’action expire elle-même son entrée de cache (updateTag). Sa réponse redessine alors la fiche sur l’état présent, et il ne reste pas de bouton actif sous « Cette pièce est partie ». Ces purges à la demande sont plafonnées par connexion (productPageRefresh), pour qu’on ne puisse pas se servir du geste pour vider le cache.
Une pièce que quelqu’un d’autre est en train de payer est encore en stock, mais elle n’est pas libre. Le panier ne la propose pas, et elle revient si ce paiement échoue (withFreeStock, modules/cart/services/free-stock.service.ts). La fiche, elle, affiche le stock brut, pour ne pas faire croire à une rupture le temps d’un paiement.
Après la fiche
Les voisines forment deux rangées, sans doublon, dans l’ordre du catalogue composé par l’équipe. La première montre ce qui accompagne la pièce (sa collection, d’autres types). La seconde montre ce qui peut la remplacer (son type). Quand la pièce ne s’achète plus, ce qui la remplace passe devant (product-neighbours.ts).
On choisit un meuble en plusieurs fois, en comparant deux ou trois pièces. « Vues récemment » les ramène en bas de la fiche, sans qu’on ait posé de cœur. La liste est dans ce navigateur (localStorage, modules/products/lib/viewed-pieces.ts) et ne garde que le nom, l’adresse et la vignette. Un prix relu d’un ancien passage pourrait être faux, et un prix affiché sur ce site est toujours vrai. Rien n’est rendu sur le serveur, et la section n’apparaît qu’à partir d’une deuxième fiche.
Enfin, une création de l’atelier peut être refaite autrement. Dans ce cas, la fiche propose le sur-mesure, avec les questions propres à la famille du meuble et un message déjà écrit (Demandes au magasin).