Saúde da conexão, reconexão e desconexão

O problema real

Uma integração pode morrer sem avisar ninguém. A pessoa entra no provedor (Google, Microsoft) e revoga o acesso por lá. A conexão deixa de existir do outro lado — sem que nada nos avise. Nosso espelho local continua dizendo "ativo".

Resultado para quem usa: o agente tenta agir, falha, e a tela mostra a integração conectada. Sem detecção, o diagnóstico é impossível.

Conexões fantasma

O detector existe exatamente para esse cenário. A lógica lida no código:

• A consulta ao vivo é a fonte da verdade. O espelho local não pode ser usado como atalho barato, porque é justamente ele que fica desatualizado nesse modo de falha.
• Coalescência por identidade: para cada identidade referenciada, uma única consulta à lista de contas conectadas. Uma identidade com cinco serviços custa uma varredura, não cinco.
• Para cada serviço, marca-se como fantasma quando a resposta ao vivo não traz uma conta ativa.

A decisão que evita alarme falso

Se a própria consulta ao vivo falhar, pulamos em vez de marcar — melhor um falso negativo do que um falso positivo assustando o usuário com uma reconexão desnecessária.

Vale como princípio de projeto para qualquer verificação de saúde: indisponibilidade do verificador não é evidência de falha do verificado.

O espelho e o que ele guarda além do status

Sincronizado em três pontos (autorização concluída, desconexão pelo painel, evento do provedor), o espelho ainda registra que o provedor recusou a credencial — informação que nenhum dos três produz, porque nasce da tentativa de uso que falhou.

Sem esse registro, um erro de autenticação seria apenas uma falha isolada; com ele, vira estado consultável para sugerir reconexão.

Desconectar

Uma ação própria atualiza o espelho para inativo. Diferente da revogação feita no provedor, esta é observável e imediata.

Como isso aparece para quem usa

• A tela de integrações mostra o estado por serviço.
• No chat, quando falta conexão, o motivo tipado diz de quem é a conexão que falta e se vale tentar de novo.

O que dá para fazer