Primeiros Passos
Guia para configurar o ambiente de desenvolvimento da QuettaCode Platform.
Pré-requisitos
| Ferramenta | Versão Mínima | Download |
|---|---|---|
| JDK | 21+ | Adoptium |
| Node.js | 20+ | Node.js |
| pnpm | 9+ | npm install -g pnpm |
| Docker | 24+ | Docker Desktop |
| Git | 2.40+ | Git |
Clonando o Repositório
git clone https://github.com/quettacode/platform.git
cd platform
Estrutura do Monorepo
platform/
├── apps/
│ ├── api/ # Backend Spring Boot (Kotlin)
│ ├── web/ # Frontend Next.js
│ └── docs/ # Documentação Docusaurus
├── packages/
│ ├── ui/ # Design System (Componentes)
│ └── resources/ # Tipos e schemas compartilhados
├── pnpm-workspace.yaml
├── turbo.json
└── docker-compose.yml
Instalando Dependências
Frontend (Node.js)
# Na raiz do monorepo
pnpm install
Backend (Gradle)
cd apps/api
./gradlew build -x test
Configurando Variáveis de Ambiente
Crie os arquivos .env baseados nos exemplos:
# Backend
cp apps/api/src/main/resources/application-local.yml.example \
apps/api/src/main/resources/application-local.yml
# Frontend
cp apps/web/.env.example apps/web/.env.local
Consulte Variáveis de Ambiente para detalhes.
Subindo os Serviços
1. Containers Docker
docker compose up -d
Isso iniciará:
- PostgreSQL (porta 5432)
- MongoDB (porta 27017)
- Redis (porta 6379)
2. Backend
cd apps/api
./gradlew bootRun
O servidor estará disponível em http://localhost:8080
3. Frontend
cd apps/web
pnpm dev
A aplicação estará disponível em http://localhost:3000
Verificando a Instalação
Acesse os endpoints de health check:
| Serviço | URL | Resposta Esperada |
|---|---|---|
| API | http://localhost:8080/actuator/health | {"status": "UP"} |
| Web | http://localhost:3000 | Página de login |
| Docs | http://localhost:3001 | Documentação |