Comment le catalogue est indexé

Les moteurs par boutique, langue et devise, ce qui entre dans chaque document, et les trois voies qui gardent l'index à jour.

La recherche ne tourne pas sur la base de données de la boutique. Elle tourne sur un index à nous, qui est une copie du catalogue préparée pour répondre en millisecondes. Ce guide explique comment cette copie se fait et comment elle reste fidèle.

Un moteur par boutique, langue et devise

Lors du handshake, le module nous dit quelles boutiques il a, dans quelles langues et avec quelles devises. Pour chaque combinaison naît un moteur de recherche, et c'est ce que vous voyez dans Recherche → Moteurs de recherche : la boutique à laquelle il appartient, ce qu'il indexe, la langue et la devise, combien de documents il contient et quand a eu lieu la dernière indexation.

Cette séparation n'est pas un détail de rangement. Le nom d'un produit en français et en portugais sont deux textes différents, et une recherche sur « chaussures » ne doit pas trouver de résultats par le texte portugais. Les prix suivent la même logique : chaque moteur garde ceux de sa devise.

Une boutique multilingue a donc plus d'un moteur, et presque tout ce qui se configure par moteur (poids, synonymes, filtres) se configure une fois pour chacun.

Ce qui entre dans un document

De chaque produit nous gardons ce qui sert à le trouver et à le montrer : référence, EAN et MPN, nom, marque, catégories, caractéristiques et attributs, descriptions, prix, image, état du stock et l'URL dans la boutique.

Trois options du module changent ce qui y arrive :

• Prix avec TVA : décide si le prix indexé est avec ou sans taxe. Il doit être identique à ce que la boutique affiche, sinon les résultats disent un chiffre et la fiche en dit un autre.
• Taille d'image : laquelle des images de PrestaShop voyage vers l'index. Celle des cartes de la recherche, pas celle du détail.
• Produits en rupture de stock : les indexer quand même, les rétrograder dans les résultats, ou les masquer.

Et trois signaux facultatifs, que la boutique partage si elle le veut, et qui ne servent pas à chercher mais à trier et à mesurer : le volume de ventes (il alimente le tri « meilleures ventes » et la détection des best-sellers invisibles), le prix de revient (il donne les marges dans les analytics) et les commandes (elles relient la recherche au chiffre d'affaires).

Attention Activer ou désactiver le partage des ventes ou du coût demande une réindexation complète pour que l'index reflète le changement. Le module vous prévient quand cela arrive.

Les trois voies qui la gardent à jour

Après la première indexation complète, le quotidien se règle tout seul :

1. Temps réel. Enregistrer, supprimer ou changer le stock d'un produit pousse la modification sur-le-champ. C'est par là que passe l'écrasante majorité des mises à jour, et c'est ce qui fait que le prix et le stock dans la recherche sont les mêmes que dans la boutique.
2. Synchronisation périodique. À intervalles réguliers, la plateforme demande à la boutique de revoir le catalogue, et c'est ce qui rattrape ce que le temps réel n'a pas vu (un import par CSV, une modification faite directement dans la base de données). Pour que cela fonctionne, l'adresse https://a-tua-loja/module/buskara/sync doit être accessible depuis l'extérieur.
3. Manuelle. Le bouton Tout réindexer dans le module, ou la commande en ligne. Voir réindexer le catalogue.

Quand se méfier de la voie 2 Les pare-feu, l'authentification basique dans les environnements de préproduction et les règles du type « seulement mon IP » bloquent la synchronisation périodique sans afficher d'erreur visible dans le back-office. Le symptôme est un index qui reste des jours sans bouger alors que le temps réel, lui, fonctionne.

Ce que coûte l'indexation

Rien au forfait. Indexer compte de façon symbolique (10 requêtes pour 10 000 items indexés) et n'est jamais facturé : cela ne touche pas la limite et ne génère pas de dépassement. Garder le catalogue à jour ne doit pas être une décision budgétaire.

Ce qui apparaît dans le graphique d'utilisation, c'est ce comptage symbolique, et il est là par transparence, pour qu'on voie ce que l'index a fait. Voir ce qui compte comme requête.

Un second moteur, pour le contenu

Le blog et les pages de la boutique peuvent être indexés à part, dans un moteur à eux, et apparaître dans les résultats sans prendre la place des produits. C'est facultatif et cela s'active dans le module ; c'est expliqué dans articles et contenu de la boutique.