Pipeline de seed, rebuild e sincronização do banco mestre

O pipeline de seed, rebuild e sincronização do banco mestre é o processo técnico que transforma arquivos de dados versionados em um banco mestre utilizável pelo jogo. Ele permite reconstruir a base oficial de forma previsível, aplicar migrations, carregar dados core, sincronizar conteúdo e gerar o master.db usado para iniciar novas carreiras.

Esse item não é sobre a qualidade do conteúdo em si. Ele é sobre a capacidade de reconstruir a base de dados de forma confiável durante o desenvolvimento. O pipeline atual já cumpre seu papel principal: rebuild do master, aplicação de migrations, seed de dados, escrita de JSON pelo editor em vários fluxos e separação entre banco mestre e carreira ativa. As principais ressalvas são que a validação durante rebuild ainda é limitada e o seed pode depender de condições de banco vazio/parcial.

Escopo incluído

• Rebuild do banco mestre
• Aplicação de migrations
• Seed de dados core
• Seed de países
• Seed de clubes
• Seed de jogadores
• Seed de competições
• Seed de estádios
• Seed de managers quando aplicável
• Seed de árbitros quando aplicável
• Seed de regras
• Sincronização de arquivos JSON/dados para SQLite
• Escrita de volta para JSON quando aplicável
• Scripts de rebuild
• Validação básica durante rebuild
• Contagens e logs de rebuild
• Limpeza/recriação controlada do banco mestre
• Backup/rename atômico quando aplicável
• Separação entre master database e active game
• Processo repetível em desenvolvimento

Fora de escopo

• Editor visual do pipeline
• Rebuild parcial avançado por região
• Rebuild remoto em servidor
• Sincronização com banco online
• Importação automática de qualquer fonte externa
• Curadoria automática perfeita dos dados
• Interface para jogador comum rodar rebuild
• Sistema completo de versionamento visual de datasets
• Pipeline público final para modders sem documentação adicional
• Detecção perfeita de todos os erros possíveis de dados
• Garantia de que um banco parcialmente corrompido seja sempre reconstruído automaticamente sem intervenção
• Validação de qualidade editorial profunda durante rebuild

Critérios de conclusão

• O banco mestre pode ser reconstruído de forma previsível.
• Migrations são aplicadas corretamente durante o rebuild.
• Dados core são carregados.
• Dados de nações, clubes, jogadores e competições entram no banco.
• O processo é repetível durante desenvolvimento.
• O master database gerado pode iniciar uma carreira.
• A carreira ativa é criada a partir do master database.
• O processo reduz trabalho manual e risco de inconsistência.
• O pipeline permite evolução contínua do conteúdo oficial.
• Logs e contagens ajudam a identificar problemas básicos.
• Ressalvas sobre seed em banco parcial e validação leve são documentadas.