{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://timecredit.app/schemas/curriculum.schema.json",
  "title": "TimeCredit Quiz — Curriculum (arbre référentiel)",
  "description": "Arbre d'un curriculum : un fichier par (pays x langue). Ne contient PAS de questions, seulement la structure matière -> niveau -> chapitre. Les questions vivent dans des fichiers pack séparés (quiz-pack.schema.json).",
  "type": "object",
  "additionalProperties": false,
  "required": ["schema_version", "country", "language", "subjects"],
  "properties": {
    "schema_version": { "const": "1.0" },
    "country": {
      "type": "string",
      "pattern": "^[A-Z]{2}$",
      "description": "Code pays ISO 3166-1 alpha-2. L'unité est le PAYS/curriculum, pas la langue (FR != BE != CH)."
    },
    "language": {
      "type": "string",
      "pattern": "^[a-z]{2}$",
      "description": "Code langue ISO 639-1. Contenu indépendant par langue (pas de couche de traduction partagée)."
    },
    "subjects": {
      "type": "array",
      "minItems": 1,
      "items": { "$ref": "#/$defs/subject" }
    }
  },
  "$defs": {
    "validation": {
      "type": "object",
      "description": "Indicateur de validité AGRÉGÉ, CALCULÉ par le pipeline — jamais saisi à la main. Recalculé à chaque changement d'une question. 'ready' uniquement si tout le contenu requis est status=validated.",
      "additionalProperties": false,
      "required": ["status"],
      "properties": {
        "status": {
          "enum": ["empty", "in_progress", "ready"],
          "description": "empty = aucune question validée ; in_progress = partiel ; ready = complet et livrable dans l'app. L'app ne doit ouvrir/débloquer qu'un niveau 'ready'."
        },
        "validated_questions": { "type": "integer", "minimum": 0 },
        "required_questions": { "type": "integer", "minimum": 0, "description": "Seuil attendu (ex: 30 par chapitre)." },
        "computed_at": { "type": "string", "format": "date-time" },
        "note": { "type": "string" }
      }
    },
    "subject": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "name", "levels"],
      "properties": {
        "id": { "type": "string", "pattern": "^[a-z0-9_]+$", "description": "ex: math, physique_chimie, histoire_geo" },
        "name": { "type": "string" },
        "icon": { "type": "string" },
        "optional": { "type": "boolean", "default": false, "description": "true = enseignement optionnel/spécialité ; false = tronc commun." },
        "levels": {
          "type": "array",
          "minItems": 1,
          "items": { "$ref": "#/$defs/level" }
        }
      }
    },
    "level": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "grade", "chapters"],
      "properties": {
        "id": { "enum": ["I", "II", "III", "IV", "V", "VI", "VII"] },
        "grade": { "type": "string", "description": "ex: 6e, 5e, ..., Terminale" },
        "validation": { "$ref": "#/$defs/validation", "description": "Validité du NIVEAU = agrégat de tous ses chapitres. 'ready' seulement si chaque chapitre est 'ready'." },
        "chapters": {
          "type": "array",
          "minItems": 1,
          "items": { "$ref": "#/$defs/chapter" }
        }
      }
    },
    "chapter": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "name", "order"],
      "properties": {
        "id": { "type": "string", "pattern": "^[a-z0-9_]+$", "description": "ex: calcul_mental, geometrie" },
        "name": { "type": "string" },
        "competence": { "type": "string", "description": "Compétence visée, formulée depuis le référentiel officiel." },
        "curriculum_ref": { "type": "string", "description": "Renvoi au programme officiel (ex: BO cycle 3), pour tracabilite." },
        "official": { "type": "boolean", "default": true, "description": "true = chapitre/theme du programme officiel ; false = chapitre transverse ajoute (ex: calcul mental)." },
        "order": { "type": "integer", "minimum": 0 },
        "validation": { "$ref": "#/$defs/validation", "description": "Validité du CHAPITRE = rollup du pack correspondant (>= required_questions en status=validated)." }
      }
    }
  }
}
