Manual do Administrador
Este manual descreve as funcionalidades disponíveis no painel administrativo (PanelAdmin) do Vertex Contas. Acesso restrito à role admin.
Visão Geral
O painel admin concentra configurações do sistema, gestão de usuários, planos, gateways de pagamento, blog, Wiki, gamificação e documentos legais.
Configurações
Em Admin → Configurações você encontra abas para:
| Aba | Descrição |
|---|---|
| Geral | Nome do sistema, fuso horário e configurações base. |
| Marca | Logo, nome do plano PRO e branding. |
| Driver SMTP, SES ou outro. Teste de envio. | |
| Blog | Configurações do módulo Blog. |
| Documentos | Templates de documentos oficiais. |
| Segurança | Políticas de senha e limpeza de logs de auditoria. |
| Funcionalidades | Habilitar/desabilitar módulos. |
| Pusher | Configuração de WebSockets para Chat VIP. |
| Homepage | Conteúdo da landing page. |
IA (Gemini)
Na aba IA / Gemini configure a integração com a API do Google Gemini para:
- Vertex Bot: dicas personalizadas no dashboard
- Consultoria PRO: conclusão estratégica e projeções em PDF
- Categorização de extratos na importação CSV
A chave pode ser definida no Admin ou via variável GEMINI_API_KEY no arquivo .env. Mantenha a chave em sigilo.
Planos
Gerencie os planos Free e PRO: limites de transações, recursos habilitados e preços. O conteúdo da página pública /planos pode ser editado em Plan → Editar conteúdo.
Gateways de Pagamento
Configure integrações com Stripe, Mercado Pago e correlatos. Habilite ou desabilite gateways individualmente. As assinaturas PRO são processadas pelos gateways configurados.
Gestão de Usuários
Liste, edite, suspenda ou ative usuários. Gerencie roles e permissões. Visualize pagamentos e assinaturas por usuário.
Medalhas e Regras de Conquistas
Em Gamificação → Medalhas cadastre medalhas com título, descrição, ícone e raridade. Em Regras de Conquistas defina as condições para desbloquear cada medalha (ex.: atingir meta de poupança, orçamento respeitado).
Central de Insights
Gerencie os insights didáticos exibidos pelo Vertex Bot. Cada insight está vinculado a um evento (ex.: page_reports, page_budgets) e nível (info, warning). Quando a IA está desabilitada, esses insights servem de fallback.
Central Legal
Edite os textos de Termos de Uso, Política de Privacidade (LGPD), Termos de Assinatura e Política de Cookies. Alterações são aplicadas imediatamente no sistema.