고객사 앱 이벤트가 SCI 규격과 어긋나는지 알려줍니다.

{"type":"object","properties":{"verdict_no":{"type":"string"},"app_id":{"type":"string"},"event_name":{"type":"string"},"param_key":{"type":["string","null"]},"collect_no":{"type":["string","null"]},"spec_no":{"type":["string","null"]},"verdict":{"type":"string","enum":["규격과 맞음","필수 파라미터가 빠짐","값 형식이 다름","규격에 없는 이벤트","SDK 버전이 낮음"]},"expected_type":{"type":["string","null"]},"sdk_rank":{"type":["integer","null"],"description":"client_events.sdk_ver 를 점으로 끊어 앞자리부터 major×1000000 + minor×1000 + patch 로 더한 값입니다. 세 자리로 안 읽히면 null 입니다"},"min_sdk_rank":{"type":["integer","null"],"description":"sci_event_spec.min_sdk_ver 를 같은 식으로 더한 값입니다. 규격에 없는 이벤트이면 null 입니다"},"evidence":{"type":"array","items":{"type":"object","properties":{"table":{"type":"string","enum":["client_events","sci_event_spec"]},"field":{"type":"string"},"agg":{"type":["string","null"]},"value":{}},"required":["table","field","value"]}},"summary":{"type":"string"},"hedge":{"type":["string","null"]}},"required":["verdict_no","app_id","event_name","verdict","evidence","summary"]}

[
  {
    "verdict_no": "EV-001",
    "app_id": "kr.co.bank.smart",
    "event_name": "purchase",
    "param_key": "amount",
    "collect_no": "CE-001",
    "spec_no": "ES-001",
    "verdict": "값 형식이 다름",
    "expected_type": "number",
    "sdk_rank": 8001000,
    "min_sdk_rank": 8000000,
    "evidence": [
      {
        "table": "client_events",
        "field": "sample_value",
        "agg": null,
        "value": "12,000원"
      },
      {
        "table": "sci_event_spec",
        "field": "value_type",
        "agg": null,
        "value": "number"
      }
    ],
    "summary": "결제 금액을 '12,000원' 처럼 통화 표시를 붙여 보내 수치로 안 읽힙니다.",
    "hedge": null
  },
  {
    "verdict_no": "EV-002",
    "app_id": "kr.co.bank.smart",
    "event_name": "sign_up",
    "param_key": "method",
    "collect_no": null,
    "spec_no": "ES-004",
    "verdict": "필수 파라미터가 빠짐",
    "expected_type": "string",
    "sdk_rank": 8001000,
    "min_sdk_rank": 7005000,
    "evidence": [
      {
        "table": "sci_event_spec",
        "field": "is_required",
        "agg": null,
        "value": true
      },
      {
        "table": "client_events",
        "field": "param_key",
        "agg": "count",
        "value": 1
      }
    ],
    "summary": "가입 이벤트에서 파라미터가 referrer 하나만 올라와 필수인 method 가 없습니다.",
    "hedge": null
  },
  {
    "verdict_no": "EV-003",
    "app_id": "kr.co.bank.smart",
    "event_name": "coupon_pressed",
    "param_key": null,
    "collect_no": "CE-005",
    "spec_no": null,
    "verdict": "규격에 없는 이벤트",
    "expected_type": null,
    "sdk_rank": 8001000,
    "min_sdk_rank": null,
    "evidence": [
      {
        "table": "client_events",
        "field": "event_name",
        "agg": null,
        "value": "coupon_pressed"
      },
      {
        "table": "sci_event_spec",
        "field": "event_name",
        "agg": "count",
        "value": 12
      }
    ],
    "summary": "쿠폰 누름 이벤트는 규격 열두 줄 어디에도 없어 WorksFM 이 읽을 자리가 없습니다.",
    "hedge": "고객사가 따로 심은 이벤트로 보이므로, 버릴지 규격에 자리를 만들지는 SCI 조직과 고객사가 정합니다."
  },
  {
    "verdict_no": "EV-004",
    "app_id": "kr.co.bank.smart",
    "event_name": "app_open",
    "param_key": "session_id",
    "collect_no": "CE-006",
    "spec_no": "ES-008",
    "verdict": "SDK 버전이 낮음",
    "expected_type": "string",
    "sdk_rank": 7002001,
    "min_sdk_rank": 8000000,
    "evidence": [
      {
        "table": "client_events",
        "field": "sdk_ver",
        "agg": null,
        "value": "7.2.1"
      },
      {
        "table": "sci_event_spec",
        "field": "min_sdk_ver",
        "agg": null,
        "value": "8.0.0"
      }
    ],
    "summary": "앱 실행 이벤트가 7.2.1 에서 올라와 규격이 요구하는 8.0.0 에 못 미칩니다.",
    "hedge": null
  },
  {
    "verdict_no": "EV-005",
    "app_id": "kr.co.bank.smart",
    "event_name": "add_to_cart",
    "param_key": "quantity",
    "collect_no": "CE-010",
    "spec_no": "ES-010",
    "verdict": "값 형식이 다름",
    "expected_type": "integer",
    "sdk_rank": 8001000,
    "min_sdk_rank": 7000000,
    "evidence": [
      {
        "table": "client_events",
        "field": "sample_value",
        "agg": null,
        "value": null
      },
      {
        "table": "sci_event_spec",
        "field": "value_type",
        "agg": null,
        "value": "integer"
      }
    ],
    "summary": "장바구니 수량 파라미터는 올라오지만 값이 늘 비어 있어 정수로 안 읽힙니다.",
    "hedge": "앱에서 값을 안 실어 보내는 것인지 수집 단계에서 떨어진 것인지는 고객사 개발자와 확인합니다."
  },
  {
    "verdict_no": "EV-006",
    "app_id": "kr.co.shop.mall",
    "event_name": "app_open",
    "param_key": "session_id",
    "collect_no": "CE-016",
    "spec_no": "ES-008",
    "verdict": "규격과 맞음",
    "expected_type": "string",
    "sdk_rank": 10000001,
    "min_sdk_rank": 8000000,
    "evidence": [
      {
        "table": "client_events",
        "field": "sdk_ver",
        "agg": null,
        "value": "10.0.1"
      },
      {
        "table": "sci_event_spec",
        "field": "min_sdk_ver",
        "agg": null,
        "value": "8.0.0"
      }
    ],
    "summary": "앱 실행 이벤트가 10.0.1 에서 올라와 8.0.0 을 넘습니다.",
    "hedge": null
  },
  {
    "verdict_no": "EV-007",
    "app_id": "kr.co.shop.mall",
    "event_name": "purchase",
    "param_key": "amount",
    "collect_no": "CE-011",
    "spec_no": "ES-001",
    "verdict": "규격과 맞음",
    "expected_type": "number",
    "sdk_rank": 8002000,
    "min_sdk_rank": 8000000,
    "evidence": [
      {
        "table": "client_events",
        "field": "sample_value",
        "agg": null,
        "value": "58000"
      },
      {
        "table": "sci_event_spec",
        "field": "value_type",
        "agg": null,
        "value": "number"
      }
    ],
    "summary": "결제 금액이 58000 으로 올라와 수치 그대로 읽힙니다.",
    "hedge": null
  }
]

