Operação diária no Admin

TLDR: Os procedimentos manuais da equipe no ActiveAdmin: aprovar documentação, criar filiação à mão e atualizar o código de rastreio da carteira.

O Admin de produção fica em https://api.cbtrg.com/admin. Todos os passos abaixo exigem usuário com admin: true.

Pré-requisitos

Conta de admin no CITRG.
Para os fluxos de documentação, entender que a aprovação do perfil (UserProfile) é o que libera o membro a editar o perfil público; a aprovação da filiação (Membership) é o que conta para o gate de acesso ao Apolo.

Autorizar envio de documentação — processar carteiras

Fazer login em https://api.cbtrg.com/admin.
Ir em https://api.cbtrg.com/admin/user_profiles.
A página tem várias abas, que são filtros. Focar em “Pronta para revisar”. A aba “Documentação Pendente” são as pessoas que ainda não enviaram tudo — a menos que haja uma ligação ou e-mail perguntando, não precisa de atenção.
- Assim que a pessoa termina de enviar toda a documentação pelo site, ela é movida automaticamente para “Pronta para revisar”.
Ao abrir um perfil, há o botão “Aprovar Perfil” no topo.
Esse botão pega a imagem enviada pela pessoa, coloca dentro da filiação e autoriza o perfil. Um e-mail é enviado à pessoa avisando que a documentação foi aprovada.

Membros com carteira definitiva emitida não passam por esse fluxo na renovação — a aprovação é automática, ver R-004.

Atualizar o código de rastreio dos Correios de uma filiação

Fazer login em https://api.cbtrg.com/admin.
Ir em https://api.cbtrg.com/admin/memberships/.
Encontrar a carteira e clicar em editar.
Preencher o campo “Código de rastreamento da carteira” e salvar antes de qualquer outra ação.
Depois de salvar, clicar em “Enviar atualização de carteira”, no topo à direita.
O usuário recebe um e-mail informando que a carteira ficou pronta, com o código para rastrear nos Correios.

Criar uma filiação manualmente

Normalmente o processo é todo automatizado pelo webhook do checkout — este fluxo é para exceção. O perfil só é criado uma vez; depois basta criar novas filiações.

Criar o usuário, se não existir, em /admin/users/new. A senha não importa (o login e senha são do Apolo), então qualquer senha de 6 dígitos ou mais serve. O e-mail tem que ser obrigatoriamente igual ao do Apolo.
Criar um perfil para o usuário em /admin/user_profiles/new. Não precisa preencher todos os campos — usuário, nome, telefone e endereço bastam.
Criar a filiação em /admin/memberships/new. Precisa selecionar o usuário; praticamente todos os campos são obrigatórios.
Voltar no perfil criado no passo 2 e aprová-lo pelo botão no topo.

Procedimento Administrativo (PAD)

Os procedimentos administrativos ficam em /admin/administrative_procedures. Um procedimento pode ter uma filiação associada e, a partir dela, permite Suspender Filiação e Reativar Filiação. Toda alteração é registrada na trilha de auditoria (gem Audited). Ver a spec do módulo.

Troubleshooting

Suspensão que “deu certo” mas não suspendeu — era um bug de falha silenciosa, corrigido: suspend!/unsuspend! passaram a usar update! e as chamadas foram para dentro do begin/rescue. Se o histórico do procedimento registrar a suspensão, membership.suspended está de fato true. Ver a spec.
Jobs de e-mail e de notificação — visíveis e re-executáveis em /good_job.