Files

T

Ricardo Monla 69149c9e29 [RFC-ADN-01] Armonía Integral — estandarizar manifiestos de proyectos

- P2604: Agregar Identificación, Stakeholders, Nodos, Herramientas, Hitos Clave
- P2605: Agregar Identificación, Stakeholders, Nodos, Herramientas, Hitos Clave
- P2602: Eliminar sección de nodos duplicada + agregar Hitos Clave
- Todos: Rutas relativas corregidas, referencias DB-First

2026-03-16 15:24:26 -03:00

6.8 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 nomenclatura de proyectos (RFC-ADN-01)
—	DOC	📍	Actualizar README.md con funcionalidades nuevas (auto-refresh, estado/modo)

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

Plan de Mejoras (12 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	✅

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:  ████████░░  67%  Eventos

Métricas Totales

Métrica	Valor
Tests pasando	15
Archivos creados	12
Archivos modificados	10
Archivos limpiados/movidos	20+
Fases completadas	11/12 (92%)

Referencias

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

6.8 KiB Raw Blame History