Модуль:PlayerStats/doc: различия между версиями

{{Doc/begin|{{FULLPAGENAME}}}}{{Docpage}}<includeonly>{{Docpage/для модулей}}</includeonly>

[[Module:PlayerStats]] — это центральный контроллер (точка входа) для генерации полной личной страницы игрока [[ЧТМ]]. Модуль собирает абсолютно всю статистику по игроку за все годы, высчитывает достижения, [[Индивидуальные рекорды ЧТМ|рекорды]], [[мегарейтинг]], медали, строит навигационные шаблоны и хронологию матчей.

Главное достижение системы — скорость работы. Вместо того чтобы каждый блок (таблицы, медали, рекорды) заново перебирал базу данных, система делает один-единственный проход по [[Модуль:Data|базам данных]] всех лет через движок {{Модуль|StatEngine/Pure}} (Харвестер). Все данные кэшируются в гигантский словарь <code>GrandStats</code>, откуда интерфейсные модули мгновенно забирают нужные цифры.

 

<syntaxhighlight lang="wikitext">

Или с указанием параметров:

<syntaxhighlight lang="wikitext">

-->|achievements=no<!-- Вычислять и показывать ли блок «Достижения и Рекорды» (по умолчанию-yes)<!--  

-->|main_table=no<!-- Отключает расчёт и вывод таблицы статистики (по умолчанию — yes)

-->|navboxes=no<!-- Отключает расчёт и вывод навигационных шаблонов (по умолчанию — yes)

-->|achievements =  

   |main_table  =  

   |sortable    =  

   |medals      =  

   |matches_list =  

   |matches_link =  

   |navboxes    =  

== Архитектура системы ==

Система разделена на независимые слои, как в классическом MVC (Model-View-Controller).

; Слой 1: Базы Данных (Data)

*   [[Module:Data/2006]] ... [[Module:Data/2046]]: Сырые массивы матчей. Никакой логики, только факты (кто играл, кто забил, минуты, пенальти).

*  [[Module:Data/Teams]]: Справочник команд (коды, полные названия, падежи).

; Слой 2: Настройки и Правила (Config)

*   [[Module:Config]]: Мозг проекта. Здесь лежат списки годов, массивы чемпионов, цвета для таблиц, параметры эпох (с какого года считается статистика), а также «Костыли» (ручные корректировки вроде +11 к полезности для отдельного матча).

; Слой 3: Вычислительные движки (Engines)

*   [[Module:StatEngine/Pure]] (Харвестер): Математик. Берет сырые базы и перемалывает их в готовую статистику (голы, мега-трики, матчи на ноль). Ничего не знает про интерфейс.

*   [[Module:StatEngine/TournamentAwards]]: Логика судейства (кто получил [[Башмак]], кто [[MVP игрового дня]], как разрешать равенство очков).

*   [[Module:Megarating]]: Сложный калькулятор [[мегарейтинг]]а по формулам ЧТМ (награждение очками, тайбрейкеры).

; Слой 4: Контроллер (PlayerStats)

Сам [[Module:PlayerStats]]. Его задачи по порядку:

# Подгрузить все БД.

# Прогнать всё через Харвестер и получить <code>GrandStats</code>.

# Применить ручные добавки из <code>Config.award_adjustments</code>.

# Сделать линейный проход по плоскому списку матчей <code>flat_matches</code> для расчёта последовательностей (серии побед, паузы между матчами, сухие серии) с помощью <code>StreaksCore</code>.

*  [[Module:Автоматическая статистика]]: Рисует таблицу по годам и сворачиваемый список матчей.

Поскольку система написана модульно, вам почти никогда не придется лезть в математику (`StatEngine`) или в контроллер (`PlayerStats`). Все изменения делаются в конфигурациях.

<markdown>### Как добавить новый турнир (например, ЧТМ-2050):

1. Создайте модуль **`Module:Data/2050`** и заливайте туда матчи.

2. Откройте **`Module:Config`**:

3. **ВСЁ.** Система автоматически начнет считать статистику 2050 года, добавит новые колонки в таблицы и обновит все медали и мегарейтинг.

### Как скорректировать статистику (например, забытые голы или полезность):

1. Зайдите в **`Module:Config`**.

2. В массиве `Config.metrics` найдите нужный показатель (например, `clearances` или `head_goals`).

<markdown>Модуль `PlayerStats` сам подхватит эти цифры, плюсанет их в общую историю и в конкретный год.

### Что делать, если появляется новый показатель?

1. В `StatEngine/Pure` в `create_empty_stats` добавьте поле `center_goals = 0`.

2. Там же в `extract_goals` пропишите `if goal.goal_type == "с центра" then p.goals.center_goals = ... end`.

3. В `Config` в `Config.metrics` создайте словарь `["center_goals"]`.

4. В `Module:Автоматическая статистика` добавьте строчку в `p.row_defs`.</markdown>

<includeonly>''Пожалуйста, добавляйте категории на страницу [[/doc|документации]]''.</includeonly>{{Doc/end}}