Modos de runtime
As diferenças entre o runtime local desconectado e o runtime publicado na Plataforma.
O OonCore tem dois modos de execução. No frontend, o modo é passado em defineOonApp({ runtimeMode }); no backend, por OON_RUNTIME_MODE.
| Contrato | local |
platform |
|---|---|---|
| Configuração | NODE_ENV=development, OON_RUNTIME_MODE=local |
ambiente publicado |
| Bind | somente loopback | contrato da infraestrutura |
| Identidade | principal técnico local | usuário, tenant e Deployment reais |
| Ativação | ativa_local |
estados da plataforma |
| Sessão | cookie HttpOnly, TTL de até 30 dias | auth/SSO configurado |
| RBAC | simula somente papéis do manifesto | acessos reais |
| Plataforma | nenhuma chamada obrigatória | conforme capability |
| Publicar/promover | bloqueado | por contratos autorizados |
export const app = defineOonApp({
// ...
runtimeMode: import.meta.env.DEV ? "local" : "platform",
});
Ambientes publicados
Na plataforma, APP_ENVIRONMENT é a fonte canônica do ambiente lógico — desenvolvimento, homologacao ou producao — e é o valor exposto em /health/version (deployment.environment). NODE_ENV=production não indica, por si só, um ambiente de produção.
Estados da instância (platform)
| Estado | Comportamento do frontend |
|---|---|
ativa |
Acesso normal |
configurando |
Fluxo de configuração |
suspensa |
/instancia-suspensa |
revogada |
/instancia-revogada |
| não ativada | /ativacao |
Essas rotas são reservadas pelo Core e não podem ser declaradas pelo App.