리뷰에 되풀이되는 불만을 상세 표기와 견줘 고칠 상품을 추립니다

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

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

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

• 파일을 올리기 전에는 샘플 데이터로 보기를 켜 화면을 확인합니다.
• 열 이름이 빠지거나 별점 칸이 비면 목록 대신 어느 줄이 왜 걸렸는지 이슈로 보여 주고 나머지 상품은 그대로 판정됩니다.

{"type":"object","properties":{"product_id":{"type":"string"},"product_name":{"type":"string"},"verdict":{"type":"string","enum":["표기 맞음","치수 표기 어긋남","배송일 표기 초과","목록에 없는 옵션","소재·색상 표기와 다름","반품 사유와 겹침"]},"complaint_review_count":{"type":["integer","null"],"minimum":0,"description":"그 판정을 만든 리뷰 수입니다. 판정마다 세는 대상이 달라 validation_notes 13번에 갈래별로 적어 두었습니다"},"return_rate_pct":{"type":["number","null"],"minimum":0,"maximum":100,"description":"order_return.return_count ÷ order_count × 100 을 소수 한 자리로 반올림한 값입니다"},"peer_return_rate_pct":{"type":["number","null"],"minimum":0,"maximum":100,"description":"같은 category 의 다른 상품 반품률을 반올림하지 않은 채 평균 낸 뒤 그 평균만 소수 한 자리로 반올림한 값입니다"},"fix_line":{"type":["string","null"],"description":"상세에서 고칠 줄과 바꿔 넣을 값입니다"},"evidence":{"type":"array","items":{"type":"object","properties":{"dataset":{"type":"string"},"field":{"type":"string"},"agg":{"type":["string","null"]},"value":{"type":["string","number","null"]}},"required":["dataset","field","value"]}},"summary":{"type":"string"},"hedge":{"type":["string","null"]}},"required":["product_id","product_name","verdict","evidence","summary"]}

