Capítulo 07 / Cola técnica

Referência

Tudo o que você precisa em um lugar só — URLs, portas, comandos, scripts npm, arquivos importantes. Para quando você só quer encontrar uma coisa rápido sem ler manual.

URLs locais

ServiçoURL / Porta
App (Next dev)http://localhost:3000
Supabase APIhttp://127.0.0.1:54321
Supabase Studiohttp://127.0.0.1:54323
Mailpit (email capture)http://127.0.0.1:54324
MCP localhttp://127.0.0.1:54321/mcp
Edge Functionshttp://127.0.0.1:54321/functions/v1/
Storage S3http://127.0.0.1:54321/storage/v1/s3
Postgrespostgres://postgres:postgres@127.0.0.1:54322/postgres
Analytics (logflare)http://127.0.0.1:54327

Ambientes cloud

AmbienteDomínioProject ref
simpe-ms-test (QA) teste-ms.simpe.site (consulte o time)
simpe-ms-dev (prod) ms.simpe.site (consulte o time)

Scripts npm

ComandoO que faz
npm run devSobe só o Next dev (Supabase precisa estar rodando)
npm run dev:localsupabase start + next dev + supabase functions serve em paralelo
npm run db:resetZera DB local, reaplica migrations + roda seed
npm run db:statussupabase status — URLs e chaves do local
npm run local:stopsupabase stop — derruba os containers
npm run functions:serveEdge functions com hot reload
npm run buildBuild de produção do Next
npm run lintESLint
npm run formatPrettier em todos os arquivos
npm testVitest em modo watch
npm run test:runVitest single run (CI)
npm run test:coverageVitest com cobertura

Comandos Supabase CLI mais usados

ComandoO que faz
supabase startSobe o stack local (idempotente)
supabase stopDerruba containers, mantém dados
supabase stop --no-backupDerruba e apaga volumes
supabase statusMostra URLs e chaves do local
supabase db resetDrop schema, reaplica migrations + roda seed
supabase migration new <nome>Cria arquivo de migration vazio
supabase migration upAplica migrations pendentes (sem zerar)
supabase db pushAplica migrations no projeto cloud linkado
supabase db diffMostra diff entre local e remoto
supabase db pullGera migration a partir do estado remoto
supabase link --project-ref <ref>Linka CLI a um projeto cloud
supabase projects listLista projetos no qual estou autenticado
supabase functions serve [<nome>]Roda edge functions com hot reload
supabase functions deploy <nome> --no-verify-jwtDeploy de edge function no projeto linkado
supabase functions logs <nome> --tailLogs ao vivo de uma edge function
supabase secrets listLista secrets do projeto linkado
supabase loginAutentica a CLI

Usuários do seed

Senha de todos: senha123.

EmailRole (app_role)
viz@local.testVisualização
edicao@local.testEdição
gestar@local.testGestar
admin@local.testAdmin — role usado pela SES
super@local.testSuperAdmin — mesmas permissões do Admin; distingue staff Pacto

Arquivos importantes do repo

CaminhoO que é
README.mdPorta de entrada do repo
CLAUDE.mdReferência arquitetural detalhada (cache, transforms, patterns)
.env.exampleTemplate do .env
.mcp.jsonConfiguração de servidores MCP do projeto
supabase/config.tomlConfig do Supabase local (portas, services, seed paths)
supabase/seed.sqlDados sintéticos rodados no db reset
supabase/seed-spec.mdSpec / receita do seed
supabase/migrations/Migrations versionadas, ordenadas por timestamp
supabase/functions/Edge functions (Deno)
supabase/supabase-workflow-guia.mdGuia detalhado de workflow (versão markdown)
actions/Server actions Next ('use server')
rpc/Funções de DB (Data Access Layer)
components/novo-layout/Componentes da UI ativa
components/legacy/Código antigo, não editar

Enums do banco

Os principais — mais detalhes via MCP local ou Studio.

app_role

Visualização · Edição · Gestar · Admin · SuperAdmin

item_tipo

objetivo · acao · resultado · entrega · atividade

semaforo_status

verde · amarelo · vermelho · nao_monitorado · azul

Links úteis

Fim do manual. Boa construção.