Skip to content

Instalação local (clínica / MacBook) ​

O modo local roda dentro da clínica (servidor on-prem, MacBook ou PC). Ele atende uma empresa e é um node. Funciona sem internet e sincroniza com a nuvem quando há conexão.

Antes de instalar ​

No servidor online, você precisa ter:

  1. A empresa provisionada (veja Criar empresa e node) — você terá o COMPANY_ID.
  2. Um node registrado para essa empresa — você terá o NODE_ID e o segredo (mostrado uma única vez).

Configuração ​

O mesmo código da API roda em modo local apenas mudando o .env:

bash
APP_MODE=local
PORT=3001

COMPANY_ID=<id-da-empresa>
NODE_ID=<id-do-node>
NODE_SECRET=<segredo-do-node-mostrado-no-registro>

DATABASE_URL=postgres://clino:clino@localhost:5432/clino_company_local
CLOUD_API_URL=https://api-clino.findgroup.xyz   # para onde o Sync Worker sincroniza

ENCRYPTION_KEY=<32+ chars>
JWT_ACCESS_SECRET=<16+ chars>
JWT_REFRESH_SECRET=<16+ chars>

LOCAL_STORAGE_PATH=./storage
SYNC_ENABLED=true
SYNC_INTERVAL_MS=30000
VariávelDescrição
COMPANY_IDa empresa que este node atende (fixa)
NODE_IDid do node registrado na nuvem
NODE_SECRETcredencial do node (vai nos headers ao sincronizar)
DATABASE_URLbanco PostgreSQL local desta empresa
CLOUD_API_URLURL da API online para sincronizar
SYNC_ENABLEDliga/desliga a sincronização automática
SYNC_INTERVAL_MSde quanto em quanto tempo o Sync Worker roda

Subir ​

Suba um Postgres local e a API em modo local. As migrations da empresa rodam no boot, então um install novo já fica pronto para autenticar e operar offline.

bash
docker run -d --name clino-local-pg \
  -e POSTGRES_USER=clino -e POSTGRES_PASSWORD=clino -e POSTGRES_DB=clino_company_local \
  -p 5432:5432 postgres:16

# com o .env configurado:
pnpm --filter @clino/api start    # ou node dist/main.js (produção)

Verificar ​

bash
curl http://localhost:3001/api/health/sync     # status de sincronização (modo local)
curl http://localhost:3001/api/health/storage  # storage local gravável

A partir daqui, os usuários autenticam localmente (mesmo sem internet) e cada operação gera um evento de outbox. Veja Sincronização e conflitos.