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

Материал из ЧТМ
Перейти к навигации Перейти к поиску
Нет описания правки
Нет описания правки
 
(не показано 7 промежуточных версий 2 участников)
Строка 3: Строка 3:


== Структура модуля ==
== Структура модуля ==
; Секция «Комбайн» (Harvester)
Основной модуль ядра, предназначенный для массовой обработки данных. За один проход анализирует всю [[Модуль:Data|базу данных]] по матчам за год и извлекает из неё всю необходимую информацию: голы, передачи, сыгранные матчи, карточки и т.д. Такой подход обеспечивает высокую скорость обработки, глобальный и самый быстрый сбор статистики.
Ядро модуля, предназначенное для массовой обработки данных. За один проход анализирует всю [[Модуль:Data|базу данных]] по матчам за год и извлекает из неё всю необходимую информацию: голы, передачи, сыгранные матчи, карточки и т.д. Такой подход обеспечивает высокую скорость обработки.


; Блок обратной совместимости
Содержит блок '''«Harvester»''' (Комбайн), который проходит по базе данных матчей ровно один раз и извлекает абсолютно всю статистику, раскладывая её по заранее созданным пустым массивам.
Набор функций, которые имитируют работу старой версии модуля. Позволяет страницам и шаблонам, которые использовали старые методы вызова, продолжать работать без изменений, но при этом использовать новый, более быстрый механизм расчётов.


; Блок агрегации игрового дня
Основные функции:
Инструмент для расчёта итоговой статистики игроков за один конкретный игровой день. Собирает все действия игроков в рамках одного игрового дня (очки, голы, MVP) и подготавливает данные для определения лучших игроков.
* Определяет, за какую команду играл человек в конкретном матче.
* Считает сыгранные матчи (в поле и на воротах).
* Суммирует все типы голов, передачи, карточки, сухие матчи, пенальти.
* Высчитывает продвинутую статистику (показатель «Плюс/Минус», ценность голов, командную статистику).


; Блок «машины дуэлей»
Создаёт три итоговых массива данных:
Функция для прямого сравнения двух игроков друг против друга. Анализирует только те матчи, в которых оба игрока играли друг против друга, и рассчитывает их личную статистику встреч. Используется как один из критериев при разрешении ничьих.
* Players — суммарная статистика по игрокам.
* Teams — статистика по командам (очки, победы, разница мячей).
* PlayerTeam — статистика конкретного игрока за конкретную команду.
* Может собирать данные как за один указанный год, так и за всю историю (циклом по всем годам).


Блок судейства и призов
== См. также ==
Набор функций для определения победителей в различных номинациях. Применяет сложные, многоуровневые правила и критерии для ранжирования игроков и присвоения призовых мест (например, «[[Лучший бомбардир игрового дня|Лучший бомбардир]]», «[[Самый полезный футболист игрового дня|Самый полезный игрок]]», «[[Лучший вратарь игрового дня|Лучший вратарь]]»).
Подстраницы модуля:
 
{{С*|global=Модуль:StatEngine|list=ul|Pure|Matchday|TournamentAwards|Legacy|RatingCalc|RatingBuilder|RatingBuilder/TournamentPoints}}
; Блок определения наград турнира
----
Специализированные функции для присуждения итоговых наград всего турнира, таких как «[[Золотой Башмак]]». Использует официальную систему правил для разрешения ничьих, учитывая не только общее количество голов, но и их важность (в плей-офф, без учёта пенальти) и хронологию.
 
; Блок тестов
Служебные функции для проверки корректности работы модуля. Позволяют разработчикам быстро выводить на тестовую страницу сводные таблицы со всеми рассчитанными показателями для проверки правильности вычислений.
<includeonly>''Пожалуйста, добавляйте категории на страницу [[/doc|документации]]''.</includeonly>{{Doc/end}}
<includeonly>''Пожалуйста, добавляйте категории на страницу [[/doc|документации]]''.</includeonly>{{Doc/end}}

Текущая версия от 00:54, 3 июня 2026

Документация Документация

Модуль является основным вычислительным блоком, отвечающим за обработку и анализ игровой статистики. Модуль использует данные о матчах и правила из Config для расчёта всех показателей игроков и команд, а также для определения победителей в различных номинациях.

Структура модуля

Основной модуль ядра, предназначенный для массовой обработки данных. За один проход анализирует всю базу данных по матчам за год и извлекает из неё всю необходимую информацию: голы, передачи, сыгранные матчи, карточки и т.д. Такой подход обеспечивает высокую скорость обработки, глобальный и самый быстрый сбор статистики.

Содержит блок «Harvester» (Комбайн), который проходит по базе данных матчей ровно один раз и извлекает абсолютно всю статистику, раскладывая её по заранее созданным пустым массивам.

Основные функции:

  • Определяет, за какую команду играл человек в конкретном матче.
  • Считает сыгранные матчи (в поле и на воротах).
  • Суммирует все типы голов, передачи, карточки, сухие матчи, пенальти.
  • Высчитывает продвинутую статистику (показатель «Плюс/Минус», ценность голов, командную статистику).

Создаёт три итоговых массива данных:

  • Players — суммарная статистика по игрокам.
  • Teams — статистика по командам (очки, победы, разница мячей).
  • PlayerTeam — статистика конкретного игрока за конкретную команду.
  • Может собирать данные как за один указанный год, так и за всю историю (циклом по всем годам).

См. также

Подстраницы модуля: