🧬 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 tools/adn/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:
- ./tools/adn/run triggers: Procesa y sincroniza los cambios basados en las reglas del ADN.
- ruby tools/adn/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

3.5 KiB Raw Blame History