# 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/_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 --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). - **Estado en su Postgres propio** (P335/Fase 17, decisión del Operador 2026-10-05: NEXXA sigue en pie aunque srv-ns8 caiga): todo pasa por `organismo/lib_estado.rb` (`Nexxa::Estado`), con motor `archivo` (JSON 0600, el de siempre y el de los tests) o `pg` (base `nexxa` local, socket peer con el usuario del servicio, sin contraseña), elegido EXPLÍCITO con `NEXXA_ESTADO=pg` en un drop-in systemd de los dos servicios. `mutar` es leer-modificar-guardar atómico y la dispensa elige y reserva la key en un solo paso. Pasar de un motor al otro: `organismo/cli_estado.rb migrar|verificar|exportar`, que desde GEMMA corre `gemma nexxa estado:pg --accion preparar|activar|revertir`. Plan vigente: `dtic-GEMMA/_docs/DIIAA/p_P335_nexxa-pools-por-individuo-mente-y-red-con-gestion-web.md`.