4.7 KiB
4.7 KiB
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 y Nomenclatura
- Directiva: Todo el contenido debe estar en español.
- Nomenclatura de Nodos: Estrictamente minúsculas en nombres de archivo y referencias (ej:
srv-ns8,pc-dasu0,srvv-maurik). - Alcance:
- Interacciones con el asistente (chat).
- Documentación (archivos
.md). - Mensajes de Commit (Git).
- Comentarios en el código (scripts, configs).
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.
- Alcance Global: Esta directiva aplica a TODOS los directorios del proyecto, incluyendo
adn/,bitacoras/,nodos/, yprocedimientos/. - Directiva:
- Consistencia: No deben existir discrepancias entre diferentes hebras. Si se actualiza una definición en
01_ontologia.md, debe reflejarse en los protocolos y bitácoras correspondientes. - Trazabilidad: Los IDs y estados deben ser consistentes a través del tiempo.
- Auto-corrección: Al detectar una inconsistencia, es prioritario resolverla para restaurar la armonía del sistema documental.
- Consistencia: No deben existir discrepancias entre diferentes hebras. Si se actualiza una definición en
4. Estructura de Bitácora (Flujo Diario)
- Principio: Orden Inverso Cronológico (Lo más nuevo SIEMPRE ARRIBA).
- Archivo Diario:
bitacoras/YYYY-MM-DD.md. - Secciones Obligatorias:
4.1 Control de Gestión
- Pendientes: Tabla de tareas por hacer (ID | NODO | DETALLE).
- En Proceso: Tabla de tareas activas (ID | NODO | DETALLE).
- Resumen de Actividades:
- Formato: Tabla (NODO | RESUMEN INTEGRAL).
- Estilo: Narrativa Sintética e Integral. SIN TÍTULOS NI ESTADOS en el texto. Solo la historia consolidada del día para ese nodo.
- Regla: Una sola fila por Nodo.
4.2 Actividades Detalladas
- Subdivisión: Encabezados por Nodo (
### srv-ns8). - Formato: Tabla detallada (Tema | Detalle | Ini | Fin).
- Estilo: Narrativa Generosa y Técnica. Aquí se explican los "qué", "cómo" y "por qué".
- Estados: Uso de iconos (✅, 🧹, 🔧) para visualización rápida.
4.3 Footer de Mantenimiento (IA)
- Al final de cada bitácora, incluir el bloque de comentarios HTML con las Premisas de Trabajo (Orden inverso, Nomenclatura, Flujo de Carga: Detalle -> Resumen).
5. Documentación de Nodos (Snapshots)
- Ubicación:
nodos/<hostname>.md(Raíz del proyecto). - Contenido: Representa el Estado Actual (Snapshot) del nodo.
- Actualización: Solo se modifica cuando cambia la configuración o estado del nodo. No duplicar información dinámica de la bitácora.
6. 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:
- Aplicar cambios temporalmente.
- Esperar confirmación explícita del usuario (ej: presionar una tecla) durante un tiempo prudencial (5 minutos).
- Si no hay confirmación: Revertir cambios inmediatamente y restaurar estado anterior.
- Si hay confirmación: Hacer cambios persistentes.
7. Referencia de Estados (Bitácora Detallada)
Para optimizar espacio horizontal en tablas de detalle:
| Icono | Significado | Descripción |
|---|---|---|
| ✅ | Completado | Tarea finalizada o problema solucionado exitosamente. |
| ⏳ | En Proceso | Tarea iniciada pero pendiente de cierre. |
| 🟢 | Operativo | Servicio funcionando correctamente tras intervención. |
| 🔧 | Mantenimiento | Acción técnica de configuración o ajuste. |
| 🧪 | Verificado | Validación técnica o prueba superada. |
| ⚠️ | Alerta | Problema detectado, riesgo o atención requerida. |
| 📍 | Definido | Hito establecido o prioridad fijada. |
8. 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óndocs/. - Formato Mensaje:
[Categoría] Descripción breve del cambio.