Files

T

Ricardo Monla 160da47f96 [P2606] WebServer NGINX: plan actualizado, ficha nodo, HTTPS operativo

- P2606: Plan v1.1 EN EJECUCIÓN. Fases 1-3 completadas.
- Ficha nodo srvv-nginx-rm.md. P2606 en adn/07_proyectos.md.
- Incluye cambios acumulados de sesiones anteriores.

2026-03-28 12:18:42 -03:00

9.1 KiB

Raw Blame History

P2604 - Mejoras al ADN

Manifiesto de Proyecto | Referencia: adn/07_proyectos.md

Identificación

Campo	Valor
Código	P2604
Nombre	Mejoras al Ecosistema ADN
Estado	⏳ En Ejecución
Inicio	14/03/2026
Fin Estimado	Continuo (mejora continua)

Objetivo

Mejoras atómicas, incrementales y reutilizables al ecosistema ADN. Una herramienta por vez, siguiendo los principios: Menos es Más + Mejora Continua + Armonía Integral.

Stakeholders

Rol	Persona	Visibilidad
Responsable Técnico	Lic. Ricardo MONLA	Operador directo
Dirección de TIC	(Jerárquico superior)	Dashboard asíncrono

Nodos Involucrados

Nodos Exclusivos (Core)

Nodo	IP	Rol en el Proyecto
srv-ns8	`10.0.10.8`	Servidor de desarrollo y ejecución del ADN

Herramientas

Herramienta	Uso
Ruby 3.x	Lenguaje del ecosistema ADN
RSpec	Framework de tests
RuboCop	Lint automatizado
GitHub Actions	CI/CD (tests + lint)

Hitos Clave

Fecha	ID	Estado	Hito
14/03	F1-F8	✅	Tests core, deprecation banners, error handler, constants, logger, HelpFormatter, docs técnica, CI/CD
15/03	F9-F10	✅	Integración MSPs con ADN + Saneamiento y consolidación (S1-S15)
15/03	F11-F12	✅	Bitácora Web auto-refresh + Estado/Modo calculado automáticamente
16/03	RFC-01	✅	Convención de nomenclature de proyectos (RFC-ADN-01)
18/03	WZ-v2	✅	Plan e implementación de W-ZOMBI v2.0 (reemplazo sonda legacy)
—	DOC	📍	Actualizar README.md con funcionalidades nuevas (auto-refresh, estado/modo)
—	P2604.08	✅	Implementación del modelo Ámbito/Nodo en el ecosistema ADN

Diagnóstico Integral

Problemas Identificados

#	Problema	Archivo(s)	Principio	Severidad
1	Sin tests para módulos core	`core/*.rb`	Menos es Más	Alta
2	Banner DEPRECATED incompleto	`cli/validador.rb`	Armonía	Media
3	core/validador.rb sin deprecation	`core/validador.rb`	Armonía	Media
4	Constantes de colores hardcodeadas	`core/colores.rb`	Menos es Más	Baja
5	Sin handler de errores global	`run`	Armonía	Alta
6	db/exporters sin tests	`db/exporters/*.rb`	Menos es Más	Media
7	Logger sin rotación	`core/logger.rb`	Mejora Cont.	Baja
8	Help inconsistente entre CLI	`cli/*.rb`	Armonía	Baja
9	Sonda W-ZOMBI monolítica e inflexible	`adn/tools/sonda_w-zombi/servidor.rb`	Menos es Más	Alta

Plan de Mejoras (13 Fases)

Fase 1: Tests Core (Menos es Más)

ID	Módulo	Tests	Estado
T1	`spec/db/evento_spec.rb`	3	✅
T2	`spec/core/colores_spec.rb`	6	✅
T3	`spec/core/validador_spec.rb`	6	✅
T4	`spec/cli/help_spec.rb`	0	📍

Fase 2: Deprecation Banners (Armonía)

ID	Archivo	Acción	Estado
D1	`cli/validador.rb`	Banner agregado	✅
D2	`core/validador.rb`	Revisar - útil para validaciones	⏸️
D3	`db/exporters/md_exporter.rb`	Banner agregado	✅

Fase 3: Manejo de Errores (Armonía)

ID	Mejora	Estado
E1	Agregar `rescue` global en `run`	✅
E2	Estandarizar mensajes de error	✅
E3	Logging de excepciones no manejadas	✅

Herramientas creadas: core/error_handler.rb, excepciones en core/constants.rb

Fase 4: Constantes y Config (Menos es Más)

ID	Mejora	Estado
C1	Documentar constantes en constants.rb	✅
C2	Agregar constantes reutilizables (estados, modos)	✅
C3	Validar constantes al inicio	✅

Fase 5: Logger Mejorado (Mejora Continua)

