dtic-DIIAA/adn/02_protocolo.md

02 - Protocolo del Proyecto: Normas y Directivas

Este documento establece las reglas fundamentales para la interacción, documentación y desarrollo en el proyecto srv-NS8.

1. Idioma

• Directiva: Todo el contenido debe estar en español.
• Alcance:
  • Interacciones con el asistente (chat).
  • Documentación (archivos .md).
  • Mensajes de Commit (Git).
  • Comentarios en el código (scripts, configs).
  • Nombres de archivos y directorios (preferentemente, salvo estándares técnicos estrictos).

2. Formato de Documentación

• Estilo: Markdown estándar.
• Ubicación: Todo documento clave debe residir en el directorio adn/.

3. Armonía y Auto-optimización

• Principio: La documentación (ADN) debe mantenerse como un todo coherente y libre de contradicciones.
• Directiva:
  • Consistencia: No deben existir discrepancias entre diferentes hebras (archivos .md). Si se actualiza una definición en 01_ontologia.md, debe reflejarse en los protocolos y bitácoras correspondientes.
  • Auto-corrección: Al detectar una inconsistencia, es prioritario resolverla para restaurar la armonía del sistema documental.

4. Estructura de Registro (Centralizada)

• Principio: Bitácora Única.
  • adn/00_bitacora.md es la Fuente de Verdad Histórica del Grid completo.
  • Se prohíben bitácoras dispersas en archivos individuales.
• Formato: Tabla Markdown con columnas: | Hora | Nodo | Detalle |.
  • Hora: HH:MM (Hora Local).
  • Nodo: Hostname del equipo afectado (e.g. srv-pmox1, srvv-SITIO).
  • Detalle: Descripción consisa. Uso de Emojis para estado visual (✅, ⚠️, ❌, 🔧).

5. Documentación de Nodos (Snapshots)

• Ubicación: adn/nodos/<HOSTNAME>.md.
• Contenido: Representa el Estado Actual (Snapshot) del nodo.
• Actualización: Solo se modifica cuando cambia la configuración o estado del nodo (no se usa como log histórico).

5. Protocolo de Seguridad de Red (Hombre Muerto)

• Problemática: La administración remota del servidor implica el riesgo de desconexión total ante cambios erróneos en la configuración de red.
• Directiva: Toda modificación de red debe incluir un mecanismo de reversión automática.
• Implementación:
  • Usar scripts con temporizador ("Dead Man's Switch").
  • Flujo:
    1. Aplicar cambios temporalmente.
    2. Esperar confirmación explícita del usuario (ej: presionar una tecla) durante un tiempo prudencial (5 minutos).
    3. Si no hay confirmación: Revertir cambios inmediatamente y restaurar estado anterior.
    4. Si hay confirmación: Hacer cambios persistentes.

6. Referencia de Estados (Bitácora)

Para optimizar espacio horizontal, la columna Estado utiliza los siguientes iconos:

Icono	Significado	Descripción
✅	Completado	Tarea finalizada o problema solucionado exitosamente.
⏳	En Proceso	Tarea iniciada pero pendiente de cierre.
🧪	Verificado	Validación técnica o prueba superada.
⚠️	Alerta	Problema detectado, riesgo o atención requerida.
📍	Definido	Hito establecido o prioridad fijada sin ejecución inmediata.

7. Resguardo del Repositorio (Safeguard)

• Objetivo: Asegurar la integridad y el historial de cambios del proyecto.
• Directiva:
  • Frecuencia: Al finalizar una tarea significativa o conjunto de tareas relacionadas (hito).
  • Alcance: Todo cambio en adn/, servicios/config, scripts/ y documentación docs/.
  • Formato Mensaje: [Categoría] Descripción breve del cambio.
    • Categorías: Feat (Nueva funcionalidad), Fix (Corrección), Docs (Documentación), Refactor (Mejora de código/estructura), Chore (Mantenimiento).