결제 내역 기준으로 크레딧 지급이 어긋난 주문을 찾아주는 관리자 페이지입니다.

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

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

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

• 파일을 올리기 전에는 예시 데이터로 판정 목록이 어떻게 나오는지 미리 봅니다.
• 열 이름이 다르거나 주문 번호 칸이 비어 있어도 판정 목록은 살아 있고, 어떤 값을 읽지 못했는지 근거 상세에 남습니다.

{"type":"object","properties":{"case_key":{"type":"string"},"order_id":{"type":["string","null"]},"entry_id":{"type":["string","null"]},"verdict":{"type":"string","enum":["granted_as_paid","granted_less_than_paid","granted_more_than_paid","paid_but_not_granted","granted_without_order","refunded_but_not_revoked","revoked_without_refund"]},"expected_credits":{"type":["number","null"],"description":"credit_orders.amount_paid 를 credit_products.price 로 나눈 묶음 수량에 credit_products.credits 를 곱한 값입니다. 주문에 이어지지 않는 원장 기록은 null 입니다."},"granted_credits":{"type":["number","null"],"description":"같은 order_id 의 credit_ledger 기록 중 reason 이 purchase_grant 인 행의 delta_credits 합계입니다. 그런 기록이 없으면 null 입니다."},"revoked_credits":{"type":["number","null"],"description":"같은 order_id 의 credit_ledger 기록 중 reason 이 refund_revoke 인 행의 delta_credits 합계입니다. 그런 기록이 없으면 null 입니다. 환불 주문에서는 이 값의 절댓값을 granted_credits 와 견주어 회수가 모자란지 정합니다."},"credit_gap":{"type":["number","null"],"description":"granted_credits 에서 expected_credits 를 뺀 값입니다. 두 값 중 하나가 null 이면 null 입니다."},"evidence":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"value":{"type":["string","number","null"]},"agg":{"type":"string","enum":["count","sum","avg","min","max"]}},"required":["field","value"]}},"summary":{"type":"string"}},"required":["case_key","order_id","entry_id","verdict","expected_credits","granted_credits","revoked_credits","credit_gap","evidence","summary"]}

