feat(nexxa): NEXXA versionada en dtic-DIIAA (1.3.0): pools por individuo mente/red, API por rol y gestión desde nexxa-web
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>
This commit is contained in:
Ricardo Monla
2026-10-04 16:42:13 -03:00
co-authored by Claude Opus 5.5 GEMMA
parent 50ac0d0fdf
commit a60758875d
31 changed files with 5653 additions and 0 deletions
+46
View File
@@ -0,0 +1,46 @@
# frozen_string_literal: true
# lib_usos.rb — Registro de uso por individuo (P201/Fase3, D045 §11, ME-605 punto 5)
# ==============================================================================
# Trazabilidad de quién recibió qué key y cuándo — separado del dato de origen
# (cuenta_origen, en lib_registro.rb) y separado de registro.json (estado actual)
# para no mezclar "foto del ahora" con "historial acumulado". Append-only,
# JSONL — mismo espíritu que un log de bitácora: se escribe, no se reescribe.
# ==============================================================================
require 'json'
require 'time'
module Nexxa
module Usos
LOG_FILE = File.expand_path('usos.log', __dir__).freeze
# evento (P204/Fase3): 'dispensada' (reserva al entregar la key) o 'agotada'
# (el consumidor reportó agotamiento real) — default compat con llamadas
# previas a Fase3 (todas eran dispensas).
def self.registrar(provider:, identificador:, individuo:, en: Time.now, evento: 'dispensada')
linea = {
'provider' => provider,
'identificador' => identificador,
'individuo' => individuo,
'evento' => evento,
'en' => en.iso8601
}
File.open(LOG_FILE, 'a') { |f| f.puts(linea.to_json) }
end
# Historial más reciente primero, opcionalmente filtrado por key
def self.historial(provider: nil, identificador: nil, limit: 50)
return [] unless File.exist?(LOG_FILE)
lineas = File.readlines(LOG_FILE).filter_map do |l|
JSON.parse(l)
rescue JSON::ParserError
nil
end
lineas.select! { |l| l['provider'] == provider } if provider
lineas.select! { |l| l['identificador'] == identificador } if identificador
lineas.last(limit).reverse
end
end
end