모든 통계를 어떻게 만드는가

우리가 표시하는 모든 것은 감사 가능하게 유지하는 세 가지 출처에서 옵니다: Supercell 공개 API (developer.brawlstars.com), Brawlify CDN (cdn.brawlify.com), 그리고 공식 API가 플레이어당 최근 25경기 이후로는 노출하지 않는 전투와 집계를 보존하는 자체 Supabase 데이터베이스.

Supercell API는 구조 데이터(브롤러, 가젯, 스타파워, 하이퍼차지, 기어, 이벤트 로테이션)의 정식 출처이지만 브롤러 이미지, 등급, 긴 설명 같은 핵심 필드는 빠져 있습니다. 이 필드들은 독립적으로 운영되며 때때로 Supercell보다 1~3일 늦는 Brawlify CDN과 교차 참조합니다. 공식 API에 새 브롤러가 등장했지만 Brawlify에 아직 없을 때, 출시일에도 브롤러 페이지가 정확히 렌더되도록 로컬 등급 매핑(BRAWLER_RARITY_MAP)을 유지합니다.

데이터베이스는 meta_stats에 두 종류의 행을 저장합니다: source=user (동기화를 활성화한 프리미엄 사용자의 실제 전투)와 source=global (상위 PRO 랭킹의 자동 샘플링). 사이트의 모든 공개 통계는 source=global 필터로 계산되어 단일 사용자의 개인 데이터가 절대 공개 페이지로 새지 않습니다.

BrawlVision의 "PRO" 레이어는 세계 최고 플레이어들의 최근 전투에서 계산된 집계입니다. 6시간마다 cron 작업(meta-poll)이 경쟁 활동이 집중된 11개국의 Supercell 공식 랭킹을 조회하여 각 상위 200위에서 약 2,100명의 고유 플레이어로 구성된 중복 제거 풀을 만듭니다.

이 풀에 확률적 샘플러를 적용하여 인기 있는 (맵, 모드) 조합이 데이터셋을 지배하고 희귀 조합을 가리지 않도록 합니다. 개별 전투를 받아들일 확률은 p = min(1, (minLive + 1) / (current + 1))이며, minLive는 가장 적게 표현된 조합의 카운트, current는 후보 전투의 조합 카운트입니다. 과소 샘플링된 조합은 더 많은 가중치를 받고, 포화된 조합은 성장이 멈춥니다.

cron은 서버리스 함수의 300초 maxDuration 안에 머물기 위해 270초 소프트 예산으로 실행당 META_POLL_MAX_DEPTH = 1,000명의 플레이어까지 반복합니다. 각 응답은 반복 횟수, 조회된 플레이어 수, 모드별 카운트가 담긴 "adaptive" 진단 블록을 포함하여 비정상 샘플러 동작이 프로덕션에서 관찰 가능하도록 합니다.

소박한 승률(승리/매치)은 작은 표본에서 오해를 줍니다: 새 맵에서 3-0인 브롤러는 "100% 승률"을 보여주지만 의미가 없습니다. BrawlVision은 베이지안 스무딩으로 이를 보정하고 표본 크기가 매우 다른 브롤러 사이에서도 비교 가능한 숫자를 반환합니다.

공식은 WR_bayesian = (wins + α) / (battles + α + β)이며, α와 β는 50% 승률을 중심으로 하는 사전 신념을 인코딩하는 하이퍼파라미터입니다. 실제로 α = β = 25, "실제 데이터를 보기 전에 50/50의 50번 이전 전투를 가정"하는 것과 같습니다. 3승 0패의 브롤러는 소박한 100%에서 (3 + 25) / (3 + 50) = 52.8%로 이동하여 실제 샘플링 상태를 훨씬 잘 대표합니다.

표본이 커질수록 사전의 가중치는 감소합니다: 1,000 전투와 530승에서 베이지안 WR은 (530 + 25) / (1,000 + 50) = 52.9%로 소박한 53.0%와 거의 동일합니다. 스무딩은 표본이 진짜로 작을 때만 "아픕니다". 이것이 정확히 원하는 속성입니다: 신호가 아닌 노이즈를 처벌합니다.

Comfort Score는 "어떤 브롤러로 평균보다 정말 잘하는가?"라는 질문에 답하는 BrawlVision 자체 메트릭입니다. 순수한 승률이 아닙니다: 개인 성과의 다양한 차원을 포괄하기 위해 60/30/10 가중치로 세 가지 구성 요소를 결합합니다.

