@oondemand/oon-core-back 0.4.22 → 0.4.24

package/README.md

@@ -15,6 +15,13 @@ O Core suporta `ecosystem.role` em `central.config.js`: `root` para a Central de
 
 Compatibilidade temporária: `CENTRAL_ATIVACAO_BACKEND_URL` e `MEUS_APPS_BACKEND_URL` continuam aceitas como aliases da URL da API. Nunca aponte a URL da API para o próprio Core.
 
+## Saúde operacional
+
+- `GET /health/ready`: retorna HTTP 200 somente quando o MongoDB está conectado; retorna 503 enquanto o runtime não estiver pronto.
+- `GET /health/version`: expõe as versões do OonCore e da Central, commit, release, build e ambiente da publicação.
+
+Na imagem de entrega, essas rotas são publicadas pelo Nginx sob `/api/health/ready` e `/api/health/version`.
+
 ## Fluxo
 
 `GET /ativacao/status` informa estado sem segredos. `POST /ativacao/validar-codigo` valida sem consumir. `POST /ativacao/concluir` revalida, chama `/ativar`, criptografa imediatamente o token da instância, executa hooks declarativos, chama `/concluir` e marca a instância como `ativa`. `POST /ativacao/tentar-novamente` retoma uma ativação já registrada sem exigir novo código.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oondemand/oon-core-back",
-  "version": "0.4.22",
+  "version": "0.4.24",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/oondemand/oon-platform.git",

package/src/api/status.routes.js

@@ -1,21 +1,65 @@
+"use strict";
+
 const express = require("express");
 const mongoose = require("mongoose");
 const ctx = require("../core/context");
+const { runtimeSummary } = require("./core.routes");
 
 const router = express.Router();
 
-router.get("/", (_req, res) => {
-  const states = {
-    0: "Desconectado",
-    1: "Conectado",
-    2: "Conectando",
-    3: "Desconectando",
+const DATABASE_STATES = Object.freeze({
+  0: { code: "disconnected", label: "Desconectado" },
+  1: { code: "connected", label: "Conectado" },
+  2: { code: "connecting", label: "Conectando" },
+  3: { code: "disconnecting", label: "Desconectando" },
+});
+
+function databaseState(readyState = mongoose.connection.readyState) {
+  return DATABASE_STATES[readyState] || {
+    code: "unknown",
+    label: "Status desconhecido",
+  };
+}
+
+function readinessSummary(readyState = mongoose.connection.readyState) {
+  const database = databaseState(readyState);
+  const ready = readyState === 1;
+  return {
+    status: ready ? "ready" : "not_ready",
+    service: ctx.config.serviceName,
+    database: {
+      ready,
+      state: database.code,
+    },
+  };
+}
+
+function versionSummary() {
+  return {
+    status: "ok",
+    service: ctx.config.serviceName,
+    ...runtimeSummary(),
   };
-  const dbState = mongoose.connection.readyState;
+}
+
+router.get("/", (_req, res) => {
+  const database = databaseState();
   res.status(200).json({
     message: `${ctx.config.serviceName} rodando - vs ${ctx.config.serviceVersion}`,
-    database: states[dbState] || "Status desconhecido",
+    database: database.label,
   });
 });
 
+router.get("/health/ready", (_req, res) => {
+  const summary = readinessSummary();
+  res.status(summary.database.ready ? 200 : 503).json(summary);
+});
+
+router.get("/health/version", (_req, res) => {
+  res.status(200).json(versionSummary());
+});
+
 module.exports = router;
+module.exports.databaseState = databaseState;
+module.exports.readinessSummary = readinessSummary;
+module.exports.versionSummary = versionSummary;

package/src/core/utils/instanceActivation.js

@@ -114,6 +114,27 @@ function role() {
   return ctx.config.ecosystem?.role === "root" ? "root" : "member";
 }
 
+function deploymentBootstrap() {
+  const deploymentId = String(process.env.OON_DEPLOYMENT_ID || "").trim();
+  const token = String(process.env.OON_DEPLOYMENT_TOKEN || "").trim();
+  if (!deploymentId && !token) return null;
+  if (!deploymentId || !token) {
+    throw new GenericError(
+      "OON_DEPLOYMENT_ID e OON_DEPLOYMENT_TOKEN devem ser configurados juntos.",
+      { statusCode: 500, code: "DEPLOYMENT_BOOTSTRAP_INCOMPLETE" },
+    );
+  }
+  const tenancyModel =
+    ctx.config.tenancyModel || ctx.config.ecosystem?.tenancyModel;
+  if (tenancyModel !== "none") {
+    throw new GenericError(
+      "Bootstrap direto de deployment é permitido somente para Apps globais.",
+      { statusCode: 500, code: "DEPLOYMENT_BOOTSTRAP_TENANCY_INVALID" },
+    );
+  }
+  return { deploymentId, token };
+}
+
 function ambiente() {
   const value =
     process.env.APP_ENVIRONMENT || process.env.NODE_ENV || "desenvolvimento";
@@ -264,6 +285,38 @@ async function ensureInstance() {
     await instance.save();
   }
 
+  const bootstrap = deploymentBootstrap();
+  if (bootstrap) {
+    let currentToken = null;
+    try {
+      currentToken = decrypt(instance);
+    } catch {
+      currentToken = null;
+    }
+    if (
+      instance.deploymentId !== bootstrap.deploymentId ||
+      instance.credentialType !== "deployment" ||
+      currentToken !== bootstrap.token ||
+      instance.status !== "ativa"
+    ) {
+      clearInstanceIdentity(instance);
+      instance.deploymentId = bootstrap.deploymentId;
+      instance.credentialType = "deployment";
+      instance.status = "ativa";
+      instance.appCode = getAppCode();
+      instance.ambiente = ambiente();
+      instance.ecosystemUrl = process.env.CENTRAL_ATIVACAO_URL;
+      instance.publicUrl = process.env.PUBLIC_APP_URL;
+      instance.coreVersion = version();
+      instance.appVersion = version();
+      instance.ativadaEm = new Date();
+      instance.concluidaEm = new Date();
+      instance.credentialVersion = Number(instance.credentialVersion || 0) + 1;
+      Object.assign(instance, encrypt(bootstrap.token));
+      await instance.save();
+    }
+  }
+
   // Versões anteriores do Core marcavam a aplicação root como ativa sem criar
   // o App root e o grafo mínimo do ecossistema. Quando o domínio disponibiliza
   // o verificador, o App cadastrado passa a ser a fonte de verdade.
@@ -530,6 +583,7 @@ module.exports = {
   globalFields,
   rootFields,
   role,
+  deploymentBootstrap,
   ambiente,
   publicUrl,
   version,