Command Center API

Propósito

Family de endpoints transversales y de plataforma que no pertenecen a un dominio de negocio: plan de cuentas template, manual de cuentas canónico, exports internos consumidos por Jean d’Arc en build, gestión de agentes (tasks y registry) y monitoreo. El Command Center es la sección administrativa que orquesta estos recursos compartidos entre todos los tenants.

Mapa de Familias

Familia	Prefijo	Router	Consumidor típico
Plan de cuentas template	/api/command/plan-cuentas	routes/command/plan-cuentas/	Sevastopol admin · jean_d_arc build
Manual de cuentas (CRUD)	/api/command/manual-cuentas	routes/command/manual-cuentas/	Sevastopol admin
Manual de cuentas (export)	/api/internal/manual-cuentas	routes/internal/manual-cuentas.ts	jean_d_arc loader
Agentes — tasks	/api/agent/tasks	routes/command/agent-tasks.ts	Registry view
Agentes — registry	/api/agent/registry	routes/command/registry.ts	Registry view
Monitoreo	/api/monitoring	routes/command/monitoring.ts	Dashboard ejecutivo

Plan de Cuentas (template)

El plan de cuentas template es el árbol jerárquico de cuentas contables que sirve de base para que cada tenant materialice su propio manual al crearse.

Método	Ruta	Uso
GET	/api/command/plan-cuentas	Lista todas las cuentas del template (estructura de árbol).
GET	/api/command/plan-cuentas/:codigo	Obtiene una cuenta por código.
POST	/api/command/plan-cuentas	Crea cuenta en el template (admin global).
PUT	/api/command/plan-cuentas/:codigo	Actualiza cuenta.
DELETE	/api/command/plan-cuentas/:codigo	Elimina cuenta del template.

Manual de Cuentas

El manual de cuentas es la documentación canónica de cada cuenta del plan: descripción, ejemplos contables, debe/haber, normas IFRS asociadas. Vive en MongoDB (nostromo_manual.cuentas) y se mantiene por administradores del sistema.

Método	Ruta	Uso
GET	/api/command/manual-cuentas	Lista entradas del manual con filtros (codigo, grupo).
GET	/api/command/manual-cuentas/:codigo	Obtiene una entrada por código.
POST	/api/command/manual-cuentas	Crea entrada del manual.
PUT	/api/command/manual-cuentas/:codigo	Actualiza descripción, ejemplos o metadatos.
DELETE	/api/command/manual-cuentas/:codigo	Elimina entrada.

Export interno (consumido por Jean d’Arc en build)

Endpoint read-only para que Jean d’Arc materialice las páginas del manual de cuentas durante el build estático. No usa JWT de usuario; requiere un token compartido en el header X-Internal-Token.

GET /api/internal/manual-cuentas

Expone la colección nostromo_manual.cuentas enriquecida con el plan contable template para incluir nombre, padre, grupo e imputabilidad.

Request

curl -X GET http://localhost:8000/api/internal/manual-cuentas \
  -H "X-Internal-Token: $INTERNAL_API_TOKEN"

Response 200

{
  "version": "2026-05-14T12:00:00.000Z",
  "cuentas": [
    {
      "codigo": "1101000",
      "nombre": "Efectivo y equivalentes",
      "grupo": "activos-corrientes-1100000",
      "padre": "1100000",
      "descripcion_markdown": "## Debe\n\nSe debita por entradas de efectivo.",
      "ejemplos": [{ "titulo": "Caja", "descripcion_md": "Ingreso de caja." }],
      "imputable": true,
      "updated_at": "2026-05-14T12:00:00.000Z"
    }
  ]
}

Cabeceras de cache:

• Cache-Control: public, max-age=300, stale-while-revalidate=600
• ETag: basado en el mayor updated_at del manual exportado.

Errores: 401 (token ausente/invalido), 503 (token no configurado o Mongo no disponible), 500 (error inesperado).

Ver código: orchestrator/src/routes/internal/manual-cuentas.ts.

Agentes (tasks y registry)

El registry view de Sevastopol consume estos endpoints para mostrar el estado de los agentes IA del ecosistema (Orchestrator, Sevastopol, Nostromo, Mother, Jean d’Arc).

Método	Ruta	Uso
GET	/api/agent/tasks	Lista tareas/jobs reportados por agentes.
POST	/api/agent/tasks	Crea una tarea (uso de los agentes para reportar trabajo).
PUT	/api/agent/tasks/:id	Actualiza estado de una tarea.
GET	/api/agent/registry	Lista agentes activos y su última actividad (heartbeat).
POST	/api/agent/registry/heartbeat	Heartbeat de un agente.

Monitoreo

Método	Ruta	Uso
GET	/api/monitoring/metrics	Métricas operacionales (latencia, throughput, errores).
GET	/api/monitoring/audit	Bitácora de auditoría (acciones administrativas).
GET	/api/monitoring/health	Estado de servicios (DB, Mongo, conexiones).

Detalles narrativos en Orchestrator · Monitoring.