Admin em 10h23min de 25 de janeiro de 2026

2026-01-25T10:23:31Z

Admin: Criou página com '== Módulo:Temporada/Estatisticas == Este módulo é responsável pela consolidação estatística das partidas de uma temporada, a partir dos dados estruturados fornecidos pelo {{tl|Partida}} e processados pelo módulo {{code|Module:Temporada/Partidas}}. Ele não gera saída visual. Seu papel é exclusivamente lógico, servindo como base para: * Estatísticas gerais da temporada * Campanhas por competição * Infobox da temporada * Relatórios e agregações...'

2026-01-24T22:03:58Z

Criou página com '== Módulo:Temporada/Estatisticas == Este módulo é responsável pela **consolidação estatística das partidas de uma temporada**, a partir dos dados estruturados fornecidos pelo {{tl|Partida}} e processados pelo módulo {{code|Module:Temporada/Partidas}}. Ele **não gera saída visual**. Seu papel é exclusivamente lógico, servindo como base para: * Estatísticas gerais da temporada * Campanhas por competição * Infobox da temporada * Relatórios e agregações...'

Página nova

== Módulo:Temporada/Estatisticas ==

Este módulo é responsável pela **consolidação estatística das partidas de uma temporada**, a partir dos dados estruturados fornecidos pelo {{tl|Partida}} e processados pelo módulo {{code|Module:Temporada/Partidas}}.

Ele **não gera saída visual**. Seu papel é exclusivamente lógico, servindo como base para:

* Estatísticas gerais da temporada
* Campanhas por competição
* Infobox da temporada
* Relatórios e agregações futuras

---

== Dependências ==

Este módulo depende obrigatoriamente de:

* {{code|Module:Temporada/Utils}}
* {{code|Module:Temporada/Partidas}}

Caso qualquer uma dessas dependências seja alterada, este módulo deve ser revisado.

---

== Responsabilidades ==

O módulo é responsável por:

* Contabilizar apenas partidas válidas
* Ignorar automaticamente:
** Jogos anulados
** Jogos marcados como “não conta”
* Identificar corretamente se o Atlético atuou como:
** Mandante
** Visitante
* Consolidar:
** Jogos
** Vitórias
** Empates
** Derrotas
** Gols pró
** Gols contra
** Saldo de gols
** Aproveitamento
* Gerar estatísticas separadas para:
** Total
** Mandante
** Visitante

---

== O que este módulo NÃO faz ==

* Não gera HTML
* Não aplica CSS
* Não renderiza tabelas
* Não acessa páginas da wiki
* Não possui lógica editorial ou visual
* Não conhece ano, competição ou contexto da página

Toda visualização deve ser feita por templates ou outros módulos consumidores.

---

== Estrutura de dados retornada ==

A função principal retorna uma tabela Lua com a seguinte estrutura:

<syntaxhighlight lang="lua">
{
jogos = number,
vitorias = number,
empates = number,
derrotas = number,
gols_pro = number,
gols_contra = number,
saldo = number,
aproveitamento = number,

mandante = {
jogos = number,
vitorias = number,
empates = number,
derrotas = number,
gols_pro = number,
gols_contra = number
},

visitante = {
jogos = number,
vitorias = number,
empates = number,
derrotas = number,
gols_pro = number,
gols_contra = number
}
}
</syntaxhighlight>

---

== Funções públicas ==

=== <code>calcular(listaDePartidas)</code> ===

Calcula as estatísticas gerais da temporada a partir de uma lista de partidas.

; Parâmetros
* <code>listaDePartidas</code> – tabela Lua contendo listas de argumentos equivalentes aos parâmetros do {{tl|Partida}}

; Comportamento
* Cada item da lista é convertido internamente em uma partida normalizada
* Apenas partidas válidas são contabilizadas
* O resultado é acumulado em uma única estrutura estatística

; Retorno
* Tabela Lua contendo as estatísticas consolidadas

---

== Exemplo de uso (interno) ==

Este módulo é utilizado internamente por outros módulos, por exemplo:

<syntaxhighlight lang="lua">
local Estatisticas = require("Module:Temporada/Estatisticas")

local stats = Estatisticas.calcular(listaDePartidas)
</syntaxhighlight>

A renderização desses dados deve ser feita externamente, por templates ou módulos de visualização.

---

== Convenções editoriais ==

* Este módulo deve permanecer **genérico**
* Não devem ser inseridas regras específicas de uma temporada isolada
* Toda exceção histórica deve ser resolvida no nível da partida
* Alterações devem ser documentadas nesta página

---

== Histórico ==

* Módulo criado no contexto da automação das páginas de temporada da Wiki Galo Digital
* Parte do checklist mestre de automação (Etapa 3.1)

Módulo:Temporada/Estatisticas/doc - Histórico de revisão

Admin em 10h23min de 25 de janeiro de 2026