Smarter One V2 — Backend Funcional
Sistema completo de gestão de estágios com banco de dados real, autenticação, permissões por perfil e geração de documentos.
⚠️ Esta é a versão de homologação/backend — separada do protótipo navegável anterior.
🚀 Stack
- Next.js 14 (App Router)
- TypeScript
- Prisma ORM + PostgreSQL (Supabase)
- NextAuth.js (autenticação por credenciais)
- Tailwind CSS
- Server Actions (CRUD sem API REST separada)
📋 Pré-requisitos
- Node.js 18+
- Conta no Supabase (gratuita)
- npm ou yarn
1. Instalação
# Clone ou extraia o projeto
cd smarter-v2-backend
# Instale as dependências
npm install
2. Configurar o arquivo .env
Crie o arquivo .env na raiz do projeto:
# ── BANCO DE DADOS (Supabase) ─────────────────────────────────
# Acesse: Supabase Dashboard > Settings > Database > URI
DATABASE_URL="postgresql://postgres:[SUA_SENHA]@db.[SEU_PROJETO].supabase.co:5432/postgres"
# ── NEXTAUTH ──────────────────────────────────────────────────
NEXTAUTH_URL="http://localhost:3000"
NEXTAUTH_SECRET="coloque-aqui-uma-string-aleatoria-de-32-caracteres-minimo"
# ── SUPABASE (para storage de arquivos) ───────────────────────
NEXT_PUBLIC_SUPABASE_URL="https://[SEU_PROJETO].supabase.co"
NEXT_PUBLIC_SUPABASE_ANON_KEY="[sua-anon-key]"
SUPABASE_SERVICE_ROLE_KEY="[sua-service-role-key]"
# ── SMTP (HostGator) ──────────────────────────────────────────
SMTP_HOST="mail.seudominio.com.br"
SMTP_PORT="587"
SMTP_USER="[email protected]"
SMTP_PASS="sua-senha-email"
SMTP_FROM="Smarter Estágios <[email protected]>"
# ── AUTHENTIQUE (assinatura digital) ─────────────────────────
AUTHENTIQUE_API_TOKEN=""
AUTHENTIQUE_WEBHOOK_SECRET=""
# ── APP ───────────────────────────────────────────────────────
NEXT_PUBLIC_APP_URL="http://localhost:3000"
Como obter as credenciais do Supabase:
- Acesse supabase.com e crie uma conta
- Clique em New Project
- Escolha nome, senha do banco e região (preferencialmente São Paulo)
- Aguarde a criação (≈ 2 minutos)
- Vá em Settings → Database
- Copie a Connection String → URI → cole no
DATABASE_URL
- Vá em Settings → API
- Copie
URL → NEXT_PUBLIC_SUPABASE_URL
- Copie
anon public → NEXT_PUBLIC_SUPABASE_ANON_KEY
- Copie
service_role → SUPABASE_SERVICE_ROLE_KEY
Como gerar o NEXTAUTH_SECRET:
# No terminal (Linux/Mac):
openssl rand -base64 32
# Ou use o site: https://generate-secret.vercel.app/32
3. Rodar as Migrations (criar tabelas)
npx prisma migrate dev --name init
Isso vai criar todas as 20 tabelas no banco Supabase automaticamente.
Se preferir usar db push sem migrations:
npx prisma db push
4. Rodar o Seed (dados de teste)
npm run db:seed
Isso vai criar:
- Franqueadora master
- 1 Franqueado (Smarter São Paulo)
- 1 Empresa (TechCorp Brasil)
- 1 Estudante (Ana Lima)
- 1 Vaga
- 1 Contrato de estágio completo com 11 documentos
- Leads de CRM
- Lançamentos financeiros
5. Iniciar em modo desenvolvimento
npm run dev
Acesse: http://localhost:3000
6. Build para produção
npm run build
npm start
7. Deploy no Vercel
Opção A — GitHub (recomendado)
- Crie um repositório no GitHub e faça push do projeto
- Acesse vercel.com → New Project
- Importe o repositório do GitHub
- Em Environment Variables, adicione todas as variáveis do
.env
- Clique em Deploy
Opção B — Vercel CLI
npm install -g vercel
vercel login
vercel --prod
Configurações importantes no Vercel:
- Framework Preset: Next.js (detectado automaticamente)
- Build Command:
npm run build
- Output Directory:
.next
- Install Command:
npm install
⚠️ Após o primeiro deploy, rode o seed via Vercel CLI ou diretamente no Supabase SQL Editor.
8. Usuários de Teste
Após rodar o seed, use estes acessos:
9. Módulos Implementados ✅
Autenticação
Banco de Dados
Permissões por Perfil
Dashboard
Empresas
Estudantes
Contratos de Estágio
CRM
Financeiro
Instituições
10. O Que Ainda Falta Implementar 🚧
Documentos Reais
Assinatura Digital (Authentique)
E-mail (SMTP HostGator)
Upload de Arquivos
Formulários (CRUD Completo)
DISC Completo
Avaliação Semestral
Financeiro Avançado
Importação Excel/CSV
Processo Seletivo
🗃️ Schema do Banco
Tabelas criadas pelo Prisma:
users — Todos os usuários do sistema
franchises — Unidades franqueadas
companies — Empresas parceiras
institutions — Instituições de ensino
students — Estagiários (perfil completo)
vacancies — Vagas de estágio
applications — Candidaturas a vagas
contracts — Contratos de estágio
internship_documents — 11 documentos por contrato
evaluations — Avaliações semestrais
crm_leads — Pipeline CRM
crm_tasks — Tarefas do CRM
financials — Lançamentos financeiros
disc_tests — Testes DISC realizados
gamification_points — Pontuação da gamificação
activity_logs — Log de todas as ações
notifications — Notificações dos usuários
uploaded_files — Arquivos enviados
🔧 Comandos Úteis
npm run dev # Desenvolvimento local
npm run build # Build de produção
npm run db:generate # Gerar Prisma Client após mudar schema
npm run db:migrate # Rodar migrations
npm run db:push # Enviar schema sem migration (dev rápido)
npm run db:seed # Popular banco com dados de teste
npm run db:studio # Abrir Prisma Studio (interface visual do banco)
npm run db:reset # Resetar banco e rodar seed novamente
📁 Estrutura do Projeto
smarter-v2-backend/
├── app/
│ ├── layout.tsx # Layout raiz com SessionProvider
│ ├── page.tsx # Redireciona para /login ou /dashboard
│ ├── providers.tsx # NextAuth SessionProvider
│ ├── login/
│ │ └── page.tsx # Tela de login com acesso rápido para testes
│ ├── dashboard/
│ │ ├── layout.tsx # Layout com sidebar (protegido por sessão)
│ │ ├── page.tsx # Dashboard com KPIs reais do banco
│ │ ├── empresas/
│ │ ├── estudantes/
│ │ ├── contratos/
│ │ ├── crm/
│ │ ├── financeiro/
│ │ └── ... (outros módulos)
│ └── api/
│ └── auth/[...nextauth]/ # API route do NextAuth
├── components/
│ ├── layout/
│ │ └── Sidebar.tsx # Sidebar dinâmica por perfil
│ └── ui/
│ ├── Button.tsx
│ ├── Card.tsx
│ ├── Badge.tsx
│ ├── Input.tsx
│ └── Modal.tsx
├── lib/
│ ├── prisma.ts # Singleton do Prisma Client
│ ├── auth.ts # Configuração do NextAuth
│ └── actions/
│ ├── auth.ts # Server Actions de autenticação
│ ├── companies.ts # CRUD de empresas
│ ├── students.ts # CRUD de estudantes
│ ├── contracts.ts # CRUD de contratos
│ ├── crm.ts # CRUD do CRM
│ └── financial.ts # CRUD financeiro
├── prisma/
│ ├── schema.prisma # Schema completo do banco
│ └── seed.ts # Seed com dados de teste
├── types/
│ └── next-auth.d.ts # Tipos estendidos do NextAuth
├── middleware.ts # Proteção de rotas por perfil
├── .env # Variáveis de ambiente (não commitar!)
├── .env.example # Template das variáveis
└── README.md # Este arquivo
🔐 Segurança
- Senhas hasheadas com bcrypt (10 rounds)
- Sessões JWT assinadas com
NEXTAUTH_SECRET
- Rotas protegidas via middleware do Next.js
- Dados filtrados por
franchiseId / companyId / studentId em todas as queries
- Sem dados de outras unidades visíveis para franqueados
- Sem dados de outras empresas visíveis para empresas
💡 Próximos Passos Sugeridos
- Configure o Supabase e rode o seed
- Teste o login com os 4 perfis
- Implemente os formulários de criação (empresas, estudantes, contratos)
- Configure o SMTP e teste o envio de e-mail
- Configure o Authentique para assinatura digital real
- Implemente o upload de arquivos no Supabase Storage
- Adicione o DISC completo para estudantes
📞 Suporte
Desenvolvido para Smarter Estágios.
Em caso de dúvidas técnicas, entre em contato com a equipe de desenvolvimento.
