Projeto:Galo Digital/Documentação/Automação de Temporadas

Manual Geral da Automação de Temporadas

Projeto Wiki Galo Digital

Este manual descreve a arquitetura, os princípios e o funcionamento do sistema de automação de temporadas do projeto Wiki Galo Digital.

O sistema foi concebido para garantir rigor histórico, padronização editorial, escalabilidade técnica e sustentabilidade de longo prazo, tendo o Scribunto (Lua) como núcleo lógico.

---

Objetivo do sistema

A automação de temporadas tem como objetivos principais:

• Eliminar cálculos manuais em wikitexto
• Garantir consistência estatística entre páginas
• Reduzir erros editoriais
• Facilitar manutenção e expansão histórica
• Preservar decisões técnicas e museológicas

O sistema separa claramente:

• Dados
• Lógica
• Apresentação

---

Princípios estruturais

O sistema foi construído com base nos seguintes princípios:

• Fonte única da verdade
• Separação de responsabilidades
• Automação defensiva
• Baixo acoplamento
• Compatibilidade com infraestrutura limitada

---

Arquitetura geral

A automação é composta por quatro camadas principais:

Camada	Função
Dados	Registro estruturado das partidas
Lógica	Processamento estatístico e inferências
Apresentação	Templates editoriais
Visual	CSS global

---

Camada de dados

Fonte única

Todos os dados de uma temporada residem em:

• Módulo:Temporada/Dados/ANO

Exemplo:

• Módulo:Temporada/Dados/1919

Esta camada contém apenas:

• Partidas
• Metadados diretos
• Sem cálculos
• Sem lógica

---

Camada lógica (Scribunto)

Módulo central

• Módulo:Temporada

Função:

• Orquestra o acesso aos dados
• Expõe APIs de alto nível
• Centraliza chamadas entre módulos

---

Módulos especializados

Módulo	Responsabilidade
Módulo:Temporada/Partidas	Modelo lógico da partida e renderização
Módulo:Temporada/Estatisticas	Consolidação estatística geral
Módulo:Temporada/Campanha	Campanha por competição
Módulo:Temporada/Artilharia	Artilharia automática
Módulo:Temporada/Utils	Funções utilitárias comuns

Cada módulo:

• Tem responsabilidade única
• É reutilizável
• Evita efeitos colaterais

---

Camada de apresentação (templates)

Os templates funcionam como interface editorial.

Predefinição	Função
Infortemporada	Infobox automática da temporada
Partida	Registro editorial da partida
EstatisticasTemporada	Estatísticas gerais
CampanhaTemporada	Campanha por competição
ArtilheirosTemporada	Artilharia da temporada

Regras:

• Templates não calculam nada
• Não possuem lógica condicional complexa
• Apenas encaminham parâmetros

---

Camada visual (CSS)

A camada visual é centralizada em:

• MediaWiki:Common.css

Funções:

• Definir classes semânticas
• Padronizar tabelas e infoboxes
• Sustentar a automação visual

Classes críticas:

• .gd-result-win
• .gd-result-draw
• .gd-result-loss
• .gd-table
• .gd-stadium

---

Fluxo completo de funcionamento

1. Editor registra partidas via


2. Dados são armazenados no módulo da temporada 3. Módulos Lua processam:

  * Resultados
  * Estatísticas
  * Campanhas
  * Artilharia

4. Templates exibem os dados 5. CSS define a apresentação final

---

Regras de integridade

O sistema aplica automaticamente:

• Exclusão de partidas anuladas
• Exclusão de partidas marcadas como nao_conta
• Pontuação padrão 3-1-0
• Normalização de dados textuais
• Tratamento defensivo de erros

---

Escalabilidade e evolução futura

Este sistema foi projetado para permitir, no futuro:

• Migração parcial para Cargo
• Integração com Wiki Semântica
• Geração automática de consultas
• Visualizações avançadas

---

Governança técnica

Regras de governança recomendadas:

• Alterações em módulos exigem revisão técnica
• Alterações em CSS devem ser documentadas
• Templates não devem receber lógica
• Dados históricos não devem ser reescritos sem justificativa

---

Preservação da memória técnica

Este manual faz parte do esforço de:

• Preservar decisões técnicas
• Evitar dependência de conhecimento tácito
• Garantir continuidade institucional
• Facilitar onboarding de novos editores

---

Histórico

• Sistema concebido no âmbito do Projeto Wiki Galo Digital
• Desenvolvido com foco em memória, pesquisa e automação
• Base técnica da documentação histórica das temporadas