Tests ADN / test (push) Canceled after 0s
- Base: código de producción de srvv-nexxa (1.2.1), importado y verificado por hash (P335/F3) - Pools por individuo (lib_pools): mente y red, mezclan proveedores, keys compartidas o exclusivas - API: /disponible/mente|red y /estado por rol, pool_vacio explícito, /pools (CRUD admin), liberar admin - Revertir el agotada propio + motivo y quién la agotó (de P334/F4) - nexxa-web: sección Pools, motivo y botón Liberar, provider libre con sugerencias, escape de texto externo - Convención REG002: lib_*, cli_*, tool_humo_pool; contratos externos con su nombre - Suite local sobre copia aislada: humo HTTP, pools, revertir; servidor_prueba para mirar la web Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Co-Authored-By: GEMMA <noreply@gemma.dtic>
37 lines
2.5 KiB
Markdown
37 lines
2.5 KiB
Markdown
# 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`.
|