{
  "contract_version": "gab_100_contract_v1",
  "gab_id": "GAB-100",
  "canonical_name": "VisualTeacherBoard",
  "module_owner": "EdTechVisualLearning",
  "renderer_key": "text_cta",
  "required_fields": [
    "gab_id",
    "board_id",
    "title",
    "zones"
  ],
  "optional_fields": [
    "board_subtitle",
    "board_icon",
    "board_note",
    "primary_cta"
  ],
  "field_types": {
    "title": "string — titre de la séance affiché dans l'en-tête du tableau",
    "board_subtitle": "string — sous-titre contextuel (ex: 'Support de classe · projetable')",
    "board_icon": "string — emoji icône de l'en-tête",
    "zones": "array<{zone_id,zone_type,label,icon,content}> — 1 à 6 zones pédagogiques",
    "zones[].zone_id": "string — identifiant unique de la zone (ex: 'obj', 'causes')",
    "zones[].zone_type": "enum['objectif','causes','frise','question_orale','definition','exemple','methode','bilan'] — type canonique de la zone",
    "zones[].label": "string — libellé affiché dans l'en-tête de la zone",
    "zones[].icon": "string — emoji affiché dans le label de la zone",
    "zones[].content": "string — texte pédagogique de la zone",
    "board_note": "string — note de bas de tableau (italique, discret)",
    "primary_cta": "object{label,action} — bouton principal structurel"
  },
  "constraints": [
    "zones doit contenir au moins 1 entrée ; idéalement 2 à 4 zones pour lisibilité projetable.",
    "zone_id doit être unique dans le tableau.",
    "primary_cta.label vient du JSON — le bouton HTML ne contient jamais de libellé en dur.",
    "Le tableau est conçu pour projection (fond sombre --ink) : ne pas ajouter d'images ou de contenu lourd."
  ],
  "blocked_conditions": [
    "zones absent ou vide (BLOCKED)",
    "title absent (BLOCKED)",
    "board_id absent (BLOCKED)"
  ],
  "accessibility": [
    "keyboard_navigable",
    "focus_visible",
    "prefers_reduced_motion",
    "zones lisibles en lecture d'écran (role/aria implicite via sémantique HTML)"
  ],
  "qa_cases": [
    { "case": "instance conforme", "expected": "rendu complet, 4 zones affichées, 0 erreur" },
    { "case": "zones absent ou vide", "expected": "BLOCKED listant le champ zones" },
    { "case": "title absent", "expected": "BLOCKED listant le champ title" },
    { "case": "instance externe injectée via init(ext)", "expected": "le rendu change sans modifier le HTML" },
    { "case": "responsive 375/768/1024", "expected": "zones empilées en colonne sur mobile, grille 2×2 sur desktop" }
  ],
  "traceability": {
    "derived_from_core_gab": "GAB-100",
    "note": "Ce schema VALIDE l'instance. Le contrat pédagogique complet (input_contract/validation_logic/feedback_scoring_logic) vit dans le CORE-GAB officiel, pas ici (évite la duplication)."
  }
}
