학교로 나갈 코딩 키트가 그 주 수업에 모자란지 알려줍니다.

• 묶음 기준: verdict
• 한 행: 사유 라벨 · kit_id + 한 줄 요약(근거 수치 포함)
• 근거 표는 행을 펼쳤을 때 보입니다 (`module_name` / `firmware_ver` / `checked_at` 열)

화면·코드·면접에서 이 단어를 그대로 씁니다. 키는 출력 스키마의 enum 과 같습니다.

• 자가채점 — 판정 일치 · 정답 186벌 기준 수치는 본인이 러너를 돌려 나온 값을 넣습니다. 예측 화면에는 비워 둡니다 — 출처를 댈 수 없는 숫자를 화면에 두지 않기 위해서입니다.
• 출력 스키마 검증 항목을 통과 여부와 함께 상시 노출
• 검증 노트 — 자동 / 수동 / 정직 경계선

• 표를 올리기 전에는 샘플 데이터로 보기를 눌러 화면을 확인합니다.
• 열이 빠지거나 수업 코드가 비면 목록 대신 어느 줄이 왜 걸렸는지 이슈로 보여 주고 나머지 사유 묶음은 그대로 살아 있습니다.

{"type":"object","properties":{"kit_id":{"type":"string"},"lesson_code":{"type":"string"},"verdict":{"type":"string","enum":["수업에 맞음","부품이 빠짐","펌웨어가 낮음","점검한 지 오래됨"]},"missing_modules":{"type":["string","null"],"description":"required_modules 를 쉼표로 끊어 코드와 필요 개수로 읽은 뒤, 그 kit_id 의 kit_inventory 행에서 같은 module_code 가 몇 줄인지 세어 모자란 만큼을 코드와 개수로 적습니다. 모자란 것이 없으면 비웁니다."},"lowest_firmware":{"type":["string","null"],"description":"그 키트의 firmware_ver 중 자릿수별로 비교해 가장 낮은 값입니다. 펌웨어가 적히지 않은 부품은 세지 않고, 셀 값이 하나도 없으면 비웁니다."},"required_firmware":{"type":["string","null"]},"days_since_check":{"type":["integer","null"],"description":"class_date 에서 그 키트의 가장 이른 checked_at 을 뺀 날수입니다."},"evidence":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"agg":{"type":["string","null"]},"value":{}},"required":["field","value"]}},"summary":{"type":"string"},"hedge":{"type":["string","null"]}},"required":["kit_id","lesson_code","verdict","evidence","summary"]}

