[ADN / Bitácora] Evolución Progresiva: Sistema de Iconografía Dual (Estado + Semántica)
This commit is contained in:
+48
-15
@@ -29,8 +29,8 @@ Este documento establece las reglas fundamentales para la interacción, document
|
||||
- **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).
|
||||
- **Pendientes**: Tabla de tareas por hacer (ID **[Icono] - [Hora Ini] - [Nombre Tarea]** | NODO | DETALLE).
|
||||
- **En Proceso**: Tabla de tareas activas (ID **[Icono] - [Hora Ini] - [Nombre Tarea]** | 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.
|
||||
@@ -38,12 +38,18 @@ Este documento establece las reglas fundamentales para la interacción, document
|
||||
|
||||
### 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.
|
||||
- **Formato**: Tabla detallada (Tema | Hitos).
|
||||
- **Nomenclatura del Tema**: `[Estado] [Categoría] - [ID] - **[Nombre Tarea]**` (ej. `✅ 💾 - A09 - **dtic-BKPs C4**`).
|
||||
- **Nomenclatura de Hitos**: `⏱️ **Cronología:**` seguido de viñetas con formato `- [Icono Semántico] **[Hora] hs**: [Descripción]` (ej. `- 🚀 **09:13 hs**: Reanudación del ciclo...`).
|
||||
- **Estilo (Hitos)**: **Narrativa Generosa y Técnica**. Explicando los "qué" y "por qué".
|
||||
- **Estados (Tema)**: Estrictamente delimitados para trazabilidad (✅ Cerrado, ⏳ En Proceso, ⚠️ Fallo).
|
||||
- **Categoría (Tema)**: Uso de taxonomía semántica (🔧, 🧹, 📝, 🧪, etc) acoplada al Estado para dar catalogación de lectura rápida.
|
||||
- **Semántica (Hitos)**: Uso libre de iconos descriptivos (🐛, 💾, 👁️, 🚀) integrados al nivel de la viñeta de tiempo para dar contexto visual detallado a cada evento.
|
||||
|
||||
### 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).
|
||||
- Al final de cada bitácora, incluir el bloque de comentarios HTML con las **Premisas de Trabajo**.
|
||||
- **Evolución**: El footer debe ser idéntico al del día anterior o una versión evolucionada (con nuevas reglas). NUNCA una versión simplificada o diferente.
|
||||
- **Registro**: Las nuevas reglas se acumulan para mantener la memoria del sistema.
|
||||
|
||||
## 5. Documentación de Nodos (Snapshots)
|
||||
- **Ubicación**: `nodos/<hostname>.md` (Raíz del proyecto).
|
||||
@@ -61,18 +67,30 @@ Este documento establece las reglas fundamentales para la interacción, document
|
||||
3. **Si no hay confirmación**: Revertir cambios inmediatamente y restaurar estado anterior.
|
||||
4. **Si hay confirmación**: Hacer cambios persistentes.
|
||||
|
||||
## 7. Referencia de Estados (Bitácora Detallada)
|
||||
Para optimizar espacio horizontal en tablas de detalle:
|
||||
## 7. Referencia de Iconografía
|
||||
Para optimizar el escaneo visual de las bitácoras, la columna de Tema implementa un Sistema Visual Dual (`[Estado] [Categoría]`):
|
||||
|
||||
### 1. Icono de Estado (Obligatorio)
|
||||
| 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. |
|
||||
| ✅ | **Completado** | Tarea general finalizada exitosamente. |
|
||||
| ⏳ | **En Proceso** | Tarea en ejecución o pendiente de cierre. |
|
||||
| ⚠️ | **Fallo / Alerta** | Tarea fallida, cancelada o riesgo detectado. |
|
||||
| 📍 | **Definido** | Pendiente en la cola de planificación (Control de Gestión). |
|
||||
|
||||
### 2. Iconos Semánticos (Categoría del Tema & Hitos Internos)
|
||||
| Icono | Orientación | Ejemplos de Uso |
|
||||
| :---: | :--- | :--- |
|
||||
| 🟢 | **Operativo** | Servicio funcionando, confirmación de red, OK. |
|
||||
| 🔧 | **Configuración** | Mantenimiento, ajuste de parámetros, cambios de código. |
|
||||
| 🧪 | **Prueba** | Validación técnica, ensayos, simulaciones, logs. |
|
||||
| 🐛 | **Bug / Fix** | Errores de software, excepciones, correcciones. |
|
||||
| 🧹 | **Limpieza** | Refactorización, purga, reubicación de archivos. |
|
||||
| 💾 | **Datos** | Backups, volcados, sincronización de discos, almacenamiento. |
|
||||
| 🚀 | **Despliegue** | Lanzamiento masivo, ejecución grande, puesta en marcha. |
|
||||
| 👁️ | **Análisis** | Revisión humana, planificación, auditoría, brainstorming. |
|
||||
| 🧠 | **Estructura** | Conceptualización de arquitectura, metodologías, ideas críticas. |
|
||||
| 📝 | **Documentación**| Actualización del ADN, manuales, reportes, logs manuales. |
|
||||
|
||||
## 8. Resguardo del Repositorio (Safeguard)
|
||||
- **Objetivo**: Asegurar la integridad y el historial de cambios del proyecto.
|
||||
@@ -80,3 +98,18 @@ Para optimizar espacio horizontal en tablas de detalle:
|
||||
- **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`.
|
||||
|
||||
## 9. Evolución Progresiva (Mejora Continua)
|
||||
- **Principio**: El ADN no es estático; evoluciona a partir de los descubrimientos y buenas prácticas (emergentes) surgidas durante la operación diaria.
|
||||
- **Flujo de Vida de una Mejora**:
|
||||
1. **Incubación (Prueba de Concepto)**: Una técnica experimental (ej. notas ocultas HTML para instanciar a la IA, rediseños de interfaces) se prueba bajo fuego en la trinchera (bitácoras diarias, scripts, reportes).
|
||||
2. **Identificación**: Se reconoce el valor sistémico y repetible de la técnica.
|
||||
3. **Formalización**:
|
||||
4. UNIFICACIÓN: Una sola fila por Nodo en Resumen.
|
||||
5. ESTADO ACTIVO: Tareas iniciadas sin finalizar van a 'En Proceso'.
|
||||
6. IDENTIFICADORES: Usar el correlativo exacto del Tema (ej. `[✅ - 09:13 - **dtic-BKPs C4**](#...)`).
|
||||
7. ARMONÍA: Consultar y seguir estrictamente las premisas del ADN (`adn/02_protocolo.md`)., `adn/01_ontologia.md`, etc.).
|
||||
4. **Propagación**: A partir de su formalización, la regla es de cumplimiento obligatorio para el trabajo futuro y, donde sea viable, se refactoriza el material previo para mantener la Consistencia (ver Sección 3).
|
||||
- **Ejemplos Fundacionales**:
|
||||
1. **Estructura Dinámica**: Las *Premisas de Trabajo (IA)* en el footer de las bitácoras nacieron como un experimento y evolucionaron orgánicamente hasta convertirse en un estándar estructural oficial (Sección 4.3).
|
||||
2. **Migración Tecnológica (Bash → Ruby)**: El salto de scripts procedimentales en Bash hacia aplicaciones estructuradas en Ruby (`dtic-BKPs`). La operación real demostró que Bash resultaba frágil e inescalable para secuencias complejas. Ruby fue probado, identificado como superior por su manejo de excepciones y adaptabilidad estructural, formalizado en la reescritura de las herramientas, y propagado como el nuevo estándar de facto para construir utilidades dentro del repositorio.
|
||||
|
||||
Reference in New Issue
Block a user