퀴즈 오답에서 어느 개념이 막혔는지 짚고, 다음에 볼 강의를 추천하는 학습 도우미입니다.

{"type":"object","properties":{"learner_id":{"type":"string"},"period":{"type":"string"},"stuck_concepts":{"type":"array","items":{"type":"object","properties":{"concept_id":{"type":"string"},"name":{"type":"string"},"wrong_rate":{"type":"number"},"wrong_item_ids":{"type":"array","items":{"type":"string"}},"prerequisite_path":{"type":"array","items":{"type":"string"}}},"required":["concept_id","name","wrong_rate","wrong_item_ids","prerequisite_path"]}},"recommendations":{"type":"array","minItems":1,"maxItems":3,"items":{"type":"object","properties":{"content_id":{"type":"string"},"target_concept_id":{"type":"string"},"reason":{"type":"string"},"difficulty":{"type":"string"},"evidence_item_ids":{"type":"array","items":{"type":"string"}},"confidence":{"type":"string","enum":["low","mid","high"]}},"required":["content_id","target_concept_id","reason","difficulty","evidence_item_ids"]}},"unmapped_tags":{"type":"array","items":{"type":"string"}},"explanation":{"type":["string","null"]}},"required":["learner_id","period","stuck_concepts","recommendations","unmapped_tags"]}

[
  {
    "input_ref": "l_001 · 2026-06-08~06-10 (리스트·딕셔너리 오답 집중)",
    "output": {
      "learner_id": "l_001",
      "period": "2026-06-08~2026-06-10",
      "stuck_concepts": [
        {
          "concept_id": "c_list",
          "name": "리스트",
          "wrong_rate": 0.67,
          "wrong_item_ids": [
            "q_301",
            "q_305"
          ],
          "prerequisite_path": [
            "c_var",
            "c_cond",
            "c_loop",
            "c_list"
          ]
        },
        {
          "concept_id": "c_dict",
          "name": "딕셔너리",
          "wrong_rate": 1,
          "wrong_item_ids": [
            "q_312",
            "q_315"
          ],
          "prerequisite_path": [
            "c_var",
            "c_cond",
            "c_loop",
            "c_list",
            "c_dict"
          ]
        }
      ],
      "recommendations": [
        {
          "content_id": "ct_110",
          "target_concept_id": "c_loop",
          "reason": "리스트·딕셔너리 오답의 공통 선수 개념인 반복문이 미이수 상태입니다. 변수·조건문은 정답률이 높아 넘어가고, 아직 다지지 않은 가장 기초 개념인 반복문부터 다시 보도록 추천합니다.",
          "difficulty": "basic",
          "evidence_item_ids": [
            "q_301",
            "q_312"
          ],
          "confidence": "high"
        },
        {
          "content_id": "ct_130",
          "target_concept_id": "c_list",
          "reason": "반복문을 마친 뒤 리스트 강의를 재학습하도록 추천합니다. 오답 2건이 리스트 개념에 몰려 있습니다.",
          "difficulty": "inter",
          "evidence_item_ids": [
            "q_305"
          ],
          "confidence": "mid"
        },
        {
          "content_id": "ct_140",
          "target_concept_id": "c_dict",
          "reason": "리스트를 다진 뒤 딕셔너리로 이어가도록 추천합니다. 딕셔너리는 리스트를 선수로 하므로 순서상 마지막입니다.",
          "difficulty": "inter",
          "evidence_item_ids": [
            "q_315"
          ],
          "confidence": "mid"
        }
      ],
      "unmapped_tags": [],
      "explanation": "리스트와 딕셔너리 문제에서 자주 막히셨는데, 두 개념이 공통으로 딛고 있는 반복문이 아직 덜 잡힌 것으로 보입니다. 반복문 강의부터 다시 보시면 그다음이 한결 수월해집니다. 다만 문항 수가 많지 않아 확정은 아니고, 반복문을 보신 뒤 정답률로 확인해 보시길 권합니다."
    }
  },
  {
    "input_ref": "l_002 · 2026-06-11 (미등록 개념 태그 혼입)",
    "output": {
      "learner_id": "l_002",
      "period": "2026-06-11~2026-06-11",
      "stuck_concepts": [
        {
          "concept_id": "c_func",
          "name": "함수",
          "wrong_rate": 1,
          "wrong_item_ids": [
            "q_120",
            "q_121"
          ],
          "prerequisite_path": [
            "c_var",
            "c_func"
          ]
        }
      ],
      "recommendations": [
        {
          "content_id": "ct_120",
          "target_concept_id": "c_func",
          "reason": "함수 문항 2건을 모두 틀리셨고 선수 개념인 변수는 잡혀 있어, 함수 강의를 바로 재학습하도록 추천합니다.",
          "difficulty": "basic",
          "evidence_item_ids": [
            "q_120",
            "q_121"
          ],
          "confidence": "high"
        }
      ],
      "unmapped_tags": [
        "q_401(정규표현식)",
        "q_402(머신러닝 입문)"
      ],
      "explanation": "함수 개념에서 막히신 것으로 보여 함수 강의를 추천합니다. 정규표현식·머신러닝 입문 문항은 아직 개념 지도에 등록되지 않아 진단에서 제외했고, 추측으로 끼워 맞추지 않았습니다. 이 두 태그는 개념 지도에 편입되면 다음 진단부터 반영됩니다."
    }
  },
  {
    "input_ref": "l_003 · 2026-06-11~06-12 (전부 정답, 다음 심화 추천)",
    "output": {
      "learner_id": "l_003",
      "period": "2026-06-11~2026-06-12",
      "stuck_concepts": [],
      "recommendations": [
        {
          "content_id": "ct_180",
          "target_concept_id": "c_recur",
          "reason": "최근 문항을 모두 맞히셨고 객체지향까지 이수하셨습니다. 함수·조건문을 선수로 하는 재귀가 아직 미이수라 다음 심화 단계로 추천합니다.",
          "difficulty": "advanced",
          "evidence_item_ids": [],
          "confidence": "mid"
        }
      ],
      "unmapped_tags": [],
      "explanation": "최근 푸신 문제는 모두 맞히셨습니다. 막힌 개념은 보이지 않아, 이수하신 함수·객체지향 위에서 다음 단계인 재귀 강의로 넘어가시길 추천합니다. 근거가 되는 오답이 없어 확신도는 보통으로 표시했습니다."
    }
  }
]

