축사 계측값에서 환기가 필요한 구간을 보여주는 관리자 페이지입니다.

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

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

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

• 계측 파일을 올리기 전에는 샘플 데이터로 보기로 화면을 확인합니다.
• 값이 비거나 물리적으로 불가능한 값이 들어오면 목록 대신 센서 확인 대상으로 보여 주고 화면은 살아 있습니다.

{"type":"object","properties":{"advice_id":{"type":"string"},"reading_no":{"type":"string"},"barn_code":{"type":"string"},"advice_code":{"type":"string","enum":["ok","nh3_high","heat_humid","sensor_untrusted","barn_unmapped"]},"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":["advice_id","reading_no","barn_code","advice_code","evidence","summary"]}

[
  {
    "advice_id": "ad_0001",
    "reading_no": "RD-0818-001",
    "barn_code": "A동",
    "advice_code": "ok",
    "evidence": [
      {
        "field": "temp_c",
        "agg": null,
        "value": 24.1
      },
      {
        "field": "nh3_ppm",
        "agg": null,
        "value": 8.4
      }
    ],
    "summary": "온도와 암모니아가 모두 기준 안이라 조치가 필요하지 않습니다.",
    "hedge": null
  },
  {
    "advice_id": "ad_0002",
    "reading_no": "RD-0818-010",
    "barn_code": "C동",
    "advice_code": "ok",
    "evidence": [
      {
        "field": "temp_c",
        "agg": null,
        "value": 19.2
      },
      {
        "field": "humidity_pct",
        "agg": null,
        "value": 54
      }
    ],
    "summary": "온도와 습도가 낮게 유지되고 있어 그대로 두어도 됩니다.",
    "hedge": null
  },
  {
    "advice_id": "ad_0003",
    "reading_no": "RD-0818-003",
    "barn_code": "A동",
    "advice_code": "nh3_high",
    "evidence": [
      {
        "field": "nh3_ppm",
        "agg": null,
        "value": 26.5
      },
      {
        "field": "fan_state",
        "agg": null,
        "value": "low"
      }
    ],
    "summary": "암모니아가 기준 25ppm 을 넘었는데 팬이 약하게 돌고 있어 환기를 올려야 합니다.",
    "hedge": null
  },
  {
    "advice_id": "ad_0004",
    "reading_no": "RD-0818-013",
    "barn_code": "A동",
    "advice_code": "nh3_high",
    "evidence": [
      {
        "field": "nh3_ppm",
        "agg": null,
        "value": 31.2
      },
      {
        "field": "reading_no",
        "agg": "count",
        "value": 3
      }
    ],
    "summary": "같은 동에서 암모니아 초과 구간이 세 번 이어져 순회 순서를 앞으로 당겨야 합니다.",
    "hedge": null
  },
  {
    "advice_id": "ad_0005",
    "reading_no": "RD-0818-006",
    "barn_code": "B동",
    "advice_code": "heat_humid",
    "evidence": [
      {
        "field": "temp_c",
        "agg": null,
        "value": 32.2
      },
      {
        "field": "humidity_pct",
        "agg": null,
        "value": 86.5
      }
    ],
    "summary": "고온에 습도까지 높아 팬을 최대로 돌려도 체감이 떨어지지 않는 구간입니다.",
    "hedge": "합성 기준 판정이라 실제 체감은 사육 두수와 바닥 상태에 따라 달라집니다."
  },
  {
    "advice_id": "ad_0006",
    "reading_no": "RD-0818-007",
    "barn_code": "B동",
    "advice_code": "sensor_untrusted",
    "evidence": [
      {
        "field": "sensor_flag",
        "agg": null,
        "value": "통신 두절"
      },
      {
        "field": "temp_c",
        "agg": null,
        "value": null
      }
    ],
    "summary": "값이 통째로 비어 있어 판단하지 않고 센서 확인 대상으로 남깁니다.",
    "hedge": null
  },
  {
    "advice_id": "ad_0007",
    "reading_no": "RD-0818-011",
    "barn_code": "C동",
    "advice_code": "sensor_untrusted",
    "evidence": [
      {
        "field": "temp_c",
        "agg": null,
        "value": 87
      },
      {
        "field": "co2_ppm",
        "agg": null,
        "value": 0
      }
    ],
    "summary": "온도가 87도로 찍히고 이산화탄소가 0 이라 계측 자체를 믿지 않고 뺍니다.",
    "hedge": null
  },
  {
    "advice_id": "ad_0008",
    "reading_no": "RD-0818-012",
    "barn_code": "D동",
    "advice_code": "barn_unmapped",
    "evidence": [
      {
        "field": "barn_code_raw",
        "agg": null,
        "value": "D동"
      },
      {
        "field": "sensor_flag",
        "agg": null,
        "value": "미등록 동"
      }
    ],
    "summary": "기준값 설정에 없는 동이라 비교할 기준이 없어 판단을 미룹니다.",
    "hedge": null
  }
]

[자동 검증 · 코드가 판정합니다] 1. advice_code 가 enum 다섯 값 중 하나인지 확인합니다. 2. advice_id·reading_no·barn_code·advice_code·evidence·summary 가 모두 채워졌는지 확인합니다. 3. humidity_pct 가 0 이상 100 이하이고 temp_c 가 영하 20도에서 45도 사이인지 확인합니다. 벗어나면 계산에서 빼고 센서 확인 대상으로 돌립니다. 4. evidence 의 field 이름이 계측 데이터에 실재하는 컬럼인지 대조합니다. 5. agg 가 없는 evidence 의 value 가 그 reading_no 행의 값과 같은지 확인합니다. 6. sensor_flag 가 채워져 있으면 advice_code 는 ok 가 아닌지 확인합니다. 계측에는 sensor_flag 가 빈 정상 행과 채워진 이상 행이 모두 있습니다. 7. summary 가 존댓말로 끝나는지 확인합니다. [평가 러너 · 2주차] 관리자가 실제로 환기를 올린 기록 90건과 규칙의 advice_code 를 비교해 놓친 구간과 과하게 잡은 구간을 나눠 냅니다. [수동 검증 · 사람이 봅니다] 1. 고온다습과 암모니아 초과가 겹친 구간을 어느 쪽으로 묶을지 표본 20건을 눈으로 확인합니다. 2. 사료 급이 직후처럼 수치가 일시적으로 오르는 시간대를 판정에서 뺄지는 현장 관례를 따라 관리자가 정합니다.