49 lines
3.5 KiB
Markdown
49 lines
3.5 KiB
Markdown
# 🧬 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.rb`).
|
|
- **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**:
|
|
- `ruby tools/adn.rb triggers`: Procesa y sincroniza los cambios basados en las reglas del ADN.
|
|
- `ruby tools/ns8-candados/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*
|