업종 분석 매트릭스 지표 및 상대평가 통합
ADR-295 업종 분석 매트릭스 지표 및 상대평가 통합
1. Metadata
- ADR ID: ADR-295
- Status: draft
- Date: 2026-03-11
- Owner: YSY
2. Domain Decision
- 업종 분석은 파트너 절대 성과가 아니라
업종 내 상대 성과를 기준으로 해석한다. - 상대평가 SoT는 원천 운영 테이블이 아니라 일별 집계 매트릭스 테이블로 고정한다.
- 상대평가 계산은 ADR-005 canonical 업종(
DINING/CAFE_DESSERT/BAR/BEAUTY/FITNESS/ACTIVITY/WELLNESS/ETC)별로 분리한다. - 표본수 최소 기준을 충족하지 못한 파트너는 점수 산출 대상에서 제외한다.
3. Product Decision
- 업종 분석 점수는 초기에는
참고 지표로만 노출한다. - 점수는 절대점수 1개가 아니라
지표별 점수 + 종합점수를 함께 제공한다. - 최소 노출 지표는
예약 전환, 사용 전환, 관심매장 증가율로 시작한다. - 종합점수는 가중합으로 계산하되 가중치 변경은 버전 관리한다.
- 점수는 일별 스냅샷으로 저장하며 과거 값 재현을 보장한다.
4. UX Decision
- 업종 분석 카드는
업종 평균 대비 문구를 기본으로 표시한다. - 점수는 숫자(0~100)와 백분위(%)를 함께 표시한다.
- 표본수 부족 시 점수 대신
데이터 부족 상태를 표시한다. - 점수 카드에는
산식 버전과 기준 기간을 명시한다.
5. Tech Decision
category_metrics_daily 테이블을 추가해 업종 기준선(평균/중앙값/분위수)을 저장한다.partner_category_score_daily 테이블을 추가해 파트너 상대평가 결과를 저장한다.- 점수 계산 함수
refresh_partner_category_score_daily(p_metric_date date, p_score_version text)를 제공한다. - 점수 계산은 하루 1회 배치로 실행하고 멱등 업서트로 구현한다.
- 점수 계산 시 표본수 기준(예: 최근 30일 예약 N건 이상)은 파라미터화한다.
- 점수 공식/가중치는
score_version으로 관리한다.
6. Ops Decision
- 점수 배치 성공률/지연/실패를 모니터링한다.
- 점수 버전 변경 시 재계산 범위와 롤백 절차를 런북으로 운영한다.
- 표본수 기준 변경 이력을 운영 로그로 남긴다.
- 점수 관련 파트너 문의 대응을 위한 해석 가이드를 운영 문서로 제공한다.
7. Implementation Contract (Optional)
7.1 API Contract
- 업종 분석 API는
p_partner_id, p_from, p_to, p_score_version을 입력으로 받는다. - 응답은 지표별 점수, 종합점수, 백분위, 데이터충분여부를 포함한다.
7.2 Data Contract
category_metrics_daily(category, metric_date) 유니크를 강제한다.partner_category_score_daily(partner_id, metric_date, score_version) 유니크를 강제한다.- 집계 키
category는 ADR-005 canonical 업종 값만 저장한다. - 점수 유효 범위는
0 <= score <= 100으로 강제한다.
7.3 Error/Observability Contract
- 점수 배치 로그에
score_version, sample_threshold, excluded_count를 기록한다. - 표본수 미달 파트너 수를 모니터링 지표로 수집한다.
7.4 Test/Acceptance Contract
- 동일 날짜/버전 재실행 시 중복 행이 생성되지 않아야 한다.
- 표본수 미달 파트너는 점수가 계산되지 않고
데이터 부족 상태여야 한다. - score_version 변경 시 이전 버전 결과와 구분 조회가 가능해야 한다.
8. Validation
Buy me a coffee