Predefinição:Partida/doc: mudanças entre as edições

De Clube Atletico Mineiro - Enciclopedia Galo Digital
Ir para navegação Ir para pesquisar
← Edição anterior
Admin (discussão | contribs)
Burocratas, Administradores
1 029 edições
Sem resumo de edição
 
(Uma revisão intermediária pelo mesmo usuário não está sendo mostrada)
Linha 1: Linha 1:
<noinclude>
{{Documentação de predefinição}}
{{Documentação de template}}
</noinclude>


= Template:Partida =
= Predefinição:Partida =


Este template é a **interface editorial** para registro e exibição de partidas individuais dentro das páginas de temporada da Wiki Galo Digital.
A '''Predefinição:Partida''' representa uma única partida oficial ou amistosa de uma temporada do Clube Atlético Mineiro no projeto '''Wiki Galo Digital'''.


Ele funciona como uma camada de apresentação, delegando toda a lógica de cálculo, validação histórica e normalização de dados ao módulo Lua [[Module:Temporada/Partidas]].
Ela atua exclusivamente como interface editorial, delegando todo o processamento lógico, estatístico e de renderização ao módulo Lua correspondente.


Cada chamada do template corresponde a **uma linha da tabela de partidas**.
---
 
== Escopo e finalidade ==
 
Esta predefinição tem como finalidade:
 
* Registrar editorialmente uma partida da temporada
* Padronizar a entrada de dados das partidas
* Alimentar automaticamente:
** Estatísticas da temporada
** Campanhas por competição
** Artilharia
* Garantir consistência entre dados históricos e cálculos automatizados
 
{{Aviso|texto=Esta predefinição não executa lógica de negócio. Toda a lógica pertence ao módulo Lua.}}


---
---


== Finalidade ==
== Arquitetura e dependências ==


O '''Template:Partida''' tem como objetivos:
A predefinição depende exclusivamente do módulo:


* simplificar a edição de partidas pelos editores
* <code>Módulo:Temporada/Partidas</code>
* reduzir wikitexto repetitivo
* garantir padronização visual e estrutural
* evitar cálculos manuais em páginas de temporada
* manter separação clara entre lógica (Lua) e apresentação (wikitexto)


Este template **não realiza cálculos estatísticos**.
Esse módulo, por sua vez, utiliza:
 
* <code>Módulo:Temporada/Utils</code>
 
E integra-se com:
 
* <code>Módulo:Temporada/Estatisticas</code>
* <code>Módulo:Temporada/Campanha</code>
* <code>Módulo:Temporada/Artilharia</code>


---
---


== Funcionamento ==
== Uso ==


O template:
Exemplo de uso básico:


# recebe parâmetros editoriais simples
<syntaxhighlight lang="wiki">
# repassa esses parâmetros ao módulo Lua
{{Partida
# renderiza automaticamente uma linha (<code>&lt;tr&gt;</code>) da tabela de partidas
| id = 191901
# aplica classes CSS de resultado (vitória, empate, derrota)
| ano = 1919
# destaca automaticamente o Clube Atlético Mineiro em negrito
| competicao = Amistoso
 
| data = 23/03/1919
Toda a lógica é executada pelo módulo:
| mandante = Atlético
| visitante = Lusitano
| gols_mandante = 3
| gols_visitante = 0
| gols_mandante_autores = Gondim (2); Quetinho
| estadio = Campo desconhecido
| local = Belo Horizonte-MG
}}
</syntaxhighlight>


* [[Module:Temporada/Partidas]]
O parâmetro <code>ano</code> é utilizado para vincular a partida às estatísticas e campanhas da temporada.


---
---


== Parâmetros ==
== Parâmetros ==
=== Parâmetros principais ===


