SmartDataUC / visor-smartdata

Apache License 2.0
0 stars 2 forks source link

Documentación de la Aplicación Visor-Smartdata

Introducción

Visor-Smartdata es una aplicación desarrollada en Shiny, diseñada para ofrecer una visualización interactiva y detallada de la información extraída de medios de comunicación escritos en internet y redes sociales. Su principal objetivo es proporcionar un panorama noticioso actualizado de la realidad de Chile y el Gobierno de Santiago (GS).

Objetivo de la Aplicación

El propósito principal de Visor-Smartdata es permitir a los usuarios visualizar y analizar datos provenientes de distintos medios de comunicación y redes sociales, brindando un entendimiento profundo tanto del comportamiento general como específico de la información. Esta herramienta está destinada a facilitar el seguimiento de la actualidad noticiosa y las tendencias informativas que afectan al país y a su gobierno.

Características Principales

Funcionalidades

La aplicación cuenta con varias funcionalidades diseñadas para ofrecer una experiencia de usuario completa:

Tipos de Datos

Los datos manejados por la aplicación incluyen:

Visualizaciones

Las visualizaciones proporcionadas por la aplicación son:

Detalles Técnicos

Paquetes de R Utilizados

La aplicación utiliza un conjunto de paquetes de R, entre las cuales se incluyen:

La lista completa está descrita en la siguiente tabla:

Paquete Versión Fecha (UTC) Documentación Oficial
bsicons 0.1.2 2023-11-04 bsicons
bslib 0.6.1 2023-11-28 bslib
DBI 1.2.3 2024-06-02 DBI
dbplyr 2.4.0 2023-10-26 dbplyr
dplyr 1.1.4 2023-11-17 dplyr
DT 0.33 2024-04-04 DT
forcats 1.0.0 2023-01-29 forcats
ggplot2 3.5.1 2024-04-23 ggplot2
highcharter 0.9.4 2022-01-03 highcharter
jsonlite 1.8.8 2023-12-04 jsonlite
leaflet 2.2.2 2024-03-26 leaflet
lubridate 1.9.3 2023-09-27 lubridate
markdown 1.13 2024-06-04 markdown
ngram 3.2.3 2023-12-10 ngram
pool 1.0.3 2024-02-14 pool
purrr 1.0.2 2023-08-10 purrr
quanteda 4.0.2 2024-04-24 quanteda
quanteda.textplots 0.94.4 2024-01-25 quanteda.textplots
quanteda.textstats 0.97 2024-04-08 quanteda.textstats
readr 2.1.5 2024-01-10 readr
readxl 1.4.3 2023-07-06 readxl
RPostgres 1.4.7 2024-05-27 RPostgres
scales 1.3.0 2023-11-28 scales
sf 1.0-16 2024-03-24 sf
shiny 1.8.0 2023-11-17 shiny
shinycssloaders 1.0.0 2020-07-28 shinycssloaders
shinyjs 2.1.0 2021-12-23 shinyjs
shinyWidgets 0.8.2 2024-03-01 shinyWidgets
snakecase 0.11.1 2023-08-27 snakecase
stringr 1.5.1 2023-11-14 stringr
tibble 3.2.1 2023-03-20 tibble
tidyr 1.3.1 2024-01-24 tidyr
tidytext 0.4.2 2024-04-10 tidytext
tidyverse 2.0.0 2023-02-22 tidyverse

Requerimientos del Servidor

La aplicación necesita un servidor capaz de instalar shiny-server y que tenga acceso a internet para conectarse a la base de datos PostgreSQL alojada en smartdata.cwt3zjjzj7as.sa-east-1.rds.amazonaws.com.

Estructura de Archivos

La estructura de archivos de la aplicación sigue un formato estándar:

Forma de Uso

Inicio de la Aplicación

Para iniciar la aplicación, los usuarios deben acceder a la URL específica del servidor, por ejemplo, http://18.230.138.21:3838/visor-smartdata/. Una vez ingresado, se presentará un formulario de inicio de sesión donde se deben ingresar el usuario y la contraseña.

Roles de Usuario

La aplicación distingue entre dos roles de usuario:

Navegación y Secciones

Después de iniciar sesión, la aplicación presenta un menú principal en el lado izquierdo con opciones para seleccionar fecha, categoría y comunas. La aplicación se divide en tres secciones principales:

  1. Resumen: Proporciona información del día actual.
  2. Medios: Incluye análisis de información de medios de comunicación, con subsecciones para categorías, comunas y tendencias.
  3. Redes Sociales: Muestra datos y análisis específicos de redes sociales.

Seguridad

La seguridad en Visor-Smartdata está garantizada mediante el uso de shinymanager, que proporciona autenticación y administración de usuarios para proteger el acceso a la aplicación.

Despliegue

Alojamiento

Actualmente, la aplicación está alojada en un servidor AWS, pero puede desplegarse en cualquier servidor que cumpla con los requisitos necesarios.

Pasos para el Despliegue

  1. Instalar shiny-server en el servidor.
  2. Instalar R (versión >= 4.1) desde CRAN.
  3. Instalar las librerías requeridas para la aplicación.
  4. Asegurar acceso a internet para la conexión con la base de datos.
  5. Clonar el repositorio que contiene el código de la aplicación.
  6. Generar en la raíz del proyecto un archivo .Renviron que contenga tanto el HOST como PASS de acceso a la base de datos como se describe a continuación:
HOST="ip.del.host"
PASS="clavedebbdd"

Mantenimiento y Actualizaciones

Gestión de Actualizaciones

Actualmente, no hay un plan definido para las actualizaciones de la aplicación. Cualquier cambio o mejora se gestiona según sea necesario.

Contacto para Mantenimiento

El equipo de mantenimiento puede ser contactado a través de Iván Olivares, DATAUC.