Guide de Test et Validation — Indexeur Pagefind Unifié (Sanity + SSR + Docs)

Golden Path Phase 0 — Section 2.3
Date de mise à jour finale : 2026-09-24
Auteur : Antigravity

---

Améliorations & Correctifs Apportés

1. Script d’Indexation Unifié (apps/web/scripts/build-pagefind-index.js)

   • Combine l’indexation statique du dossier dist/client (Starlight Docs) avec une extraction dynamique de l’API Sanity lors du post-build.
   • Indexe la Page d’accueil (/) avec le filtre et badge PAGE.
   • Indexe les Articles de Blog (/blog/${slug}/) avec le filtre et badge BLOG.
   • Indexe la Documentation Starlight (/overview/) avec le filtre et badge DOC.

2. Classification Précise des Badges (SearchModal.astro)

   • Badge PAGE (vert/émeraude) pour la page d’accueil.
   • Badge BLOG (bleu) pour les articles de blog Sanity.
   • Badge DOC (violet/indigo) pour les pages de documentation Starlight.

---

Instructions de Test

Test 1 : Vérification de l’Indexation lors du Build

Exécuter la commande de build complète :

npx pnpm@12.3.4 --filter ./apps/web build

Résultat attendu dans la console :

[Pagefind Indexer] Démarrage de l'indexation unifiée...
[Pagefind Indexer] Indexation des fichiers statiques dans dist/client...
[Pagefind Indexer] Enregistrement de la Page d'accueil...
[Pagefind Indexer] Enregistrement de l'article blog: /blog/welcome-to-oci/
[Pagefind Indexer] Enregistrement de l'article blog: /blog/premier-article-sanity/
[Pagefind Indexer] ✅ Indexation unifiée terminée avec succès !

---

Test 2 : Contrôle des Badges et Résultats de Recherche

1. Démarrer le dev server ou déployer sur l’environnement de test.
2. Rechercher "cloud" ou "documentation" : la page Starlight ressort avec le badge DOC (et non PAGE).
3. Rechercher "OCI" ou "Premier Article" : l’article ressort avec le badge BLOG.
4. Rechercher "Welcome" ou "Site" : la page d’accueil ressort avec le badge PAGE.