외부 고객이 원하는 지표를 말하면 어떤 데이터 상품과 필드로 답할 수 있는지 찾아주는 도구입니다.

{"type":"object","properties":{"request_id":{"type":"string"},"matched_fields":{"type":"array","items":{"type":"object","properties":{"field_id":{"type":"string"},"product_id":{"type":["string","null"]},"confidence":{"type":"number"}},"required":["field_id","product_id","confidence"]},"minItems":0},"sample_api":{"type":"object","properties":{"endpoint":{"type":"string"},"params":{"type":"array","items":{"type":"string"}}},"required":["endpoint","params"]},"access_flag":{"type":"string","enum":["ok","needs_review","denied"]},"evidence":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","enum":["request_text","field_name","description","access_tier"]},"note":{"type":"string"}},"required":["field","note"]},"minItems":1},"hedge":{"type":"string"}},"required":["request_id","matched_fields","sample_api","access_flag","evidence","hedge"]}

[
  {
    "request_id": "Q001",
    "matched_fields": [
      {
        "field_id": "F001",
        "product_id": "sales_index",
        "confidence": 0.82
      },
      {
        "field_id": "F010",
        "product_id": "sales_index",
        "confidence": 0.6
      }
    ],
    "sample_api": {
      "endpoint": "/v1/sales_index",
      "params": [
        "region_code",
        "month"
      ]
    },
    "access_flag": "ok",
    "evidence": [
      {
        "field": "description",
        "note": "'지역별 월매출' 요청에 매출지수 매핑"
      },
      {
        "field": "access_tier",
        "note": "B2B 등급이라 제공 가능"
      }
    ],
    "hedge": "confidence 는 합성 카탈로그 기준 추정이라 실제 매핑 정확도와 다를 수 있다."
  },
  {
    "request_id": "Q002",
    "matched_fields": [
      {
        "field_id": "F004",
        "product_id": null,
        "confidence": 0.55
      }
    ],
    "sample_api": {
      "endpoint": "/v1/trade_area",
      "params": [
        "card_owner_age"
      ]
    },
    "access_flag": "denied",
    "evidence": [
      {
        "field": "access_tier",
        "note": "pii·internal 필드라 외부 제공 불가"
      },
      {
        "field": "field_name",
        "note": "card_owner_age 는 개인 식별 위험"
      }
    ],
    "hedge": "권한 판정은 합성 규칙 기준이라 실 거버넌스 정책과 다를 수 있다."
  },
  {
    "request_id": "Q003",
    "matched_fields": [],
    "sample_api": {
      "endpoint": "",
      "params": []
    },
    "access_flag": "needs_review",
    "evidence": [
      {
        "field": "description",
        "note": "요청에 맞는 필드를 카탈로그에서 못 찾아 미매핑으로 알림"
      }
    ],
    "hedge": "미등록 요청이라 사람 검토 필요. 합성 기준."
  }
]

matched_fields 의 field_id·product_id 가 카탈로그에 있는지, access_flag enum, evidence min(1)은 Zod 와 카탈로그 조인으로 자동 검증한다. evidence note 가 요청·필드와 의미상 맞는지, hedge 가 합성 기준임을 밝혔는지는 judge 모델과 수동 spot-check 로 검증한다. confidence 는 합성 카탈로그 기준 추정값이라 metrics 의 정직 경계선과 일관되게 검증된 수치로 제시하지 않는다.