# 🧬 ADN del Proyecto: srv-ns8 (Arquitectura de Datos y Normas)

## Resumen Ejecutivo
El directorio `adn/` constituye el "núcleo genético" del servidor `srv-ns8`. No es simplemente una carpeta de documentos, sino un sistema dinámico e interconectado que define las reglas de gobernanza, la ontología de la infraestructura y los protocolos de sincronización del proyecto. Su principio rector es la **Armonía Integral**, donde cualquier cambio en la infraestructura o en los registros debe propagarse para mantener la coherencia del sistema completo.

---

## 🔍 Análisis Estructural
- **Tipo de Proyecto**: Sistema de Gobernanza de Infraestructura y Metadatos (Documentación Viva + Automatización).
- **Organización**: Se estructura en **Hebras (1 a 7)**, cada una responsable de un dominio operativo:
  - `01_ontologia.md`: Definición de nodos (Proxmox, Xen, VMs, Satélites).
  - `02_bitacora.md`: Estándar para el registro diario y reglas de triggers.
  - `03_seguridad.md`: Protocolos de protección y acceso seguro.
  - `04_iconografia.md`: Taxonomía visual semántica para estados y eventos.
  - `05_ia.md`: Normas y directivas específicas para la interacción con IAs.
  - `06_gobernanza.md`: Normas de nomenclatura, evolución del sistema y codificación.
  - `07_proyectos.md`: Gestión transversal de proyectos e hitos.
- **Archivos Fundamentales**:
  - `00_indice.md`: El punto de entrada que explica la interconexión entre Hebras, Bitácoras y Nodos.
  - `triggers.yml`: Archivo de configuración que orquesta la automatización de la propagación de datos.

## ⚙️ Configuración y Dependencias
- **Tecnologías Clave**:
  - **Motor de ejecución**: Ruby (utilizado para scripts de automatización como `adn/tools/run`).
  - **Formatos**: Markdown para documentación y YAML para reglas de automatización.
  - **Entorno**: Dockerizado para servicios de red (Nginx, Homepage, Bitácoras).
- **Configuración Relevante**:
  - `triggers.yml`: Define qué acciones disparar ante eventos específicos (ej. cierre de tareas, creación de nuevas bitácoras).
- **Comandos Necesarios**:
  - `./adn/tools/run triggers`: Procesa y sincroniza los cambios basados en las reglas del ADN.
  - `ruby adn/tools/seguridad/ns8-candados.rb`: Gestiona la seguridad y secretos del servidor.

## 🧠 Contexto para IA
- **Patrones y Convenciones**: Se debe mantener estrictamente la iconografía semántica (`04_iconografia.md`) y seguir las directivas de la Hebra 05. Ningún cambio debe romper la "Armonía Integral" definida en el índice.
- **Áreas Críticas**: 
  - `triggers.yml` es vital para la integridad de los datos.
  - La sincronización entre Bitácoras y Ontología es el punto más sensible de la operación diaria.
- **Deuda Técnica**: El sistema de triggers está en fase de desarrollo (Fase 2: Automatización), por lo que requiere supervisión humana para validar ciertas propagaciones complejas.

## 🚀 Próximos Pasos
- **Documentación Pendiente**: Expandir la documentación de red en la Ontología para incluir diagramas de topología actualizados.
- **Preguntas para Nuevos Colaboradores**:
  - ¿Cómo se asegura que un nuevo nodo en Proxmox esté correctamente reflejado en la Ontología?
  - ¿Qué icono semántico corresponde a una tarea en proceso versus una tarea bloqueada?
- **Primera Tarea Lógica**: Verificar que las últimas entradas de la bitácora cumplan con el formato de la Hebra 02 y que los triggers hayan procesado las actualizaciones de estado.

---
*Generado siguiendo docs/prompt/documentacion.md*