Files
dtic-DIIAA/adn/02_bitacora.md
T

5.1 KiB

02 - Hebra: Formato de Bitácora

Referencia canónica: adn/00_indice.md

Esta hebra define el formato, estructura y reglas de sincronización de las bitácoras diarias del proyecto.

1. Principios Generales

  • Orden Inverso Cronológico: Lo más nuevo SIEMPRE ARRIBA.
  • Archivo Diario: bitacoras/YYYY-MM-DD.md.

2. Control de Gestión

  • 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.
    • Regla: Una sola fila por Nodo.

3. Actividades Detalladas

  • Subdivisión: Encabezados por Nodo (### srv-ns8).
  • Formato Jerárquico:
    1. Título H4 del Tema: #### [Estado] - [ID] - [Nombre Tarea] (ej. #### ✅ - A09 - dtic-BKPs C4).
    2. Párrafo Narrativo: Descripción rica que incluye referencias de migración (ej. ➡️ **[Viene del 23/02]...**) y que explica el "qué" y el "por qué" de la tarea.
    3. Tabla Cronológica: Tabla | Tiempo | Descripción |.
  • Formato de Tiempo y Modo: Las tablas cronológicas deben usar el formato | I | F | Descripción | E |.
  • Columnas:
    • I (Inicio): Hora de comienzo HH:MM.
    • F (Fin): Hora de finalización HH:MM (usar - si está en curso).
    • Descripción: Detalle de la actividad.
    • E (Estado [Modo]): Combinación de Modo ([P] Presencial / [R] Remoto) y Estado Semántico (, , 👁️, ⚠️). Ejemplo: [P] ✅.
  • Estados (Tema): Estrictamente delimitados para trazabilidad ( Cerrado, En Proceso, ⚠️ Fallo).
  • Semántica (General): Uso de una taxonomía visual rica para escaneo visual ultrarrápido (ver hebra 04_iconografia.md).
  • Trazabilidad de Proyectos (Prefijos): Cuando una actividad forme parte de un plan formalizado en docs/proy/, la descripción del evento en la bitácora DEBE comenzar con el código del plan entre corchetes.
    • Formato: [PROY.FASE.ITEM] Descripción de la actividad
    • Ejemplo: [P2601.07.01] Configuración de DNS en dasu-pc-0
  • Auto-Registro (IA): Cualquier acción técnica autónoma de la IA DEBE registrarse explícitamente en las tablas cronológicas indicando "(IA)" y el respectivo emoji semántico.

3.1 Ejemplo Estructural

### sql-dasuten

#### ✅ - DB01.3 - Finalización de Resguardo Integral (Manual)
🛡️ Confirmación de cierre del backup de la VM 101.
➡️ **[Viene del 26/02](2026-02-26.md)**

| I | F | Descripción | E |
| :--- | :--- | :--- | :--- |
| 16:02 | 16:15 | Finalización exitosa del resguardo integral. | [R] ✅ |

3.2 Trazabilidad Transdiaria (Rollover)

Cuando una tarea migra entre bitácoras, se deben inyectar hipervinculos bidireccionales:

  • Origen (día anterior): ➡️ **[Continúa el DD/MM](YYYY-MM-DD.md)**
  • Destino (día siguiente): ➡️ **[Viene del DD/MM](YYYY-MM-DD.md)**

Estos enlaces garantizan que cualquier lector pueda navegar la línea de tiempo completa de una tarea sin importar cuántos días abarque.

4. Métricas Híbridas (Telemetría)

OBLIGATORIO. Cada hito o bloque de sincronización (SINC) debe registrar el esfuerzo:

  • En proceso: Usar formato [Físico/Remoto: Iniciado HH:MM].
  • Finalizado: Usar formato de duración [Físico/Remoto: H:MM hs].

La IA escaneará sintácticamente estas métricas para graficarlas en la aplicación web del dashboard. El campo F - I determina la duración automática.

5. Reglas de Sincronización en Cascada (Triggers)

El mantenimiento de la bitácora es dinámico y reactivo. La actualización de una sección debe disparar (trigger) la actualización de sus dependencias:

  • Trigger 1 (Detalle → En Proceso): Al insertar una nueva viñeta en la cronología de una tarea activa (), se DEBE actualizar la columna DETALLE de esa misma tarea en la tabla En Proceso.
  • Trigger 2 (Cierre → Resumen Integral): Al cambiar el estado de la última tarea activa de un Nodo de a (o ⚠️), se DEBE desencadenar la redacción o actualización de su RESUMEN INTEGRAL.
  • Trigger 3 (Cambio de Día → Rollover): Al crear un nuevo archivo de bitácora:
    1. Migrar las actividades Pendientes y En Proceso hacia las tablas del nuevo día.
    2. En la bitácora del día fenecido, cambiar el Estado Tema de las tareas migradas a ➡️ (Migrado).
    3. Inyectar hipervínculos bidireccionales de trazabilidad transdiaria.

Al final de cada bitácora, incluir una referencia mínima a la fuente de verdad de las Directivas IA:

<!-- 🤖 PREMISAS DE TRABAJO (IA): Fuente de Verdad → adn/05_ia.md -->

Evolución: Las premisas de trabajo evolucionan exclusivamente en la hebra 05_ia.md. Las bitácoras nunca duplican las reglas.