Identificadores voláteis: como uma gravação inocente parte uma integração
Um cliente via planos de trabalho a esvaziar-se sem explicação. A causa estava num formulário que apagava e voltava a criar as suas linhas.
O cliente descreveu o problema assim: "os planos apagam-se sozinhos". Um plano de trabalho, configurado num sistema, aparecia vazio de um dia para o outro. Ninguém lhe tinha tocado, e não havia erro em lado nenhum. Já tinham voltado a configurá-lo à mão duas vezes.
Pedimos o histórico de alterações dos dois sistemas envolvidos e procurámos o que tinha mudado no dia anterior a cada falha. Em ambos os casos, alguém tinha aberto a ficha de um cliente noutro sistema, corrigido um dado sem relação, e gravado.
O padrão que o causava
A ficha do cliente incluía uma lista de pontos, cada um com o seu identificador na base de dados. O código que gravava a ficha seguia um padrão muito comum em formulários com listas: apagar todas as linhas e inserir de novo as que vinham no formulário.
É um padrão cómodo. Não é preciso distinguir o que foi alterado, acrescentado ou removido. O preço é discreto: cada gravação dá identificadores novos a todas as linhas, mesmo às que ninguém alterou.
Durante anos isso não incomodou ninguém, porque nada fora da ficha guardava esses identificadores.
Quando outro sistema passa a depender deles
Mais tarde, o segundo sistema começou a ler os pontos e a guardar os identificadores nas suas próprias tabelas: horários, registos, estatísticas. A partir desse dia, cada gravação da ficha passou a quebrar referências do outro lado.
O segundo sistema tinha sido escrito de forma defensiva. Ao montar um plano, se um ponto referenciado já não existia, saltava-o e continuava. A intenção era boa: não rebentar por causa de um dado em falta. O efeito foi o pior possível. Os pontos desapareciam do plano sem mensagem nenhuma.
Havia um segundo dano, mais lento. O histórico guardava o nome de cada ponto, por isso não se perdia. Mas ficava preso aos identificadores antigos, e o mesmo ponto físico passava a contar duas vezes nas estatísticas.
A reparação e a correção
A reparação imediata foi remapear as referências antigas para os identificadores atuais, comparando nomes e posições. Voltar a configurar o plano à mão, como o cliente vinha a fazer, resolvia o sintoma e cortava a ligação ao histórico.
A correção de fundo foi no formulário. Cada linha passou a enviar o seu identificador num campo escondido, e a gravação passou a fazer três coisas distintas:
- atualizar as linhas que trazem identificador;
- inserir as que não trazem;
- apagar só as que saíram do formulário.
São vinte linhas de código a mais. Os identificadores passam a ser estáveis, que é o que qualquer sistema externo assume.
Antes de dar o trabalho por fechado, procurámos o mesmo padrão no resto do código. Encontrámos outra lista na mesma ficha que já tinha sido corrigida no passado, pelo mesmo motivo, sem que ninguém procurasse as listas irmãs.
O que fica
Um identificador é uma promessa. A partir do momento em que sai da tabela onde nasceu, seja por uma API, uma exportação ou uma consulta de outro sistema, tem de se manter enquanto a coisa que identifica existir. Apagar e recriar quebra essa promessa a cada gravação.
Saltar em silêncio não é robustez. Um sistema que encontra uma referência partida e continua sem dizer nada esconde o problema de quem o podia resolver. Registar o salto, com o identificador em falta, teria reduzido a investigação a cinco minutos.
Corrigir a classe, não o caso. Um defeito encontrado num sítio raramente está só nesse sítio.