Pular para o conteúdo principal

Comandos Essenciais

Referência rápida dos comandos mais utilizados no desenvolvimento.

Backend (Gradle)

Executar a partir de apps/api/:

ComandoDescrição
./gradlew bootRunInicia o servidor em modo desenvolvimento
./gradlew bootRun --args='--spring.profiles.active=local'Inicia com profile local
./gradlew buildCompila o projeto
./gradlew build -x testCompila sem rodar testes
./gradlew testExecuta todos os testes
./gradlew ktlintFormatFormata código Kotlin
./gradlew ktlintCheckVerifica formatação
./gradlew dokkaHtmlGera documentação KDoc
./gradlew liquibaseUpdateAplica migrations pendentes
./gradlew liquibaseRollbackCount -PliquibaseCommandValue=1Reverte última migration

Frontend (pnpm)

Executar a partir da raiz do monorepo ou diretório específico:

Monorepo (Raiz)

ComandoDescrição
pnpm installInstala todas as dependências
pnpm devInicia todos os apps em dev
pnpm buildBuild de produção de todos os apps
pnpm lintLint em todos os pacotes
pnpm typecheckVerifica tipos em todos os pacotes

Web (apps/web)

ComandoDescrição
pnpm devInicia Next.js em dev (porta 3000)
pnpm buildBuild de produção
pnpm startInicia servidor de produção
pnpm lintESLint

Docs (apps/docs)

ComandoDescrição
pnpm startInicia Docusaurus (porta 3001)
pnpm buildBuild estático
pnpm serveServe build local
pnpm docusaurus gen-api-docs allRegenera docs da API

UI (packages/ui)

ComandoDescrição
pnpm storybookInicia Storybook (porta 6006)
pnpm build-storybookBuild do Storybook
pnpm typecheckVerifica tipos

Docker

ComandoDescrição
docker compose up -dInicia todos os containers
docker compose downPara todos os containers
docker compose logs -fLogs em tempo real
docker compose psStatus dos containers
docker compose exec postgres psql -U postgresAcessa o PostgreSQL
docker compose exec redis redis-cliAcessa o Redis CLI

Git Hooks (Husky)

Configurados automaticamente:

HookAção
pre-commitLint staged files
commit-msgValida formato do commit

Atalhos Úteis

Limpar Cache

# Gradle
./gradlew clean

# pnpm
pnpm store prune

# Next.js
rm -rf apps/web/.next

# Docusaurus
rm -rf apps/docs/.docusaurus apps/docs/build

Atualizar Dependências

# pnpm
pnpm update --interactive --latest

# Gradle (wrapper)
./gradlew wrapper --gradle-version=8.10