Módulo:Temporada/Campanha/doc

Módulo:Temporada/Campanha

O Módulo:Temporada/Campanha é responsável pela consolidação da campanha do Clube Atlético Mineiro por competição em uma determinada temporada, no projeto Wiki Galo Digital.

Ele processa as partidas registradas no módulo de dados da temporada e apresenta os resultados agregados por competição, com recortes de desempenho total, como mandante e como visitante.

---

Escopo e responsabilidades

Este módulo é responsável por:

• Agrupar partidas por competição
• Calcular campanha do Atlético em cada competição
• Separar desempenho:
  • Total
  • Mandante
  • Visitante
• Calcular:
  • Jogos
  • Vitórias, empates e derrotas
  • Gols pró e contra
  • Saldo de gols
  • Aproveitamento
• Renderizar tabela consolidada por competição

---

Dependências

Este módulo depende diretamente de:

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

E consome dados exclusivamente de:

• Module:Temporada/Dados/ANO

---

Estrutura de dados

Estrutura base de campanha

Cada campanha por competição utiliza a seguinte estrutura:

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

Essa estrutura é inicializada por competição.

---

Funções internas

processarPartida(c, p)

Processa uma partida individual dentro da campanha da competição.

• Ignora partidas:
  • Anuladas
  • Não contabilizáveis
• Identifica se o Atlético atuou como:
  • Mandante
  • Visitante
• Atualiza:
  • Jogos
  • Resultados
  • Gols pró e contra

---

saldo(c)

Calcula o saldo de gols da estrutura informada.

• Retorno
  • gols_pro - gols_contra

---

aproveitamento(c)

Calcula o aproveitamento percentual da campanha.

• Regra
  • Pontuação padrão 3-1-0
• Retorno
  • Percentual formatado
  • Retorna “–” se não houver jogos

---

Função pública

render(frame)

Renderiza a tabela de campanha por competição da temporada.

• Parâmetro
  • frame.args.ano

• Fluxo de execução

1. Obtém partidas do ano
2. Agrupa por competição
3. Consolida campanha
4. Renderiza tabela com três linhas por competição:
   1. Total
   2. Mandante
   3. Visitante

• Saída
  • Tabela wiki estruturada

---

Regras de validação

• Ano inválido gera erro controlado
• Competições vazias são ignoradas
• Partidas anuladas não entram no cálculo
• Partidas não contabilizáveis são ignoradas

---

Boas práticas e manutenção

• Não misturar lógica editorial com lógica de campanha
• Alterações na estrutura exigem revisão da renderização
• Novos recortes devem ser documentados
• Dados históricos devem permanecer no módulo de dados do ano
• Evitar duplicação de cálculos já existentes em outros módulos

---

Páginas relacionadas

• Módulo:Temporada
• Módulo:Temporada/Partidas
• Módulo:Temporada/Estatisticas
• Módulo:Temporada/Dados/1919
• Predefinição:CampanhaTemporada

---

Histórico

• Módulo criado para consolidação da campanha por competição
• Centraliza recortes total, mandante e visitante
• Estruturado para facilitar expansão futura