Logo

User Manual

Complete guide to using Vem de Rotas. Learn how to use each module and get the most out of the platform.

O Vem de Rotas é um painel administrativo completo construído com Next.js 16, projetado para ser a base de qualquer sistema que precise de gestão de usuários, permissões e monitoramento de atividades.

Dashboard
Usuários
Perfis & Permissões
Feedbacks
Logs
Perfil

A navegação principal fica na barra lateral esquerda. Em dispositivos móveis, use o ícone de menu para expandir. Cada módulo é exibido apenas se o usuário tiver permissão para acessá-lo.

Login

  • E-mail e senha: preencha o formulário e clique em "Entrar"
  • Google/GitHub: clique no botão OAuth correspondente
  • Sessão persistida: o painel mantém você logado via refresh token automático

Registro

Acesse a página inicial e clique em “Criar conta”. Preencha nome, e-mail e senha. Se a verificação de e-mail estiver ativa, confirme seu endereço antes do primeiro acesso.

Recuperação de Senha

Na tela de login, clique em “Esqueci minha senha”, informe seu e-mail e aguarde o link de redefinição (válido por 60 minutos).

O Dashboard exibe métricas e informações relevantes de acordo com o perfil (role) do usuário logado.

Cards de Estatísticas

Total, ativos, inativos e novos usuários nos últimos 30 dias.

Resumo de Feedbacks

Distribuição por status: pendente, em análise, resolvido, rejeitado.

Logs Recentes

Últimas ações do sistema com responsável, entidade e horário.

O módulo de Usuários permite listar, criar, editar e gerenciar contas do sistema.

Listagem

  • Busca por nome ou e-mail em tempo real (com debounce)
  • Filtro por perfil (role) e status (ativo/inativo)
  • Ordenação por nome, status ou data de criação
  • Visualização em lista (tabela) ou grade (cards)
  • Alternância de visualização salva nas suas preferências

Ações

Criar usuário

Clique no botão "+ Novo usuário". Preencha nome, e-mail, telefone, perfil e senha.

Editar

Clique nos três pontos (...) ao lado do usuário e selecione "Editar".

Ativar/Desativar

Use o toggle de status diretamente na linha/card do usuário.

Excluir

Selecione "Excluir" no menu de ações. A ação é irreversível.

O sistema de perfis (roles) e permissões permite controlar exatamente o que cada usuário pode ver e fazer no painel.

Perfis (Roles)

  • Acesse o menu "Perfis" na barra lateral
  • Clique em "+ Novo perfil" para criar um grupo
  • Expanda um perfil clicando nele para ver suas permissões
  • Use o campo de busca para vincular usuários ao perfil
  • Exclua perfis não utilizados (usuários não são afetados)

Permissões

Cada permissão representa uma ação específica (ex: users_create,feedbacks_delete). Acesse “Permissões” para criar novas permissões e vinculá-las a perfis existentes.

O módulo centraliza feedbacks enviados pelos usuários do sistema ou do formulário público.

Tipos

Sugestão, Bug, Elogio e outros tipos configuráveis.

Status

Pendente → Em análise → Resolvido / Rejeitado. Altere via menu de ações.

Visualização

Lista (tabela) ou grade (cards). Filtros por tipo, status e busca por texto.

Detalhes

Clique em um feedback para ver descrição completa, imagem (se houver) e dados do autor.

Os Logs de Atividade registram automaticamente ações realizadas no sistema para fins de auditoria e rastreabilidade.

Filtros Disponíveis

Responsável (causer)Tipo de entidadeEvento (criado/atualizado/excluído)Período (data de/até)

Clique em qualquer log para ver os detalhes completos, incluindo as propriedades que foram alteradas (antes e depois), a entidade afetada e um link para o perfil do responsável pela ação.

Acesse “Meu Perfil” clicando em seu nome no rodapé da barra lateral. O perfil está dividido em abas:

Informações

Edite nome e telefone.

Foto de Perfil

Faça upload ou remova seu avatar (PNG, JPG ou GIF, máx. 2MB).

Alterar Senha

Informe a senha atual e defina uma nova (mín. 8 caracteres).

Contas Vinculadas

Gerencie provedores OAuth conectados (Google, GitHub).

Preferências

Defina idioma (pt-BR / en) e tema (claro / escuro). Salvo automaticamente.