[자동 검증 · 코드가 판정합니다] 1. verdict 가 규격과 맞음·필수 파라미터가 빠짐·값 형식이 다름·규격에 없는 이벤트·SDK 버전이 낮음 다섯 값 중 하나인지 확인합니다. 2. verdict_no·app_id·event_name·verdict·evidence·summary 가 모두 채워졌는지 확인합니다. 3. sdk_rank 가 sdk_ver 를 점으로 끊어 major×1000000 + minor×1000 + patch 로 더한 값과 같은지 다시 계산합니다. 자리 수가 셋이 아니면 null 인지 봅니다. 문자열로 견주면 10.0.1 이 8.0.0 보다 작게 나옵니다. 4. min_sdk_rank 가 min_sdk_ver 를 같은 식으로 더한 값과 같은지 다시 계산합니다. 규격에 없는 이벤트이면 null 인지 봅니다. 5. sdk_rank 가 0 이상 99999999 이하인지 범위를 봅니다. 6. expected_type 을 적었다면 그 값이 spec_no 가 가리키는 규격 줄의 value_type 과 같아야 합니다. 7. event_name 이 sci_event_spec.event_name 목록에 없으면 verdict 가 규격에 없는 이벤트인지 확인합니다. 8. sdk_rank 가 min_sdk_rank 보다 작으면 verdict 가 SDK 버전이 낮음인지 확인합니다. 9. sci_event_spec.is_required 가 참인 param_key 가 같은 app_id·event_name 의 client_events.param_key 에 없으면 verdict 가 필수 파라미터가 빠짐인지 확인합니다. 10. sample_value 가 value_type 으로 안 읽히면 verdict 가 값 형식이 다름인지 확인합니다. number 와 integer 는 SCI 가 숫자 그대로 받는 자리라, 통화 표시나 천 단위 쉼표가 한 글자라도 섞이면 안 읽힌 것으로 보고 떼어 내서 다시 읽지 않습니다 — '58000' 처럼 숫자만 있는 값은 읽히고, 쉼표나 '원' 이 붙은 값은 읽히지 않습니다. timestamp 는 ISO 8601 이나 밀리초 정수여야 하고, boolean 은 true·false 여야 합니다. 값이 비어 있으면 어느 형식으로도 안 읽힌 것으로 봅니다. 11. verdict 가 규격과 맞음이면 이름 대조·버전 비교·필수 확인·형식 읽기를 한 번 더 돌려 걸리는 것이 없는지 봅니다. 12. 판정 순서는 규격에 없는 이벤트, SDK 버전이 낮음, 필수 파라미터가 빠짐, 값 형식이 다름 순으로 먼저 걸리는 갈래를 씁니다. 다만 SDK 가 낮은 이벤트는 파라미터가 그 버전에서 아예 안 실리는 것이라 값 형식 검사를 돌리지 않습니다. 13. collect_no 가 있으면 client_events 에 실재하는 줄 번호이고 그 줄의 app_id·event_name 이 판정과 같은지 대조합니다. 14. spec_no 가 있으면 sci_event_spec 에 실재하는 줄 번호이고 그 줄의 event_name·param_key 가 판정과 같은지 대조합니다. 15. evidence 에 적은 field 가 client_events·sci_event_spec 에 실재하는 컬럼 이름인지 대조합니다. 16. agg 가 없는 evidence 는 그 value 가 인용한 줄의 원문 값과 글자까지 같은지 봅니다. 17. summary 는 고객사 앱 개발자에게 바로 나가는 줄이라 존댓말로 닫혀 있어야 합니다. [평가 러너 · 2주차] 1. 짝 80건을 골라 손으로 적은 사유와 도구가 낸 사유를 맞춰 일치율을 냅니다. 2. 사유별 건수를 앱마다 세어 두 앱 이상에서 되풀이되는 이벤트를 추립니다. [수동 검증 · 사람이 봅니다] 1. 값이 늘 비어 있는 파라미터를 앱이 안 실어 보내는지 수집에서 떨어지는지 고객사 개발자와 확인합니다. 2. 규격에 없는 이벤트를 버릴지 규격에 자리를 만들지 SCI 조직과 고객사가 정합니다.