ID	Mejora	Estado
L1	Agregar rotación de logs	✅
L2	Niveles de log configurables	✅
L3	Output JSON estructurado	✅

Fase 6: Help Consistente (Armonía)

ID	Mejora	Estado
H1	HelpFormatter helper reutilizable	✅

Fase 7: Documentación Técnica

ID	Documento	Estado
DOC1	`docs/tecnica/adn_cli.md`	✅
DOC2	`docs/tecnica/adn_core.md`	✅
DOC3	`docs/tecnica/adn_tests.md`	✅

Fase 8: CI/CD

ID	Mejora	Estado
CI1	GitHub Actions para tests	✅
CI2	Lint automatizado (.rubocop.yml)	✅

Fase 9: Integración MSP (Armonía Integral)

ID	Mejora	Estado
M1	Auditoría de MSPs	✅
M2	Registro de MSPs en BD	✅
M3	Listado de MSPs disponibles	✅
M4	Documentación de integración	✅
M5	Reutilizar NodosInfo en CLI	✅

Fase 10: Saneamiento y Consolidación

ID	Mejora	Estado
S1-S9	Limpieza de código muerto y duplicaciones	✅
S10	Migrar SubcomandoSalud a namespace ADN	✅
S11	CLI `ssh` — ejecución remota reutilizable	✅
S12	Refactorizar ssh.rb — leer datos de fichas	✅
S13	Consolidar core/ — submódulos CLI	✅
S14	Subcomando `nodos info`	✅
S15	Actualizar README.md con estructura real	✅

Fase 11: Bitácora Web (Mejora Continua)

ID	Mejora	Estado
B1	Auto-refresh cada 30 segundos	✅
B2	Refresh al recuperar foco	✅
B3	Smart refresh (comparando max_id)	✅

Fase 12: Consistencia de Eventos (Menos es Más)

ID	Mejora	Estado
E1	Estado calculado automáticamente	✅
E2	Modo resuelto desde última jornada	✅
E3	Estado automático al actualizar con --fin	✅

Fase 13: Implementación W-ZOMBI v2.0 (Mejora Continua)

ID	Mejora	Estado
W1	Implementación de arquitectura modular	✅
W2	Integración como subcomando ADN-CLI	✅
W3	Test de despliegue y telemetría	✅

Fase 14: Estandarización Visual (Armonía Integral)

ID	Mejora	Estado
V1	Implementar barras de progreso Unicode en P2604	✅
V2	Propagar notación de barras a P2601	✅
V3	Crear guía de estilo para indicadores visuales	✅

Fase 15: Optimización de Intervención IA (Mejora Continua)

ID	Mejora	Estado
IA1	Diagnóstico de logs y fricción (sesión 18/03)	✅
IA2	Refactorización de directivas en 05_ia.md	✅
IA3	Automatización de contexto de seguridad (candados)	✅
IA4	Validación de reducción de pasos exploratorios	✅

Fase 16: Modelo Ámbito/Nodo (Armonía Integral)

ID	Mejora	Estado
A1	Base de Datos: tabla `ambitos`, columnas `ambito_id`	✅
A2	CLI Ruby: comando `ambitos`, normalización `--help`	✅
A3	API REST: endpoints `/api/ambitos/*`	✅
A4	Frontend: AmbitoDashboard con selector de ámbito	✅
A5	Documentación: hebras ADN actualizadas	✅

Progreso

Fase  1:  ██████████ 100%  Tests Core
Fase  2:  ██████░░░░  67%  Deprecation
Fase  3:  ██████████ 100%  Error Handler
Fase  4:  ██████████ 100%  Constants
Fase  5:  ██████████ 100%  Logger
Fase  6:  ██████████ 100%  HelpFormatter
Fase  7:  ██████████ 100%  Documentación
Fase  8:  ██████████ 100%  CI/CD
Fase  9:  ██████████ 100%  MSP
Fase 10:  ██████████ 100%  Saneamiento
Fase 11:  ██████████ 100%  Bitácora Web
Fase 12:  ██████████ 100%  Eventos
Fase 13:  ██████████ 100%  W-ZOMBI v2.0
Fase 14:  ██████████ 100%  Visibilidad
Fase 15:  ██████████ 100%  Optimización IA
Fase 16:  ██████████ 100%  Ámbito/Nodo

Métricas Totales

Métrica	Valor
Tests pasando	15
Archivos creados	14
Archivos modificados	12
Archivos limpiados/movidos	20+
Fases completadas	13/13 (100%)

Planes de Ejecución

Referencias

Punto de verdad: adn/README.md
ADN: Ontología | Proyectos
ADN IA: 05_ia.md
Bitácoras: IDs 1054-1056, 1073, 1106, 1112, 1163 vía ./adn/tools/run db evento:listar --detalle

9.1 KiB Raw Blame History