Módulo:Temporada/doc

``` Módulo:Temporada/doc ```

O conteúdo já está:

• Em wikitext puro.
• Com títulos, listas e blocos de código compatíveis.
• Adequado tanto para editores quanto para documentação técnica institucional.

---

Módulo:Temporada

Descrição

O Módulo:Temporada é um módulo Scribunto (Lua) responsável por processar, calcular e apresentar estatísticas automatizadas das temporadas de futebol do Clube Atlético Mineiro na Wiki Galo Digital.

Seu objetivo principal é:

• Reduzir edição manual.
• Garantir consistência histórica.
• Centralizar regras de cálculo.
• Preservar exceções históricas (W.O., jogos anulados, formatos antigos).

O módulo foi projetado para funcionar tanto em temporadas históricas quanto em temporadas modernas, sem exigir extensões adicionais como Cargo ou Wiki Semântica.

---

Princípios de funcionamento

O módulo segue os seguintes princípios editoriais e técnicos:

1. A tabela de partidas é a fonte primária dos dados

1. • Estatísticas nunca devem ser digitadas manualmente quando puderem ser calculadas.

1. Regras históricas explícitas

1. • Jogos anulados não entram em estatísticas.
   • W.O. não contam gols pró ou contra, salvo decisão editorial futura.

1. Separação entre dados e apresentação

1. • Os dados são fornecidos via parâmetros.
   • O cálculo ocorre no Lua.
   • A apresentação é gerada automaticamente.

1. Uso defensivo do Scribunto

1. • O módulo não gera erro fatal se dados estiverem incompletos.
   • Campos ausentes são ignorados de forma segura.

---

Estrutura do módulo

Atualmente, o módulo oferece a seguinte função pública:

• estatisticas - Gera um resumo estatístico geral da temporada.

Funções planejadas para evolução futura:

• Campanha por competição.
• Estatísticas por mando (mandante / visitante).
• Integração automática com Infotemporada.
• Artilharia automatizada.

---

Função: estatisticas

Finalidade

Calcula e exibe automaticamente as estatísticas gerais da temporada a partir de uma lista estruturada de jogos.

As estatísticas calculadas são:

• Jogos disputados.
• Vitórias.
• Empates.
• Derrotas.
• Gols pró.
• Gols contra.
• Aproveitamento percentual.

---

Sintaxe de uso

{{#invoke:Temporada|estatisticas
 | jogos =
   gols_pro;gols_contra;tipo
   gols_pro;gols_contra;tipo
}}

---

Parâmetro obrigatório

jogos

Lista de jogos da temporada, com um jogo por linha, no seguinte formato:

gols_pro ; gols_contra ; tipo

Campos

• gols_pro

 ** Número de gols marcados pelo Atlético.
 ** Deve ser numérico.
 ** Para W.O. ou jogos anulados, recomenda-se usar 0.

• gols_contra

 ** Número de gols sofridos pelo Atlético.
 ** Deve ser numérico.
 ** Para W.O. ou jogos anulados, recomenda-se usar 0.

• tipo

 ** Define como o jogo será tratado estatisticamente.
 ** Valores aceitos:
 *** normal - Jogo válido para estatísticas.
 *** wo - Jogo decidido por W.O. (ignorado nos cálculos).
 *** anulado - Jogo anulado oficialmente (ignorado nos cálculos).

---

Exemplo completo (Temporada 1919)

{{#invoke:Temporada|estatisticas
 | jogos =
   3;0;normal
   1;0;normal
   0;1;normal
   3;1;normal
   0;0;normal
   0;5;normal
   0;0;anulado
   2;1;normal
   0;0;wo
   4;0;normal
   1;2;normal
   0;0;wo
   3;2;normal
   3;3;normal
   6;0;normal
   0;0;wo
   8;3;normal
}}

---

Resultado gerado

O módulo retorna automaticamente uma tabela contendo:

• Total de jogos considerados.
• Vitórias, empates e derrotas.
• Gols pró e contra.
• Aproveitamento percentual.

Todos os valores são calculados dinamicamente, sem necessidade de edição manual.

---

Boas práticas editoriais

• Nunca misture jogos válidos e anulados sem indicar corretamente o tipo.
• Evite recalcular estatísticas manualmente em outras seções da página.
• Em caso de dúvida histórica:

 ** Marque o jogo como anulado.
 ** Documente a exceção no texto da página.

---

Limitações atuais

Nesta versão inicial, o módulo:

• Não diferencia competições.
• Não calcula estatísticas por mando.
• Não gera artilharia automaticamente.
• Não lê dados diretamente da tabela visual de partidas.

Essas limitações são intencionais, visando:

• Performance.
• Clareza editorial.
• Facilidade de manutenção.

---

Evolução futura (não obrigatória)

Caso o projeto venha a utilizar Cargo ou Wiki Semântica, este módulo poderá:

• Substituir listas manuais por consultas automáticas.
• Gerar estatísticas cruzadas entre temporadas.
• Alimentar infoboxes e relatórios globais.

Mesmo sem essas extensões, o Módulo:Temporada continuará funcional e válido.

---

Histórico e decisão arquitetural

Este módulo foi concebido como parte da estratégia de:

• Automação editorial progressiva da Wiki Galo Digital.
• Preservação histórica rigorosa.
• Redução de inconsistências em páginas de temporada.

Ele representa a primeira camada lógica reutilizável para temporadas de futebol no projeto.