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. Formato de Registro (Bitácoras)

• Estructura: Tablas separadas por fecha (H2 con fecha YYYY-MM-DD).
• Orden: Descendente (lo más reciente arriba).
• Columnas Obligatorias:
  • Hora (HH:MM)
  • E (Estado/Icono)
  • Acción
  • Detalle/Impacto

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).