[
  {
    "kit_id": "KIT-1142",
    "lesson_code": "LSN-06",
    "verdict": "부품이 빠짐",
    "missing_modules": "MOD-ULTRA×1",
    "lowest_firmware": "1.6.1",
    "required_firmware": "1.5.0",
    "days_since_check": 17,
    "evidence": [
      {
        "field": "required_modules",
        "value": "MOD-CTRL×1, MOD-ULTRA×1, MOD-BLE×1, MOD-BREAD×1"
      },
      {
        "field": "module_code",
        "agg": "count",
        "value": 4
      },
      {
        "field": "lesson_title",
        "value": "초음파로 거리 재기"
      },
      {
        "field": "class_date",
        "value": "2026-09-22"
      }
    ],
    "summary": "서울 목운중 3반 6주차 수업에 초음파센서가 필요한데 이 키트에는 들어 있지 않습니다.",
    "hedge": null
  },
  {
    "kit_id": "KIT-1304",
    "lesson_code": "LSN-08",
    "verdict": "부품이 빠짐",
    "missing_modules": "MOD-SERVO×1",
    "lowest_firmware": "1.7.0",
    "required_firmware": "1.6.0",
    "days_since_check": 12,
    "evidence": [
      {
        "field": "required_modules",
        "value": "MOD-CTRL×1, MOD-SERVO×2, MOD-BREAD×1"
      },
      {
        "field": "module_code",
        "agg": "count",
        "value": 1
      },
      {
        "field": "school_name",
        "value": "성남 분당중"
      },
      {
        "field": "class_date",
        "value": "2026-09-26"
      }
    ],
    "summary": "성남 분당중 1반 자동문 수업은 서보모터가 두 개 필요한데 이 키트에는 한 개만 들어 있습니다.",
    "hedge": "모자란 개수만큼 채워 넣으면 되는 키트라 다시 꾸리지 않고 부품만 넣어 보냅니다."
  },
  {
    "kit_id": "KIT-1187",
    "lesson_code": "LSN-08",
    "verdict": "펌웨어가 낮음",
    "missing_modules": null,
    "lowest_firmware": "1.4.2",
    "required_firmware": "1.6.0",
    "days_since_check": 22,
    "evidence": [
      {
        "field": "firmware_ver",
        "value": "1.4.2"
      },
      {
        "field": "min_firmware",
        "value": "1.6.0"
      },
      {
        "field": "module_name",
        "value": "제어보드"
      },
      {
        "field": "class_date",
        "value": "2026-09-23"
      }
    ],
    "summary": "고양 화정고 1반에 나갈 키트의 제어보드가 1.4.2 라서 자동문 수업이 요구하는 1.6.0 에 못 미칩니다.",
    "hedge": "서보모터와 브레드보드는 펌웨어가 없는 부품이라 이 비교에서 빼고 셌습니다."
  },
  {
    "kit_id": "KIT-1203",
    "lesson_code": "LSN-04",
    "verdict": "점검한 지 오래됨",
    "missing_modules": null,
    "lowest_firmware": "1.5.4",
    "required_firmware": "1.4.0",
    "days_since_check": 84,
    "evidence": [
      {
        "field": "checked_at",
        "value": "2026-06-30"
      },
      {
        "field": "class_date",
        "value": "2026-09-22"
      },
      {
        "field": "school_name",
        "value": "인천 청라초"
      },
      {
        "field": "lesson_title",
        "value": "LED 신호등 만들기"
      }
    ],
    "summary": "인천 청라초 5반 키트는 6월 30일에 마지막으로 점검해 수업일까지 84일이 지났습니다.",
    "hedge": "부품과 펌웨어는 수업 조건을 채웠고 점검 날짜만 지난 키트라 여는 김에 같이 손보면 됩니다."
  },
  {
    "kit_id": "KIT-1250",
    "lesson_code": "LSN-10",
    "verdict": "수업에 맞음",
    "missing_modules": null,
    "lowest_firmware": "1.6.0",
    "required_firmware": "1.6.0",
    "days_since_check": 14,
    "evidence": [
      {
        "field": "firmware_ver",
        "value": "1.6.0"
      },
      {
        "field": "min_firmware",
        "value": "1.6.0"
      },
      {
        "field": "module_code",
        "agg": "count",
        "value": 4
      },
      {
        "field": "checked_at",
        "value": "2026-09-10"
      }
    ],
    "summary": "수원 매탄중 2반 스마트팜 수업에 필요한 부품이 모두 들어 있고 가장 낮은 펌웨어가 1.6.0 이라 그대로 나가도 됩니다.",
    "hedge": null
  },
  {
    "kit_id": "KIT-1288",
    "lesson_code": "LSN-06",
    "verdict": "수업에 맞음",
    "missing_modules": null,
    "lowest_firmware": "1.5.0",
    "required_firmware": "1.5.0",
    "days_since_check": 13,
    "evidence": [
      {
        "field": "firmware_ver",
        "value": "1.5.0"
      },
      {
        "field": "min_firmware",
        "value": "1.5.0"
      },
      {
        "field": "school_name",
        "value": "부천 상동초"
      },
      {
        "field": "class_date",
        "value": "2026-09-25"
      }
    ],
    "summary": "부천 상동초 4반 키트는 제어보드가 요구 값과 똑같은 1.5.0 이라 낮은 쪽으로 세지 않고 그대로 내보냅니다.",
    "hedge": null
  },
  {
    "kit_id": "KIT-1142",
    "lesson_code": "LSN-07",
    "verdict": "펌웨어가 낮음",
    "missing_modules": null,
    "lowest_firmware": "1.6.1",
    "required_firmware": "1.6.5",
    "days_since_check": 24,
    "evidence": [
      {
        "field": "firmware_ver",
        "value": "1.6.1"
      },
      {
        "field": "min_firmware",
        "value": "1.6.5"
      },
      {
        "field": "lesson_title",
        "value": "블루투스로 조명 켜기"
      },
      {
        "field": "class_date",
        "value": "2026-09-29"
      }
    ],
    "summary": "서울 목운중 3반이 40주차에 할 조명 수업은 1.6.5 를 요구하는데 이 키트의 제어보드와 블루투스 모듈이 1.6.1 입니다.",
    "hedge": "LED 모듈과 브레드보드는 펌웨어를 안 쓰는 부품이라 가장 낮은 값을 고를 때 빼고 셌습니다."
  }
]

