성공한 검색만큼만 청구됐는지 요청 기록과 청구서를 맞춥니다

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

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

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

• 로그와 청구서를 올리기 전에는 샘플 데이터 보기로 화면을 확인합니다.
• 청구서의 열이 빠지거나 요금제 표에 없는 엔진이 오면 목록 대신 어느 줄이 왜 걸렸는지 보여 주고 화면은 살아 있습니다.

{"type":"object","properties":{"line_no":{"type":"string"},"account_id":{"type":"string"},"period":{"type":"string"},"engine":{"type":"string","enum":["google_search","google_shopping","google_jobs","google_news","google_maps","bing","baidu","amazon","youtube","yandex","google_scholar"]},"verdict":{"type":"string","enum":["쓴 만큼 청구됨","실패 응답까지 과금","요청 수와 청구 건수 차이","요금제 단가 안 맞음","무료 할당량 미반영"]},"overcharge_usd":{"type":["number","null"],"description":"청구서의 amount_usd 에서 요금제대로 계산한 금액을 뺀 값이며 소수 넷째 자리까지 반올림합니다. 요금제대로의 금액은 그 기간 로그의 과금 대상 요청 수에서 included_quota 를 뺀 건수(0 보다 작으면 0)에 unit_price 를 곱해 냅니다. 그 계산에 들어간 건수와 단가, 할당량은 evidence 에 그대로 싣습니다. 청구서에 그 엔진 줄이 없으면 뺄 값이 없어 null 로 둡니다."},"log_missing":{"type":"boolean","description":"그 (엔진, 기간) 짝의 request_log 행이 한 줄도 없으면 참입니다. 참이면 견줄 로그가 없어 건수 차이의 원인이 과금 오류인지 로그 수집 누락인지 이 화면에서 가리지 못하므로 hedge 에 그 사실을 적습니다."},"summary":{"type":"string"},"evidence":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"agg":{"type":"string","enum":["count"],"description":"이 항목의 value 가 수록 행의 값이 아니라 그 컬럼으로 센 행 수임을 밝힙니다. 없으면 수록 행의 값 그대로입니다."},"value":{"type":["string","number","boolean","null"]},"quote":{"type":"string"}},"required":["field"]}},"hedge":{"type":["string","null"]}},"required":["line_no","account_id","period","engine","verdict","overcharge_usd","summary","evidence","hedge"]}

