Модуль:Config/doc
Это страница документации Модуль:Config.
Документация
 |
Модуль является центральным хранилищем настроек и правил. Он содержит базовые параметры, которые используются другими модулями для расчёта статистики и отображения таблиц. Изменение параметров в этом файле позволяет централизованно управлять поведением всей системы.
Структура модуля
- Единый список турниров
Перечень всех годов проведения ЧТМ, которые учитываются системой. Добавление нового года в этот список автоматически включает его во все статистические расчёты и таблицы на сайте, без необходимости вносить изменения в других местах.
- Единый стиль всех таблиц
Набор правил, определяющих внешний вид таблиц: цвета, рамки, выравнивание текста и т.д. Обеспечивает единообразное визуальное оформление всех статистических таблиц на сайте. Здесь же задана цветовая палитра для призовых мест (золото, серебро, бронза, дерево) и для выделения команд.
- Блок фильтров (белые списки стадий)
Список официальных стадий плей-офф (например, «1/8 финала», «Финал»). Позволяет системе отличать матчи основной сетки на выбывание от других игр (например, матчей за 3-е место или стыковых матчей). Это необходимо для корректного расчёта статистики, относящейся только к плей-офф.
- Блок эпох (с какого года считается статистика)
Список, который для каждого статистического показателя указывает год, с которого начался его учёт. Гарантирует, что система не будет пытаться считать те данные, которые в определённые годы ещё не собирались. Например, голы (goals) учитываются с 2006 года, а голевые передачи (assists) — только с 2026.
- Словарь показателей (для генератора таблиц)
Технический справочник. Для каждого статистического показателя (голы, автоголы, карточки) здесь прописаны правила его извлечения из базы данных. Определяет, как именно система должна рассчитывать каждый показатель, является ли он негативным («антиприз») и нужно ли применять особые корректировки.
- Набор инструментов
Вспомогательные технические функции для выполнения стандартных операций. Содержат базовые действия, такие как преобразование счёта из текста в числа, определение года турнира по ID матча или форматирование чисел для вывода.
- Универсальный радар (сканер присутствия)
Инструмент для составления полного списка участников матча. Анализирует все данные по игре (составы, голы, карточки и т.д.) и определяет каждого игрока, который принимал в ней участие. Это гарантирует, что ни один участник не будет пропущен при сборе статистики.
- Умная сортировка (универсальный тайбрейкер)
Механизм, определяющий, кто из игроков должен занять более высокое место в таблице, если их основные показатели равны. Применяет последовательный набор дополнительных правил (например, сравнивает показатели за предыдущие годы) для обеспечения однозначного ранжирования в спорных ситуациях.
- Конструктор таблиц
Инструменты для автоматической генерации HTML-кода таблиц. Содержит функции для создания заголовка, добавления строк и ячеек, что упрощает и стандартизирует процесс вывода статистических данных на страницы сайта.