docs: Plan P2603.01 Automatización Zoom y actualizaciones P2601.09

2026-03-31 18:03:21 -03:00
parent 160da47f96
commit 1fd213173e
72 changed files with 19694 additions and 460 deletions
@@ -0,0 +1,276 @@
+# P2604 - Mejoras al ADN
+
+> Manifiesto de Proyecto | Referencia: [`adn/07_proyectos.md`](../../../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**](../../../nodos/srv-ns8.md) | `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
+
+- [Estandarización de Ayudas en Pantalla para Herramientas ADN](P2604.01.01_Estandarizacion-Ayudas-ADN.md)
+- [Implementación W-ZOMBI v2.0](P2604.03.01_Plan-W-ZOMBI-v2.0.md)
+- [Estandarización de Indicadores Visuales de Progreso](P2604.04.01_Estandarizacion-Barras-Progreso.md)
+- [Estudio de Fricción IA (Antigravity) y Mejora Continua](P2604.05.01_Estudio-Friccion-IA.md)
+- [Modelo Ámbito/Nodo para el Ecosistema ADN](P2604.08_Ambito-Nodo.md)
+
+## Referencias
+
+- **Punto de verdad**: [`adn/README.md`](../../../adn/README.md)
+- **ADN**: [Ontología](../../../adn/01_ontologia.md) | [Proyectos](../../../adn/07_proyectos.md)
+- **ADN IA**: [05_ia.md](../../../adn/05_ia.md)
+- **Bitácoras**: IDs 1054-1056, 1073, 1106, 1112, 1163 vía `./adn/tools/run db evento:listar --detalle`