@oondemand/oon-core-back 0.4.23 → 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.23",
+  "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;