Actif search functional Revu le 2026-05-22 search/meilisearch-search.md

Recherche globale (Ctrl+K)

Vue d'ensemble

ISI-APP intègre un moteur de recherche transverse propulsé par Meilisearch. Il permet à l'utilisateur, depuis n'importe quel écran de l'application, de retrouver instantanément n'importe quelle entité métier (client, ticket, projet, contrat, document, etc.) sans avoir à naviguer dans le module correspondant.

Cette doc décrit la recherche globale instantanée (la modale Ctrl+K). Pour la recherche avancée multi-rubriques (page dédiée /advanced-search avec filtres et résultats paginés), voir advanced-search.md. Les deux fonctionnalités sont complémentaires mais distinctes : la recherche globale est faite pour aller vite, la recherche avancée pour explorer en profondeur.

À quoi ça sert

Permettre à l'utilisateur de sauter directement vers une fiche depuis n'importe quelle page, sans passer par les menus, en quelques frappes au clavier. L'objectif est de remplacer la navigation par la recherche pour les utilisateurs qui connaissent déjà l'objet qu'ils cherchent (un nom de client, un numéro de ticket, un libellé d'application…).

Comment y accéder

Action	Résultat
`Ctrl+K` (Windows/Linux) ou `Cmd+K` (macOS)	Ouvre la modale de recherche depuis n'importe quelle page
Clic sur le bouton de recherche dans la barre du haut (herobar)	Idem
`Échap`	Ferme la modale

La modale s'ouvre par-dessus la page courante : pas de changement de contexte, pas de rechargement.

Périmètre indexé

La recherche couvre 12 rubriques métier. Chaque rubrique apparaît comme un groupe distinct dans les résultats.

Catégorie affichée	Ce qu'on y trouve	Champs sur lesquels la recherche porte
Entités	Clients / sociétés	Nom du client
Adresses	Adresses physiques (sites, agences)	Nom du site, ville, libellé
Utilisateurs	Comptes utilisateurs	Nom, prénom, email
Projets	Projets en cours et clos	Nom du projet
Applications	Applications du parc IT	Libellé applicatif, type de connecteur
Fournisseurs	Fournisseurs et prestataires	Nom du fournisseur
Matériels	Postes, serveurs, équipements	Libellé matériel, numéro d'inventaire / tag
Machines virtuelles	VM du parc	Libellé VM, type
Contrats	Contrats fournisseurs et clients	Libellé contrat
Documents	Documents joints aux fiches métier	Nom du document
Documentations	Pages Wiki internes	Titre du wiki
Tickets	Tickets de support	Sujet du ticket, numéro de ticket

Seuls les éléments actifs (non supprimés) apparaissent. Les éléments en corbeille (dtdel) sont automatiquement exclus.

Comportement utilisateur

Saisie minimum : 2 caractères avant que la recherche ne se déclenche.
Recherche en temps réel : les résultats se rafraîchissent au fil de la frappe (debounce de 250 ms pour ne pas saturer le réseau).
Tolérance aux fautes : Meilisearch corrige les fautes de frappe légères et accepte les recherches partielles (préfixes).
Résultats groupés : les correspondances sont affichées par catégorie, dans un ordre stable, avec une icône / vignette par type d'objet et un badge d'état pour les tickets.
Limite par rubrique : 5 résultats max par catégorie pour garder la modale lisible.

Touche	Action
Flèches Haut / Bas	Naviguer dans la liste de résultats
Entrée	Ouvrir le résultat sélectionné
Échap	Fermer la modale
`Ctrl+K` / `Cmd+K`	Ouvrir / fermer

Un clic à la souris fonctionne évidemment aussi. La sélection ouvre directement la fiche correspondante (édition ou consultation selon les droits de l'utilisateur).

Sécurité et cloisonnement multi-tenant

La recherche respecte intégralement les droits de l'utilisateur :

Un utilisateur ne voit que les données de son entité (cloisonnement multi-tenant strict).
Les utilisateurs Presta Premium voient uniquement les clients qui leur sont rattachés.
Les profils restreints ne voient que ce que leur profil autorise (ex. profil 900 ne voit ni clients, ni adresses, ni utilisateurs).
Les projets secrets ne sont visibles qu'aux membres explicitement autorisés.
Les tickets sont filtrés selon le niveau de profil : un demandeur ne voit que ses propres tickets.
Les contrats ne sont visibles qu'aux profils ayant le droit blcontract ou aux administrateurs, et les contrats secrets sont exclus.
Les wikis respectent la liste des profils exclus définie sur chaque page.

Aucun résultat hors périmètre ne peut "fuiter" : les contrôles sont appliqués côté moteur de recherche, pas seulement à l'affichage.

Performance perçue

Réponse typique en moins de 50 ms (recherche perçue comme instantanée).
Une seule requête réseau par frappe (toutes les rubriques sont interrogées en parallèle).
Les recherches obsolètes sont automatiquement annulées si l'utilisateur tape plus vite que le réseau ne répond.

Voir meilisearch-optimizations.md pour le détail des optimisations de performance.

Limitations connues

La recherche se limite aux 12 rubriques listées ci-dessus. Pour étendre le périmètre, il faut ajouter un nouvel index (intervention dev).
Les modifications faites sur une fiche apparaissent dans les résultats après réindexation (différée de quelques secondes le temps que la file d'attente d'indexation traite l'événement).
La recherche ne porte que sur les champs principaux de chaque entité (nom, libellé). Le contenu détaillé d'une fiche (description, commentaires, pièces jointes) n'est pas indexé.
Les documents sont indexés par leur nom de fichier, pas par leur contenu (pas d'OCR ni d'indexation full-text PDF/Word).
Pour une recherche avec critères avancés (filtres par date, statut, montant…), utiliser la recherche avancée.

Page d'administration

Une page d'administration /admin/meilisearch (réservée aux administrateurs ISI) permet de :

Visualiser l'état de chaque index (nombre de documents indexés vs. nombre d'enregistrements actifs en base).
Identifier les index désynchronisés.
Relancer une réindexation complète (par index ou globale).
Recréer un index en cas d'incohérence.

Le rafraîchissement du tableau est automatique pendant qu'une indexation est en cours.

Doc technique : .claude/technical-docs/search/meilisearch-search.md