Docs/uso/GUIA_SUPER_ADMIN_PT.md

🔐 Guia Completo do Super Administrador

bindi - Painel de Super Administração da Plataforma


📋 Índice

  1. Introdução
  2. Acesso ao Painel
  3. Dashboard Global
  4. Gerenciamento de Tenants
  5. Gerenciamento de Usuários Globais
  6. Monitoramento da Plataforma
  7. Configurações Globais
  8. Segurança e Auditoria
  9. Manutenção do Sistema
  10. Suporte e Troubleshooting

Introdução

O que é o Super Admin?

O Super Administrador é o nível mais alto de acesso na plataforma bindi. Com este acesso, você pode:

  • Gerenciar todos os tenants (lojas) da plataforma
  • Monitorar métricas globais de uso e performance
  • Configurar parâmetros do sistema
  • Acessar logs de auditoria para segurança
  • Realizar manutenções e atualizações

Responsabilidades

Área Responsabilidade
Tenants Criar, suspender, gerenciar lojas
Usuários Gerenciar donos de loja e acessos
Plataforma Monitorar saúde e performance
Segurança Auditoria e conformidade
Suporte Resolver escalações técnicas

Acesso ao Painel

URL de Acesso

https://seu-dominio.com/super-admin

Requisitos de Segurança

  1. Email super-admin cadastrado no sistema
  2. Senha forte (mínimo 12 caracteres)
  3. Autenticação Two-Factor (2FA) (recomendado)
  4. IP autorizado (se configurado)

Primeiro Acesso

  1. Acesse a URL do super-admin
  2. Digite suas credenciais
  3. Configure 2FA se solicitado
  4. Revise as políticas de segurança

Dashboard Global

Visão Geral

O dashboard apresenta métricas em tempo real de toda a plataforma:

┌─────────────────────────────────────────────────────────┐
│  🌐 SUPER ADMIN DASHBOARD                               │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐   │
│  │ TENANTS  │ │ USUÁRIOS │ │ VENDAS   │ │ PRODUTOS │   │
│  │   127    │ │   1.450  │ │ 45.678   │ │  23.456  │   │
│  │ ativos   │ │  total   │ │ hoje     │ │ cadastr. │   │
│  └──────────┘ └──────────┘ └──────────┘ └──────────┘   │
│                                                         │
│  📊 SAÚDE DO SISTEMA                                    │
│  ├─ API: 🟢 Operacional (99.9% uptime)                  │
│  ├─ Database: 🟢 Saudável (45ms latência)               │
│  ├─ Storage: 🟢 OK (67% utilizado)                      │
│  └─ Auth: 🟢 Funcionando                                │
│                                                         │
│  🏆 TOP TENANTS (por vendas)                            │
│  1. Supermercado Alfa - R$ 125.000                      │
│  2. Mini Box Beta - R$ 89.000                           │
│  3. Loja Gama - R$ 67.000                               │
│                                                         │
└─────────────────────────────────────────────────────────┘

Métricas Principais

Métrica Descrição
Total Tenants Número de lojas cadastradas
Tenants Ativos Lojas com atividade nos últimos 30 dias
Total Usuários Todos os usuários da plataforma
GMV (Gross Merchandise Value) Volume total de vendas
Uptime Disponibilidade do sistema

Gerenciamento de Tenants

Listar Tenants

  1. Acesse "Tenants" no menu
  2. Visualize todas as lojas cadastradas
  3. Use filtros para buscar:
    • Por nome
    • Por status (Ativo, Inativo, Suspenso)
    • Por país/região
    • Por plano

Criar Novo Tenant

  1. Clique em "+ Novo Tenant"
  2. Preencha os dados:
Campo Descrição
Nome Fantasia Nome da loja
País Localização
Moeda Moeda principal
Plano Free, Starter, Pro, Enterprise
Email do Dono Email do proprietário
Nome do Dono Nome completo
  1. Clique em "Criar Tenant"
  2. O sistema enviará email de boas-vindas ao dono

Visualizar Detalhes do Tenant

Informações disponíveis:

Seção Dados
Resumo Status, data de criação, último acesso
Métricas Vendas, produtos, usuários
Usuários Lista de funcionários
Faturamento Plano, uso, cobrança
Logs Atividade recente

Ações sobre Tenants

Ação Descrição
Editar Modificar dados do tenant
Suspender Bloquear acesso temporariamente
Reativar Restaurar acesso após suspensão
Deletar Remover permanentemente (cuidado!)
Impersonar Acessar como se fosse o dono da loja

Impersonation (Acessar como Dono)

Recurso útil para suporte técnico:

  1. Clique no tenant
  2. Clique em "Impersonar"
  3. Você acessará o sistema como se fosse o dono
  4. Barra amarela indicará que está em modo impersonation
  5. Clique em "Sair" para voltar ao super-admin

Importante: Todas as ações em impersonation são logadas.


Gerenciamento de Usuários Globais

Tipos de Usuário Global

Tipo Descrição
Super Admin Acesso total à plataforma
Admin Acesso administrativo limitado
Suporte Visualização e impersonation
Financeiro Acesso a faturamento e relatórios