[
  {
    "product_id": "PRD-10604",
    "product_name": "기모 트레이닝팬츠",
    "verdict": "표기 맞음",
    "complaint_review_count": 0,
    "return_rate_pct": 2.1,
    "peer_return_rate_pct": 2.3,
    "fix_line": null,
    "evidence": [
      {
        "dataset": "review",
        "field": "rating",
        "value": 5
      },
      {
        "dataset": "review",
        "field": "complaint_tag",
        "value": null
      },
      {
        "dataset": "product_detail",
        "field": "size_table",
        "value": "M 허리 74 총장 96 / L 허리 78 총장 98"
      },
      {
        "dataset": "order_return",
        "field": "return_count",
        "value": 7
      },
      {
        "dataset": "order_return",
        "field": "order_count",
        "value": 340
      }
    ],
    "summary": "불만이 달린 리뷰가 없고 반품률 2.1%도 같은 하의 상품 평균 2.3% 아래입니다. 상세에서 고칠 줄이 없습니다.",
    "hedge": null
  },
  {
    "product_id": "PRD-10631",
    "product_name": "실버 링 귀걸이",
    "verdict": "표기 맞음",
    "complaint_review_count": 0,
    "return_rate_pct": 0,
    "peer_return_rate_pct": null,
    "fix_line": null,
    "evidence": [
      {
        "dataset": "product_detail",
        "field": "size_table",
        "value": null
      },
      {
        "dataset": "order_return",
        "field": "return_count",
        "value": 0
      },
      {
        "dataset": "order_return",
        "field": "return_reason",
        "value": null
      },
      {
        "dataset": "review",
        "field": "rating",
        "value": 4
      }
    ],
    "summary": "치수표가 비어 있는 잡화라 치수 판정을 건너뜁니다. 반품이 0건이고 같은 잡화 상품이 하나뿐이라 반품률 비교도 하지 않아 그대로 둡니다.",
    "hedge": null
  },
  {
    "product_id": "PRD-10412",
    "product_name": "린넨 와이드팬츠",
    "verdict": "치수 표기 어긋남",
    "complaint_review_count": 4,
    "return_rate_pct": 1.9,
    "peer_return_rate_pct": 2.4,
    "fix_line": "상세 치수표 M 허리 76 → 실측 중앙값 72.5, L 허리 80 → 실측 중앙값 73.5 로 다시 재고 고칩니다",
    "evidence": [
      {
        "dataset": "review",
        "field": "claimed_value",
        "value": "허리 72cm"
      },
      {
        "dataset": "review",
        "field": "claimed_value",
        "value": "허리 73cm"
      },
      {
        "dataset": "review",
        "field": "option_name",
        "value": "블랙/M"
      },
      {
        "dataset": "product_detail",
        "field": "size_table",
        "value": "M 허리 76 총장 98 / L 허리 80 총장 99"
      },
      {
        "dataset": "review",
        "field": "review_id",
        "agg": "count",
        "value": 4
      },
      {
        "dataset": "order_return",
        "field": "return_count",
        "value": 8
      }
    ],
    "summary": "M 리뷰 두 건의 실측 중앙값이 허리 72.5cm, L 두 건이 73.5cm 인데 상세 치수표는 M 76cm·L 80cm 입니다. 반품률 1.9%는 같은 하의 평균 2.4%의 두 배에 못 미쳐 치수 표기 쪽이 먼저 걸립니다.",
    "hedge": "리뷰의 실측값은 재는 자리마다 달라질 수 있어 상세를 고치기 전에 판매자가 한 벌을 직접 재 보는 편이 낫습니다."
  },
  {
    "product_id": "PRD-10488",
    "product_name": "코튼 오버셔츠",
    "verdict": "배송일 표기 초과",
    "complaint_review_count": 3,
    "return_rate_pct": 2.9,
    "peer_return_rate_pct": null,
    "fix_line": "상세 배송 안내 '2일 이내' → 최근 리뷰 기준 5일 이상으로 고칩니다",
    "evidence": [
      {
        "dataset": "review",
        "field": "delivered_days",
        "value": 6
      },
      {
        "dataset": "review",
        "field": "delivered_days",
        "value": 7
      },
      {
        "dataset": "review",
        "field": "delivered_days",
        "value": 5
      },
      {
        "dataset": "product_detail",
        "field": "delivery_days",
        "value": 2
      },
      {
        "dataset": "review",
        "field": "review_id",
        "agg": "count",
        "value": 3
      }
    ],
    "summary": "배송일이 적힌 리뷰 3건이 모두 상세에 적힌 2일을 넘겼습니다. 받은 날을 안 적은 리뷰 RV-88288 은 분모에서 뺐고, 같은 상의 상품이 하나뿐이라 반품률 비교는 건너뛰었습니다.",
    "hedge": null
  },
  {
    "product_id": "PRD-10530",
    "product_name": "베이직 니트",
    "verdict": "목록에 없는 옵션",
    "complaint_review_count": 2,
    "return_rate_pct": 2.3,
    "peer_return_rate_pct": 2.7,
    "fix_line": "아이보리/FREE 를 옵션에 되살리거나 품절 안내를 상세에 답니다",
    "evidence": [
      {
        "dataset": "review",
        "field": "option_name",
        "value": "아이보리/FREE"
      },
      {
        "dataset": "product_detail",
        "field": "option_list",
        "agg": "count",
        "value": 2
      },
      {
        "dataset": "product_detail",
        "field": "updated_at",
        "value": "2026-03-06T09:40:00"
      },
      {
        "dataset": "review",
        "field": "review_id",
        "agg": "count",
        "value": 2
      }
    ],
    "summary": "리뷰 2건이 아이보리/FREE 로 달렸는데 지금 옵션은 차콜과 블랙 둘뿐입니다. 상세를 마지막으로 고친 3월 6일 뒤로 아이보리가 빠진 채 리뷰만 남아 있습니다.",
    "hedge": null
  },
  {
    "product_id": "PRD-10703",
    "product_name": "램스울 가디건",
    "verdict": "소재·색상 표기와 다름",
    "complaint_review_count": 2,
    "return_rate_pct": 2.7,
    "peer_return_rate_pct": 2.3,
    "fix_line": "상세 소재 '울 100%' 를 실제 혼용률로 다시 적고 보풀 안내를 답니다",
    "evidence": [
      {
        "dataset": "review",
        "field": "claimed_value",
        "value": "아크릴 느낌"
      },
      {
        "dataset": "review",
        "field": "claimed_value",
        "value": "보풀 심함"
      },
      {
        "dataset": "product_detail",
        "field": "material_text",
        "value": "울 100%"
      },
      {
        "dataset": "order_return",
        "field": "return_reason",
        "value": "단순변심"
      },
      {
        "dataset": "tag_map",
        "field": "overlap",
        "value": "안 겹침"
      },
      {
        "dataset": "review",
        "field": "review_id",
        "agg": "count",
        "value": 2
      }
    ],
    "summary": "소재를 말한 리뷰 2건이 상세의 울 100% 와 어긋납니다. 반품 사유는 단순변심이고 대응표가 그 짝을 안 겹침으로 두어 소재 표기 쪽으로 걸립니다.",
    "hedge": "촉감으로 적은 리뷰라 실제 혼용률은 판매자가 소싱처 라벨로 확인해야 갈라집니다."
  },
  {
    "product_id": "PRD-10577",
    "product_name": "숏패딩",
    "verdict": "반품 사유와 겹침",
    "complaint_review_count": 2,
    "return_rate_pct": 8.4,
    "peer_return_rate_pct": 3.1,
    "fix_line": "상세 색상 '카키(밝은 올리브)' 를 실제 촬영본 색으로 바꾸고 조명 안내를 답니다",
    "evidence": [
      {
        "dataset": "review",
        "field": "complaint_tag",
        "value": "색상"
      },
      {
        "dataset": "order_return",
        "field": "return_reason",
        "value": "색상"
      },
      {
        "dataset": "tag_map",
        "field": "overlap",
        "value": "겹침"
      },
      {
        "dataset": "order_return",
        "field": "return_count",
        "value": 21
      },
      {
        "dataset": "order_return",
        "field": "order_count",
        "value": 250
      },
      {
        "dataset": "review",
        "field": "claimed_value",
        "value": "어두운 카키"
      }
    ],
    "summary": "리뷰 불만도 색상, 반품 사유도 색상이라 대응표가 두 갈래를 겹침으로 잇고, 반품률 8.4%가 같은 아우터 평균 3.1%의 두 배를 넘습니다. 고쳐서 되돌아오는 금액이 가장 큰 상품이라 먼저 손댑니다.",
    "hedge": null
  }
]

