Files
dtic-DIIAA/servicios/nexxa
63ea8a0abb
Tests ADN / test (push) Canceled after 0s
feat(nexxa): 1.5.0 — identificador de una key editable desde nexxa-web
PATCH /keys acepta 'identificador': renombra en el registro y en todos los pools, deja el evento 'renombrada (antes X)' en usos y lo rechaza si la key está reservada o el nombre existe (409). Campo Identificador en el panel de edición. Los chips de pools de APIs se refrescan tras cambiar un pool. Suite: humo HTTP 63, pools 45, revertir 10.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Co-Authored-By: GEMMA <noreply@gemma.dtic>
2026-10-04 18:05:02 -03:00
..

NEXXA — broker de API keys del ecosistema (servicio DIIAA)

NEXXA administra el pool de API keys (Gemini, DeepSeek, …) que consumen GEMMA y los individuos F1: dispensa una key por consulta, cifrada de punta a punta para el consumidor, y recibe el reporte de salud de cada key. Se gestiona desde nexxa-web (web/, panel con usuarios admin/operador) y se consume por su API HTTP (organismo/server.rb, :4568).

Origen y versión

  • Versión vigente: organismo/VERSION (fuente única; nexxa-web la muestra en /version).
  • Metamorfosis (2026-10-04, P335): nació como el individuo rm-apid06-nexxa del linaje apids (repo rm-APIDs, P201/P204/P205/P238). Pasa a ser el servicio srvv-nexxa del ámbito DIIAA: es la misma NEXXA, evolucionada.
  • Base de este repo: el código que corría en producción el 2026-10-04 (versión 1.2.1), importado y verificado por hash contra el nodo (gemma git importar:verificar, 23/23 iguales). El repo rm-APIDs había quedado atrasado desde P201 (6 archivos distintos o ausentes).

Estructura (convención REG002, P335/Fase 9)

  • organismo/lib_*.rb: módulos (registro, pools, tokens, auth, usos, checkins, cripto, envelope).
  • organismo/cli_*.rb: CLIs de emergencia en el nodo (cli_admin, cli_consumidor, cli_registrar).
  • organismo/tool_humo_pool.rb: humo que corre EN el nodo contra el registro real (provider descartable).
  • Contratos externos con su nombre de siempre: server.rb (lo arranca systemd) y el chasis F1 chat.rb, latido.rb, nexxa.rb, router.rb (los usa gemma individuos chat, igual en todos los individuos).
  • test/: suite local sobre una copia aislada con estado falso (ruby test/<x>_test.rb); test/servidor_prueba.rb deja un NEXXA de prueba corriendo para mirar nexxa-web en un navegador.

Reglas

  • El código se cambia acá y se despliega desde acá, nunca editando en el nodo: gemma nodos deploy --nodo <nodo> --local-dir servicios/nexxa/organismo --remoto-dir /opt/nexxa/organismo --archivos ... (verifica hash local == remoto).
  • Versión semver por release: patch (arreglo), minor (función nueva compatible), major (cambia el contrato de la API). Se sube organismo/VERSION en el mismo commit del cambio.
  • Estado y secretos nunca acá (ver .gitignore): registro.json, tokens.json, usuarios, sesiones, la master key y los logs viven solo en el nodo (Regla de Oro 15).

Plan vigente: dtic-GEMMA/_docs/DIIAA/p_P335_nexxa-pools-por-individuo-mente-y-red-con-gestion-web.md.