Módulo:Temporada/Estatisticas/doc

Módulo:Temporada/Estatisticas

O Módulo:Temporada/Estatisticas é responsável pela consolidação estatística das partidas de uma temporada no projeto Wiki Galo Digital.

Ele processa os dados brutos de partidas, aplica regras de validação e cálculo e retorna estatísticas agregadas, que podem ser consumidas por outros módulos ou renderizadas por templates.

---

Escopo e responsabilidades

Este módulo é responsável por:

• Consolidar estatísticas gerais da temporada
• Processar partidas válidas (não anuladas e contabilizáveis)
• Separar desempenho como mandante e visitante
• Calcular:
  • Jogos
  • Vitórias, empates e derrotas
  • Gols pró e contra
  • Saldo de gols
  • Aproveitamento
• Fornecer renderização tabular para uso editorial

---

Dependências

Este módulo depende diretamente de:

• Module:Temporada/Utils
• Module:Temporada/Partidas

E carrega dinamicamente os dados de cada temporada a partir de:

• Module:Temporada/Dados/ANO

---

Estrutura de dados

Estrutura base

A função interna de criação da estrutura estatística gera os seguintes campos:

• Estatísticas gerais
  • jogos
  • vitorias
  • empates
  • derrotas
  • gols_pro
  • gols_contra
  • saldo
  • aproveitamento
• Estatísticas como mandante
• Estatísticas como visitante

Cada subestrutura mantém seus próprios totais.

---

Funções internas

processarPartida(stats, partida)

Processa uma partida individual e acumula seus dados na estrutura estatística.

• Ignora partidas:
  • Anuladas
  • Marcadas como não contabilizáveis
• Identifica se o Atlético atuou como:
  • Mandante
  • Visitante
• Atualiza:
  • Contadores de jogos
  • Gols pró e contra
  • Resultado (V, E, D)

---

Funções públicas

calcularPorAno(ano)

Calcula todas as estatísticas da temporada informada.

• Parâmetro
  • ano (number)

• Fluxo de execução

1. Cria estrutura estatística vazia
2. Carrega dinamicamente o módulo de dados do ano
3. Processa cada partida
4. Calcula saldos e aproveitamento

• Retorno
  • Tabela Lua com estatísticas consolidadas

---

render(frame)

Função pública de renderização da tabela de estatísticas gerais.

• Uso
  • Template:EstatisticasTemporada
• Parâmetro
  • frame.args.ano

• Saída
  • Tabela wiki com:
    • Totais gerais
    • Mandante
    • Visitante

---

Regras de validação

O módulo aplica validações defensivas:

• Ano inválido retorna erro controlado
• Partidas inválidas são ignoradas
• Campos ausentes são tratados como zero
• Aproveitamento é calculado apenas ao final

---

Boas práticas e manutenção

• Não adicionar lógica editorial neste módulo
• Manter separação clara entre cálculo e apresentação
• Não alterar estrutura de retorno sem revisar dependências
• Novos campos estatísticos devem ser documentados
• Dados históricos devem ser adicionados apenas em Módulo:Temporada/Dados/ANO

---

Páginas relacionadas

• Módulo:Temporada
• Módulo:Temporada/Utils
• Módulo:Temporada/Partidas
• Módulo:Temporada/Dados/1919
• Predefinição:EstatisticasTemporada

---

Histórico

• Módulo criado para consolidação estatística centralizada
• Estruturado para evitar repetição de cálculos entre templates
• Preparado para expansão futura de indicadores