Skip to content

Migrations ​

O Clino usa um migrator próprio, transparente e testado — sem mágica de ORM.

Dois conjuntos ​

  • platform — roda no banco central (clino_platform).
  • company — roda em todos os bancos de empresa (online e em cada install local), então o schema é idêntico em todo lugar.

Cada migration tem um id ordenado (0001_init, 0002_…) e é aplicada dentro de uma transação. O id aplicado é gravado numa tabela schema_migrations.

Garantias ​

  • Idempotente — re-rodar aplica só o que falta.
  • Ordem protegida — o migrator recusa um histórico fora de ordem ou “drift” (um id aplicado que sumiu do conjunto).
  • Sem perder dados locais não sincronizados — migrations são DDL aditivo.

Quando rodam ​

  • No boot da API: online migra o platform; local migra o banco da empresa local. (Se o banco não estiver acessível, ele só registra um aviso — não derruba o boot.)
  • No provisionamento: o conjunto company roda no banco recém-criado.

Conferir a versão do schema ​

bash
curl http://localhost:3041/api/health/version
# → { "appVersion": "0.1.0", "schemaVersion": "0001_init", "mode": "online" }

Adicionar uma migration ​

  1. Acrescente 0002_<descricao> no array correspondente (apps/api/src/database/migrations/platform.ts ou .../company.ts).
  2. No próximo boot/deploy ela é aplicada automaticamente em todos os bancos.

Como cada empresa tem seu próprio banco, a mesma migration company é aplicada a cada um deles — online e em cada node local — mantendo o schema consistente entre todos.