[자동 검증 · 코드가 판정합니다] 1. verdict 가 네 값 중 하나인지 확인합니다. 규칙이 정한 값이라 모델이 새 값을 적으면 그 응답을 버립니다. 2. kit_id·lesson_code·verdict·evidence·summary 필드가 빠짐없이 있는지 확인합니다. 3. days_since_check 가 0 이상인지 확인합니다. 수업일보다 늦게 점검한 날짜가 들어오면 입력이 잘못된 것이라 판정 대신 이슈로 내립니다. 4. missing_modules 를 다시 계산합니다. required_modules 를 쉼표로 끊어 코드와 필요 개수로 읽고, 그 kit_id 의 kit_inventory 행에서 같은 module_code 가 몇 줄인지 세어 모자란 만큼만 적습니다. 두 근거 값은 그 수업 지도안 행과 그 키트의 행 수에서 그대로 가져옵니다. 5. lowest_firmware 를 다시 계산합니다. 그 키트의 firmware_ver 를 점으로 끊어 자릿수마다 숫자로 견주고 가장 낮은 값을 고릅니다. 다만 firmware_ver 가 비어 있는 부품은 세지 않고, 셀 값이 하나도 없으면 펌웨어 판정을 하지 않고 그 사실을 hedge 에 남깁니다. 6. 펌웨어가 낮음은 lowest_firmware 가 min_firmware 보다 낮은지 자릿수 비교로 다시 계산합니다. 두 값이 같으면 낮은 것이 아니라 맞는 것으로 봅니다. 7. days_since_check 를 class_date 에서 그 키트의 가장 이른 checked_at 을 뺀 날수로 다시 계산하고, 60 을 넘는지 확인합니다. 8. 사유가 둘 이상 걸리면 부품이 빠짐, 펌웨어가 낮음, 점검한 지 오래됨 차례로 하나만 남기고 하나도 안 걸리면 수업에 맞음을 답니다. 9. evidence 의 field 이름이 입력 표에 있는 컬럼인지 대조합니다. 없는 이름을 인용하면 요약이 지어낸 문장이라는 뜻이라 규칙이 만든 기본 문장으로 되돌립니다. 10. evidence 의 value 가 수록된 행의 원문 값과 같은지 확인합니다. 여러 행을 세어 얻은 수치는 agg 를 함께 적습니다. 11. summary 가 존댓말 한 문장으로 끝나는지 확인합니다. [평가 러너 · 2주차] 손으로 매긴 정답 판정 186건과 자동 판정을 대조해 사유별 일치율을 내고, 어긋난 키트는 따로 모아 부품 표기를 읽는 규칙을 손볼지 정합니다. 부품 목록과 펌웨어 번호를 흔들어 만든 키트에 손볼 곳을 일부러 심어 두고 심은 수와 잡은 수를 견주는 일도 이 러너에서 합니다. [수동 검증 · 사람이 봅니다] 1. 부품이 빠짐으로 걸린 키트 20벌을 열어 학교가 이미 갖고 있어 빼고 보내기로 한 부품인지 교육운영 담당자가 판단합니다. 2. 수업에 맞음으로 넘어간 키트 20벌을 표본으로 열어 목록에는 있는데 실물이 고장 난 부품이 섞였는지 보고 판정 차례를 다시 봅니다.