Runbook — Aprovar um sócio

Quem pode: super_admin (presidente). Onde: /admin/usuarios.

Contexto

Quando alguém paga a associação, o webhook marca o perfil como pago-e-pendente (membership_paid_at preenchido, membership_status = 'pending'). A ativação é manual (ver ADR-0002).

Passos

1. Acesse /admin/usuarios.
2. Localize o usuário com status pendente de aprovação (pagou e aguarda).
3. Confira o pagamento no /admin/financeiro se houver dúvida (pedido do tipo associação com status pago).
4. Clique em aprovar. Isso chama assign_membership_card, que:
   • gera member_number sequencial, card_token e a validade conforme o plano;
   • ativa membership_status = 'active';
   • credita o bônus de boas-vindas de pepitas (uma única vez).
5. Confirme que o sócio agora aparece como ativo e que a carteirinha está disponível para ele em /socios/carteirinha.

Se algo der errado

• Pagou mas não aparece como pendente: verifique o webhook (o pedido virou paid?) em /admin/financeiro. O webhook confirma o pagamento por reconsulta na API do Sicoob; se a integração Sicoob não estiver configurada, o pagamento não confirma.
• Aprovou por engano: use revoke_membership (encerra a associação; mantém número/token para histórico).