[자동 검증 · 코드가 판정합니다] 1. verdict 가 enum 여섯 값(표기 맞음·치수 표기 어긋남·배송일 표기 초과·목록에 없는 옵션·소재·색상 표기와 다름·반품 사유와 겹침) 중 하나인지 확인합니다. 판정은 대조 규칙이 정하므로 모델이 다른 값을 쓰면 그 응답을 버립니다. 2. product_id·product_name·verdict·evidence·summary 다섯 필드가 모두 있는지 확인합니다. 3. return_rate_pct 와 peer_return_rate_pct 가 0 이상 100 이하인지, complaint_review_count 가 0 이상인지 범위를 확인합니다. 4. return_rate_pct 를 order_return.return_count ÷ order_count × 100 으로 다시 계산해 값이 같은지 확인합니다. 반올림은 소수 둘째 자리에서 하고 딱 절반이면 위로 올립니다. 5. peer_return_rate_pct 는 같은 category 의 다른 상품 반품률을 **반올림하지 않은 값 그대로** 평균 낸 뒤, 그 평균만 소수 한 자리로 반올림합니다. 상품마다 먼저 반올림하고 평균을 내면 아우터 평균이 3.1 이 아니라 3.0 이 나와 같은 데이터에서 판정이 갈립니다. 6. evidence 의 field 가 review·product_detail·order_return·tag_map 에 실재하는 컬럼 이름인지 대조합니다. 없는 이름을 인용하면 수정 문구가 지어낸 문장이라는 뜻이라 규칙이 만든 기본 문구로 되돌립니다. 7. agg 가 없는 evidence 값이 그 컬럼에 실제로 수록된 값과 같은지 대조합니다. 여러 리뷰에서 센 수치에는 agg 를 함께 적습니다. 8. summary 와 fix_line 이 존댓말로 끝나는 한국어 문장인지 확인합니다. 9. review.delivered_days 가 비어 있으면 그 리뷰는 배송일 판정의 분모에서 뺍니다. RV-88288 이 조건이 성립한 경우이고, 같은 상품의 RV-88259 는 받은 날이 적혀 있어 성립하지 않은 경우입니다. 10. product_detail.size_table 이 비어 있으면 그 상품의 치수 판정을 건너뜁니다. PRD-10631 이 조건이 성립한 경우이고, PRD-10412 는 치수표가 있어 성립하지 않은 경우입니다. 11. 같은 category 에 다른 상품이 없으면 peer_return_rate_pct 를 비우고 반품 사유 판정을 건너뜁니다. 잡화가 하나뿐인 PRD-10631 과 상의가 하나뿐인 PRD-10488 이 성립한 경우이고, 아우터 셋이 함께 있는 PRD-10577 은 성립하지 않은 경우입니다. 12. 판정 순서는 목록에 없는 옵션, 반품 사유와 겹침, 치수 표기 어긋남, 배송일 표기 초과, 소재·색상 표기와 다름, 표기 맞음 순으로 앞에서 걸리면 뒤를 보지 않습니다. 되돌아오는 금액이 큰 쪽을 앞에 둔 순서입니다. 13. 갈래마다 걸리는 조건과 complaint_review_count 가 세는 대상은 아래와 같습니다. · 목록에 없는 옵션 — option_name 이 그 상품 option_list 에 없는 리뷰가 1건이라도 있으면 걸리고, 그런 리뷰 수를 셉니다. · 반품 사유와 겹침 — 그 상품 리뷰의 complaint_tag 최빈값과 order_return.return_reason 을 tag_map 에서 찾아 overlap 이 「겹침」이고, return_rate_pct 가 peer_return_rate_pct 의 두 배를 넘을 때 걸립니다. 최빈값이 동수면 tag_map 에 먼저 실린 갈래를 씁니다. peer 가 비어 있으면 이 갈래는 건너뜁니다. 그 최빈 갈래로 달린 리뷰 수를 셉니다. · 치수 표기 어긋남 — complaint_tag 가 치수인 리뷰의 claimed_value 에서 부위 이름과 숫자를 뽑고, option_name 의 「/」 뒤 사이즈 키로 size_table 의 같은 사이즈·같은 부위 값과 견줍니다. 값이 다른 리뷰가 3건을 넘을 때 걸리고, 그런 리뷰 수를 셉니다. 사이즈 키가 size_table 에 없는 리뷰는 건너뜁니다. · 배송일 표기 초과 — delivered_days 가 적힌 리뷰 가운데 product_detail.delivery_days 를 넘긴 리뷰가 절반을 넘을 때 걸리고, 넘긴 리뷰 수를 셉니다. · 소재·색상 표기와 다름 — complaint_tag 가 소재 또는 색상인 리뷰가 2건 이상일 때 걸리고, 그 리뷰 수를 셉니다. · 표기 맞음 — 위 다섯 갈래에 하나도 걸리지 않은 상품이며 complaint_review_count 는 0 입니다. 14. fix_line 의 치수 값은 옵션(사이즈)별로 따로 냅니다. 같은 사이즈 리뷰의 실측값 중앙값을 쓰고, 리뷰가 짝수 건이면 가운데 두 값의 평균을 소수 한 자리로 적습니다. 사이즈를 섞어 한 값으로 내면 상세의 어느 줄을 고칠지가 다시 흐려집니다. [평가 러너 · 2주차] 1. 판매자가 손으로 정한 60건으로 판정 일치율을 냅니다. 어긋난 건은 치수 파싱에서 갈라졌는지 반품률 계산에서 갈라졌는지 나눠 리포트에 답니다. [수동 검증 · 사람이 봅니다] 1. 치수 표기 어긋남으로 뜬 상품을 판매자가 실제로 다시 재는지 표본 20건을 따라가 봅니다. 리뷰의 실측값은 재는 자리가 사람마다 달라 상세보다 넓게 나오기도 합니다. 2. tag_map 의 짝을 분기마다 판매자와 다시 봅니다. 포장 불만을 불량 반품으로 볼지 따로 둘지는 몰의 반품 정책에 따라 갈립니다. 3. 배송일 표기를 늘리는 것이 판매에 어떤 영향을 주는지 판매자에게 듣고 판정 기준을 조정할지 정합니다.