Gestão de Tenants
Quantidade de clientes e corretoras cadastradas no ecossistema com isolamento seguro.
Área Global /platform-admin
Painel Administrativo.
A área administrativa global permite aos operadores gerenciar e monitorar toda a infraestrutura SaaS, incluindo parametrização de novos clientes (tenants), envio de e-mails do sistema e faturamento recorrente.
Usuários Ativos
Mapeamento e ativação de contas administrativas e operacionais por tenant.
Assinaturas & MRR
Acompanhamento de receita recorrente mensal e controle de status de inadimplência.
Estrutura de Rotas
Submódulos Administrativos
| Rota | Finalidade Operacional |
|---|---|
| /platform-admin | Dashboard consolidado com KPIs da plataforma e atalhos rápidos. |
| /platform-admin/tenants | Criação, ativação, bloqueio e impersonação de tenants. |
| /platform-admin/integrations | Configuração de e-mail via Microsoft Graph API e SMTP/IMAP. |
| /platform-admin/asaas | Geração de assinaturas recorrentes e controle de webhooks do Asaas. |
| /platform-admin/users | Adição direta de usuários administrativos no tenant selecionado. |
| /platform-admin/billing | Lançamentos e conciliação de faturas manuais da plataforma. |
Integração de E-mail
Microsoft Graph API
Esta é a integração padrão e recomendada para envio de convites e notificações da plataforma. Garante que os e-mails não caiam na caixa de spam e dispensa autenticação por SMTP legada.
Passo a Passo de Configuração:
- Acesse o Microsoft Entra (Azure AD) e crie um App Registration como Single Tenant.
- Adicione a permissão do Microsoft Graph 'Mail.Send' com o tipo 'Application'.
- Conceda o consentimento de administrador (Grant admin consent) para a permissão criada.
- Gere um Client Secret seguro e insira os dados no formulário de integrações do Harper Analytics.
- Salve as configurações e clique no botão 'Testar envio' para validar o status CONNECTED.
Cobrança Recorrente
Integração Asaas
Permite o faturamento automático das corretoras por boleto, PIX ou cartão. Os pagamentos são monitorados via Webhook seguro no backend para bloquear ou liberar o acesso do tenant automaticamente.
Checklist Administrativo
Ações antes de ativar novo tenant
O e-mail padrão do remetente foi configurado corretamente no Microsoft Graph.
A permissão Mail.Send foi concedida e ativada no painel do Microsoft Entra.
O slug do tenant foi validado (somente letras minúsculas, números e hífens) antes de salvar.
As assinaturas e planos comerciais foram parametrizados no painel Asaas.
O link do convite gerado manualmente foi enviado ao usuário em caso de falha no envio por e-mail.