Tema
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:
- A empresa provisionada (veja Criar empresa e node) — você terá o
COMPANY_ID. - Um node registrado para essa empresa — você terá o
NODE_IDe 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ável | Descrição |
|---|---|
COMPANY_ID | a empresa que este node atende (fixa) |
NODE_ID | id do node registrado na nuvem |
NODE_SECRET | credencial do node (vai nos headers ao sincronizar) |
DATABASE_URL | banco PostgreSQL local desta empresa |
CLOUD_API_URL | URL da API online para sincronizar |
SYNC_ENABLED | liga/desliga a sincronização automática |
SYNC_INTERVAL_MS | de 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ávelA partir daqui, os usuários autenticam localmente (mesmo sem internet) e cada operação gera um evento de outbox. Veja Sincronização e conflitos.