Projeto:Galo Digital/Documentação
Documentação do Projeto Galo Digital
Esta página centraliza a **documentação técnica, editorial e operacional** do Projeto Galo Digital.
Ela funciona simultaneamente como:
- Página-mãe da documentação
- Índice Mestre vivo
- Referência conceitual e arquitetural do projeto
Todo documento técnico relevante deve estar listado aqui.
---
Índice Mestre de Documentação
Automação de Temporadas
- Guia rápido (uso editorial)
- Manual técnico de dados
- Modelo-base oficial de dados
- Checklist obrigatório de revisão
---
Padrões e Estrutura
---
Núcleo técnico (Scribunto)
- Módulo:Temporada
- Módulo:Temporada/Utils
- Módulo:Temporada/Partidas
- Módulo:Temporada/Estatisticas
- Módulo:Temporada/Campanha
- Módulo:Temporada/Artilharia
---
Predefinições editoriais
- Predefinição:Infortemporada
- Predefinição:EstatisticasTemporada
- Predefinição:CampanhaTemporada
- Predefinição:ArtilheirosTemporada
- Predefinição:Partida
---
Visão geral da arquitetura
O Projeto Galo Digital adota uma arquitetura baseada em **separação rigorosa de responsabilidades**, garantindo escalabilidade, confiabilidade histórica e facilidade de manutenção.
A estrutura se organiza em camadas:
- Dados históricos (fonte única de verdade)
- Módulos Lua (processamento e cálculo)
- Predefinições (camada editorial)
- CSS (camada visual)
- Procedimentos formais (revisão e governança)
---
Arquitetura da automação de temporadas
A automação de temporadas é baseada no princípio de **dados canônicos anuais**.
Fonte única de verdade
Cada temporada possui um módulo exclusivo no formato:
Module:Temporada/Dados/ANO
Este módulo contém **apenas dados**, nunca lógica.
Todos os cálculos automáticos utilizam exclusivamente esta fonte.
---
Processamento automático
A partir dos dados anuais, os módulos Lua calculam:
- Estatísticas gerais
- Campanha por competição
- Artilharia da temporada
- Destaques automáticos
- Infobox da temporada
Nenhum dado estatístico deve ser inserido manualmente em wikitexto.
---
Fluxo oficial de trabalho
Criação ou revisão de temporada
- Criar ou atualizar
Module:Temporada/Dados/ANOa partir do modelo-base - Preencher os dados conforme o Manual de Dados
- Executar integralmente o Checklist de Revisão
- Conferir estatísticas, campanha e artilharia
- Publicar somente após validação completa
Este fluxo é obrigatório para temporadas novas ou revisadas.
---
Regras e princípios gerais
- Dados não realizam cálculos
- Módulos não inventam dados
- Predefinições não contêm lógica
- CSS não altera significado
- Estatísticas não são editáveis manualmente
- Toda alteração estrutural exige atualização documental
---
Glossário técnico
- Temporada
- Conjunto de partidas disputadas em um mesmo ano civil ou esportivo.
- Dados canônicos
- Dados históricos registrados no módulo anual e tratados como fonte única de verdade.
- Fonte única de verdade
- Local exclusivo onde os dados oficiais residem.
- nao_conta
- Flag que exclui uma partida dos cálculos estatísticos.
- anulada
- Flag que indica partida oficialmente anulada.
- Automação
- Processo de cálculo e consolidação realizado automaticamente por módulos Lua.
- Camada editorial
- Predefinições utilizadas apenas para apresentação.
---
Governança e atualização
Esta página deve ser atualizada sempre que:
- Um novo manual for criado
- Um novo checklist for adotado
- A arquitetura técnica for alterada
- Novos padrões estruturais forem definidos
Ela é o **referencial máximo da documentação do Projeto Galo Digital**.