Criar Super Admin

  1. Acesse "Usuários Globais"
  2. Clique em "+ Novo Usuário"
  3. Preencha:
    • Nome completo
    • Email corporativo
    • Função (Super Admin, Admin, Suporte)
  4. Defina permissões específicas
  5. O usuário receberá email para configurar senha

Remover Acesso

  1. Localize o usuário
  2. Clique em "Desativar"
  3. O acesso é revogado imediatamente
  4. O histórico de ações é preservado

Monitoramento da Plataforma

Status em Tempo Real

Componente O que verificar
API Uptime, latência, erros
Database Conexões, queries lentas
Storage Uso de espaço, uploads
Auth Logins, falhas de autenticação
Jobs Tarefas em background

Alertas Configurados

Configure alertas para:

  • ⚠️ Latência API > 500ms
  • ⚠️ Uso de storage > 80%
  • ⚠️ Erros de autenticação frequentes
  • ⚠️ Tenant sem atividade > 30 dias
  • ⚠️ Queries lentas > 5 segundos

Visualizar Logs

  1. Acesse "Logs" no menu
  2. Filtre por:
    • Tipo (Erro, Warning, Info)
    • Componente (API, Auth, Database)
    • Período
    • Tenant específico

Configurações Globais

Parâmetros do Sistema

Configuração Descrição
Manutenção Ativar modo manutenção
Registro Permitir novos cadastros
Planos Configurar limites dos planos
Integrações APIs de terceiros

Modo Manutenção

Quando ativado:

  • Usuários veem mensagem de manutenção
  • Apenas super admins acessam
  • Vendas offline continuam funcionando

Para ativar:

  1. Acesse "Configurações" > "Sistema"
  2. Ative "Modo Manutenção"
  3. Defina mensagem personalizada
  4. Clique em "Salvar"

Configurar Planos

Plano Limites Padrão
Free 100 produtos, 1 usuário
Starter 500 produtos, 3 usuários
Pro 5.000 produtos, 10 usuários
Enterprise Ilimitado

Personalize:

  1. Acesse "Configurações" > "Planos"
  2. Edite limites de cada plano
  3. Salve alterações

Segurança e Auditoria

Logs de Auditoria

Todas as ações críticas são registradas:

Ação Dados Logados
Login Usuário, IP, horário, sucesso/falha
Criação de Tenant Quem criou, dados do tenant
Impersonation Quem, qual tenant, duração
Alteração de Config O que mudou, valor anterior
Deleção O que foi deletado, por quem

Visualizar Auditoria

  1. Acesse "Segurança" > "Auditoria"
  2. Filtre por:
    • Usuário
    • Tipo de ação
    • Período
    • Tenant afetado

Políticas de Senha

Enforçadas automaticamente:

  • Mínimo 12 caracteres
  • Letras maiúsculas e minúsculas
  • Números
  • Caracteres especiais
  • Expiração a cada 90 dias (configurável)

Sessões Ativas

Visualize e gerencie sessões:

  1. Acesse "Segurança" > "Sessões"
  2. Veja todas as sessões ativas
  3. Encerre sessões suspeitas se necessário

Manutenção do Sistema

Backups

Os backups são automáticos, mas você pode:

  1. Verificar status: "Manutenção" > "Backups"
  2. Forçar backup manual: Clique em "Backup Agora"
  3. Baixar backup: Para armazenamento externo
  4. Restaurar: Em caso de emergência

Atualizações

O sistema atualiza automaticamente, mas para atualizações manuais:

  1. Verifique a versão atual em "Sobre"
  2. Consulte changelog de novas versões
  3. Agende atualização fora do horário de pico
  4. Ative modo manutenção durante o processo

Limpeza de Dados

Periodicamente, limpe:

  • Logs antigos (> 90 dias)
  • Sessões expiradas
  • Tokens de recuperação usados
  • Dados de tenants deletados (após período legal)

Suporte e Troubleshooting

Problemas Comuns

Tenant não consegue acessar

Verificar:

  1. Status do tenant (ativo/suspenso)
  2. Status do usuário (ativo/desativado)
  3. Senha recentemente alterada
  4. Bloqueio por tentativas falhas

Solução:

  • Reativar tenant/usuário se necessário
  • Resetar senha
  • Desbloquear conta

Vendas não sincronizando

Verificar:

  1. Status da API
  2. Conexão do tenant
  3. Logs de erro do dispositivo

Solução:

  • Verificar logs do aplicativo
  • Forçar sincronização manual
  • Verificar firewall do cliente

Performance lenta

Verificar:

  1. Carga do servidor
  2. Queries lentas
  3. Uso de memória/CPU

Solução:

  • Identificar queries problemáticas
  • Otimizar índices
  • Escalar recursos se necessário

Escalação

Para problemas graves:

  1. Nível 1: Suporte interno
  2. Nível 2: DevOps
  3. Nível 3: Desenvolvimento

Contatos de Emergência


Checklist de Rotina

Diário

  • Verificar saúde do sistema
  • Revisar erros críticos
  • Checar tickets de suporte pendentes

Semanal

  • Analisar métricas de uso
  • Revisar logs de auditoria
  • Verificar tenants inativos

Mensal

  • Relatório de faturamento
  • Análise de crescimento
  • Revisão de segurança
  • Backup de verificação

Versão do Documento: 1.0
Última Atualização: Fevereiro 2026
Classificação: Confidencial - Apenas Super Admins