[
  {
    "case_key": "ORD-3201",
    "order_id": "ORD-3201",
    "entry_id": null,
    "verdict": "granted_as_paid",
    "expected_credits": 500,
    "granted_credits": 500,
    "revoked_credits": null,
    "credit_gap": 0,
    "evidence": [
      {
        "field": "order_id",
        "value": "ORD-3201"
      },
      {
        "field": "amount_paid",
        "value": 5500
      },
      {
        "field": "price",
        "value": 5500
      },
      {
        "field": "credits",
        "value": 500
      },
      {
        "field": "delta_credits",
        "agg": "sum",
        "value": 500
      }
    ],
    "summary": "5,500원 결제가 5,500원짜리 500크레딧 상품 한 묶음이라 기대 지급이 500크레딧이고, 구매 지급 합계도 500크레딧이라 결제대로 나갔습니다."
  },
  {
    "case_key": "ORD-3211",
    "order_id": "ORD-3211",
    "entry_id": null,
    "verdict": "granted_as_paid",
    "expected_credits": 1000,
    "granted_credits": 1000,
    "revoked_credits": null,
    "credit_gap": 0,
    "evidence": [
      {
        "field": "order_id",
        "value": "ORD-3211"
      },
      {
        "field": "credits",
        "value": 1000
      },
      {
        "field": "delta_credits",
        "agg": "sum",
        "value": 1000
      },
      {
        "field": "reason",
        "value": "promo_grant"
      },
      {
        "field": "delta_credits",
        "value": 200
      }
    ],
    "summary": "첫 구매 보너스 200크레딧이 따로 들어와 있어 보너스를 뺀 구매 지급 합계 1,000크레딧을 상품 기준 1,000크레딧과 견줬고, 두 값이 같습니다."
  },
  {
    "case_key": "ORD-3218",
    "order_id": "ORD-3218",
    "entry_id": null,
    "verdict": "granted_less_than_paid",
    "expected_credits": 1000,
    "granted_credits": 500,
    "revoked_credits": null,
    "credit_gap": -500,
    "evidence": [
      {
        "field": "order_id",
        "value": "ORD-3218"
      },
      {
        "field": "amount_paid",
        "value": 9900
      },
      {
        "field": "credits",
        "value": 1000
      },
      {
        "field": "entry_id",
        "value": "LED-8833"
      },
      {
        "field": "delta_credits",
        "agg": "sum",
        "value": 500
      }
    ],
    "summary": "9,900원 결제로 1,000크레딧 상품 한 묶음을 샀는데 구매 지급 합계가 500크레딧이라 500크레딧이 모자랍니다."
  },
  {
    "case_key": "ORD-3236",
    "order_id": "ORD-3236",
    "entry_id": null,
    "verdict": "granted_more_than_paid",
    "expected_credits": 300,
    "granted_credits": 600,
    "revoked_credits": null,
    "credit_gap": 300,
    "evidence": [
      {
        "field": "order_id",
        "value": "ORD-3236"
      },
      {
        "field": "credits",
        "value": 300
      },
      {
        "field": "entry_id",
        "value": "LED-8856"
      },
      {
        "field": "entry_id",
        "agg": "count",
        "value": 2
      },
      {
        "field": "delta_credits",
        "agg": "sum",
        "value": 600
      }
    ],
    "summary": "3,300원 결제로 300크레딧 상품 한 묶음을 샀는데 구매 지급 기록이 2건 들어와 합계가 600크레딧이라 300크레딧이 더 나갔습니다."
  },
  {
    "case_key": "ORD-3224",
    "order_id": "ORD-3224",
    "entry_id": null,
    "verdict": "paid_but_not_granted",
    "expected_credits": 600,
    "granted_credits": null,
    "revoked_credits": null,
    "credit_gap": null,
    "evidence": [
      {
        "field": "order_id",
        "value": "ORD-3224"
      },
      {
        "field": "status",
        "value": "paid"
      },
      {
        "field": "amount_paid",
        "value": 6600
      },
      {
        "field": "price",
        "value": 3300
      },
      {
        "field": "credits",
        "value": 300
      },
      {
        "field": "entry_id",
        "agg": "count",
        "value": 0
      }
    ],
    "summary": "6,600원 결제가 3,300원짜리 300크레딧 상품 두 묶음이라 기대 지급이 600크레딧인데, 이 주문 번호로 들어온 구매 지급 기록이 하나도 없습니다."
  },
  {
    "case_key": "LED-8845",
    "order_id": null,
    "entry_id": "LED-8845",
    "verdict": "granted_without_order",
    "expected_credits": null,
    "granted_credits": 1000,
    "revoked_credits": null,
    "credit_gap": null,
    "evidence": [
      {
        "field": "entry_id",
        "value": "LED-8845"
      },
      {
        "field": "order_id",
        "value": null
      },
      {
        "field": "reason",
        "value": "purchase_grant"
      },
      {
        "field": "delta_credits",
        "value": 1000
      },
      {
        "field": "entered_at",
        "value": "2026-08-20T15:44"
      }
    ],
    "summary": "구매 지급 1,000크레딧이 들어왔는데 원장의 주문 번호 칸이 비어 있어 결제 내역에 짝이 되는 주문이 없습니다."
  },
  {
    "case_key": "ORD-3247",
    "order_id": "ORD-3247",
    "entry_id": "LED-8879",
    "verdict": "refunded_but_not_revoked",
    "expected_credits": 1000,
    "granted_credits": 1000,
    "revoked_credits": -400,
    "credit_gap": 0,
    "evidence": [
      {
        "field": "order_id",
        "value": "ORD-3247"
      },
      {
        "field": "status",
        "value": "refunded"
      },
      {
        "field": "credits",
        "value": 1000
      },
      {
        "field": "delta_credits",
        "agg": "sum",
        "value": 1000
      },
      {
        "field": "entry_id",
        "value": "LED-8879"
      },
      {
        "field": "reason",
        "value": "refund_revoke"
      },
      {
        "field": "delta_credits",
        "agg": "sum",
        "value": -400
      }
    ],
    "summary": "환불로 끝난 주문인데 지급한 1,000크레딧 가운데 회수는 400크레딧뿐이라 600크레딧이 사용자에게 그대로 남아 있습니다."
  },
  {
    "case_key": "ORD-3241",
    "order_id": "ORD-3241",
    "entry_id": "LED-8867",
    "verdict": "revoked_without_refund",
    "expected_credits": 300,
    "granted_credits": 300,
    "revoked_credits": -300,
    "credit_gap": 0,
    "evidence": [
      {
        "field": "order_id",
        "value": "ORD-3241"
      },
      {
        "field": "status",
        "value": "paid"
      },
      {
        "field": "credits",
        "value": 300
      },
      {
        "field": "delta_credits",
        "agg": "sum",
        "value": 300
      },
      {
        "field": "entry_id",
        "value": "LED-8867"
      },
      {
        "field": "reason",
        "value": "refund_revoke"
      },
      {
        "field": "delta_credits",
        "value": -300
      }
    ],
    "summary": "결제 상태가 결제완료인데 원장에는 환불 회수 300크레딧이 들어와 있어, 사용자는 환불받지 못한 채 크레딧만 빠져나갔습니다."
  }
]

