Index

Type de ressource : Route Astro (Page SSR)
Fichier source : src/pages/index.astro
Statut : Actif

1. Vue d’ensemble

1.1. Description

Page d’accueil du site. Affiche un message de bienvenue avec un test d’intégration AMN (Message du schéma Sanity). Contient du contenu template Astro avec des liens vers les sections du site.

1.2. Objectif

• Afficher la page d’accueil du site
• Tester l’intégration Sanity via le message AMN
• Fournir une navigation vers les autres sections du site
• Servir de point d’entrée principal

1.3. Caractéristiques

Propriété	Valeur
URL publique	/
Mode de rendu	SSR (par défaut)
Type	Page HTML
Méthode HTTP	GET
Authentification requise	Non
Cache	Voir §6

2. Architecture et flux

[Requête utilisateur]
     │
     ▼
[Cloudflare Pages / Edge]
     │  • Routage vers Astro
     ▼
[Astro Route (index.astro)]
     │  • Récupération du message AMN via getAmn()
     │  • Rendu du composant
     ▼
[Réponse HTML]

2.2. Composants impliqués

Composant	Rôle	Couche
index.astro	Définition de la route	L2 (Astro)
getAmn()	Récupération du message AMN	L2 (Astro)
BaseHead	Métadonnées SEO globales	L2 (Astro)
Header	Navigation globale	L2 (Astro)
Footer	Pied de page global	L2 (Astro)

3. Implémentation

3.1. Code de la route

---
import BaseHead from '../components/BaseHead.astro';
import Footer from '../components/Footer.astro';
import Header from '../components/Header.astro';
import { SITE_DESCRIPTION, SITE_TITLE } from '../consts';
import { getAmn } from '../lib/sanity';

const amn = await getAmn();
---

<!doctype html>
<html lang="en">
  <head>
    <BaseHead title={SITE_TITLE} description={SITE_DESCRIPTION} />
  </head>
  <body>
    <Header />
    <main>
      <div style="background: #eef2ff; border: 1px solid #c7d2fe; padding: 1rem; border-radius: 8px; margin-bottom: 2rem;">
        <h2>🚀 Welcome, AMN Integration Test</h2>
        {amn ? (
          <div>
            <p><strong>Message Sanity:</strong> {amn.message}</p>
            <p><strong>Statut:</strong> {amn.status}</p>
          </div>
        ) : (
          <p>No active AMN message found in Sanity. <a href="/welcome">Voir la page /welcome</a></p>
        )}
      </div>
      <h1>🧑‍🚀 Hello, Astronaut!</h1>
      <p>
        Welcome to the official <a href="https://astro.build/">Astro</a> blog starter template...
      </p>
      <!-- ... -->
    </main>
    <Footer />
  </body>
</html>

4. Données et requêtes GROQ

4.1. Requête principale

*[_type == "amn" && status == "active"][0]

4.2. Requêtes secondaires

Aucune requête secondaire n’est utilisée.

4.3. Types TypeScript associés

// Type AMN (manuel, sanity-typegen non implémenté)
export type Amn = {
  _id: string;
  _type: 'amn';
  message: string;
  status: 'active' | 'inactive';
};

5. Paramètres et validation

5.1. Paramètres d’URL

Aucun paramètre d’URL n’est utilisé.

5.2. Query strings

Aucune query string n’est utilisée.

5.3. Gestion des erreurs

Code HTTP	Condition	Réponse
200	Succès	Page HTML
500	Erreur Sanity (getAmn)	Page HTML avec message d’erreur

6. Stratégie de cache

6.1. En-têtes de cache

Mode	Cache-Control	CDN-Cache-Control	Rationale
SSR standard	Non configuré	Non configuré	Par défaut Cloudflare

6.2. Implémentation dans la route

Non implémenté - pas de headers de cache explicites.

7. SEO et métadonnées

7.1. Balises meta

Balise	Source	Fallback
<title>	SITE_TITLE (const)	-
<meta name="description">	SITE_DESCRIPTION (const)	-
Meta tags globaux	BaseHead	-

7.2. Sitemap

• ✅ Cette route est-elle incluse dans le sitemap ? Oui (racine)
• ✅ Fréquence de mise à jour : daily
• ✅ Priorité : 1.0

7.3. Indexation Pagefind

• ✅ Cette route est-elle indexée par Pagefind ? Non (Pagefind non configuré)
• ⚠️ Poids du titre : Non configuré
• ⚠️ Filtres applicables : Non configuré

8. Composants UI utilisés

Composant	Fichier	Rôle	Hydratation
BaseHead	src/components/BaseHead.astro	Métadonnées SEO	Aucune
Header	src/components/Header.astro	Navigation globale	Aucune
Footer	src/components/Footer.astro	Pied de page global	Aucune

9. Sécurité

9.1. Accès et authentification

Condition	Comportement
Accès public	Page accessible sans authentification
Mode Preview	Non supporté (pas de logique preview)

9.2. Validation des entrées

Non applicable (pas de paramètres d’entrée).

9.3. En-têtes de sécurité

Non implémenté dans cette route (à configurer via Middleware Cloudflare).

10. Débogage et troubleshooting

10.1. Problèmes courants

Symptôme	Cause probable	Solution
Message AMN non affiché	Aucun document AMN actif	Créer un document AMN avec status “active”
Erreur Sanity	Variables d’environnement manquantes	Vérifier SANITY_PROJECT_ID, SANITY_DATASET

10.2. Logs et monitoring

# Logs de développement
npm run dev

# Vérification des types
npx astro check

10.3. Tests manuels

# Test de la route en local
curl -I http://localhost:4321/

11. Bonnes pratiques

11.1. Architecture

• ✅ Utiliser les composants globaux (Header, Footer, BaseHead)
• ✅ Centraliser les constantes (SITE_TITLE, SITE_DESCRIPTION)
• ✅ Gérer les erreurs de manière élégante (message fallback)

11.2. Performance

• ✅ Pas de JavaScript inutile
• ✅ HTML statique par défaut

11.3. Maintenance

• ✅ Mettre à jour le contenu template selon les besoins
• ✅ Tester l’intégration Sanity régulièrement

12. Évolutions et roadmap

12.1. Améliorations planifiées

• Supprimer le contenu template Astro
• Ajouter un vrai contenu d’accueil
• Support du mode preview
• Ajout de structured data (JSON-LD)

12.2. Limitations connues

• ❌ Contenu template Astro (non personnalisé)
• ❌ Pas de support du mode preview
• ❌ Pas de structured data (JSON-LD)
• ❌ Langue hardcodée en ‘en’

13. Ressources liées

• Documentation Astro : Routing
• Fichiers concernés :
  • src/pages/index.astro
  • src/lib/sanity.ts (getAmn)
  • src/consts.ts (SITE_TITLE, SITE_DESCRIPTION)

14. Historique des modifications

Date	Version	Description	Auteur
2026-09-15	1.0	Création initiale	Devin