Predefinição:EstatisticasTemporada/doc

De Clube Atletico Mineiro - Enciclopedia Galo Digital
Ir para navegação Ir para pesquisar

Predefinição:Documentação de predefinição

Predefinição:EstatisticasTemporada

A Predefinição:EstatisticasTemporada exibe automaticamente as estatísticas gerais de uma temporada do Clube Atlético Mineiro no projeto Wiki Galo Digital.

Ela funciona exclusivamente como camada de apresentação, consumindo dados calculados dinamicamente pelos módulos Lua responsáveis pelo processamento das partidas da temporada.

---

Escopo e finalidade

Esta predefinição tem como finalidade:

  • Exibir estatísticas gerais da temporada
  • Apresentar recortes de desempenho:
    • Total
    • Mandante
    • Visitante
  • Garantir padronização visual das estatísticas
  • Evitar qualquer cálculo manual em wikitexto

Predefinição:Aviso

---

Arquitetura e dependências

A predefinição depende diretamente do módulo:

  • Módulo:Temporada/Estatisticas

Esse módulo, por sua vez, utiliza:

  • Módulo:Temporada/Partidas
  • Módulo:Temporada/Utils

E consome os dados registrados em:

  • Módulo:Temporada/Dados/ANO

---

Uso

Exemplo de uso básico:

{{EstatisticasTemporada
 | ano = 1919
}}

O parâmetro ano é obrigatório e deve corresponder a um ano com dados cadastrados.

---

Parâmetros

Parâmetro Obrigatório Descrição
ano Sim Ano da temporada a ser processada

---

Estatísticas exibidas

A tabela gerada apresenta os seguintes indicadores:

  • Jogos disputados
  • Vitórias
  • Empates
  • Derrotas
  • Gols pró
  • Gols contra
  • Saldo de gols
  • Aproveitamento percentual

Os dados são apresentados com separação por:

  • Total
  • Mandante
  • Visitante

---

Regras de cálculo aplicadas

As seguintes regras são aplicadas pelo módulo Lua:

  • Partidas anuladas são ignoradas
  • Partidas marcadas como nao_conta são ignoradas
  • Aproveitamento calculado apenas quando há jogos registrados
  • Pontuação padrão 3-1-0

---

Boas práticas editoriais

  • Utilizar esta predefinição apenas em páginas de temporada
  • Não inserir lógica estatística no template
  • Não alterar cálculos via wikitexto
  • Alterações visuais devem ser feitas via CSS
  • Alterações de cálculo devem ser feitas apenas nos módulos Lua

---

Erros comuns

  • Ano inexistente ou sem dados cadastrados
  • Uso fora do contexto de temporada
  • Tentativa de inserir valores manuais de estatística

---

Páginas relacionadas

---

Histórico

  • Predefinição criada na Etapa 3.2 do Checklist Mestre de Automação das Temporadas
  • Integrada ao sistema automatizado via Scribunto
  • Parte do núcleo estatístico das páginas de temporada