주요 구성 요소(60%)는 그 브롤러로의 플레이어 승률이며, 글로벌 메타와 동일하게 베이지안 스무딩을 적용해 거의 사용하지 않은 브롤러가 랭킹을 왜곡하지 않게 합니다. 중간 구성 요소(30%)는 이 개인 승률과 브롤러의 전체 메타 승률 간의 차이입니다: 글로벌 메타가 48%일 때 SHELLY로 55%인 플레이어는 메타가 53%인 브롤러로 55%인 플레이어보다 더 많은 comfort를 얻는데, 상대적 향상이 더 크기 때문입니다.

마지막 구성 요소(10%)는 정규화된 사용 빈도입니다: 다른 모든 것이 같다면 브롤러를 100번 플레이하는 것이 10번보다 더 가치가 있습니다. 일관성이 보상받기 때문입니다. 정확한 공식과 가중치는 src/lib/analytics/compute.ts에 있으며 모든 엔드포인트 호출에서 동일하게 적용되어 랭킹이 재현 가능합니다.

모든 공개 브롤러에는 메타 승률이 지난 7일 동안 이전 7일에 비해 어떻게 변했는지(총 14일 창) 보여주는 "+X.Y%" 또는 "−X.Y%" 트렌드 표시기가 있습니다. 계산은 source=global에서 창의 각 절반에 최소 MIN_BATTLES_PER_TREND_WINDOW = 3 전투로 실행됩니다 — 절반 중 하나라도 임계값에 미치지 못하면 null을 반환하고 UI는 약한 신호의 숫자를 만들어내는 대신 화살표를 숨깁니다.

트렌드는 pg_cron 작업으로 6시간마다 작은 테이블(public.brawler_trends, 브롤러당 한 행)에 미리 계산됩니다. 엔드포인트 응답이 아닌 데이터베이스에서 이렇게 하는 것은 모든 ISR 새로고침에서 14일 슬라이스의 수만 행을 스캔하는 것을 피합니다. 미리 계산된 테이블이 12시간 이상 오래되었거나 비어 있으면 엔드포인트는 더 높은 비용으로 동일한 응답을 반환하는 meta_stats의 페이지화된 인라인 경로로 떨어집니다. 페이징은 PostgREST가 페이지화되지 않은 쿼리를 1,000행으로 조용히 자르기 때문에 필요하며, 이는 한때 대부분의 브롤러가 가짜 언더샘플링으로 null을 반환하게 했습니다.

논리는 의도적으로 중복 존재합니다: src/lib/brawler-detail/trend.ts의 TypeScript 버전(상세 경로)과 supabase/migrations/022_*.sql의 SQL 버전(대량 경로). 둘 다 동일한 임계값, 동일한 창, 동일한 source=global 필터를 사용합니다. 발산하면 브롤러별 상세 페이지와 집계 페이지가 같은 브롤러에 대해 다른 숫자를 보여주게 되므로 모든 변경은 둘 다에 적용됩니다.

데이터가 얼마나 자주 새로 고쳐지는지는 해석 방식에 영향을 미치므로 명시적으로 문서화합니다. 정적 페이지(이 페이지 포함)는 24시간 재검증의 ISR(Incremental Static Regeneration)을 사용합니다. 동적 데이터가 있는 페이지는 관련 작업이 무효화할 때까지 API 응답을 캐시합니다.

브롤러, 가젯, 스타파워는 24시간 서버 캐시로 Supercell API에서 동기화됩니다. meta-poll(PRO 데이터)은 6시간마다 실행되어 새로운 meta_stats 행을 생성합니다. 7일 트렌드 사전 계산은 meta-poll과 충돌을 피하기 위해 pg_cron의 "17 */6 * * *"(매 6시간마다 17분)에서 실행됩니다. 게임 내 이벤트 로테이션은 30분마다 새로 고쳐집니다.

동기화를 활성화한 프리미엄 사용자의 개별 전투는 sync cron을 통해 슬라이딩 윈도우에서 각 매치 직후에 다운로드됩니다. 데이터베이스에 들어가면 source=user로 meta_stats를 채우고 프로필 섹션의 비공개 분석의 기반이 됩니다; 공개 집계에 절대 나타나지 않으며 source=global과 절대 섞이지 않습니다.