NOTAS SOBRE ALERTAS DE QUEDA
Recuperando as quedas que você perdeu offline
O stream não retransmite o que disparou durante uma queda. O endpoint REST de quedas guarda o registro; veja como mesclá-lo sem duplicar.
O leitor ficou fora por uma hora: um deploy, um processo que caiu, um laptop que dormiu. O stream reconecta limpo, mas a reconexão só cobre o que acontece daqui em diante. As quedas que dispararam enquanto você estava fora não são retransmitidas. Recuperá-las é um passo deliberado, e o endpoint REST de quedas é a ferramenta para isso.
Aceite que a lacuna é real
O stream empurra alertas conforme as quedas são detectadas e não guarda backlog para você. Quando o seu leitor reconecta, ele começa do agora. Qualquer coisa que se moveu durante a queda existe só no registro que a API mantém, que é exatamente o que o endpoint serve: as mesmas quedas, consultáveis sob demanda, como a comparação entre stream e endpoint apresenta, verificado em 2026-10-28.
Então a recuperação tem duas metades: ponha o stream no ar de novo, depois pergunte ao endpoint o que você perdeu. Pular a segunda metade deixa um buraco que depois se lê como mercado quieto.
Peça a janela ao endpoint
Consulte o endpoint de quedas para a janela da queda, filtrado pelos seus esportes. A página de comparação documenta a diferença de formato que importa aqui: o endpoint retorna objetos com from, to, market, side e sport_name, e adiciona três campos que o stream não carrega: drop_pct, age_s e is_live. O percentual e a idade vêm calculados, o que é conveniente, e os nomes dos campos são diferentes, o que é a armadilha.
Escreva o mapeamento uma vez e guarde-o junto ao relay: from_price lê from, to_price lê to, sect lê market, outcome lê side. Código que aplica os nomes de campo do stream aos objetos do endpoint perde os números em silêncio, o tipo de bug que parece um resultado vazio.
Mescle sem duplicar
O seu armazenamento de deduplicação decide quanto a queda custou. Case cada linha do endpoint com os alertas que você registrou antes da lacuna, por evento e resultado, como o guia de deduplicação os chaveia, verificado em 2026-10-28. O que já está no armazenamento é duplicata; o que é novo pertence ao log com uma marca que diz que chegou tarde.
Essa marca importa mais do que parece. Um alerta recuperado é evidência sobre o mercado no momento do alerta, não um sinal para agir agora. Encaminhe alertas recuperados para o log e para o resumo da manhã, não para o canal que acorda pessoas, a menos que a sua revisão de cada um diga o contrário.
Meça a queda, não só a lacuna
Feche o ciclo com dois números: quanto tempo a lacuna durou, e quantas quedas o endpoint mostrou para ela. O primeiro diz se a sua política de restart está fazendo o trabalho. O segundo diz quanto o downtime custa nos seus esportes, que é o número que defende um leitor standby mais adiante.
Uma queda tratada assim não deixa nada para trás: o stream está no ar, o registro está completo, e o log diz claramente quais entradas foram recuperadas. O mercado continuou se movendo enquanto você estava fora. Agora os seus registros concordam.