{
  "contract_version": "gab_235_contract_v1",
  "gab_id": "GAB-235",
  "canonical_name": "FeedbackLearningSuccessSummary",
  "module_owner": "EdTechFeedbackLearning",
  "renderer_key": "text_cta",
  "required_fields": [
    "gab_id",
    "success_summary_id",
    "title",
    "summary",
    "items"
  ],
  "optional_fields": [
    "banner_label",
    "result",
    "primary_cta",
    "secondary_cta"
  ],
  "field_types": {
    "title": "string — compétence acquise (1 phrase, factuelle, jamais générique)",
    "summary": "string — description des acquis pédagogiques explicites",
    "banner_label": "string — libellé de la bannière de succès (ex: 'COMPÉTENCE VALIDÉE')",
    "items": "array<{id:string, text:string}> — liste des acquis vérifiés, min 1",
    "result": "object{reason:string} — justification de la validation (pourquoi ces acquis sont confirmés)",
    "primary_cta": "object{label:string, action:string}",
    "secondary_cta": "object{label:string, action:string}"
  },
  "constraints": [
    "items : min 1 élément requis ; chaque item porte un id et un text factuel.",
    "title : compétence acquise factuelle — jamais 'Bravo !' générique.",
    "NO-REWARD-WRITE : ce gabarit n'écrit, ne déclenche et n'affiche aucun XP/coins/badges. La récompense reste côté PlayKit Rewards.",
    "primary_cta et secondary_cta : libellés venant du JSON, pas hardcodés HTML.",
    "result.reason : justification factuelle de la consolidation (évidence = exercices réussis, pattern disparu, etc.)."
  ],
  "blocked_conditions": [
    "items absent ou tableau vide (BLOCKED)",
    "title absent (BLOCKED)",
    "summary absent (BLOCKED)"
  ],
  "accessibility": [
    "keyboard_navigable",
    "focus_visible",
    "prefers_reduced_motion",
    "fallback_text"
  ],
  "qa_cases": [
    { "case": "instance conforme", "expected": "rendu complet, bannière + titre + acquis + reason + CTAs, 0 erreur" },
    { "case": "items absent ou vide", "expected": "BLOCKED listant le champ manquant" },
    { "case": "title absent", "expected": "BLOCKED listant le champ manquant" },
    { "case": "summary absent", "expected": "BLOCKED listant le champ manquant" },
    { "case": "instance externe injectée (init(ext))", "expected": "le rendu change sans modifier le HTML" },
    { "case": "items avec 1 seul acquis", "expected": "rendu valide, 1 ligne acquis" },
    { "case": "result absent (optionnel)", "expected": "bloc reason masqué, rendu complet sans erreur" },
    { "case": "secondary_cta absent (optionnel)", "expected": "seul primary_cta affiché" },
    { "case": "responsive 375/768/1024", "expected": "aucun débordement horizontal" }
  ],
  "traceability": {
    "derived_from_core_gab": "GAB-235",
    "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)."
  }
}