{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://timecredit.app/schemas/progression.schema.json",
  "title": "TimeCredit Quiz — Progression utilisateur",
  "description": "État PAR ENFANT, local et mutable. N'a rien à voir avec le contenu (packs) : ici on stocke si l'enfant a RÉUSSI un niveau (>= 90 %), pas si le contenu est QA-validé. Un fichier/enregistrement par utilisateur.",
  "type": "object",
  "additionalProperties": false,
  "required": ["schema_version", "user_id", "pass_threshold_pct", "levels"],
  "properties": {
    "schema_version": { "const": "1.0" },
    "user_id": { "type": "string" },
    "country": { "type": "string", "pattern": "^[A-Z]{2}$" },
    "language": { "type": "string", "pattern": "^[a-z]{2}$" },
    "pass_threshold_pct": {
      "const": 90,
      "description": "Seuil de réussite pour valider un niveau : 90 % (et non 80). Constante produit, explicite ici pour tracabilite."
    },
    "min_sample": {
      "type": "integer",
      "minimum": 1,
      "description": "Nombre minimum de questions répondues pour qu'un score compte (anti-triche §7 : le 90 % ne se calcule pas sur 2 questions)."
    },
    "current_level": { "enum": ["I", "II", "III", "IV", "V", "VI", "VII"] },
    "credit_gagne_du_jour": { "type": "number", "minimum": 0 },
    "levels": {
      "type": "array",
      "description": "Un objet par niveau. L'INDICATEUR demandé = status. passed <=> best_score_pct >= pass_threshold_pct sur >= min_sample questions.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": ["level_id", "status"],
        "properties": {
          "level_id": { "enum": ["I", "II", "III", "IV", "V", "VI", "VII"] },
          "status": {
            "enum": ["locked", "available", "passed"],
            "description": "locked = pas encore débloqué ; available = jouable, pas encore réussi ; passed = réussi (>= 90 %) => débloque le niveau suivant."
          },
          "best_score_pct": { "type": "number", "minimum": 0, "maximum": 100 },
          "questions_answered": { "type": "integer", "minimum": 0, "description": "Taille d'échantillon sur laquelle best_score_pct est calculé." },
          "passed_at": { "type": "string", "format": "date-time" }
        }
      }
    }
  }
}