[자동 검증] 1. JSON Schema parse 통과(형식·필수 필드·enum 위반 걸러냄). 2. 막힌 뿌리 개념 재현성: 같은 입력에 항상 같은 stuck_concepts·recommendations 가 나오는지 그래프 탐색 재현 테스트(판정이 LLM 이 아니라 위상 정렬 규칙이라 결정론). 3. evidence 정합성: 각 recommendation 의 evidence_item_ids 가 그 학습자의 실제 오답 문항 id 인지, target_concept_id 가 stuck_concepts 의 선수 경로 위에 있는지 확인. 4. 추천 유효성: 추천 content_id 가 concept_catalog 의 미이수 강의이고 난이도 순서가 선수관계와 어긋나지 않는지 확인. 5. 미매핑 처리: concept_id=null 인 문항이 진단에서 빠지고 unmapped_tags 로만 노출되는지(추측 삽입 금지), prerequisite_ids 에 orphan 이 섞인 개념은 경로 조회에서 격리되는지. [수동 검증] 1. 강사 검수자 2명이 개념 매핑·추천 타당성을 비동기 라벨링, 검수자 일치도 Cohen's κ(두 사람 답이 우연 이상으로 일치하는 정도, 0~1) 하한이 기준 이상인지. 2. 설명 문구가 오답을 곧 실력 부족으로 단정하지 않는지 사람 표본 점검.