[ADN] Fase 10: Saneamiento y Consolidación - Un solo punto de verdad

- S1: Eliminar 'triggers' duplicado en run (líneas 109/131) - S2: Eliminar cli/commit.rb (truncado, sin uso) - S3: Eliminar cli/inicio.rb y cli/cierre.rb (legacy, jornada.rb los reemplaza) - S4: Mover 4 planes obsoletos de docs/plan/adn/ a docs/_hist/plan/adn/ - S5: Mover 14 backups de planes y 3 docs técnicos a docs/_hist/ - S6: Eliminar manifiesto vacío P2604_proyecto_p2604.md - S7: Corregir referencia a plan obsoleto en run - S8: Dejar de cargar core/validador.rb obsoleto en run - S9: Limpiar progreso duplicado en P2604_mejoras_ADN.md - Agregar Fase 10 al plan P2604 con 10 tareas - Un solo punto de verdad: adn/README.md - Un solo plan: docs/proy/p2604_mejoras_ADN/P2604_mejoras_ADN.md - Registro en bitácora: evento 1073
2026-03-15 14:33:32 -03:00
parent b13a389568
commit cfd0e8452a
36 changed files with 1563 additions and 238 deletions
@@ -0,0 +1,124 @@
+# Documentación Técnica: Módulos Core ADN
+
+> Referencia de módulos centrales | Proyecto: dtic-DIIAA
+
+## core/constants.rb
+
+Constantes globales del sistema.
+
+```ruby
+# Rutas
+ADN::PROJECT_ROOT
+ADN::NODOS_DIR
+ADN::BITACORAS_DIR  
+ADN::LOGS_DIR
+ADN::TOOLS_DIR
+ADN::SEGURIDAD_DIR
+
+# Estados (iconos)
+ADN::ESTADOS = {
+  pendiente: '⏳',
+  completado: '✅',
+  fallido: '❌',
+  advertencia: '⚠️',
+  pausado: '⏸️',
+  en_proceso: '📍'
+}
+
+# Modos de trabajo
+ADN::MODOS = {
+  presencial: 'P',
+  remoto: 'R'
+}
+
+# DB
+ADN::DB_CONFIG = { host: 'localhost', puerto: 5433, ... }
+```
+
+## core/logger.rb
+
+Logging estructurado JSON.
+
+```ruby
+logger = ADN::Logger.new(
+  directorio: 'logs/adn',
+  terminal: true,
+  colores: true,
+  nivel: 'INFO'
+)
+
+logger.info("mensaje", { dato: "valor" })
+logger.error("error", { exception: e })
+```
+
+### Métodos
+- `debug`, `info`, `exito`, `advertencia`, `error`
+- `buffer` - obtener logs en memoria
+- `limpiar_buffer`
+- `cerrar`
+
+## core/colores.rb
+
+Códigos ANSI para terminal.
+
+```ruby
+Color::RESET
+Color::BOLD
+Color::GREEN
+Color::CYAN
+Color::YELLOW
+Color::RED
+Color::MAGENTA
+Color::DIM
+```
+
+## core/error_handler.rb
+
+Helper para mensajes estandarizados.
+
+```ruby
+ADN::ErrorHandler.error("msg")
+ADN::ErrorHandler.warning("msg")
+ADN::ErrorHandler.info("msg")
+ADN::ErrorHandler.success("msg")
+ADN::ErrorHandler.debug("msg")
+```
+
+## core/help_formatter.rb
+
+Generador de ayuda estandarizado.
+
+```ruby
+ADN::HelpFormatter.generar_help(
+  titulo: "Comando",
+  descripcion: "Hace algo",
+  uso: "Uso: cmd [opciones]",
+  opciones: [...],
+  ejemplos: [...]
+)
+```
+
+## core/validador.rb
+
+Validador de cumplimiento ADN (para MD-First legacy).
+
+⚠️ **DEPRECATED**: Usar validaciones en DB en su lugar.
+
+## core/triggers.rb
+
+Motor de triggers para propagación automática.
+
+## core/eventos.rb
+
+Bus de eventos (pub/sub).
+
+## Dependencias
+
+```
+adn/tools/
+├── core/
+│   ├── constants.rb  (requiere colores)
+│   ├── logger.rb     (requiere colores)
+│   ├── error_handler.rb
+│   └── help_formatter.rb (requiere colores)
+```