Documentación de la Aplicación Visor-Smartdata

• Introducción
• Objetivo de la Aplicación
• Características Principales
  • Funcionalidades
  • Tipos de Datos
  • Visualizaciones
• Detalles Técnicos
  • Paquetes de R Utilizados
  • Requerimientos del Servidor
  • Estructura de Archivos
• Forma de Uso
  • Inicio de la Aplicación
  • Roles de Usuario
  • Navegación y Secciones
• Seguridad
• Despliegue
  • Alojamiento
  • Pasos para el Despliegue
• Mantenimiento y Actualizaciones
  • Gestión de Actualizaciones
  • Contacto para Mantenimiento

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:

• Visualización de Contenido: Permite ver el contenido extraído y analizado de varios medios de comunicación y redes sociales.
• Interactividad: Los usuarios pueden interactuar con gráficos, tablas y mapas para explorar los datos de manera dinámica y personalizada.
• Análisis Específico y General: Los datos pueden ser visualizados tanto de manera global como segmentada por categorías, comunas y tendencias.

Tipos de Datos

Los datos manejados por la aplicación incluyen:

• Información extraída de medios de comunicación escritos: La Tercera, El Dínamo, El Mostrador, BioBioChile, CNN Chile, The Clinic, ADN Radio, Publimetro.

• Datos de redes sociales, específicamente de Instagram y Facebook, que han sido previamente descargados y analizados.

Visualizaciones

Las visualizaciones proporcionadas por la aplicación son:

• Gráficos de Barra: Para representar distribuciones y comparaciones de datos.
• Mapas: Para visualizar información geoespacial.
• Tablas: Para mostrar datos detallados de manera estructurada.

Detalles Técnicos

Paquetes de R Utilizados

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

• shiny: Para la creación de aplicaciones web interactivas.
• bslib: Para temas y estilos.
• tidytext: Para el procesamiento de texto.
• DBI: Para la interacción con bases de datos.
• highcharter: Para gráficos interactivos.
• shinyWidgets: Para componentes interactivos adicionales.
• DT: Para tablas de datos interactivas.
• dbplyr: Para la manipulación de bases de datos con dplyr.

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:

• Raíz del Proyecto: Contiene los archivos global.R, ui.R y server.R.
• Carpeta www/: Almacena archivos CSS y JavaScript.
• Carpeta R/: Almacena funciones helper y otros scripts desarrollados por el equipo. Estas funciones descargan datos, construyen $n$-gramas y generan reportes.
• Carpeta R/tabular/: Contiene scripts para la descarga y análisis de información de redes sociales. Repositorio del equipo Tabular.
• Carpeta data/: Almacena distintos archivos requeridos para el funcionamiento de la aplicación: palabras-clave.xlsx, comunas_0001.gpkg, users.xlsx.

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:

• Administrador: Tiene la capacidad de crear nuevos usuarios y gestionar los existentes.
• Usuario Normal: Puede acceder y utilizar las funcionalidades de la aplicación sin permisos administrativos. Para más detalle sobre opciones, inputs y secciones revisar manual de usuario de la aplicación.

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.