Tema
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
idaplicado 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
companyroda 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
- Acrescente
0002_<descricao>no array correspondente (apps/api/src/database/migrations/platform.tsou.../company.ts). - 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.