Skip to content

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 3041 no 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 --build

Serviços:

ServiçoPorta hostObservação
postgres5445banco platform (volume clino-pgdata)
api3041NestJS, APP_MODE=online
web3040client 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ávelObrigatóriaDescrição
APP_MODEsimonline
PORT—porta interna da API (padrão 3001)
PLATFORM_DATABASE_URLsimconexão do banco platform
ENCRYPTION_KEYsim≥ 32 chars — criptografa segredos em repouso
JWT_ACCESS_SECRETsimsegredo do access token
JWT_REFRESH_SECRETsimsegredo 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)