{| class="wikitable"
{| class="wikitable"
! Parâmetro
! Parâmetro !! Obrigatório !! Descrição
! Obrigatório
! Descrição
|-
|-
| id
| <code>id</code> || Sim || Identificador único da partida
| recomendado
| Identificador único da partida
|-
|-
| competicao
| <code>ano</code> || Sim || Ano da temporada (usado para estatísticas)
| sim
| Competição ou torneio da partida
|-
|-
| rodada
| <code>competicao</code> || Não || Nome da competição
| não
| Rodada da competição
|-
|-
| data
| <code>rodada</code> || Não || Rodada ou fase
| sim
| Data da partida (formato livre)
|-
|-
| mandante
| <code>data</code> || Não || Data da partida
| sim
| Time mandante
|-
|-
| visitante
| <code>mandante</code> || Sim || Time mandante
| sim
| Time visitante
|-
|-
| gols_mandante
| <code>visitante</code> || Sim || Time visitante
| sim
| Número de gols do mandante
|-
|-
| gols_visitante
| <code>gols_mandante</code> || Sim || Gols do mandante
| sim
| Número de gols do visitante
|-
|-
| gols_mandante_autores
| <code>gols_visitante</code> || Sim || Gols do visitante
| não
| Autores dos gols do mandante
|-
|-
| gols_visitante_autores
| <code>gols_mandante_autores</code> || Não || Autores dos gols do mandante
| não
| Autores dos gols do visitante
|-
|-
| estadio
| <code>gols_visitante_autores</code> || Não || Autores dos gols do visitante
| não
| Estádio da partida
|-
|-
| local
| <code>estadio</code> || Não || Nome do estádio
| não
|-
| Localidade da partida (quando não houver estádio definido)
| <code>local</code> || Não || Localidade (fallback do estádio)
|}
 
---
 
=== Parâmetros de controle histórico ===
 
{| class="wikitable"
! Parâmetro
! Descrição
|-
|-
| wo
| <code>wo</code> || Não || Define vitória por W.O (sim/não)
| Indica partida decidida por W.O (<code>sim</code> / <code>true</code>)
|-
|-
| anulada
| <code>anulada</code> || Não || Marca a partida como anulada
| Indica partida anulada oficialmente
|-
|-
| nao_conta
| <code>nao_conta</code> || Não || Exclui a partida dos cálculos estatísticos
| Exclui a partida das estatísticas da temporada
|}
|}
Esses parâmetros são tratados exclusivamente pelo módulo Lua e **não exigem ajustes no template**.


---
---


== Exemplo de uso ==
== Regras de processamento ==


Exemplo de chamada dentro de uma tabela de partidas:
As seguintes regras são aplicadas pelo módulo Lua:


* Partidas anuladas não entram nos cálculos
* Partidas marcadas como <code>nao_conta</code> são ignoradas
* Resultados são calculados automaticamente
* Gols e autores alimentam estatísticas e artilharia
* W.O é tratado de forma específica na exibição do placar


{| class="wikitable gd-table gd-table-partidas"
---
! Nº
! Motivo
! Rodada
! Data
! Gols Mandante
! Time Mandante
! Placar
! Time Visitante
! Gols Visitante
! Estádio (Local)
 
{{Partida
| id = 191901
| 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 (Belo Horizonte-MG)
}}


|}
== Boas práticas editoriais ==


== Boas práticas ==
* Não utilizar HTML dentro do template
* Não inserir lógica condicional no wikitexto
* Garantir consistência na grafia de nomes de atletas
* Utilizar <code>nao_conta</code> apenas em casos justificados
* Manter o <code>id</code> único em toda a temporada


Utilizar o template apenas dentro de tabelas
---


Não inserir lógica condicional no wikitexto
== Erros comuns ==


Registrar exceções históricas usando os parâmetros próprios (<code>wo</code>, <code>anulada</code>, <code>nao_conta</code>)
* IDs duplicados
* Ano inconsistente com a temporada
* Omissão de gols em partidas com resultado definido
* Uso indevido de <code>anulada</code> ou <code>nao_conta</code>


Evitar formatação manual de resultados ou CSS
---


Manter textos explicativos e notas fora do template
== Páginas relacionadas ==


== Observações ==
* [[Módulo:Temporada/Partidas]]
* [[Módulo:Temporada/Estatisticas]]
* [[Módulo:Temporada/Campanha]]
* [[Módulo:Temporada/Artilharia]]
* [[Predefinição:Infortemporada]]
* [[Predefinição:EstatisticasTemporada]]


O template gera apenas a linha da tabela, não o cabeçalho
---
 
A classe CSS aplicada depende do resultado da partida
 
O destaque do Atlético é feito automaticamente
 
Caso não haja estádio, o campo de localidade é utilizado


== Histórico ==
== Histórico ==


Desenvolvido para o projeto '''Wiki Galo Digital'''
* Predefinição criada na Etapa 2.2 do Checklist Mestre de Automação das Temporadas
 
* Integrada ao sistema automatizado via Scribunto
Parte do sistema de automação das páginas de temporada
* Base estrutural de todos os cálculos da temporada
 
Primeira aplicação: '''Futebol – Temporada 1919'''

Edição atual tal como às 17h47min de 26 de janeiro de 2026

Predefinição:Documentação de predefinição

Predefinição:Partida

A Predefinição:Partida representa uma única partida oficial ou amistosa de uma temporada do Clube Atlético Mineiro no projeto Wiki Galo Digital.

Ela atua exclusivamente como interface editorial, delegando todo o processamento lógico, estatístico e de renderização ao módulo Lua correspondente.

---

Escopo e finalidade

Esta predefinição tem como finalidade:

  • Registrar editorialmente uma partida da temporada
  • Padronizar a entrada de dados das partidas
  • Alimentar automaticamente:
    • Estatísticas da temporada
    • Campanhas por competição
    • Artilharia
  • Garantir consistência entre dados históricos e cálculos automatizados

Predefinição:Aviso

---

Arquitetura e dependências

A predefinição depende exclusivamente do módulo:

  • Módulo:Temporada/Partidas

Esse módulo, por sua vez, utiliza:

  • Módulo:Temporada/Utils

E integra-se com:

  • Módulo:Temporada/Estatisticas
  • Módulo:Temporada/Campanha
  • Módulo:Temporada/Artilharia

---

Uso

Exemplo de uso básico: 

{{Partida
 | 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
}}

O parâmetro ano é utilizado para vincular a partida às estatísticas e campanhas da temporada.

---

Parâmetros

Parâmetro Obrigatório Descrição
id Sim Identificador único da partida
ano Sim Ano da temporada (usado para estatísticas)
competicao Não Nome da competição
rodada Não Rodada ou fase
data Não Data da partida
mandante Sim Time mandante
visitante Sim Time visitante
gols_mandante Sim Gols do mandante
gols_visitante Sim Gols do visitante
gols_mandante_autores Não Autores dos gols do mandante
gols_visitante_autores Não Autores dos gols do visitante
estadio Não Nome do estádio
local Não Localidade (fallback do estádio)
wo Não Define vitória por W.O (sim/não)
anulada Não Marca a partida como anulada
nao_conta Não Exclui a partida dos cálculos estatísticos

---

Regras de processamento

As seguintes regras são aplicadas pelo módulo Lua:

  • Partidas anuladas não entram nos cálculos
  • Partidas marcadas como nao_conta são ignoradas
  • Resultados são calculados automaticamente
  • Gols e autores alimentam estatísticas e artilharia
  • W.O é tratado de forma específica na exibição do placar

---

Boas práticas editoriais

  • Não utilizar HTML dentro do template
  • Não inserir lógica condicional no wikitexto
  • Garantir consistência na grafia de nomes de atletas
  • Utilizar nao_conta apenas em casos justificados
  • Manter o id único em toda a temporada

---

Erros comuns

  • IDs duplicados
  • Ano inconsistente com a temporada
  • Omissão de gols em partidas com resultado definido
  • Uso indevido de anulada ou nao_conta

---

Páginas relacionadas

---

Histórico

  • Predefinição criada na Etapa 2.2 do Checklist Mestre de Automação das Temporadas
  • Integrada ao sistema automatizado via Scribunto
  • Base estrutural de todos os cálculos da temporada
Disponível em “http://www.galodigital.com.br/w/index.php?title=Predefinição:Partida/doc&oldid=154281”