Manual do Administrador

Visão geral

Como Administrador do GymAI, você tem acesso total à plataforma, podendo gerenciar usuários, planos, aprovações, finanças e configurações gerais do sistema.

🔐 Acesso ao Painel Administrativo

Como Acessar

1. Faça login no app GymAI
2. Clique no ícone de perfil (canto superior)
3. Selecione "Administrador"
4. Você será redirecionado para o Painel Admin

Painel administrativo

Rota: /admin (AdminDashboardScreen). Acesso restrito à role system_admin.

Métricas principais

👥 Gestão de Usuários

Rotas: /admin-users ou /admin-user-management (UserManagementScreen)

Funcionalidades

1. Listar Todos os Usuários

• Visualizar lista completa
• Filtrar por role (user, personal_trainer, gym_owner, instructor)
• Buscar por nome ou email

2. Visualizar Perfil

• Dados pessoais completos
• Role atual
• Histórico de atividades
• Assinatura ativa

3. Editar Usuário

• Alterar informações básicas
• Ativar/Desativar conta
• Modificar roles

4. Suspender/Banir

• Suspensão temporária
• Banimento permanente
• Motivo obrigatório (registrado em auditoria)

✅ Aprovações Pendentes

Rota: /admin-pending-approvals

Fluxo de Aprovação

Personal Trainers

1. Ver lista de solicitações pendentes
2. Clicar para ver detalhes (certificações, experiência, especialidades, documentos)
3. Aprovar: Role muda para personal_trainer, usuário é notificado
4. Rejeitar: Informar motivo, enviar feedback ao solicitante

Instrutores

Mesmo fluxo dos Personal Trainers. Verificar:

• Modalidades oferecidas
• Certificados específicos
• Experiência comprovada

Academias

Validação mais rigorosa:

• Verificar CNPJ
• Validar endereço
• Conferir licenças e alvarás
• Aprovar ou solicitar mais informações

💳 Gestão de Planos e Assinaturas

Rotas: /admin-plans ou /admin-app-plans (AppPlansAdminScreen). Features dos planos: /admin-plans-features (AppPlanFeaturesAdminScreen)

Planos Disponíveis

Criar Novo Plano

1. Clicar em "+ Novo Plano"
2. Preencher: Nome, Preço, Descrição, Período de teste
3. Selecionar features permitidas
4. Definir quotas (limites mensais): -1 = Ilimitado, 0 = Bloqueado, N = Limite de N/mês
5. Salvar

🎟️ Cupons e Promoções

Rota: /admin-coupons

Tipos de Cupons

Criar Cupom

1. Clicar em "+ Novo Cupom"
2. Preencher código (ex: GYMAI2025)
3. Escolher tipo (percentual/fixo/meses grátis)
4. Definir valor, datas, limites
5. Selecionar planos aplicáveis
6. Salvar

Acompanhar Performance

• Total de resgates
• Receita impactada
• Conversão de trial → pago
• Ranking de cupons mais usados

🎁 Isenções

Rota: /admin-exemptions

Quando Usar

• Parcerias estratégicas
• Influenciadores
• Casos especiais
• Beta testers VIP
• Funcionários da empresa

Criar Isenção

1. Ir para "Isenções"
2. Clicar em "+ Nova Isenção"
3. Buscar usuário por email
4. Selecionar plano isento (ex: Premium)
5. Definir duração (Permanente ou Temporária com data final)
6. Adicionar motivo/justificativa
7. Salvar

💰 Módulo Financeiro

Rotas: /admin-finance ou /admin-financial-dashboard (AdminFinancialDashboardScreen)

Aba: Visão Geral

Aba: Repasses

Lista de todas as solicitações de saque de profissionais e academias.

Processar Repasse

1. Clicar em "✓ Processar" no repasse desejado
2. Confirmar detalhes (valor, destinatário, chave PIX)
3. Clicar em "Confirmar"
4. Aguardar processamento
5. Snackbar de sucesso confirma operação

Status de Repasses

• 🟡 pending - Aguardando aprovação
• 🔵 processing - Em processamento
• 🟢 completed - Concluído
• 🔴 rejected - Rejeitado
• ⚫ cancelled - Cancelado

Aba: Analytics

• Top 5 Profissionais por receita gerada
• Top 5 Academias por volume de transações
• Identificar parceiros estratégicos
• Base para programas de incentivo

Relatórios

Rota: /admin-reports (AdminReportsScreen). Acesso a relatórios consolidados da plataforma.

Sincronização de clientes

Rota: /admin-customers-sync (AdminCustomersSyncScreen). Sincronização com gateway de pagamento ou sistemas externos (ex.: clientes/assinaturas).

Teste de streaming

Rota: /admin-test-streaming (TestStreamingScreen). Ferramenta de suporte para testar transmissões (aulas ao vivo, etc.).

Analytics de navegação

Rota: /admin-navigation-analytics (AdminNavigationAnalyticsScreen). Métricas de navegação dos usuários na plataforma.

Rotas resumidas

⚙️ Configurações da Plataforma

Firestore: platform_settings/default

Ativar Modo Manutenção

1. Abrir Firebase Console
2. Ir para Firestore
3. Collection: platform_settings
4. Document: default
5. Editar: "maintenanceMode": true
6. Todos os usuários (exceto admins) verão tela de manutenção

🔍 Auditoria e Logs

Ações Auditadas

• Criação/edição de usuários
• Aprovação/rejeição de profissionais
• Processamento de repasses
• Alterações em planos
• Criação de cupons
• Concessão de isenções

Visualizar Logs

No Painel Admin > Atividades Recentes

Cada log contém:

• Data/Hora
• Admin responsável
• Ação realizada
• Detalhes
• IP (se aplicável)

📞 Suporte e Ajuda

FAQ

P: Como adicionar um novo administrador?

P: Como alterar taxa de comissão?

R: Ver seção "Configurações da Plataforma" acima.

P: O que fazer se um repasse falhar?