태양광 발전소가 어느 정도 필요한지 보여주는 관리자 페이지입니다.

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

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

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

• 자료를 올리기 전에는 샘플 데이터로 보기로 화면을 확인합니다.
• 일사량이나 용량이 비면 그 발전소만 계측 결측으로 빼고 나머지 판정은 그대로 이어집니다.

{"type":"object","properties":{"gap_id":{"type":"string"},"record_no":{"type":"string"},"plant_code":{"type":["string","null"]},"gap_code":{"type":"string","enum":["as_expected","low_irradiance","equipment_suspect","grid_curtailed","record_missing","plant_unmapped"]},"output_gap_kwh":{"type":["number","null"]},"evidence":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"agg":{"type":["string","null"]},"value":{"type":["string","number","boolean","null"]}},"required":["field","value"]}},"summary":{"type":"string"},"hedge":{"type":["string","null"]}},"required":["gap_id","record_no","gap_code","evidence","summary"]}

[
  {
    "gap_id": "og_0001",
    "record_no": "PR-0817-001",
    "plant_code": "PL-101",
    "gap_code": "as_expected",
    "output_gap_kwh": null,
    "evidence": [
      {
        "field": "output_kwh",
        "agg": null,
        "value": 2210
      },
      {
        "field": "irradiance_kwh_m2",
        "agg": null,
        "value": 5.2
      }
    ],
    "summary": "일사량 대비 발전량이 예상 범위 안에 들어옵니다.",
    "hedge": null
  },
  {
    "gap_id": "og_0002",
    "record_no": "PR-0818-003",
    "plant_code": "PL-103",
    "gap_code": "as_expected",
    "output_gap_kwh": null,
    "evidence": [
      {
        "field": "output_kwh",
        "agg": null,
        "value": 3720
      },
      {
        "field": "capacity_kw",
        "agg": null,
        "value": 800
      }
    ],
    "summary": "맑은 날 용량에 맞는 발전량이 나왔습니다.",
    "hedge": null
  },
  {
    "gap_id": "og_0003",
    "record_no": "PR-0817-003",
    "plant_code": "PL-103",
    "gap_code": "low_irradiance",
    "output_gap_kwh": null,
    "evidence": [
      {
        "field": "irradiance_kwh_m2",
        "agg": null,
        "value": 2.1
      },
      {
        "field": "inverter_alarm",
        "agg": null,
        "value": "none"
      }
    ],
    "summary": "일사량이 평소의 절반 이하라 발전량 감소가 날씨로 설명됩니다.",
    "hedge": null
  },
  {
    "gap_id": "og_0004",
    "record_no": "PR-0817-004",
    "plant_code": "PL-104",
    "gap_code": "equipment_suspect",
    "output_gap_kwh": 1013,
    "evidence": [
      {
        "field": "output_kwh",
        "agg": null,
        "value": 900
      },
      {
        "field": "output_kwh",
        "agg": "expected",
        "value": 1913
      }
    ],
    "summary": "일사량은 충분한데 예상보다 1,013kWh 적고 인버터 경보까지 있어 현장 확인이 필요합니다.",
    "hedge": null
  },
  {
    "gap_id": "og_0005",
    "record_no": "PR-0817-006",
    "plant_code": "PL-106",
    "gap_code": "equipment_suspect",
    "output_gap_kwh": 1003,
    "evidence": [
      {
        "field": "output_kwh",
        "agg": null,
        "value": 0
      },
      {
        "field": "output_kwh",
        "agg": "expected",
        "value": 1003
      }
    ],
    "summary": "종일 발전이 0 이라 예상치 전부가 빠졌고 인버터 정지가 원인으로 보입니다.",
    "hedge": null
  },
  {
    "gap_id": "og_0006",
    "record_no": "PR-0817-007",
    "plant_code": "PL-107",
    "gap_code": "grid_curtailed",
    "output_gap_kwh": null,
    "evidence": [
      {
        "field": "curtailed",
        "agg": null,
        "value": true
      },
      {
        "field": "inverter_alarm",
        "agg": null,
        "value": "none"
      }
    ],
    "summary": "계통 출력 제한이 걸린 날이라 설비 문제로 보지 않습니다.",
    "hedge": "합성 기준 판정이라 제한 시간과 실제 감소량은 계통 기록과 맞춰 봐야 합니다."
  },
  {
    "gap_id": "og_0007",
    "record_no": "PR-0817-005",
    "plant_code": "PL-105",
    "gap_code": "record_missing",
    "output_gap_kwh": null,
    "evidence": [
      {
        "field": "irradiance_kwh_m2",
        "agg": null,
        "value": null
      },
      {
        "field": "output_kwh",
        "agg": null,
        "value": 2400
      }
    ],
    "summary": "일사량 계측이 없어 예상치를 낼 수 없어 판정하지 않습니다.",
    "hedge": null
  },
  {
    "gap_id": "og_0008",
    "record_no": "PR-0817-008",
    "plant_code": null,
    "gap_code": "plant_unmapped",
    "evidence": [
      {
        "field": "plant_code_raw",
        "agg": null,
        "value": "pl 108"
      },
      {
        "field": "capacity_kw",
        "agg": null,
        "value": null
      }
    ],
    "output_gap_kwh": null,
    "summary": "제원 목록에 없는 발전소 코드라 용량을 몰라 계산하지 못합니다.",
    "hedge": null
  },
  {
    "gap_id": "og_0009",
    "record_no": "PR-0818-002",
    "plant_code": "PL-104",
    "gap_code": "equipment_suspect",
    "output_gap_kwh": 1000,
    "evidence": [
      {
        "field": "output_kwh",
        "agg": null,
        "value": 870
      },
      {
        "field": "output_kwh",
        "agg": "expected",
        "value": 1870
      }
    ],
    "summary": "같은 발전소가 이틀째 예상에 못 미쳐 현장 점검 순서를 앞으로 당겨야 합니다.",
    "hedge": null
  }
]

[자동 검증 · 코드가 판정합니다] 1. gap_code 가 enum 여섯 값 중 하나인지 확인합니다. 2. gap_id·record_no·gap_code·evidence·summary 가 모두 채워졌는지 확인합니다. 3. irradiance_kwh_m2 가 0 이상 10 이하이고 output_kwh 가 0 이상인지 확인합니다. 4. evidence 의 field 이름이 발전 실적 데이터에 실재하는 컬럼인지 대조합니다. 5. agg 가 없는 evidence 의 value 가 그 record_no 행의 값과 같은지 확인합니다. 6. output_gap_kwh 가 evidence 의 실적과 예상치의 차이와 같은지 다시 계산합니다. 일사량이나 용량이 비면 output_gap_kwh 도 null 인지 확인합니다. 7. summary 가 존댓말로 끝나는지 확인합니다. [평가 러너 · 2주차] 현장에서 확인한 원인 100건과 규칙의 gap_code 를 비교해 일치율과 잘못 잡은 유형을 냅니다. [수동 검증 · 사람이 봅니다] 1. 계통 제한과 설비 문제가 같은 날 겹친 건을 어느 쪽으로 묶을지 표본 20건을 눈으로 확인합니다. 2. 흐린 날의 예상치를 어느 범위까지 정상으로 볼지는 운영 기준을 따라 담당자가 정합니다.