{
  "contract_version": "gab_292_contract_v1",
  "gab_id": "GAB-292",
  "canonical_name": "OralLearningSpeechPlan",
  "module_owner": "EdTechOralLearning",
  "renderer_key": "text_cta",
  "required_fields": [
    "gab_id",
    "speech_plan_id",
    "topic",
    "plan_sections",
    "duration_target",
    "success_criteria"
  ],
  "optional_fields": [
    "hook_help",
    "transition_prompts",
    "key_message",
    "speaker_notes_policy",
    "example_plan",
    "source_metadata",
    "primary_cta",
    "secondary_cta",
    "anti_recitation_rationale",
    "accessibility",
    "child_safety"
  ],
  "field_types": {
    "plan_sections": "array<{id,label,time_start,time_end,color_role,text}> — color_role: enum['hook','body1','body2','closing'] — 2 à 6 sections attendues",
    "duration_target": "string — ex: '3 minutes', '5 minutes'",
    "success_criteria": "object | string — critères de réussite de l'oral (ex: contact visuel, respect temps, mots-clés seuls)",
    "speaker_notes_policy": "string — consigne anti-récitation affichée à l'élève",
    "hook_help": "string — suggestion d'accroche pour débuter l'exposé",
    "example_plan": "string — exemple de plan d'un autre sujet (sujet différent du topic principal)",
    "primary_cta": "object{label,action}",
    "secondary_cta": "object{label,action}"
  },
  "constraints": [
    "plan_sections doit contenir au minimum 2 sections (BLOCKED si vide).",
    "duration_target est requis pour calibrer le rendu temporel.",
    "success_criteria peut être un objet ou une chaîne ; si absent du contenu source, porter _TODO explicite.",
    "Le HTML ne contient jamais de contenu pédagogique en dur — tout vient de l'instance.",
    "example_plan doit porter un sujet différent du topic pour éviter la confusion."
  ],
  "blocked_conditions": [
    "plan_sections absent ou tableau vide",
    "topic absent",
    "duration_target absent"
  ],
  "accessibility": [
    "keyboard_navigable",
    "focus_visible",
    "prefers_reduced_motion",
    "sections colorées distinguables sans couleur seule (label textuel systématique)"
  ],
  "qa_cases": [
    { "case": "instance conforme", "expected": "rendu complet avec timeline, key_message, speaker_notes, CTAs" },
    { "case": "plan_sections vide ou absent", "expected": "BLOCKED affiché proprement" },
    { "case": "topic absent", "expected": "BLOCKED affiché proprement" },
    { "case": "instance externe injectée via init(ext)", "expected": "le rendu change sans modifier le HTML" },
    { "case": "success_criteria avec _TODO", "expected": "champ rendu en mode TODO visible, pas de crash" },
    { "case": "responsive 375/768/1024", "expected": "timeline sections sans débordement horizontal" }
  ],
  "traceability": {
    "derived_from_core_gab": "GAB-292",
    "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)."
  }
}