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

Manual de Dados das Temporadas

Projeto Wiki Galo Digital

Este manual define como estruturar, preencher e manter os dados das temporadas no sistema de automação do projeto Wiki Galo Digital.

Ele descreve a camada mais sensível do sistema: a fonte única da verdade, consumida por todos os módulos, templates e estatísticas.

---

Finalidade deste manual

Este documento tem como objetivos:

• Garantir consistência histórica dos dados
• Padronizar a entrada de informações
• Evitar erros estatísticos em cascata
• Preservar decisões editoriais e técnicas
• Facilitar revisões e auditorias futuras

---

Onde os dados vivem

Cada temporada possui um módulo de dados próprio, localizado em:

Módulo:Temporada/Dados/ANO

Exemplo:

• Módulo:Temporada/Dados/1919

Este módulo:

• Não renderiza nada
• Não calcula nada
• Apenas armazena dados estruturados

---

Estrutura básica do módulo de dados

Um módulo de dados deve seguir este padrão mínimo:

local Dados = {}

Dados.partidas = {
    {
        id = "191901",
        ano = 1919,
        competicao = "Amistoso",
        data = "23/03/1919",
        mandante = "Atlético",
        visitante = "Lusitano",
        gols_mandante = 3,
        gols_visitante = 0,
        gols_mandante_autores = "Gondim (2); Quetinho",
        estadio = "Campo desconhecido",
        local = "Belo Horizonte-MG"
    },
}

return Dados

---

Estrutura do bloco de partidas

O campo principal é:

• Dados.partidas

Ele deve conter uma lista ordenada de partidas, respeitando a cronologia histórica.

Cada partida é representada por uma tabela Lua simples.

---

Campos da partida

Campo	Obrigatório	Tipo	Descrição
id	Sim	string	Identificador único da partida
ano	Sim	number	Ano da temporada
competicao	Não	string	Nome da competição
rodada	Não	string	Rodada ou fase
data	Não	string	Data histórica (livre)
mandante	Sim	string	Time mandante
visitante	Sim	string	Time visitante
gols_mandante	Sim	number	Gols do mandante
gols_visitante	Sim	number	Gols do visitante
gols_mandante_autores	Não	string	Autores dos gols do mandante
gols_visitante_autores	Não	string	Autores dos gols do visitante
estadio	Não	string	Nome do estádio
local	Não	string	Localidade (fallback)
wo	Não	boolean	Vitória por W.O
anulada	Não	boolean	Partida anulada
nao_conta	Não	boolean	Exclui da estatística

---

Regras obrigatórias de preenchimento

ID da partida

• Deve ser único dentro da temporada
• Recomenda-se o padrão:

 * AAAANN ou AAAAMMDDNN

• Nunca reutilizar IDs

---

Campos booleanos

Os campos abaixo aceitam:

• true / false
• sim / não

Campos:

• wo
• anulada
• nao_conta

---

Autores dos gols

Padrão aceito:

• Nome
• Nome (2)
• Separação por ponto e vírgula

Exemplo:

Gondim (2); Quetinho

A grafia dos nomes impacta diretamente a artilharia.

---

Ordenação das partidas

As partidas devem ser:

• Inseridas em ordem cronológica
• Nunca reordenadas sem justificativa histórica
• Mantidas estáveis após revisão

---

O que NÃO fazer

• Não inserir HTML
• Não calcular estatísticas
• Não duplicar partidas
• Não ajustar resultados para “bater número”
• Não usar dados aproximados sem nota histórica

---

Revisão e correção de dados

Ao encontrar erro:

1. Corrija o dado no módulo 2. Salve a página 3. Verifique:

  * Estatísticas
  * Campanha
  * Artilharia

Nunca faça correção visual isolada.

---

Relação com o sistema

Os dados alimentam automaticamente:

• Infobox da temporada
• Estatísticas gerais
• Campanhas por competição
• Artilharia
• Destaques automáticos

---

Público-alvo

Este manual é destinado a:

• Editores históricos
• Pesquisadores
• Administradores de conteúdo
• Responsáveis por migração de dados

---

Histórico

• Manual criado para consolidar a camada de dados do sistema
• Parte integrante da automação de temporadas
• Documento estratégico de preservação histórica