# Atualizando o Core

> Atualização coordenada de oon-core-back, oon-core-front e create-central-oon — sempre juntos, com cache de docs, compatibilidade e validação.

Escolha uma versão publicada e compatível e atualize **os três pacotes juntos**. Na raiz do App:

```bash
npm install --save-dev --save-exact @oondemand/create-central-oon@0.7.43
npm install --prefix backend --save-exact @oondemand/oon-core-back@0.7.43
npm install --prefix frontend --save-exact @oondemand/oon-core-front@0.7.43
npm run ooncore:docs
npx --no-install create-central-oon doctor
npm run build --prefix frontend
```

O comando oficial regenera cache, manifesto e hashes — nunca edite `.ooncore/` à mão. Versione os três `package.json`, seus lockfiles e o cache.

## Depois de atualizar

1. Revise `central.app.json#compatibility.core` conforme as funções usadas; só aumente o mínimo após validar a migração.
2. Execute os testes existentes e o smoke da jornada.
3. Publique pelo fluxo existente e registre o commit homologado em Dev.

> [!WARNING]
> Falha parcial em `npm install` exige concluir os três upgrades antes do sync/check. Não publique versões divergentes. A publicação npm sozinha não atualiza Apps existentes — cada App precisa ser republicado.

## Notas de migração por linha

| Linha | O que muda |
|---|---|
| **0.7** | Identidade operacional por deployment e autorização comercial single-tenant. Compatibilidade `>=0.7.0 <0.8.0`. Abertura por `oon_launch` valida antes de persistir. Licenciamento nunca no domínio do App. |
| **0.6** | Bootstrap code-first (`defineOonApp`/`startOonApp`), `central.app.json` schema v2, scaffold único `_base`; remove templates, Omie e provider genérico de integrações. Incompatível com contratos removidos da 0.5. |
| **0.5** | Runtime local desconectado. Remover `DEV_TOKEN`, `VITE_DEV_TOKEN` e `dev-local`; Vite em `127.0.0.1` com proxy `/api`; sincronizar `.ooncore/`. |

Detalhes e histórico completo em [Versões](/versoes).

## Rollback

Restaure as versões coordenadas anteriores e os lockfiles, sincronize as docs e republique a imagem anterior pelo fluxo existente.

Fonte: https://sdk.oonapps.com/docs/operacao/atualizacao-do-core