Scripts do monorepo

Makefile (preparação)

Comando	O que faz
make setup	pnpm i → distribui o .env.example da raiz para os .env → pnpm run prisma:generate → pnpm build
make setup FORCE=1	Idem, recriando os .env do zero
make env	Só a distribuição dos .env (scripts/copy-env.mjs): cria os que faltam e acrescenta variáveis novas nos existentes, sem alterar valores
make test / make e2e-install	Testes unitários / baixa o Chromium dos e2e
make help	Lista os alvos

Raiz

Comando	O que faz
pnpm dev	turbo run dev em todas as apps
pnpm build	turbo run build
pnpm lint / pnpm lint:fix	ESLint em todo o monorepo
pnpm format / pnpm format:check	Prettier
pnpm test / pnpm coverage	Testes unitários (Vitest) / com cobertura
pnpm test:e2e	Testes e2e (Playwright) dos apps que os têm
pnpm typecheck	tsc em todos os workspaces
pnpm docker:dev	Sobe o docker-compose.dev.yml (Postgres e Redis locais)
pnpm docker:prod	Sobe o docker-compose.yml completo
pnpm prisma:generate	Gera o Prisma Client
pnpm prisma:migrate	Cria e aplica migrations (migrate dev, só desenvolvimento)
pnpm prisma:migrate:deploy	Aplica as migrations versionadas (migrate deploy, produção)
pnpm prisma:push	Sincroniza o schema sem migration (só desenvolvimento)
pnpm prisma:seed	Popula dados iniciais
pnpm prisma:reset	Reseta o banco (destrutivo)
pnpm prisma:studio	Abre o Prisma Studio
pnpm release:bump-version	scripts/bump-version.sh: incrementa a versão única de todos os workspaces, faz o commit e a tag
pnpm versions:check	Falha se algum workspace estiver com versão diferente da raiz

apps/web

Comando	O que faz
pnpm --filter web test	Testes unitários (Vitest + Testing Library)
pnpm --filter web test:e2e	Playwright; sobe o app em :3000 se E2E_BASE_URL não estiver definido
pnpm --filter web test:e2e:ui	Playwright em modo interativo
pnpm --filter web e2e:install	Instala o Chromium do Playwright

apps/docs

Comando	O que faz
pnpm --filter @moldape/docs dev	Documentação em http://localhost:4321
pnpm --filter @moldape/docs build	Gera o site estático em apps/docs/dist
pnpm --filter @moldape/docs capture	Captura as telas da plataforma em public/screens
pnpm --filter @moldape/docs pdf	Gera o PDF de entrega ao cliente em apps/docs/pdf/

Utilitários em scripts/

Script	O que faz
copy-env.mjs	Distribui o .env.example da raiz para o .env de cada app (make env)
sync-versions.mjs	Aplica a versão da raiz a todos os workspaces; --check só verifica
bump-version.sh	Release: incrementa a versão, sincroniza, faz commit e tag
cleanup.sh / cleanup.ps1	Limpeza de builds
test-login.*, test-registration.js, test-integration.sh	Smoke tests manuais de autenticação
build-utf8.ps1	Build no Windows forçando UTF-8