Predefinição:EstatisticasTemporada/doc
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
---
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/PartidasMó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_contasã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
- Módulo:Temporada/Estatisticas
- Módulo:Temporada/Partidas
- Módulo:Temporada/Utils
- Predefinição:Infortemporada
- Predefinição:CampanhaTemporada
---
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