Comandos Essenciais
Referência rápida dos comandos mais utilizados no desenvolvimento.
Backend (Gradle)
Executar a partir de apps/api/:
| Comando | Descrição |
|---|---|
./gradlew bootRun | Inicia o servidor em modo desenvolvimento |
./gradlew bootRun --args='--spring.profiles.active=local' | Inicia com profile local |
./gradlew build | Compila o projeto |
./gradlew build -x test | Compila sem rodar testes |
./gradlew test | Executa todos os testes |
./gradlew ktlintFormat | Formata código Kotlin |
./gradlew ktlintCheck | Verifica formatação |
./gradlew dokkaHtml | Gera documentação KDoc |
./gradlew liquibaseUpdate | Aplica migrations pendentes |
./gradlew liquibaseRollbackCount -PliquibaseCommandValue=1 | Reverte última migration |
Frontend (pnpm)
Executar a partir da raiz do monorepo ou diretório específico:
Monorepo (Raiz)
| Comando | Descrição |
|---|---|
pnpm install | Instala todas as dependências |
pnpm dev | Inicia todos os apps em dev |
pnpm build | Build de produção de todos os apps |
pnpm lint | Lint em todos os pacotes |
pnpm typecheck | Verifica tipos em todos os pacotes |
Web (apps/web)
| Comando | Descrição |
|---|---|
pnpm dev | Inicia Next.js em dev (porta 3000) |
pnpm build | Build de produção |
pnpm start | Inicia servidor de produção |
pnpm lint | ESLint |
Docs (apps/docs)
| Comando | Descrição |
|---|---|
pnpm start | Inicia Docusaurus (porta 3001) |
pnpm build | Build estático |
pnpm serve | Serve build local |
pnpm docusaurus gen-api-docs all | Regenera docs da API |
UI (packages/ui)
| Comando | Descrição |
|---|---|
pnpm storybook | Inicia Storybook (porta 6006) |
pnpm build-storybook | Build do Storybook |
pnpm typecheck | Verifica tipos |
Docker
| Comando | Descrição |
|---|---|
docker compose up -d | Inicia todos os containers |
docker compose down | Para todos os containers |
docker compose logs -f | Logs em tempo real |
docker compose ps | Status dos containers |
docker compose exec postgres psql -U postgres | Acessa o PostgreSQL |
docker compose exec redis redis-cli | Acessa o Redis CLI |
Git Hooks (Husky)
Configurados automaticamente:
| Hook | Ação |
|---|---|
pre-commit | Lint staged files |
commit-msg | Valida 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