Docs › Operação

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:

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.

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.

Rollback

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