feat(nexxa): taxonomía cerrada de estados y registro completo de eventos (motivo, hasta, quién), /resumen y /usos filtrable; 2.0.0 (P337/F1)
Tests ADN / test (push) Canceled after 0s

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

Co-Authored-By: GEMMA <noreply@gemma.dtic>
This commit is contained in:
Ricardo Monla
2026-10-05 03:29:40 -03:00
co-authored by Claude Opus 5.5 GEMMA
parent 08aa45117e
commit 82e56aad0e
11 changed files with 233 additions and 81 deletions
+29 -5
View File
@@ -104,6 +104,12 @@ def operador_autenticado?(req)
!sesion_actual(req).nil?
end
# Quién hizo algo desde la web, para el registro de usos (P337/Fase 1)
def quien(req)
u = sesion_actual(req)&.dig('usuario')
u ? "web:#{u}" : 'api'
end
def admin_autenticado?(req)
sesion_actual(req)&.dig('perfil') == 'admin'
end
@@ -244,7 +250,8 @@ class KeysServlet < WEBrick::HTTPServlet::AbstractServlet
res.status = 200
# Cada key trae en qué pools está (P335/Fase 12): la sección APIs lo muestra y avisa al eliminar
pools = Nexxa::Pools.leer
res.body = Nexxa::Registro.todas.map { |k| k.merge('pools' => Nexxa::Pools.de_key(k['provider'], k['identificador'], pools)) }.to_json
# Y su estado de la taxonomía calculado acá (P337/Fase 1): la web lo muestra, no lo recalcula
res.body = Nexxa::Registro.todas_con_estado.map { |k| k.merge('pools' => Nexxa::Pools.de_key(k['provider'], k['identificador'], pools)) }.to_json
end
# POST /keys/<provider>/<identificador>/liberar — admin libera una key agotada o reservada (P335/Fase 7)
@@ -302,7 +309,7 @@ class KeysServlet < WEBrick::HTTPServlet::AbstractServlet
identificador: identificador,
cuenta_origen: body['cuenta_origen'],
reset_segundos: body['reset_segundos']&.to_i,
activo: body.key?('activo') ? body['activo'] : nil
activo: body.key?('activo') ? body['activo'] : nil, por: quien(req)
)
res.status = 200
res.body = entrada.reject { |k, _| k == 'valor_cifrado' }.to_json
@@ -325,7 +332,7 @@ class KeysServlet < WEBrick::HTTPServlet::AbstractServlet
end
provider, identificador = partes
borrado = Nexxa::Registro.eliminar(provider: provider, identificador: identificador)
borrado = Nexxa::Registro.eliminar(provider: provider, identificador: identificador, por: quien(req))
Nexxa::Pools.olvidar_key(provider: provider, identificador: identificador) if borrado # sin refs colgadas (P335)
if borrado
res.status = 200
@@ -425,12 +432,28 @@ server.mount '/pools', PoolsServlet
# GET /usos — historial de eventos (dispensada/agotada) para la mini-app (P204/Fase4).
# Read-only, mismo criterio de auth que GET /keys (cualquier operador logueado).
# Usos.historial ya existía (P201/Fase3) — nunca se había montado por HTTP.
# P337/Fase 1: registro completo con filtros — ?provider=&identificador=&individuo=&evento=&horas=&limit= (máx 2000)
server.mount_proc '/usos' do |req, res|
next rechazar_no_autenticado(res) unless operador_autenticado?(req)
q = req.query
filtros = %w[provider identificador individuo evento].to_h { |k| [k.to_sym, q[k].to_s.empty? ? nil : q[k].to_s] }
limit = (q['limit'] || 100).to_i.clamp(1, 2000)
horas = q['horas'].to_s.empty? ? nil : q['horas'].to_f
res.status = 200
res.content_type = 'application/json'
res.body = Nexxa::Usos.historial(limit: 100).to_json
res.body = Nexxa::Usos.historial(**filtros, horas: horas, limit: limit).to_json
end
# GET /resumen?horas=24 — P337/Fase 1: cuántas keys en cada estado AHORA y qué pasó en la ventana (por evento y por
# key). Lo que el Dashboard muestra, calculado acá.
server.mount_proc '/resumen' do |req, res|
next rechazar_no_autenticado(res) unless operador_autenticado?(req)
horas = (req.query['horas'] || 24).to_f.clamp(1, 24 * 31)
res.status = 200
res.content_type = 'application/json'
res.body = Nexxa::Usos.resumen(Nexxa::Registro.todas_con_estado, horas: horas).to_json
end
# GET /consumidores — individuos con token registrado (metadata)
@@ -877,7 +900,8 @@ server.mount_proc '/alta' do |req, res|
identificador: body['identificador'],
cuenta_origen: body['cuenta_origen'],
reset_segundos: body['reset_segundos'].to_i,
valor: body['valor']
valor: body['valor'],
por: quien(req)
)
res.status = 201