[
  {
    "line_no": "INV-202602-01",
    "account_id": "acct_8812",
    "period": "2026-02",
    "engine": "google_search",
    "verdict": "쓴 만큼 청구됨",
    "overcharge_usd": 0,
    "summary": "google_search 는 성공 응답 4건이 그대로 과금 대상으로 잡혔고, 거기서 무료 2건을 뺀 2건 몫인 0.004 달러가 청구돼 요금제와 맞습니다.",
    "evidence": [
      {
        "field": "line_no",
        "value": "INV-202602-01",
        "quote": "INV-202602-01"
      },
      {
        "field": "charged_count",
        "value": 4
      },
      {
        "field": "request_id",
        "agg": "count",
        "value": 4
      },
      {
        "field": "included_quota",
        "value": 2
      },
      {
        "field": "unit_price",
        "value": 0.002
      },
      {
        "field": "amount_usd",
        "value": 0.004
      }
    ],
    "hedge": null,
    "log_missing": false
  },
  {
    "line_no": "INV-202602-10",
    "account_id": "acct_8812",
    "period": "2026-02",
    "engine": "yandex",
    "verdict": "쓴 만큼 청구됨",
    "overcharge_usd": 0,
    "summary": "yandex 는 결과가 빈 응답 한 건뿐이라 과금 대상이 없고 청구도 0 으로 나갔습니다.",
    "evidence": [
      {
        "field": "line_no",
        "value": "INV-202602-10",
        "quote": "INV-202602-10"
      },
      {
        "field": "charged_count",
        "value": 0
      },
      {
        "field": "amount_usd",
        "value": 0
      },
      {
        "field": "status",
        "value": "empty_result",
        "quote": "empty_result"
      },
      {
        "field": "billed",
        "value": false
      },
      {
        "field": "included_quota",
        "value": 0
      }
    ],
    "hedge": null,
    "log_missing": false
  },
  {
    "line_no": "INV-202602-02",
    "account_id": "acct_8812",
    "period": "2026-02",
    "engine": "google_shopping",
    "verdict": "실패 응답까지 과금",
    "overcharge_usd": 0.004,
    "summary": "google_shopping 은 응답을 못 받은 timeout 요청 2건에도 과금 표시가 붙어 0.004 달러가 더 나갔습니다.",
    "evidence": [
      {
        "field": "line_no",
        "value": "INV-202602-02",
        "quote": "INV-202602-02"
      },
      {
        "field": "request_id",
        "value": "req_20260214_0006",
        "quote": "req_20260214_0006"
      },
      {
        "field": "status",
        "value": "timeout",
        "quote": "timeout"
      },
      {
        "field": "billed",
        "value": true
      },
      {
        "field": "responded_at",
        "value": null
      },
      {
        "field": "request_id",
        "agg": "count",
        "value": 2
      },
      {
        "field": "unit_price",
        "value": 0.002
      }
    ],
    "hedge": null,
    "log_missing": false
  },
  {
    "line_no": "INV-202602-03",
    "account_id": "acct_8812",
    "period": "2026-02",
    "engine": "amazon",
    "verdict": "요청 수와 청구 건수 차이",
    "overcharge_usd": 0.004,
    "summary": "amazon 은 로그에 남은 과금 대상이 2건인데 청구서에는 4건으로 잡혀 0.004 달러가 더 나갔습니다.",
    "evidence": [
      {
        "field": "line_no",
        "value": "INV-202602-03",
        "quote": "INV-202602-03"
      },
      {
        "field": "charged_count",
        "value": 4
      },
      {
        "field": "request_id",
        "agg": "count",
        "value": 2
      },
      {
        "field": "included_quota",
        "value": 1
      },
      {
        "field": "unit_price",
        "value": 0.002
      },
      {
        "field": "amount_usd",
        "value": 0.006
      }
    ],
    "hedge": "이 계정 로그가 청구 기간을 통째로 담고 있다는 전제에서 센 값입니다. 로그 수집이 끊긴 구간이 있으면 차이의 원인이 달라집니다.",
    "log_missing": false
  },
  {
    "line_no": "INV-202602-04",
    "account_id": "acct_8812",
    "period": "2026-02",
    "engine": "google_jobs",
    "verdict": "요금제 단가 안 맞음",
    "overcharge_usd": 0.004,
    "summary": "google_jobs 는 2건에 요금제 단가 0.003 달러를 곱한 0.006 달러여야 하는데 청구서에는 0.01 달러가 적혀 있어 건당 0.005 달러로 계산된 셈입니다.",
    "evidence": [
      {
        "field": "line_no",
        "value": "INV-202602-04",
        "quote": "INV-202602-04"
      },
      {
        "field": "charged_count",
        "value": 2
      },
      {
        "field": "unit_price",
        "value": 0.003
      },
      {
        "field": "included_quota",
        "value": 0
      },
      {
        "field": "amount_usd",
        "value": 0.01
      }
    ],
    "hedge": null,
    "log_missing": false
  },
  {
    "line_no": "INV-202602-05",
    "account_id": "acct_8812",
    "period": "2026-02",
    "engine": "bing",
    "verdict": "무료 할당량 미반영",
    "overcharge_usd": 0.002,
    "summary": "bing 은 성공 2건에서 무료 1건을 뺀 1건 몫인 0.002 달러가 나가야 하는데 2건 몫이 그대로 청구돼 0.002 달러가 더 나갔습니다.",
    "evidence": [
      {
        "field": "line_no",
        "value": "INV-202602-05",
        "quote": "INV-202602-05"
      },
      {
        "field": "charged_count",
        "value": 2
      },
      {
        "field": "included_quota",
        "value": 1
      },
      {
        "field": "unit_price",
        "value": 0.002
      },
      {
        "field": "amount_usd",
        "value": 0.004
      }
    ],
    "hedge": null,
    "log_missing": false
  },
  {
    "line_no": "INV-202602-11",
    "account_id": "acct_8812",
    "period": "2026-02",
    "engine": "google_scholar",
    "verdict": "요청 수와 청구 건수 차이",
    "overcharge_usd": 0.006,
    "log_missing": true,
    "summary": "google_scholar 는 2026-02 로그에 요청이 한 줄도 없는데 3건이 청구돼 0.006 달러가 근거 없이 나갔습니다.",
    "evidence": [
      {
        "field": "line_no",
        "value": "INV-202602-11",
        "quote": "INV-202602-11"
      },
      {
        "field": "charged_count",
        "value": 3
      },
      {
        "field": "request_id",
        "agg": "count",
        "value": 0
      },
      {
        "field": "unit_price",
        "value": 0.002
      },
      {
        "field": "included_quota",
        "value": 0
      },
      {
        "field": "amount_usd",
        "value": 0.006
      }
    ],
    "hedge": "이 엔진은 요청 로그가 한 줄도 없어 실제로 안 쓴 것인지 로그 수집이 그 엔진만 빠진 것인지 이 화면에서는 가리지 못합니다. 금액 차이는 로그가 그 기간의 전부라는 전제에서 낸 값이라, 상대에게 묻기 전에 수집 설정부터 확인합니다."
  }
]

