Skip to content
elizfabPublic

About

🕵️‍♀️ Portal administrativo pessoal — painéis, projetos e finanças em um só lugar.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

78 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Admin — Personal Platform

Produção: https://admin-elizabetefabri.vercel.app/

Portal administrativo pessoal, privado e extensĂ­vel: ponto central de acesso aos mĂłdulos Estudos, Financeiro, PDI e Projetos.

Admin é um painel administrativo completo, com autenticação segura, gestão de projetos e controle financeiro em um só lugar. Construído com Next.js 16, React 19 e TypeScript, banco PostgreSQL no Supabase via Prisma, autenticação Better Auth e cobertura de testes com Jest e Playwright — tudo em arquitetura modular com temas claro e escuro.

Status

Marco Status
Fase 01 (frontend) concluída — banco, autenticação e backend vieram nas fases seguintes ✅ histórica
Fases 00 a 05 concluídas (ambiente, frontend, banco/Prisma, autenticação, backend, testes E2E e integração) ✅
Fase 06 concluída — repositório, CI, deploy na Vercel e variáveis por ambiente ✅
Deploy em produção ✅ https://admin-elizabetefabri.vercel.app/

Stack

  • Framework: Next.js 16 (App Router) · React 19 · TypeScript strict
  • Estilo: SCSS Modules · design system com tokens de tema (paleta Dracula, claro/escuro)
  • UI: Radix UI · Lucide React
  • Banco: PostgreSQL (Supabase em produção, Docker local) · Prisma 7
  • Validação: Zod 4
  • Auth: Better Auth (e-mail/senha, sessões, rate limit, proxy de rotas)
  • Testes: Jest + React Testing Library (unitários) · Jest + banco real (integração) · Playwright (E2E e acessibilidade)
  • Qualidade: ESLint · typecheck (next typegen + tsc --noEmit)
  • Deploy: Vercel (main → produção, demais branches → preview) · GitHub Actions (CI)
  • Node.js: ≥ 20.19

Pré-requisitos

  • Node.js ≥ 20.19
  • npm
  • Docker (PostgreSQL local via docker compose)

Como rodar

npm install
cp .env.example .env.local   # preencher DATABASE_URL, BETTER_AUTH_SECRET etc.
npm run db:up                # sobe o PostgreSQL local (Docker)
npm run db:migrate           # aplica as migrations
npx tsx prisma/seed.ts       # cria a conta administradora (SEED_ADMIN_*)
npm run dev

Abrir http://localhost:3000 — em dev, a porta pode cair para 3001 se a 3000 estiver ocupada.

Scripts

Script O que faz
npm run dev Servidor de desenvolvimento
npm run build Build de produção
npm run start Executa o build de produção
npm run lint / lint:fix ESLint (verificar / corrigir)
npm run typecheck next typegen + verificação de tipos
npm test / test:watch / test:coverage Testes unitários (Jest, 37 testes)
npm run test:integration Integração Prisma + PostgreSQL real (admin_test)
npm run test:e2e E2E Playwright (auth, navegação, CRUD, isolamento, acessibilidade)
npm run test:e2e:ui E2E com interface interativa do Playwright
npm run test:e2e:report Abre o relatĂłrio HTML do Playwright
npm run db:up / db:down Sobe/derruba o PostgreSQL local (Docker)
npm run db:migrate / db:deploy Migrations (dev / produção)
npx tsx prisma/seed.ts Seed da conta administradora
npm run vercel-build Build da Vercel (prisma migrate deploy + next build)

O E2E sobe o prĂłprio servidor na porta 3100, cria o banco admin_test e roda build + migrate + seed automaticamente (prepare-database.ts + global-setup.ts). NĂŁo Ă© preciso subir nada manualmente.

Variáveis de ambiente

Ver .env.example e o guia completo de produção em VERCEL-ENV.md (Supabase pooler Transaction/Session, segredos por ambiente, proteção de previews).

Documentação

Estrutura

src/
├── app/          # rotas (App Router), ícones e metadata
├── components/   # componentes visuais (ui, layout, shared)
├── modules/      # domínios (auth, dashboard, projects, ...)
├── lib/          # infraestrutura (auth, db, env, utils)
└── styles/       # tokens, temas claro/escuro e estilos base
tests/
├── unit/         # testes Jest unitários
├── integration/  # testes Jest com banco real (admin_test)
└── e2e/          # specs Playwright + setup/sessões

CI

About

🕵️‍♀️ Portal administrativo pessoal — painéis, projetos e finanças em um só lugar.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages