dtic-DIIAA/adn/02_bitacora.md

# 02 - Hebra: Formato de Bitácora

> Referencia canónica: [`adn/00_indice.md`](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`).
- **Referencia de Ámbito**: Cada nodo tiene un ámbito asociado (ej: `srv-ns8` → `dtic-DIIAA`). En la vista web, los eventos se agrupan por **ámbito** y la columna **Nodo** muestra el origen de cada evento.
- **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](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`
- **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.3 Plantillas de Detalle para Eventos
Para enriquecer los detalles de eventos, usar plantillas predefinidas:

**Herramienta**: `./adn/tools/run generar evento <tipo>`

**Tipos disponibles**:
- `implementacion` - Implementación técnica
- `investigacion` - Investigación/exploración
- `resolucion` - Resolución de incidentes
- `documentacion` - Documentación/corrección
- `reunion` - Reuniones/comunicaciones
- `test` - Pruebas/validación
- `debug` - Depuración
- `planificacion` - Planificación

### 3.1 Ejemplo Estructural

```markdown
### 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.

## 6. Footer de Referencia (IA)

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

```html
<!-- 🤖 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`](05_ia.md). Las bitácoras **nunca** duplican las reglas.