[자동 검증 · 사람 없이 러너가 돌립니다] 1. verdict 가 스키마가 선언한 다섯 값 안에 있는지 확인합니다. 2. line_no·engine·period·verdict·overcharge_usd·log_missing·summary·evidence 필드가 샘플에 있는지 확인합니다. 3. invoice_line 의 charged_count 와 amount_usd 가 0 이상인지 확인합니다. 4. overcharge_usd 를 amount_usd 빼기 요금제대로 계산한 금액으로 다시 계산해 소수 넷째 자리까지 반올림한 값과 같은지 봅니다. 요금제대로의 금액은 (그 기간 로그의 과금 대상 요청 수 − included_quota, 음수면 0) × unit_price 입니다. 5. evidence 의 field 가 세 데이터셋의 컬럼에 실재하는지 확인합니다. 6. evidence 의 quote 가 수록 샘플의 원문 그대로인지 확인합니다. 7. summary 가 존댓말로 끝나는지 확인합니다. 8. 조건 규칙으로 request_log 의 status 가 plan_rate 의 billable_status 목록에 없으면 billed 는 거짓이어야 합니다. 성립 사례는 req_20260214_0020 이고, 불성립 사례는 req_20260214_0006 입니다. 9. 청구서 한 줄과 견줄 로그는 **엔진과 기간이 둘 다 같은 행**입니다. 로그 행의 기간은 requested_at 의 앞 일곱 글자(연-월)로 정합니다 — 응답을 못 받아 responded_at 이 빈 timeout 행도 이 규약으로 기간이 정해집니다. 그 짝의 로그 행이 한 줄도 없으면 log_missing 을 참으로 둡니다. 10. 과금 대상 요청 수는 그 짝의 로그 행 가운데 status 가 plan_rate.billable_status 에 든 행 수입니다. billed 칸은 상대가 매긴 값이라 이 집계에 쓰지 않고, 8번처럼 어긋남을 찾는 데만 씁니다. [판정 순서 · 한 줄이 여러 사유에 걸릴 때] ① billable_status 밖 상태인데 billed 가 참인 로그 행이 있으면 실패 응답까지 과금입니다. ② charged_count 가 과금 대상 요청 수와 다르면 요청 수와 청구 건수 차이입니다. ③ included_quota 가 1 이상이고 amount_usd 가 charged_count × unit_price(할당량을 빼지 않은 금액)와 같으면 무료 할당량 미반영입니다. ④ 그렇지 않은데 amount_usd 가 (charged_count − included_quota) × unit_price 와 다르면 요금제 단가 안 맞음입니다. ⑤ 어디에도 안 걸리면 쓴 만큼 청구됨입니다. ③을 ④보다 먼저 보는 까닭은, 할당량을 안 빼면 건당 단가가 커 보여 단가 오류로 잘못 떨어지기 때문입니다 — bing(INV-202602-05)이 그 경우로, 건당 0.004 달러로 계산된 것처럼 보이지만 실제 원인은 무료 1건을 안 뺀 것입니다. 반대로 google_jobs(INV-202602-04)는 할당량이 0 이라 ③에 걸리지 않고 ④로 떨어집니다. [수동 검증 · 사람이 봅니다] 1. 요금제 표가 실제 계약 조건과 같은 시점 값인지 봅니다. 2. 문의 초안이 상대에게 그대로 보낼 만한 문장인지 봅니다. [평가 러너 · 2주차] 청구서 11줄에 규칙으로 만든 정답표를 붙여 판정 일치를 세고, 갈라진 줄은 건수 집계에서 갈렸는지 금액 계산에서 갈렸는지 나눠 리포트에 답니다.