Tema
Instalação online (servidor)
O modo online roda no servidor central / nuvem. Ele é dono do banco platform e cria/roteia o banco de cada empresa.
Pré-requisitos
- Docker + Docker Compose
- Uma porta para a API (padrão
3041no host) e uma para o web (3040)
Subir o stack de teste/produção
O docker-compose.yml sobe PostgreSQL + API + web:
bash
# 1. configure os segredos
cp .env.example .env
# edite: POSTGRES_PASSWORD, ENCRYPTION_KEY, JWT_ACCESS_SECRET, JWT_REFRESH_SECRET
# 2. suba tudo
docker compose up -d --buildServiços:
| Serviço | Porta host | Observação |
|---|---|---|
postgres | 5445 | banco platform (volume clino-pgdata) |
api | 3041 | NestJS, APP_MODE=online |
web | 3040 | client estático (nginx) |
A API conecta no Postgres pelo hostname interno postgres:5432. Os bancos de cada empresa são criados no mesmo servidor Postgres (database-per-company).
Variáveis de ambiente (online)
| Variável | Obrigatória | Descrição |
|---|---|---|
APP_MODE | sim | online |
PORT | — | porta interna da API (padrão 3001) |
PLATFORM_DATABASE_URL | sim | conexão do banco platform |
ENCRYPTION_KEY | sim | ≥ 32 chars — criptografa segredos em repouso |
JWT_ACCESS_SECRET | sim | segredo do access token |
JWT_REFRESH_SECRET | sim | segredo do refresh token |
No compose, PLATFORM_DATABASE_URL é montada a partir de POSTGRES_USER/PASSWORD/DB.
Verificar
bash
curl http://localhost:3041/api/health # { "status": "ok", ... }
curl http://localhost:3041/api/health/db # { "status": "ok", "mode": "online" }Swagger interativo: http://localhost:3041/api/docs.
As migrations do platform rodam automaticamente no boot. Em seguida, crie a primeira empresa: veja Criar empresa e node.
Ambiente de desenvolvimento
Para desenvolver com hot-reload, use o docker-compose.dev.yml (apenas o Postgres, em outra porta) e rode a API no host:
bash
docker compose -f docker-compose.dev.yml up -d # Postgres dev :5446
cp apps/api/.env.example apps/api/.env # já aponta para :5446
pnpm --filter @clino/api dev # API :3051 (watch)