Bloc PageBuilder : cta

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 cta (Call-to-Action) est un bloc PageBuilder qui affiche une section d’appel à l’action avec un titre, un texte et un bouton.

1.2. Utilisation principale

• Section CTA de la page d’accueil
• Encouragement à l’action (inscription, contact, etc.)
• Conversion des visiteurs

1.3. Périmètre concerné

• Type : Object Sanity
• Champs : heading, text, buttonText, buttonLink
• Rendu : Composant Astro CTA
• Style : Mise en évidence visuelle

---

2. Contrats d’entrée

2.1. Structure du bloc

Entrée : Configuration du bloc cta dans Sanity Studio

Structure :

{
  _type: "cta",
  heading: string,
  text: string,
  buttonText: string,
  buttonLink: string
}

Règles :

• heading : obligatoire, titre de la section
• text : obligatoire, texte de description
• buttonText : obligatoire, texte du bouton
• buttonLink : obligatoire, lien du bouton

2.2. Validation

Règles de validation :

• heading : max 100 caractères
• text : max 300 caractères
• buttonText : max 50 caractères
• buttonLink : URL valide (relative ou absolute)

---

3. Contrats de sortie

3.1. Données Sanity

Sortie : Bloc cta dans le PageBuilder

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

Utilisation :

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

3.2. Rendu Astro

Sortie : Composant Astro CTA

Comportement :

• Affichage du titre de la section
• Affichage du texte de description
• Affichage du bouton avec le lien
• Mise en évidence visuelle (couleur, taille)

---

4. Side effects

4.1. Impact sur le rendu

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

Impact :

• Création du composant CTA.astro
• Gestion du lien (interne ou externe)
• Mise en évidence visuelle

4.2. Impact sur l’accessibilité

Effet : Le bouton doit être accessible

Impact :

• Attribut aria-label si nécessaire
• Contraste suffisant
• Focus visible

---

5. Erreurs et gestion

5.1. Erreurs potentielles

Erreur	Cause probable	Solution
Lien invalide	URL mal formatée	Valider l’URL côté Sanity
Bouton vide	buttonText vide	Afficher un texte par défaut
Lien externe non sécurisé	Lien HTTP au lieu de HTTPS	Forcer HTTPS ou avertir l’utilisateur

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 cta peut passer à l’étape SPEC.

---

8. Historique des modifications

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