Tema
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:
| Modo | Onde roda | Dono de quê |
|---|---|---|
online | servidor central / nuvem | banco platform + banco online de cada empresa |
local | servidor da clínica / MacBook | banco 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
platformguarda 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.