Files
dtic-DIIAA/docs/ambito/dtic-ADN/_hist/P2604_Mejoras-ADN.md
T
Ricardo MonlaandClaude Opus 4.6 018e45e046 feat(ambito): Migración de dtic-ADN a estándar de ámbito A01
- Creado manifiesto A01_dtic-ADN.md siguiendo estándar A03/A04
- Renombrados planes P2604.* → A01.P00X (8 planes migrados)
- Archivado manifiesto legacy P2604_Mejoras-ADN.md en _hist/
- Actualizada ontología y contexto IA con referencias a A01

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-07 09:59:52 -03:00

9.8 KiB

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 ✅

Fase 17: Optimización Hardware srv-ns8

ID Mejora Estado
H1 Aumentar RAM de srv-ns8 (mínimo 32 GB para Ollama) ⏳
H2 Evaluar SSD para mejorar rendimiento ⏳

Fase 18: Integración Ollama (LLM Local)

ID Mejora Estado
O1 Instalar modelo LLM liviano (1-3B params) ⏳
O2 Integrar Ollama como backend de IA en herramientas ADN ⏳
O3 Capacidad de análisis de código/documentos via LLM local ⏳

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
Fase 17:  ░░░░░░░░░░  0%  Hardware srv-ns8
Fase 18:  ░░░░░░░░░░  0%  Ollama (LLM Local)

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