Agenn Vitrine

SaaS para comerciantes criarem vitrines on-line (catálogo ou cardápio), cada uma no próprio subdomínio. Feito com Next.js e Supabase.

Pré-requisitos

• Node.js 20.9 ou superior
• Docker Desktop em execução (para o Supabase local)

Configuração

npm install
npx supabase start

Copie .env.example para .env.local e preencha NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY e SUPABASE_SECRET_KEY com as chaves exibidas por npx supabase status.

Comandos

Comando	O que faz
npm run dev	Servidor de desenvolvimento
npm test	Testes unitários (Vitest)
npm run test:db	Testes do banco (pgTAP)
npm run test:e2e	Testes ponta a ponta (Playwright)
npm run typecheck	Verificação de tipos
npm run lint	ESLint

Como testar (fluxo atual, pela nuvem)

O desenvolvimento não depende de Docker na máquina local. Localmente rodam só npm run lint, npm run typecheck e npm test.

Tudo o mais roda no GitHub Actions (workflow CI) a cada PR:

• checks: lint, tipos e Vitest
• db: Supabase local no runner, pgTAP e geração dos tipos do banco (artefato database-types)
• e2e: build de produção e Playwright (desktop e celular)
• migrate: ao entrar na master, aplica as migrações no Supabase dev

Acompanhe com gh pr checks --watch. Quando uma migração muda o banco, baixe os tipos gerados (gh run download <run-id> --name database-types --dir <pasta-temporária>) e copie o arquivo para src/lib/supabase/database.types.ts.

Os testes de vídeo usam o driver fake do VideoService e vídeos WebM gerados com ffmpeg no CI (scripts/make-video-fixtures.mjs). Os e-mails usam o driver fake (gravados em disco). A reprodução real (HLS do Mux) e o envio real pelo Resend são conferidos na nuvem.

Endereços locais

• Página inicial: http://localhost:3000
• Acesso e painel: http://app.localhost:3000

Documentação

• Especificação: docs/superpowers/specs
• Infraestrutura de produção: docs/setup/fase-1-infra.md, docs/setup/fase-2-infra.md e docs/setup/fase-3-infra.md
• Planos de implementação: docs/superpowers/plans