Importação de dados externos

Importação de dados externos é o conjunto de scripts, pipelines e processos que permite transformar fontes externas em dados compatíveis com o FootSim. Isso pode incluir dados de jogadores, clubes, competições, ratings, estatísticas, calendários, manifestos ou estruturas de torneios.

Este item está concluído como pipeline interno de desenvolvimento e curadoria, não como feature de usuário final. O objetivo atual é acelerar criação de conteúdo, testes, bases fictícias, competições e processos internos, respeitando limitações legais e decisões de produto. Ele não significa que o jogo oficial usará dados reais licenciados, nem que o usuário final poderá importar qualquer fonte automaticamente. A cobertura já é madura para uso interno, com scripts, manifests, dry-runs, importação de competições, enriquecimento e documentação.

Escopo incluído

• Scripts de importação
• Conversão de dados externos para formato interno
• Importação de jogadores
• Importação de clubes
• Importação de competições
• Importação de estádios quando aplicável
• Importação de ratings/atributos quando aplicável
• Importação de finanças quando aplicável
• Importação de estruturas de torneios
• Importação por manifests
• Dry-runs de importação
• Escrita em arquivos de dados versionados
• Normalização de dados
• Mapeamento de campos
• Remapeamento de IDs
• Tratamento de duplicidades
• Validação pós-importação
• Pipeline interno de curadoria
• Documentação técnica do processo
• Separação entre uso interno e distribuição oficial
• Integração com rebuild do banco mestre após importação

Fora de escopo

• Uso automático de dados reais licenciados sem autorização
• Scraping indiscriminado como feature do produto
• Importação pública de qualquer site
• Garantia legal sobre fontes externas
• Atualização automática online de bases reais
• Sincronização diária com APIs externas
• Dependência obrigatória de fontes externas para jogar
• Ferramenta final para usuário leigo importar qualquer base
• Distribuição oficial de dados sem revisão legal
• Conversão perfeita de qualquer formato externo
• Interface gráfica de importação para usuário comum
• Importação direta para .fsim como fluxo final se o pipeline ainda escreve principalmente nos dados internos

Critérios de conclusão

• Dados externos podem ser convertidos para estruturas internas em casos suportados.
• Scripts documentam claramente suas entradas e saídas.
• Importações passam por validação ou dry-run quando aplicável.
• Dados importados não quebram o banco quando passam pelo pipeline esperado.
• O pipeline reduz trabalho manual de curadoria.
• Fontes externas são tratadas com cuidado legal e de produto.
• Importações podem alimentar o banco mestre ou datasets internos quando permitido.
• Erros de importação são detectáveis.
• O processo é útil para desenvolvimento interno.
• A ferramenta não cria expectativa falsa de base real oficial sem licença.
• O status “concluído” se aplica ao pipeline interno atual, não a uma feature pública de importação universal.