Ajustar a situação de exclusão de usuário de BDpro a partir de webhooks

[laura-l-amaral]

Caso de usuário que reativou a assinatura e não entrou no grupo de BDpro (ou foi removido posteriormente)

https://discord.com/channels/787841210433536010/1466480361339879607

[AldemirLucas]

Recentemente, foi identificada uma situação em que chamadas realizadas pelo front-end para o back-end estavam causando sobrecarga, resultando, por um período, em respostas com timeout ou erro 500 até que o sistema se recuperasse. Acredita-se que, durante esses episódios, quando deveria ocorrer a inserção do usuário no grupo do BD Pro e ocorria uma falha, não era registrado que o usuário não havia sido adicionado, mesmo estando com a assinatura ativa, ocasionando o cenário descrito.

[laura-l-amaral]

Outro evento de não adição no google groups (17/03/2026)

Bom dia!
Meu e-mail BigQuery cadastrado é space@vlx.space, estou consultando logado com essa mesma conta, porém a tabela basedosdados.br_me_cnpj.estabelecimentos só retorna até 2025-08-10 e o BigQuery exibe aviso de acesso restrito a linhas.

[AldemirLucas]

Melhoria nos Logs:

Atualmente, as funções de log muitas vezes carecem de contexto imediato, o que dificulta o debug para saber de onde partiu a requisição (ex: qual evento disparou a ação).

• Adicionar o contexto do webhook: Incluir o tipo de evento (ex: customer.subscription.deleted, customer.subscription.updated) nas mensagens.
• Incluir IDs essenciais: Registrar o ID do evento do Stripe (event.id), além do e-mail do cliente, permitindo correlação imediata com o painel do Stripe.
• Propagar contexto: Passar dados de contexto de qual função gerou o log (como handle_subscription, add_user, e remove_user) incluindo argumentos explícitos ou kwargs, para que os logs internos dessas funções também saibam quem as invocou.

---

Dupla Verificação de Assinatura antes de Remover do Google Groups:

Como um cliente pode ter múltiplas inscrições (ex: uma antiga cancelada e uma nova em ativação), o evento de deleção de uma não pode ser motivo para expulsá-lo imediatamente sem antes checar a situação global do usuário.

• Webhook: Na função remove_user ou imediatamente antes de chamá-la, realizar uma checagem rigorosa para ver se, naquele exato momento, o usuário possui alguma outra assinatura ativa.
• Reforçar user.is_subscriber: Atualmente o código faz if user and user.is_subscriber: return. Se essa flag de banco de dados tiver algum cache ou atraso na atualização em relação ao webhook em andamento, o usuário será removido.

---

• Prevenção de erro 500: Substituídos métodos .get() por .filter(...).first() em consultas ao modelo Account nas funções de adicionar/remover do grupo.
• Padronização de E-mails: Centralizado e refatorado o uso do validador interno _normalize_plus(email) em funções que interagem com o Google Directories is_email_in_group.

[AldemirLucas]

basedosdados/backend#1001