A atualidade dos dados de país é um problema de manutenção que quase ninguém coloca no planejamento, porque no início a lista parece estável. Depois de alguns anos, o nome de um lugar muda, uma moeda é substituída, uma divisão interna é criada, e a base que ninguém revisou passa a afirmar coisas que já não são verdade. Este texto trata de como manter um catálogo de países utilizável por um prazo longo.
Por que esses dados envelhecem?
Porque eles descrevem um objeto que muda por decisão humana. Nomes de países são alterados, moedas são substituídas, divisões internas são criadas ou fundidas, sistemas de código postal são implantados ou desativados e numeração de telefonia é reorganizada. Nada disso é um erro de quem montou a base; é o comportamento normal de um mundo administrado.
Existe um segundo motivo, mais sutil: a própria fonte muda de forma. Um critério que antes era publicado como uma lista pode passar a ser publicado como um conjunto de arquivos com estrutura diferente, e a equipe que consome precisa se adaptar mesmo quando nenhum país mudou.
O terceiro motivo é interno. A base pode ficar desatualizada porque a pessoa que a mantinha saiu do time e ninguém sabia que aquela tabela era alimentada à mão. Sem um responsável declarado, a atualização depende de alguém lembrar por acaso.
Nomes, moedas e divisões internas: o que costuma mudar
As mudanças mais visíveis são as de nome próprio, porque aparecem imediatamente na interface e nos relatórios. Elas têm uma consequência específica: se o nome for usado como chave, a mudança obriga a mexer em registros históricos, e qualquer erro nessa migração corrompe dados antigos.
As mudanças de moeda afetam valores, cotações e relatórios financeiros. Quando a moeda de um país muda, o valor histórico continua válido na moeda da época, e é justamente por isso que a data precisa estar registrada junto ao valor. Recalcular o passado com a moeda atual cria números que nunca existiram na prática.
As mudanças de divisão interna são as mais silenciosas. Uma estrutura pode ganhar, perder ou reorganizar níveis sem que a mídia dê atenção, e o efeito aparece em relatórios comparativos, quando um número cai ou sobe por motivo puramente administrativo. Uma nota de rodapé explicando a mudança vale mais do que uma tentativa de reconstruir a série para que ela fique suave.
Por que guardar a data de coleta em cada registro?
Porque sem ela não existe forma de julgar uma divergência. Quando o seu dado discorda do dado de outra pessoa, a pergunta útil é qual dos dois foi coletado mais recentemente; sem a data, a discussão vira opinião contra opinião.
Três informações deveriam acompanhar cada bloco de dado importado: a origem, a data da coleta e o intervalo ao qual aquele dado se aplica. A origem responde quem afirma aquilo. A data responde quando foi lido. O intervalo responde desde quando a afirmação era verdadeira, o que nem sempre coincide com a data da leitura.
| Informação | Pergunta que ela responde | O que dá errado sem ela |
|---|---|---|
| Origem | Quem afirma | Não se sabe a quem pedir correção |
| Data de coleta | Quando foi lido | Divergências sem árbitro |
| Intervalo de validade | Desde quando vale | Histórico recalculado errado |
Vale também registrar quem revisou. Uma base mantida em equipe precisa saber quem olhou por último aquele conjunto e quando, sob pena de todas as pessoas suporem que outra já verificou.
O histórico deve ser reescrito quando a fonte muda?
Não, e essa resposta tem consequência arquitetural. Documentos já emitidos, pedidos já fechados e relatórios já publicados devem continuar mostrando o estado do mundo no momento em que foram produzidos. Se a tabela de referência for atualizada no lugar, esses registros mudam de significado retroativamente.
A alternativa é guardar a referência usada no momento do registro, seja copiando os campos necessários, seja amarrando o registro a uma versão da tabela. A primeira opção consome mais espaço e é mais simples de auditar; a segunda é mais econômica e exige disciplina para que a versão antiga continue disponível.
Existe um caso em que atualizar o histórico é correto: quando o dado antigo estava simplesmente errado por falha de transcrição. A diferença entre corrigir um erro e acompanhar uma mudança precisa ser registrada no próprio registro, com o motivo. Sem essa distinção, a auditoria não consegue separar os dois casos.
Duas fontes confiáveis discordam: o que fazer?
Escolha uma como base e mantenha uma lista de exceções. Essa é a recomendação padrão e ela existe para evitar a fadiga de decidir caso a caso.
A fonte escolhida como base é a que responde pela maior parte dos registros e pela maior parte das dúvidas. Toda divergência pontual entra na lista de exceções, com a razão da escolha e o responsável pela decisão. Assim, a próxima pessoa que encontrar a mesma divergência não precisa refazer a análise.
Quando a divergência é sobre um ponto muito específico, é comum que a fonte mais geral e a fonte especializada discordem, e a especializada costuma ser a mais adequada para aquele ponto. Registre isso como regra, e não como caso isolado, para que a próxima divergência semelhante já tenha tratamento definido.
Vale também evitar atualizações contínuas sem ponto de corte. Uma base que muda a qualquer momento é impossível de auditar; uma que muda em datas anunciadas permite que todos os times se preparem. A cadência importa menos do que o fato de existir.
Para quem desenvolve: trate origem e data como campos
A recomendação prática é que procedência seja um dado de primeira classe, e não um comentário em algum lugar. Cada linha importada carrega de onde veio, quando foi lida e a que período se refere.
Com isso, três verificações ficam baratas. A primeira é detectar dado velho: comparar a data de coleta com a data atual e sinalizar o que passou do limite definido. A segunda é comparar fontes: agrupar por registro e listar divergências. A terceira é reconstruir o passado: consultar a versão vigente na data do pedido.
Para o vocabulário de códigos e divisões internas, vale manter a nomenclatura alinhada à fonte publicada, e o texto sobre códigos de país e subdivisão trata desse lado com mais detalhe.
Uma última recomendação de processo: defina uma pessoa responsável pela revisão periódica, com data no calendário. A maior parte dos catálogos desatualizados não está assim por falta de ferramenta, e sim por falta de dono.
Próximos passos
Se o seu problema é saber o que já está preenchido antes de decidir o que atualizar, comece pela lista de cobertura de dados por país. Se a base já cresceu e a manutenção virou gargalo, o texto sobre escalar dados de teste entre países trata da passagem para um modelo escalável. E a página de formatos de endereço e identidade por país serve como referência de nomenclatura ao comparar fontes.
Advertência: os nomes de fonte, as datas de coleta e os números de versão usados neste texto são formatos de exemplo, escritos para mostrar onde cada informação se encaixa. Não apontam para nenhuma base existente, não descrevem o processo interno deste site e não devem ser citados como referência de procedência.