Referência · SIMPE-MS Local Setup

URLs locais

Serviço	URL / Porta
App (Next dev)	`http://localhost:3000`
Supabase API	`http://127.0.0.1:54321`
Supabase Studio	`http://127.0.0.1:54323`
Mailpit (email capture)	`http://127.0.0.1:54324`
MCP local	`http://127.0.0.1:54321/mcp`
Edge Functions	`http://127.0.0.1:54321/functions/v1/`
Storage S3	`http://127.0.0.1:54321/storage/v1/s3`
Postgres	`postgres://postgres:postgres@127.0.0.1:54322/postgres`
Analytics (logflare)	`http://127.0.0.1:54327`

Ambientes cloud

Ambiente	Domínio	Project ref
`simpe-ms-test` (QA)	teste-ms.simpe.site	(consulte o time)
`simpe-ms-dev` (prod)	ms.simpe.site	(consulte o time)

Scripts npm (Next, lint, testes)

Para tudo que envolve banco, edge functions ou stack local, prefira a CLI supabase direto — veja a próxima tabela. Os scripts abaixo são os que não têm equivalente na CLI Supabase.

Comando	O que faz
`npm run dev`	Sobe o Next dev (Supabase precisa estar rodando)
`npm run build`	Build de produção do Next
`npm run lint`	ESLint
`npm run format`	Prettier em todos os arquivos
`npm test`	Vitest em modo watch
`npm run test:run`	Vitest single run (CI)
`npm run test:coverage`	Vitest com cobertura

Aliases de conveniência

Existem no package.json por costume, mas a recomendação é usar a CLI supabase equivalente para manter o vocabulário consistente com a documentação oficial.

Alias	Equivalente preferido
`npm run dev:local`	`supabase start` + `npm run dev` (+ `supabase functions serve` se mexer em edge function)
`npm run db:reset`	`supabase db reset`
`npm run db:status`	`supabase status`
`npm run local:stop`	`supabase stop`
`npm run functions:serve`	`supabase functions serve`

Comandos Supabase CLI mais usados

Comando	O que faz
`supabase start`	Sobe o stack local (idempotente)
`supabase stop`	Derruba containers, mantém dados
`supabase stop --no-backup`	Derruba e apaga volumes
`supabase status`	Mostra URLs e chaves do local
`supabase db reset`	Drop schema, reaplica migrations + roda seed
`supabase migration new <nome>`	Cria arquivo de migration vazio
`supabase migration up`	Aplica migrations pendentes (sem zerar)
`supabase db push`	Aplica migrations no projeto cloud linkado
`supabase db diff`	Mostra diff entre local e remoto
`supabase db pull`	Gera migration a partir do estado remoto
`supabase link --project-ref <ref>`	Linka CLI a um projeto cloud
`supabase projects list`	Lista projetos no qual estou autenticado
`supabase functions serve [<nome>]`	Roda edge functions com hot reload
`supabase functions deploy <nome>`	Deploy de edge function no projeto linkado
`supabase functions logs <nome> --tail`	Logs ao vivo de uma edge function
`supabase secrets list`	Lista secrets do projeto linkado
`supabase login`	Autentica a CLI

Usuários do seed

Senha de todos: senha123.

Email	Role (`app_role`)
viz@local.test	Visualização
edicao@local.test	Edição
gestar@local.test	Gestar
admin@local.test	Admin — role usado pela SES
super@local.test	SuperAdmin — mesmas permissões do Admin; distingue staff Pacto

Arquivos importantes do repo

Caminho	O que é
`README.md`	Porta de entrada do repo
`CLAUDE.md`	Referência arquitetural detalhada (cache, transforms, patterns)
`.env.example`	Template do `.env`
`.mcp.json`	Configuração de servidores MCP do projeto
`supabase/config.toml`	Config do Supabase local (portas, services, seed paths)
`supabase/seed.sql`	Dados sintéticos rodados no `db reset`
`supabase/seed-spec.md`	Spec / receita do seed
`supabase/migrations/`	Migrations versionadas, ordenadas por timestamp
`supabase/functions/`	Edge functions (Deno)
`supabase/supabase-workflow-guia.md`	Guia 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.