Skip to content

Visão geral ​

O Clino é uma plataforma médica offline-capable e multi-tenant. O backend (NestJS) é o mesmo código rodando em dois modos, escolhidos por configuração:

ModoOnde rodaDono de quê
onlineservidor central / nuvembanco platform + banco online de cada empresa
localservidor da clínica / MacBookbanco local de UMA empresa + UM node

O objetivo: a clínica continua trabalhando sem internet. O backend local autentica usuários, lê e grava no banco local, e registra cada mudança como um evento de outbox. Quando a conexão volta, o Sync Worker reconcilia com a nuvem.

Princípios ​

  • Isolamento por empresa. Cada empresa tem um banco PostgreSQL físico separado (database-per-company). O banco platform guarda só metadados (empresas, roteamento de banco, nodes, licenças, admins) — nunca dado clínico.
  • Durabilidade. Todo write importante grava o dado e o evento de outbox na mesma transação. Se a transação falha, nada fica pela metade.
  • Idempotência. Cada evento tem um UUID global; o inbox deduplica por ele. IDs são sempre UUID (nunca auto-increment), para local e nuvem nunca colidirem.
  • Conflitos. Detectados por versão. Não é “last-write-wins”: divergência vira um conflito registrado, nunca uma sobrescrita silenciosa.
  • Sem dependências pesadas de sync. Sem Debezium / Airbyte / CDC / replicação — é um outbox/inbox controlado pelo próprio backend.

Componentes ​

  • Platform DB — registro de empresas, roteamento de bancos, nodes, licenças, admins.
  • Company DB (1 por empresa, online e em cada local) — usuários, roles, auditoria, outbox/inbox, conflitos, checkpoints e os dados de negócio.
  • Sync Worker — empurra (push) e puxa (pull) eventos entre local e nuvem, com lock, checkpoint, retry e detecção de conflito.
  • Node — cada instalação local é um node registrado, com credencial própria.

Próximos passos ​