O MeuAssistente é um sistema multitenancy completo para gestão financeira e de compromissos, integrado com agentes de IA para processamento de mensagens WhatsApp e automação de tarefas.
✅ PAINEL ADMINISTRATIVO COMPLETO IMPLEMENTADO
O sistema agora possui:
- Autenticação completa com NextAuth.js e Google OAuth
- Painel do usuário com gestão de transações, compromissos e tarefas
- Painel administrativo completo para OWNER/ADMIN global
- APIs REST para todas as funcionalidades core
- Interface responsiva e moderna com Tailwind CSS
- Frontend: Next.js 15 com App Router
- Backend: API Routes do Next.js
- Banco de Dados: PostgreSQL com Prisma ORM
- Autenticação: NextAuth.js
- Styling: Tailwind CSS
- Processamento: N8N (próxima etapa)
- Pagamentos: Asaas (próxima etapa)
- Login com Google OAuth
- Registro de usuários
- Sistema de roles (OWNER, ADMIN, USER)
- Redirecionamento baseado em papel
- Dashboard com métricas
- Gestão de usuários do family
- Gestão de categorias
- Gestão de transações financeiras
- Gestão de compromissos
- Gestão de tarefas
- Página de integrações
- Gestão de Planos: Básico, Premium, Enterprise
- Gestão de Assinaturas: Filtros, status, ações
- Gestão de Pagamentos: Faturas, status de pagamento
- Relatórios: Métricas de faturamento, usuários, crescimento
- Configurações: Parâmetros do sistema, integrações
- Monitoramento N8N: Workflows, logs, métricas
- Usuários (CRUD completo)
- familys (empresas)
- Categorias
- Transações
- Compromissos
- Tarefas
- Uso e assinaturas
- Logs de auditoria
- Node.js 20+ (recomendado) ou 18+
- PostgreSQL 16+ (ou compatível)
- Docker (opcional, para containerização)
- Git (para versionamento)
- Clone o repositório
git clone <repository-url>
cd MeuAssistente- Instale as dependências
npm install- Configure as variáveis de ambiente
cp .env.example .env
# Edite o arquivo .env com suas configurações- Configure o banco de dados
npx prisma generate
npx prisma db push
npx prisma db seed- Execute o projeto
npm run devdocker-compose up -ddocker build -t meuassistente .docker run -p 3000:3000 \
-e DATABASE_URL="postgresql://..." \
-e NEXTAUTH_SECRET="seu-secret" \
-e NEXTAUTH_URL="http://localhost:3000" \
meuassistenteO projeto inclui um Dockerfile otimizado para deploy no EasyPanel. Veja o guia completo em EASYPANEL_SETUP.md.
Passos rápidos:
- Conecte seu repositório Git no EasyPanel
- Configure as variáveis de ambiente (veja
EASYPANEL_SETUP.md) - Defina a porta:
3000 - Faça o deploy
- Execute as migrations:
npx prisma migrate deploy
Variáveis de ambiente obrigatórias:
DATABASE_URL- String de conexão PostgreSQLNEXTAUTH_SECRET- Secret para NextAuthNEXTAUTH_URL- URL da aplicaçãoNEXT_PUBLIC_APP_URL- URL pública da aplicação
MeuAssistente/
├── src/
│ ├── app/
│ │ ├── api/ # API Routes
│ │ │ ├── auth/ # Autenticação
│ │ │ ├── users/ # Usuários
│ │ │ ├── tenants/ # Famílias (Tenants)
│ │ │ ├── categories/ # Categorias
│ │ │ ├── transactions/ # Transações
│ │ │ └── ...
│ │ ├── dashboard/ # Painel principal
│ │ │ ├── layout.tsx # Layout com menu dinâmico
│ │ │ ├── page.tsx # Dashboard
│ │ │ ├── users/ # Gestão de usuários
│ │ │ ├── plans/ # Gestão de planos (Admin)
│ │ │ ├── subscriptions/ # Gestão de assinaturas (Admin)
│ │ │ ├── payments/ # Gestão de pagamentos (Admin)
│ │ │ ├── reports/ # Relatórios (Admin)
│ │ │ ├── settings/ # Configurações (Admin)
│ │ │ └── n8n/ # Monitoramento N8N (Admin)
│ │ ├── login/ # Página de login
│ │ └── register/ # Página de registro
│ └── lib/ # Utilitários
│ ├── db.ts # Configuração Prisma
│ └── ...
├── prisma/
│ ├── schema.prisma # Schema do banco de dados
│ └── seed.ts # Seed do banco
├── public/ # Arquivos estáticos
├── scripts/ # Scripts auxiliares
│ └── docker-entrypoint.sh # Script de inicialização Docker
├── Dockerfile # Dockerfile para produção
├── docker-compose.yml # Docker Compose (desenvolvimento)
├── .dockerignore # Arquivos ignorados no Docker
├── EASYPANEL_SETUP.md # Guia de deploy no EasyPanel
└── README.md # Este arquivo
Após executar o seed, você terá acesso a:
- Email: admin@teste.com
- Senha: admin123
- Acesso: Painel administrativo completo
- Email: admin-global@teste.com
- Senha: admin123
- Acesso: Painel administrativo do family
- Email: usuario@teste.com
- Senha: usuario123
- Acesso: Painel do usuário
O sistema apresenta menus diferentes baseados no papel do usuário:
Para USER:
- Dashboard
- Usuários
- Categorias
- Transações
- Compromissos
- Tarefas
- Integrações
Para OWNER/ADMIN:
- Dashboard
- Clientes (familys)
- Planos
- Assinaturas
- Pagamentos
- Relatórios
- Configurações
- Monitoramento N8N
O projeto inclui um Dockerfile multi-stage otimizado para produção:
- Build otimizado: Multi-stage build reduz tamanho da imagem
- Segurança: Executa com usuário não-root
- Prisma: Geração automática do Prisma Client
- Standalone: Next.js configurado para produção
Guia completo de deploy disponível em EASYPANEL_SETUP.md.
Características:
- ✅ Dockerfile compatível com EasyPanel
- ✅ Configuração de variáveis de ambiente
- ✅ Health checks configurados
- ✅ Suporte a migrations automáticas
- ✅ Documentação completa
- Integração de Dados Reais: Conectar páginas com APIs do Prisma
- Sistema de Assinaturas: Implementar lógica de planos e pagamentos
- Setup N8N: Configurar ambiente de processamento
- Integrações Google: Calendar e Tasks APIs
- WhatsApp Business: Configuração do número único
- Testes Automatizados: Cobertura de funcionalidades críticas
- CI/CD: Pipeline automatizado de deploy
- Fork o projeto
- Crie uma branch para sua feature (
git checkout -b feature/AmazingFeature) - Commit suas mudanças (
git commit -m 'Add some AmazingFeature') - Push para a branch (
git push origin feature/AmazingFeature) - Abra um Pull Request
Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.
Para dúvidas ou suporte, entre em contato através dos canais oficiais do projeto.
Desenvolvido com ❤️ para simplificar a gestão financeira e de compromissos