수집 실패 기록을 차단·구조 변경·인증 만료로 나눠 보여주는 관리자 페이지입니다.

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

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

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

• 로그를 올리기 전에는 샘플 데이터로 보기로 화면을 확인합니다.
• 응답 코드나 적중률이 비면 목록 대신 어느 줄이 왜 판정되지 않았는지 미판정으로 보여 주고 화면은 살아 있습니다.

{"type":"object","properties":{"finding_id":{"type":"string"},"log_no":{"type":"string"},"cause_code":{"type":"string","enum":["blocked","layout_changed","auth_expired","network_unstable","undecidable"]},"evidence":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"agg":{"type":["string","null"]},"value":{"type":["string","number","null"]}},"required":["field","value"]}},"summary":{"type":"string"},"hedge":{"type":["string","null"]}},"required":["finding_id","log_no","cause_code","evidence","summary"]}

[
  {
    "finding_id": "fd_0001",
    "log_no": "LOG-2026W34-002",
    "cause_code": "layout_changed",
    "evidence": [
      {
        "field": "http_status",
        "agg": null,
        "value": 200
      },
      {
        "field": "selector_hit_ratio",
        "agg": null,
        "value": 0.08
      }
    ],
    "summary": "응답은 정상인데 선택자가 거의 걸리지 않아 화면 구조가 바뀐 것으로 봅니다.",
    "hedge": null
  },
  {
    "finding_id": "fd_0002",
    "log_no": "LOG-2026W34-003",
    "cause_code": "blocked",
    "evidence": [
      {
        "field": "http_status",
        "agg": null,
        "value": 403
      },
      {
        "field": "retry_count",
        "agg": null,
        "value": 3
      }
    ],
    "summary": "재시도 세 번이 모두 403 으로 막혀 차단으로 봅니다.",
    "hedge": null
  },
  {
    "finding_id": "fd_0003",
    "log_no": "LOG-2026W34-005",
    "cause_code": "auth_expired",
    "evidence": [
      {
        "field": "auth_error",
        "agg": null,
        "value": "certificate expired"
      },
      {
        "field": "http_status",
        "agg": null,
        "value": 401
      }
    ],
    "summary": "인증서 만료 메시지와 401 이 함께 나와 인증 단계에서 끊긴 것으로 봅니다.",
    "hedge": null
  },
  {
    "finding_id": "fd_0004",
    "log_no": "LOG-2026W34-007",
    "cause_code": "network_unstable",
    "evidence": [
      {
        "field": "http_status",
        "agg": null,
        "value": null
      },
      {
        "field": "elapsed_ms",
        "agg": null,
        "value": 30000
      }
    ],
    "summary": "응답 코드가 없고 제한 시간까지 걸려 연결이 끊긴 것으로 봅니다.",
    "hedge": "합성 기준 판정이라 실제로는 상대 서버의 일시 지연일 수 있습니다."
  },
  {
    "finding_id": "fd_0005",
    "log_no": "LOG-2026W34-011",
    "cause_code": "layout_changed",
    "evidence": [
      {
        "field": "selector_hit_ratio",
        "agg": null,
        "value": 0
      },
      {
        "field": "rows_collected",
        "agg": null,
        "value": 0
      }
    ],
    "summary": "선택자가 하나도 걸리지 않아 같은 사이트에서 구조 변경이 이어지는 것으로 봅니다.",
    "hedge": null
  },
  {
    "finding_id": "fd_0006",
    "log_no": "LOG-2026W34-006",
    "cause_code": "undecidable",
    "evidence": [
      {
        "field": "site_code_raw",
        "agg": null,
        "value": "kb bank"
      },
      {
        "field": "site_id",
        "agg": null,
        "value": null
      }
    ],
    "summary": "사이트 코드 표기가 흔들려 어느 사이트인지 붙지 않아 판정을 미룹니다.",
    "hedge": null
  },
  {
    "finding_id": "fd_0007",
    "log_no": "LOG-2026W34-013",
    "cause_code": "network_unstable",
    "evidence": [
      {
        "field": "http_status",
        "agg": null,
        "value": 503
      },
      {
        "field": "log_no",
        "agg": "count",
        "value": 2
      }
    ],
    "summary": "같은 사이트에서 5xx 응답이 그날 두 번 나와 상대 서버 쪽 문제로 봅니다.",
    "hedge": null
  }
]

[자동 검증 · 코드가 판정합니다] 1. cause_code 가 enum 다섯 값 중 하나인지 확인합니다. 2. finding_id·log_no·cause_code·evidence·summary 가 모두 채워졌는지 확인합니다. 3. selector_hit_ratio 가 0 이상 1 이하인지 확인합니다. 4. evidence 의 field 이름이 작업 로그에 실재하는 컬럼인지 대조합니다. 5. agg 가 없는 evidence 의 value 가 그 log_no 행의 값과 같은지 확인합니다. 6. http_status 가 200 이면 cause_code 는 blocked 가 아닌지 확인합니다. 로그에는 200 이면서 선택자가 안 걸린 행과 200 이면서 정상 수집된 행이 모두 있습니다. 7. summary 가 존댓말로 끝나는지 확인합니다. [평가 러너 · 2주차] 담당자가 사후에 확인한 실제 원인 120건과 규칙의 cause_code 를 비교해 일치율과 갈리는 조합을 냅니다. [수동 검증 · 사람이 봅니다] 1. 정상 수집된 행(LOG-2026W34-001·LOG-2026W34-012)은 실패가 아니라 판정 대상에서 빠집니다. 실패만 골라 왔는지 표본으로 확인합니다. 2. 재시도 끝에 성공한 건을 실패로 셀지 말지는 운영 기준을 따라 담당자가 정합니다.