Files

T

Ricardo Monla cfd0e8452a [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

2.0 KiB

Raw Permalink Blame History

Documentación Técnica: Módulos Core ADN

Referencia de módulos centrales | Proyecto: dtic-DIIAA

core/constants.rb

Constantes globales del sistema.

# 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.

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.

Color::RESET
Color::BOLD
Color::GREEN
Color::CYAN
Color::YELLOW
Color::RED
Color::MAGENTA
Color::DIM

core/error_handler.rb

Helper para mensajes estandarizados.

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.

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)

2.0 KiB Raw Permalink Blame History