Plan: Refactorización UI Bitácoras - Armonía Integral

Grupo de Trabajo: dtic-BITACORAS

Código: P2603.01 Fecha: 30 de marzo de 2026 Autor: Sistema ADN Versión: 1.0 Estado: ✅ COMPLETADO

📋 Resumen Ejecutivo

Alinear el comportamiento del Frontend de Bitácoras Web con el principio de Armonía Integral del ecosistema ADN. El objetivo consiste en garantizar que la interfaz gráfica represente con absoluta fidelidad la topología relacional de la base de datos, desvinculando la agrupación visual de eventos de la pertenencia física de su nodo, orientándola en su lugar a nivel de cada entrada y su respectivo ámbito operativo (ambito_id).

Motivación

Previo a esta actualización, la interfaz de usuario en la vista de "Día Completo" (/bitacoras/:fecha/completa) agrupaba inherentemente las entradas bajo el ambito_nombre asociado al Nodo que las emitía (ej: dtic-DIIAA para el nodo 37 srv-ns8). Esto causaba distorsiones visuales severas: eventos declarados explícitamente para dtic-DASUTEN o dtic-ADN aparecían bajo la pestaña lila de dtic-DIIAA simplemente porque fueron ejecutados desde un servidor de infraestructura. El principio de Armonía Integral requiere que la representación sea fiel al dominio lógico de la tarea y no a la contingencia física del hardware subyacente.

Decisiones Clave

Desacoplamiento Topológico: Modificar App.tsx para que itere sobre nodoGroup.entradas y extraiga el ámbito propio de cada evento, anulando la agrupación genérica por nodo.
Sincronización Transversal: Actualizar masivamente las entradas huérfanas o desactualizadas en PostgreSQL para vincularlas a sus ámbitos verdaderos en la tabla bitacoras.ambitos.
Registro del Ámbito Autónomo dtic-ADN: Incorporar oficialmente el ecosistema interno ADN como un ámbito de primer nivel en la base de datos para cobijar sus propios eventos de scripting (P2604).

🌐 Arquitectura de Sincronización

Base de Datos (PostgreSQL)
   │
   ├── bitacoras.ambitos (1:DIIAA, 2:DASUTEN, 7:ADN)
   │
   └── bitacoras.entradas (FK ambito_id -> ambitos.id)
          │
      API (Node.js/Express)
          │
      Frontend (React/Vite)
          └── App.tsx (Itera e.ambito_nombre -> Agrupa -> Renderiza Card)

🎯 Objetivo

Implementar, desplegar y validar la reestructuración del backend y frontend para que los Eventos se muestren categorizados bajo el Scope exacto (Ámbito) para el que fueron planificados, independientemente del nodo físico desde el cual se registró la actividad.

📅 Fases de Implementación

✅ FASE 1: Sincronización Estructural (Base de Datos)

1.1: Auditar inconsistencias entre doc_path (ej. ambito/dtic-DASUTEN/P...) y el campo relacional ambito_id.
1.2: Crear oficialmente el registro para el ámbito matricial dtic-ADN en la tabla bitacoras.ambitos (Obtuvo ID: 7).
1.3: Ejecutar parche SQL de actualización masiva:
- 17 entradas actualizadas a ambito_id = 2 (dtic-DASUTEN).
- 2 entradas actualizadas a ambito_id = 7 (dtic-ADN).
1.4: Verificar consistencia de la respuesta JSON en el endpoint de la API (/api/entradas/1341 confirmando "ambito_id":2).

✅ FASE 2: Refactorización Lógica (Frontend)

2.1: Analizar el método de agrupación en frontend/src/App.tsx.
2.2: Detectar el fallo de diseño (se utilizaba nodoGroup.ambito_nombre ignorando e.ambito_nombre).
2.3: Reescribir el algoritmo de porAmbito para que genere subgrupos (Cards/Badges) iterando a nivel de entrada individualmente.
2.4: Resolver conflictos de tipado de TypeScript definiendo propiedades opcionales (ambito_nombre, nodo_nombre) en la interfaz Entrada. (A ser completado en refactor de tipos global si persiste).
2.5: Aprovechar HMR (Hot Module Replacement) de Vite para aplicar el cambio en vivo.

✅ FASE 3: Validación End-to-End

3.1: Consultar la URL local (http://localhost:5174/bitacoras/) para verificar que el evento 1341 (Instalación DASU-PCV2) aparece correctamente bajo la pestaña de dtic-DASUTEN.
3.2: Confirmar que otros eventos del core de scripts aparecen bajo dtic-ADN.
3.3: Documentar la culminación de la reforma en el Master Plan P2603_bitacoras.md bajo el Hito UI02.

📊 Impacto Operativo

Aspecto	Antes (Agrupación por Nodo)	Después (Armonía Integral)
Fidelidad Estructural	❌ Engañosa	✅ Exacta
Monitoreo de Nodos	La cabecera era el nodo dominante	El nodo es un metadato tabular por cada fila
Identificación Visual	Los proyectos de DASUTEN se ocultaban en DIIAA	Cada ámbito destaca independientemente

🔗 Referencias

Proyecto padre: P2603_bitacoras.md
Principio Rector: IA.md (Sección 3: Armonía Integral)
Ontología: 01_ontologia.md

5.0 KiB Raw Permalink Blame History