Bloc PageBuilder : features

Objet : Bloc PageBuilder
Type : Object
Slice : Slice 1 (Page d’accueil)
Cycle : DOC → SPEC → CODE → TEST → INTÉG
Statut : DOC

---

1. Description et périmètre

1.1. Objectif

Le bloc features est un bloc PageBuilder qui affiche une liste de fonctionnalités avec des icônes, des titres et des descriptions.

1.2. Utilisation principale

• Section des fonctionnalités de la page d’accueil
• Présentation des avantages produits
• Liste de caractéristiques

1.3. Périmètre concerné

• Type : Object Sanity
• Champs : title, features (array)
• Rendu : Composant Astro Features
• Grille responsive : Support mobile/desktop

---

2. Contrats d’entrée

2.1. Structure du bloc

Entrée : Configuration du bloc features dans Sanity Studio

Structure :

{
  _type: "features",
  title: string,
  features: [
    {
      title: string,
      text: string,
      icon: string
    }
  ]
}

Règles :

• title : obligatoire, titre de la section
• features : obligatoire, tableau de features
• Chaque feature : title (obligatoire), text (obligatoire), icon (optionnel)

2.2. Validation

Règles de validation :

• title : max 100 caractères
• features : minimum 1 feature, maximum 6 features
• feature.title : max 50 caractères
• feature.text : max 200 caractères
• feature.icon : nom d’icône (ex: “star”, “check”, “arrow”)

---

3. Contrats de sortie

3.1. Données Sanity

Sortie : Bloc features dans le PageBuilder

Format : JSON avec la structure définie ci-dessus

Utilisation :

• Rendu dans le composant Astro Features
• Utilisation dans le PageBuilder de la page

3.2. Rendu Astro

Sortie : Composant Astro Features

Comportement :

• Affichage du titre de la section
• Affichage de la grille de features
• Icônes, titres et descriptions
• Grille responsive (1 colonne mobile, 3 colonnes desktop)

---

4. Side effects

4.1. Impact sur le rendu

Effet : Le bloc features nécessite un composant Astro spécifique

Impact :

• Création du composant Features.astro
• Gestion de la grille responsive
• Gestion des icônes

4.2. Impact sur les performances

Effet : Les icônes peuvent impacter les performances

Impact :

• Utilisation d’icônes SVG inline ou d’une librairie d’icônes
• Lazy loading des icônes si nécessaire

---

5. Erreurs et gestion

5.1. Erreurs potentielles

Erreur	Cause probable	Solution
Aucune feature	Tableau features vide	Afficher un message d’erreur ou masquer le bloc
Icône invalide	Nom d’icône incorrect	Afficher une icône par défaut
Trop de features	Plus de 6 features	Limiter à 6 features côté Sanity

5.2. Codes HTTP

Non applicable (bloc PageBuilder)

---

6. Checklist de validation

Avant de passer à l’étape SPEC, vérifier :

• La structure du bloc est documentée
• Les contrats d’entrée/sortie sont documentés
• Les side effects sont identifiés
• Les erreurs potentielles sont documentées

---

7. Approbation

Validation requise : Confirmer que la documentation du bloc features peut passer à l’étape SPEC.

---

8. Historique des modifications

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