MafgameStat — репозиторий турнирного сайта (методология)
Самодокументирующий README для GitHub. Полная внутренняя версия: ../МЕТОДОЛОГИЯ_new_ce634_v1.0.md.
Обновлять при существенных изменениях. Эталон «new»/мобильной версии — ce634.html.
Что это
Статический сайт статистики мафия-турниров. Без сборки (no build): чистые HTML+CSS+JS. Прод — Vercel (mafgamestat.vercel.app). Каждый турнир имеет id (напр. 634 = Чемпионат Европы 2026).
Два вида страниц турнира:
- Классика — набор страниц (
tournament.html, participants.html, seating{id}.html, cards{id}.html, standings.html, results.html, roles.html, player.html). Десктоп-ориентированы.
- «new» / мобильная — единый SPA
ce{id}.html (эталон ce634.html). Мобайл-фёрст, esports-раскладка, всё в одном файле поверх ТЕХ ЖЕ данных.
Структура репозитория (site/)
index.html хаб турниров (список, статусы, постеры)
tournament.html страница турнира (?t=id) — меню разделов классики
participants.html состав + рейтинг markery (универсальная, ?t=id)
seating{id}.html интерактивная рассадка (классика)
cards{id}.html карточки игроков (классика)
standings.html сводная (?t=id) · roles.html (?t=id) · results.html · player.html
ce{id}.html «new»/мобильная версия (эталон ce634.html)
data/
tournaments.js РЕЕСТР всех турниров (статусы, постеры, accent, разделы, порядок)
live.js LIVE-движок: тянет игры с mafgame через прокси /mafgame/*, парсит, защищает снимок
streams.js ссылки на трансляции
tournament_{id}.json мета турнира (in_progress, games_total, prize_eur, stars, accent, referees, format)
participants_{id}.json ростер + рейтинг markery (nick,uid,real,av,status,markery_id,ms,r_tier,r_elo_cur,r_elo_2026,r_rank_eu_2026)
avatars_{id}.json {avatars:{nick:url}, judges:{"1":{name,tg,avatar},...}}
elo_{id}.json {players:{nick:{global,tournaments}}}
skip_{id}.json {nick: номер игры отдыха}
games_{id}_current.json {games:[{title,stage,tables:[{table_num,judge,winner,seats:[{seat,name,role,marker,aps,wpts,ci,result}]}]}]}
_snapshots/ снимки рейтинга markery по датам
assets/ постеры (bonn{id}.jpg — широкий, bonn{id}_card.jpg — 16:9 для hero), фавикон
vercel.json rewrite /mafgame/:path* -> https://mafgame.org/:path* (прокси для live)
Поток данных
- Реестр
tournaments.js (window.TOURNAMENTS_DB.tournaments[]) — что за турниры, статусы, постеры, accent, разделы.
- По каждому турниру — JSON-файлы в
data/ (см. выше).
- Live: если
tournament_{id}.json.in_progress===true, live.js loadGames(id) при каждом открытии тянет /mafgame/tournaments/{id}/game_results (Vercel проксирует на mafgame.org), парсит Inertia-данные (convertInertia), сравнивает с сохранённым в localStorage снимком и не затирает хорошие данные пустыми (snapScore/notRegression). До старта / для завершённых — отдаёт локальный games_{id}_current.json.
- Победитель стола — из официального поля
results mafgame (red_win/black_win), не из очков.
Источники: mafgame.org (ростер uid, протоколы, рассадка, результаты — HTML Inertia), markery.online (ELO/тиры/места — ведём через Excel-базу, снимок в _snapshots/), mafiastats.com (REST, сверка).
Формулы
- Σ (итог игрока) = WPTS + доп(aps) + Ci по сыгранным играм.
- доп(aps) может быть отрицательным (штраф). «доп+»=сумма плюсов, «доп−»=сумма минусов, «доп-всего»=aps+ci.
- Роли: Citizen(Мирный), Sheriff(Шериф) — красные; Mafia, Don — чёрные. К+Ш=красные, Ч+Д=чёрные.
- «убит 1-й ночью»: seat.marker==='first_killed'. Результат: result==='W'/'L'.
«new»/ce634 — архитектура (детали в шапке ce634.html)
Загрузчик → объект D → computeSeating()+computeStats() → NAV (4 группы) строит sidebar(desktop)/tabbar(mobile) → RENDER[section]()+afterRender().
- Мобильный режим:
@media(max-width:1024px) (ловит и раскрытый Fold). Таб-бар снизу, всплывающее меню, тумблер Компактно/Подробно, залипший ник.
statFull (Компактно/Подробно), myPlayer+viewMode (localStorage), демо-режим (makeDemo — полный случайный бракет для проверки статы до старта).
Жизненный цикл турнира и статусы
Статус задаётся в tournaments.js (status) + флаг in_progress в tournament_{id}.json. Порядок на главной — поле phase.
- gathering (собирается) — идёт регистрация, состав НЕ финализирован, рассадки нет.
status:"gathering", phase:4, in_progress:false. Показываем анонс/заявки.
- upcoming (скоро) — финальный состав и рассадка готовы (квалификация посеяна), турнир ещё не начался.
status:"upcoming", phase:3. Доступны рассадка/карточки/участники; игр ещё нет. in_progress:false до дня старта.
- live (идёт) — дни турнира. Состав считаем финальным и тянем игры с mafgame:
tournament_{id}.json.in_progress:true, status:"live", phase:2. live.js при каждом открытии подтягивает game_results через прокси.
- ⚠️ Тянуть только в дни турнира. НЕ держать
in_progress:true постоянно (лишняя нагрузка на mafgame + риск подтянуть кривое/пустое). Включаем на дни турнира, после — выключаем.
- finished (завершён → архив) — после окончания.
in_progress:false, status:"finished", phase:1. Данные заморожены, турнир уходит в архив (главная сортирует по дате start).
Как ЗАКРЫВАТЬ турнир (заморозка + сверка 1:1 с mafgame)
- Снять с mafgame официальную итоговую таблицу (Result Table: Финал + Полуфинал + Квалификация + награды/MVP).
- Вставить её 1-в-1 в
tournament_{id}.json → standings (total/final/qualification), awards, чемпион/подиум. Сверить с сайтом mafgame до цента — итог и расшифровка обязаны биться.
- Заморозить протоколы
games_{id}_current.json (роли, очки, победители столов) как есть на конец турнира.
- Переключить:
tournament_{id}.json.in_progress:false; в tournaments.js status:"finished", phase:1.
- ⚠️ Брать ОФИЦИАЛЬНУЮ таблицу mafgame, НЕ пересчитывать самим. Урок (v10.1 Кёльн-702, уточнён в v14.1 на CEC-694 и ЧЕ-634): в официальную таблицу баллы финальных игр входят с коэффициентом ×1.3, причём на ВСЁ (WPTS, допы, штрафы, лучший ход, Ci); полуфинал — без коэффициента. В протоколах game_results лежат сырые баллы, поэтому live-таблица финала занижала Σ. Решение:
tournament_{id}.json.final_coef (напр. 1.3) — live.js (v2.1) умножает баллы стадии «Финал» на лету, а при заморозке коэффициент вшивается в games_{id}_current.json. Сверка 694: квалификация 30/30 и финал 10/10 — 1:1. Для завершённых источник истины — всё равно таблица mafgame.
- Задеплоить новую версию.
Как добавить НОВЫЙ турнир (чек-лист)
- Собрать
data/*_{newid}* (participants/tournament/avatars/elo/skip/games_current) по схемам выше. Добавить запись в tournaments.js.
- Копия
ce634.html → ce{newid}.html, заменить 634→{newid}, тексты (название/город/даты), START-дату, постер assets/*_card.jpg (16:9).
- Поправить стадии в
stagesPanel() и группировку селектора игр (День/стадии) под реальный формат. Число игр — из данных, не хардкод.
- Кнопку-переключатель на классической
tournament.html?t={newid} (условие по t.id).
- QA: jsdom 0 ошибок (проверять КЛИКАМИ); демо-бракет; мобильный визуал — на телефоне через превью.
- Zip → залить (см. Деплой).
Деплой
cd site
zip -r ../Uploaded/mafgamestat_vN_upload.zip . \
-x "_Архив/*" -x "data/_snapshots/*" -x "SPEC.md" -x "*.DS_Store" -x "*.bak" -x "* *"
→ содержимое залить в GitHub (github.com/ValeriiScz/bitvachempionov2026) → Vercel автодеплой. Zip кладёт содержимое site/ в корень (без префикса). Перед сборкой zip: поднять CACHE_VERSION в sw.js (иначе у установивших PWA код обновится только со 2-го открытия).
Грабли (важно)
- «Сайт мелкий на телефоне, локальный HTML — ок» = в Chrome включён режим «Версия для ПК» для домена (рендер в ~980px + ужатие). Это НЕ код — снять галочку в браузере. Проверять ПЕРВЫМ. (PWA-обёртка это лечит навсегда, см. ниже.)
.seatgrid/сетки: repeat(N,minmax(0,1fr)) + min-width:0 — иначе min-content колонок вылезает.- Sticky-колонки на подсвеченной строке — фон делать НЕПРОЗРАЧНЫМ, иначе цифры просвечивают при скролле.
- Не ломать защиту снимка в
live.js (localStorage snapScore/notRegression) — она бережёт данные при глюках mafgame.
- Версионирование строго инкрементом; старое →
_Архив/.
QA — что можно и нельзя автоматически
- Можно:
node --check / jsdom-прогон (проверять кликами, не только вызовом функций), баланс {} в CSS, десктоп-скриншот.
- Нельзя: отрендерить реальную мобильную ширину в CI/песочнице (headless-браузер недоступен). Мобильный визуал — на устройстве.
Мобильное приложение (PWA) — реализовано (v12)
Сайт устанавливается как приложение: manifest.json (standalone, палитра Bonn) + sw.js (service worker) + иконки assets/icons/ (эмблема mafgame внутри чемпионского кубка, золото на navy; any/maskable 192/512 + apple-touch-icon 180) + PWA-блок в <head> всех страниц (манифест, theme-color, iOS-меты, регистрация SW — только по http(s), локальный file:// просмотр не падает) + промо-плашка установки на всех страницах: iPhone — инструкция Safari→«На экран “Домой”», Android — кнопка «Установить» (beforeinstallprompt) или инструкция про меню Chrome; не показывается внутри установленного приложения и 14 дней после «Позже» (localStorage mgs_pwa_promo_hide_until).
Стратегии кэша (sw.js):
/mafgame/* — только сеть (кэш обходится): live всегда свежий, защита снимка в live.js не задета;data/*.json — network-first (офлайн — из кэша);- оболочка (html/js/иконки/шрифты) — stale-while-revalidate: мгновенно из кэша + фоновое обновление (код не «залипает» даже без bump).
⚠️ При каждом деплое поднять CACHE_VERSION в sw.js (…-v12.1, …-v13) — на activate старые кэши удаляются. Установка: iPhone — Safari → Поделиться → «На экран "Домой"»; Android — Chrome → меню ⋮ → «Установить приложение». Полноэкранный standalone-запуск заодно навсегда лечит баг «Версии для ПК».
Нативное приложение (Swift/Kotlin) — избыточно: та же зависимость от mafgame, магазины, поддержка.
