Módulo: Analytics — Reportes ETL¶

Ubicación: src/app/views/analytics
Acceso: sesión autenticada; Telemetría tiene guardia adicional por rol.

¿Qué hace?¶

Analytics reúne el ciclo completo de los reportes HTML/BI de LogiGho: el área de datos los publica y versiona; el resto de la organización los encuentra y consume; y los responsables autorizados pueden entender su uso mediante telemetría.

Recorrido sencillo¶

flowchart LR
    A[Área de datos publica HTML] --> B[Gestión y versionado]
    B --> C[Catálogo de reportes]
    C --> D[Visor protegido]
    D --> E[Sesión de telemetría]
    E --> F[Dashboard y auditoría]
    G[Áreas organizacionales] --> B
    G --> E

1. Un administrador sube un reporte HTML y define sus datos, estado y roles autorizados.
2. El reporte aparece como tarjeta a los usuarios con acceso en la interfaz.
3. El visor lo carga dentro de un contenedor seguro, permite cambiar versiones y descargar el HTML original.
4. El uso visible del visor alimenta métricas y auditoría.
5. Las áreas organizacionales agrupan roles configurables y evitan categorías escritas en código.

Estructura de carpetas¶

views/analytics/
├── routes.ts
├── guards/telemetria.guard.ts
├── models/
├── components/
│   ├── reporte-sandbox/
│   └── modal-area-organizacional/
├── gestion-reportes/
├── lista-reportes/
├── vista-reporte/
├── telemetria-reportes/
└── services/
    ├── reportes-analytics/
    ├── reporte-sanitizer/
    ├── areas-organizacionales/
    ├── telemetria-tracker/
    └── telemetria-consulta/

La regla es simple: un elemento se mantiene cerca de la vista que lo usa; cuando una segunda vista lo necesita, se convierte en componente, modelo o servicio compartido de analytics.

Áreas y roles¶

Las categorías de reportes y áreas de consumo ya no son una lista fija. La colección AreasOrganizacionales administra nombre, estado, descripción y roles. Gestión de Reportes, Lista de Reportes y Telemetría usan esta fuente común.

Consulta la guía completa en Áreas organizacionales.

Seguridad del visor¶

Un reporte HTML puede contener JavaScript, por lo que nunca se inserta directamente en el DOM de LogiGho. El visor aplica varias barreras complementarias:

La combinación allow-scripts + allow-same-origin no se utiliza nunca: anularía el aislamiento del sandbox.

Datos y almacenamiento¶

Las versiones son inmutables: publicar un archivo agrega una versión; editar nombre, área, estado o roles no crea una versión ni reemplaza el archivo en S3.

Límites conocidos y siguiente paso¶

• La interfaz controla visibilidad y acciones por rol, pero la autorización definitiva debe reforzarse también en backend/API Gateway antes de abrir los endpoints a consumidores no confiables.
• La vista directa del reporte debe reforzar en backend la verificación de RolesPermitidos, además del filtro de catálogo; no se debe confiar únicamente en la UI para proteger datos.
• El histórico de telemetría se puede consultar con Todo, pero para operación diaria se recomiendan períodos acotados y los índices de Telemetría.

Historial de cambios¶