Valho

Visão Geral

Valho é uma plataforma administrativa de gestão corporativa com frontend em Next.js 16 e backend em Node.js + Express. O sistema oferece controle de autenticação, gerenciamento de usuários, convites, papéis, permissões e visualização de dados em um dashboard centralizado.

Por que usar

• Autenticação segura com JWT e sessão armazenada em Redis
• Controle de acesso por permissões e papéis administrativos
• Cadastro de usuários via convite
• Reset de senha por e-mail com token seguro
• Interface moderna com React, Tailwind CSS e animações Framer Motion
• Backend protegido com Helmet, rate limiter e validação de entrada com Zod

Funcionalidades Principais

Backend (API)

• Login, logout, registro e validação de token
• Reset de senha e confirmação de redefinição
• Gestão de usuários: listagem, ativação, inativação e convites
• Gestão de papéis e permissões: criação e edição de grupos, atribuição de usuários
• Dashboard e atividades com filtros e paginação
• Configurações gerais e dados de sistema

Frontend

• Área de login com proteção de rotas
• Dashboard inicial com dados de negócio
• Navegação lateral com menu hierárquico
• Páginas de usuário, permissões e configuração
• Processos de convite e gerenciamento de usuários
• Suporte a notificações com react-hot-toast

Estrutura do Repositório

• api/ - backend Express com rotas, controladores, serviços, middleware e configuração de banco/Redis
• web/ - frontend Next.js com App Router, páginas, componentes e rotas de API proxy
• api/db.sql - scripts de criação SQL para banco de dados

Tecnologias

• Backend: Node.js, Express, MySQL2, Redis, JWT, Zod, Helmet, Nodemailer
• Frontend: Next.js 16, React 19, Tailwind CSS 4, TypeScript, Framer Motion, SweetAlert2

Como Executar

Backend

cd api
npm install
npm run dev

Frontend

cd web
npm install
npm run dev

Acessar

• Frontend: http://localhost:4000
• Backend: porta definida pelo seu src/server.js (geralmente http://localhost:3000 ou similar)

Variáveis de Ambiente

No backend, defina as variáveis necessárias no .env:

• JWT_SECRET - chave secreta para tokens JWT
• DB_HOST, DB_USER, DB_PASSWORD, DB_NAME - conexão MySQL
• REDIS_URL ou configuração do Redis
• MAIL_USER, MAIL_PASS, MAIL_HOST, MAIL_PORT - e-mail para reset de senha

No frontend, defina no .env ou no ambiente de execução:

• API_URL - URL base do backend
• APP_TOKEN - token de aplicação usado nas chamadas proxy do frontend

Observações para Clientes

Valho é uma solução ideal para empresas que precisam de um painel administrativo seguro com recursos de gestão de acesso e usuários. A plataforma já conta com: autenticação corporativa, multilayer de segurança, gerenciamento de convites e controle de permissões.

O sistema está preparado para evoluir com módulos adicionais de financeiro, estoque e relatórios avançados.

Próximos Passos

• Personalizar layouts e textos de acordo com a identidade da empresa
• Completar os módulos de financeiro e estoque
• Adicionar testes automatizados e CI/CD
• Finalizar documentação de API e fluxo de deploy