[자동 검증 · 매 실행] 1. verdict 가 granted_as_paid·granted_less_than_paid·granted_more_than_paid·paid_but_not_granted·granted_without_order·refunded_but_not_revoked·revoked_without_refund 일곱 값 안에 있는지 봅니다. 2. case_key·order_id·entry_id·verdict·expected_credits·granted_credits·revoked_credits·credit_gap·evidence·summary 필드가 모든 판정 카드에 있는지 봅니다. 3. expected_credits 를 credit_orders.amount_paid ÷ credit_products.price 로 낸 묶음 수량에 credit_products.credits 를 곱해 다시 계산하고, granted_credits 는 같은 order_id 의 credit_ledger 기록 중 reason 이 purchase_grant 인 행의 delta_credits 합, revoked_credits 는 reason 이 refund_revoke 인 행의 delta_credits 합으로 다시 계산해 값이 같은지 봅니다. revoked_credits 는 카드에 실어 두기만 하는 값이 아니라 9번 판정 순서에서 구매 지급 합계와 견주는 값이라, 이 재계산이 틀리면 환불 주문의 사유가 바뀝니다. 4. credit_gap 이 granted_credits 에서 expected_credits 를 뺀 값과 같은지 봅니다. 두 값 중 하나가 null 이면 credit_gap 도 null 입니다. 5. 판정 카드가 선언한 JSON Schema 형식을 지키는지 봅니다. 6. agg 가 없는 evidence 의 value 가 주문 행·상품 기준 행·원장 행에 수록된 값 그대로인지 봅니다. 여러 행에서 낸 수치는 agg 에 sum·count 를 적습니다. 7. 판정 카드마다 evidence 항목이 3개 이상이고, evidence 의 field 가 credit_orders·credit_products·credit_ledger 의 컬럼에 있는지 봅니다. 8. summary 가 존댓말 한 문장으로 끝나는지 봅니다. 9. 판정 순서를 규칙 그대로 다시 밟습니다. 앞 단계에서 걸린 주문은 뒤 비교를 건너뛰므로 한 주문에는 사유가 하나만 붙습니다. 첫째, 같은 order_id 에 reason 이 refund_revoke 인 기록이 있고 credit_orders.status 가 refunded 가 아니면 verdict 는 revoked_without_refund 입니다. 둘째, status 가 refunded 인 주문은 refund_revoke 합계의 절댓값을 purchase_grant 합계와 견줍니다. 회수 기록이 아예 없어 절댓값이 0 이거나, 기록이 있어도 절댓값이 지급 합계보다 작으면 아직 돌려받지 못한 크레딧이 남아 있으므로 refunded_but_not_revoked 입니다. 지급 1,000 에 회수 -400 이면 600 이 남아 이 사유로 갑니다. 만료 차감(expire_revoke)은 환불 회수가 아니라 이 합계에서 뺍니다. 셋째, status 가 paid 인데 purchase_grant 기록이 없으면 paid_but_not_granted 입니다. 넷째, 앞의 셋에 걸리지 않은 주문만 granted_credits 를 expected_credits 와 견주어 적으면 granted_less_than_paid, 많으면 granted_more_than_paid, 같으면 granted_as_paid 입니다. 둘째에서 걸린 환불 주문은 이 단계에서 걸리면 뒤 비교를 건너뛴다는 규칙에 따라 넷째의 지급 금액 비교를 하지 않으므로, 회수가 모자란 환불 주문에서 지급까지 어긋났으면 그 사실은 근거 수치로만 남고 사유로는 나오지 않습니다. 10. 반대 방향도 밟습니다. credit_ledger 의 reason 이 purchase_grant 인데 order_id 가 비어 있거나 credit_orders.order_id 에 없으면 그 기록 하나가 granted_without_order 이고, reason 이 promo_grant·admin_adjust 인 기록은 주문 번호가 비어 있어도 판정 대상이 아닙니다. 주문 번호가 비어 있는 지급 기록과 프로모션 지급이 섞인 주문이 각각 samples 에 있습니다. [평가 러너 · 2주차] 운영 담당자 2명이 결제 내역과 원장을 직접 열어 매긴 결과와 도구 판정의 일치도(Cohen's κ: 우연히 맞은 몫을 뺀 일치 정도, 0~1)를 잽니다. [수동 검증 · 사람이 봅니다] 1. 관리자 조정으로 나간 크레딧을 구매 지급 합계에 셀지 뺄지는 팀리부뜨 운영 정책이 정합니다. 2. 쿠폰 할인이 들어간 주문처럼 결제 금액이 상품 단가로 나누어떨어지지 않는 건은 지금 규칙이 판정 대상에서 빼 두므로, 표본 20건을 눈으로 확인해 수량을 어떻게 셀지 정합니다. 3. 환불 회수가 지급 합계보다 많이 빠진 주문은 사용자가 곧바로 문의하는 방향이라 사유를 따로 두지 않았습니다. 회수 합계의 절댓값이 지급 합계보다 큰 건은 표본 20건을 눈으로 확인해 부분 환불 정책과 맞는지 정합니다.