Как мы строим каждую статистику

Всё, что мы показываем, происходит из трёх источников, которые мы держим аудируемыми: публичный API Supercell (developer.brawlstars.com), CDN Brawlify (cdn.brawlify.com) и наша собственная база Supabase, в которой персистируются бои и агрегаты, не раскрываемые официальным API дальше последних 25 матчей на игрока.

API Supercell — каноничный источник структурных данных: бойцов, гаджетов, star powers, гиперзарядов, шестерёнок и ротации событий. Однако оно не возвращает картинки бойцов, редкость и длинные описания. Эти поля мы сверяем с CDN Brawlify, который работает независимо и иногда отстаёт от Supercell на один-три дня. Когда в API появляется новый боец, которого ещё нет в Brawlify, мы держим локальную карту редкости (BRAWLER_RARITY_MAP), чтобы страница бойца корректно отрисовывалась в день релиза.

Наша база хранит два класса записей в meta_stats: source=user (реальные бои премиум-пользователей с включённой синхронизацией) и source=global (автоматический сэмплинг из топ-рейтингов PRO). Любая публичная статистика на сайте считается с фильтром source=global, чтобы личные данные никогда не утекали на публичные страницы.

Слой "PRO" в BrawlVision — это агрегаты, посчитанные на свежих боях лучших игроков мира. Каждые шесть часов cron-задача (meta-poll) опрашивает официальные рейтинги Supercell по одиннадцати странам — там, где сосредоточена соревновательная активность — и строит дедуплицированный пул примерно из 2 100 уникальных игроков из топ-200 каждой страны.

Над этим пулом применяется вероятностный сэмплер, чтобы популярные комбинации (карта, режим) не доминировали в датасете и не маскировали редкие. Вероятность принять отдельный бой — p = min(1, (minLive + 1) / (current + 1)), где minLive — счётчик наименее представленной комбинации, а current — счётчик комбинации кандидата. Недосэмплированные комбинации получают больший вес, насыщенные перестают расти.

Cron итерирует до META_POLL_MAX_DEPTH = 1 000 игроков за запуск с мягким бюджетом 270 секунд, чтобы оставаться в пределах maxDuration 300 с serverless-функции. Каждый ответ содержит блок "adaptive" с диагностикой: число итераций, опрошенных игроков, счётчики по режимам — чтобы аномалии сэмплера были видны в продакшене.

Наивный Win Rate (победы / матчи) обманчив на малых выборках: боец 3-0 на новой карте показывает "100 % WR", и это ничего не значит. BrawlVision применяет байесовское сглаживание для коррекции и возвращает число, сравнимое между бойцами с очень разными размерами выборки.

Формула: WR_bayesian = (wins + α) / (battles + α + β), где α и β — гиперпараметры, кодирующие предварительное убеждение, центрированное на 50 % WR. На практике α = β = 25, что эквивалентно "предположить 50 предыдущих боёв 50/50 до того, как видны реальные данные". Боец с 3 победами и 0 поражениями из наивных 100 % переходит к (3 + 25) / (3 + 50) = 52,8 %, гораздо ближе к реальному состоянию выборки.

По мере роста выборки вес priora падает: при 1 000 боях и 530 победах байесовский WR становится (530 + 25) / (1 000 + 50) = 52,9 %, практически идентично наивным 53,0 %. Сглаживание "бьёт" только тогда, когда выборка действительно мала. Это и есть нужное свойство: штрафовать шум, а не сигнал.

Comfort Score — собственная метрика BrawlVision, отвечающая на вопрос "с каким бойцом ты на самом деле играешь лучше среднего?". Это не чистый Win Rate: он сочетает три компонента с весами 60/30/10, покрывая разные стороны личной формы.

Главный компонент (60 %) — WR игрока с этим бойцом, сглаженный байесовски как и глобальный мета, чтобы редко играемый боец не искажал ранг. Средний компонент (30 %) — разница между этим личным WR и общим мета-WR бойца: игрок с 55 % на SHELLY при глобальном мета 48 % набирает больше comfort, чем игрок с 55 % на бойце с мета 53 %, потому что относительный лифт выше.

Финальный компонент (10 %) — нормализованная частота использования: при прочих равных играть бойца 100 раз весит больше, чем 10, потому что постоянство вознаграждается. Точные формулы и веса живут в src/lib/analytics/compute.ts и применяются одинаково на каждом вызове эндпоинта, чтобы ранг был воспроизводим.

У каждого публичного бойца есть индикатор тренда "+X,Y%" или "−X,Y%", показывающий, как изменился его мета-WR за последние 7 дней по сравнению с предыдущими 7 (всего окно 14 дней). Расчёт идёт на source=global с минимумом MIN_BATTLES_PER_TREND_WINDOW = 3 боя в каждой половине окна — если одна из половин ниже порога, мы возвращаем null, и UI скрывает стрелку, не выдумывая слабый сигнал.

Тренд предрасчитывается каждые шесть часов в маленькой таблице (public.brawler_trends, одна строка на бойца) задачей pg_cron. Делать это в БД, а не в ответе эндпоинта, позволяет не сканировать десятки тысяч строк 14-дневного среза при каждом ISR-обновлении. Если предрасчитанная таблица старше 12 часов или пуста, эндпоинт переходит на пагинированный inline-маршрут поверх meta_stats, возвращающий тот же ответ ценой большей задержки. Пагинация нужна, потому что PostgREST молча обрезает непагинированные запросы до 1 000 строк — что однажды заставило большинство бойцов отдавать null по ложной недосемплированности.

Логика дублирована by design: TypeScript-версия в src/lib/brawler-detail/trend.ts (маршрут детали) и SQL-версия в supabase/migrations/022_*.sql (массовый маршрут). Обе используют один и тот же порог, окно и фильтр source=global. Если они разойдутся, страница бойца и агрегатная страница покажут разные числа для одного и того же бойца, поэтому любое изменение применяется к обеим.

Как часто данные обновляются — влияет на интерпретацию, поэтому мы документируем явно. Статичные страницы (включая эту) используют ISR (Incremental Static Regeneration) с ревалидацией раз в 24 часа. Страницы с динамическими данными кэшируют ответ API, пока соответствующая задача не инвалидирует его.

Бойцы, гаджеты и star powers синхронизируются с API Supercell с серверным кэшем 24 часа. Meta-poll (PRO-данные) запускается каждые 6 часов и пишет свежие строки в meta_stats. Предрасчёт 7-дневных трендов запускается в pg_cron на "17 */6 * * *" (минута 17 каждых шести часов), чтобы не сталкиваться с meta-poll. Внутриигровая ротация событий обновляется каждые 30 минут.

Отдельные бои премиум-пользователей с включённой синхронизацией скачиваются сразу после каждой партии в скользящем окне через cron sync. Попадая в нашу базу, они подпитывают meta_stats с source=user и являются основой приватной аналитики в разделе профиля; они никогда не появляются в публичных агрегатах и никогда не смешиваются с source=global.