Descripción General del Sistema de Quick Reports

El sistema de Quick Reports representa una solución moderna y eficiente para la generación de reportes, integrando tecnologías frontend con Angular y backend con Node.js, además de servicios cloud de AWS. Esta arquitectura permite un procesamiento robusto y escalable de datos, ideal para aplicaciones empresariales que requieren generación de reportes dinámicos.

Fase Inicial del Proceso

El proceso de generación de reportes comienza con una fase de preparación crucial. Durante esta etapa, el sistema inicializa los componentes necesarios y establece las conexiones con los diversos servicios. Esta preparación inicial es fundamental para garantizar un flujo de datos fluido y sin interrupciones durante todo el proceso de generación del reporte.

Configuración de Filtros en la Interfaz

La experiencia del usuario comienza en la interfaz de Angular, donde se presenta una pantalla intuitiva para la selección de filtros. Esta interfaz permite a los usuarios personalizar sus reportes según sus necesidades específicas. Los filtros pueden incluir rangos de fechas, categorías, departamentos o cualquier otro parámetro relevante para el negocio.

Iniciación de la Generación del Reporte

Una vez configurados los filtros, el usuario activa el proceso mediante el botón de generación. En este punto, el frontend de Angular construye una solicitud estructurada que encapsula todos los parámetros seleccionados. Esta solicitud se transmite al servidor Node.js a través de una API REST, iniciando así la fase de procesamiento backend.

Procesamiento en Node.js

El servidor Node.js actúa como un intermediario inteligente en el proceso. Al recibir la solicitud, el servidor construye dinámicamente las consultas SQL necesarias basándose en los filtros recibidos. La integración con el cliente de AWS Athena se realiza mediante SDK oficiales, asegurando una comunicación segura y eficiente con los servicios de AWS.

Ejecución en AWS Athena

Athena, como servicio de consultas serverless de AWS, procesa la consulta SQL contra los datos almacenados. Este proceso es altamente eficiente ya que Athena puede manejar grandes volúmenes de datos sin necesidad de infraestructura dedicada. El resultado se almacena automáticamente en un bucket de S3 en formato CSV, facilitando su posterior acceso y distribución.

Gestión de la Respuesta

Tras completar el procesamiento, Athena genera un objeto de respuesta detallado. Este objeto contiene metadatos importantes como la ubicación del archivo en S3, estadísticas de la consulta y cualquier información relevante sobre el proceso de generación. Esta información es crucial para el seguimiento y la gestión del reporte.

Registro y Persistencia

Como paso final en el backend, Node.js realiza el registro persistente de la operación. Se almacena información crítica como el ID del archivo en S3, timestamps, usuario solicitante y parámetros utilizados. Este registro es esencial para el seguimiento, auditoría y posible recuperación futura del reporte.

Conclusión del Proceso

El ciclo se completa con la confirmación del registro en la base de datos. En este punto, el sistema ha generado exitosamente el reporte, lo ha almacenado de forma segura en S3, y ha mantenido un registro completo de la operación. El usuario puede ahora acceder al reporte generado, ya sea para visualización inmediata o para descarga posterior.

Diagrama de Flujo: Módulo de Reportes en Angular con AWS