# 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)
```