Suscripciones de telefonia móvil celular

Proyecto Plataformas Web

Aplicación en NodeJS que permita leer los datos de las Suscripciones a telefonía celular móvil, publicadas por el Banco Mundial y publicar las estadísticas de un determinado país en un año específico.

Los archivos del proyecto se han realizado para una mejor manipulación y estructura de la aplicación Modelo, Vista, Controlador

Primeros pasos 🚀

Lo primero en nuestro proyecto es clonar el proyecto de Git en el directorio que deseamos.

Pre-requisitos 📋

Archivo CSV

Un archivo indispensable para la ejecución debemos descargar los datos csv a consultar de la siguiente pagina: https://datos.bancomundial.org/indicador/IT.CEL.SETS

NodeJs

NodeJs es esencial para que puedas ejecutar la aplicación.

Windows

Puedes descargar la ultima version de nodejs desde su página oficial.

Linux

Para distribuciones basadas en debian puedes usar los siguientes comandos :

curl -sL https://deb.nodesource.com/setup_13.x | bash -
apt-get install -y nodejs

Para disctribuciones basadas en arch puedes instalar usando el siguiente comando:

sudo pacman -S nodejs npm

Git

Necesitaras de git en caso de que quieras hacer cambios en la aplicacion y tener el codigo fuente a la mano.

Windows

En la página oficial podras encontrar el archivo de instalación.

Linux

Debian y derivadas: sudo apt install git
Arch y derivadas: sudo pacman -S git

Instalación

NodeJS nos permite ejecutar un proyecto de manera rápida únicamente instalando los paquetes y las dependencias que necesita nuestro proyecto de la siguiente forma.

Usando git

Primer paso

Para poder inicializar y clonar nuestro repositorio nos dirigimos a la pagina del proyecto en git y copiamos la dirrecion del repositorio

Segundo paso Luego de copiar el enlace nos dirigimos a nuestra terminal y colocamos git clone seguido del enlace copiado ej:

git clone https://github.com/WilsonAG/PW-P56-P1.git

Se cargaran los archivos correspondientes para nuestro proyecto.

Tercer paso

Librerías

Al ejecutar el siguiente comando, ayudara a intalar los modulos necesarios para el correcto funcionamiento del programa desarrollado debido a que estos modulos no estan incluidos dentro del repositorio de git por uso inesesario de memoria; A demas este comando nos ayuda a verificar el funcionamiento de las librerias.

npm install

Usando npm

El proyecto tambien esta alojando en npm para una instalacion mucho mas sencilla. Para ello insertaremos en la terminal los siguientes comados:

Como comando global en el sistema:

npm install -g suscripciones-telefonia

Como dependencia para un proyecto:

npm install suscripciones-telefonia

Nota: Para ejecutar la aplicacion como dependencia de un proyecto lo hacemos de la siguiente manera: npx suscripciones-telefonia [comando] [opciones]

Modo de uso

En esta aplicacion se utiliza una invocacion por consola la cual constara de la siguiente estructura ubicandonos en el proyecto:

Si usaste el metodo de git:

node src/app.js [comando] [argumento 1] [argumento 2][argumento 3]

si instalaste por npm:

suscripciones-telefonia [comando] [argumento 1] [argumento 2][argumento 3]

Comandos 🔌

publicar:

Este comando publicará las estadísticas en una página web básica. Se requieren de tres parámetros.

-- file -f: Permite establecer el path del archivo CSV que contiene los datos a analizar.
-- country -c:Permite determinar el país a analizar a través de su código ISO 3166 ALPHA-3.
-- year -y: Permite especificar el año para el cual se requiere las estadísticas. Por defecto, 2018.

⚙️Ejemplo de ejecución:

Enviando año como parámetro


node src\app.js publicar -f "[direccion del archivo csv]" -c "ECU" -y 2015

suscripciones-telefonia publicar -f "[direccion del archivo csv]" -c "ECU" -y 2015

Sin año como parámetro

node src\app.js publicar -f "[direccion del archivo csv]" -c "ECU"

suscripciones-telefonia publicar -f "[direccion del archivo csv]" -c "ECU"

guardar

Este comando almacenará los resultados de las estadísticas en un archivo json. Recibe los mismos parámetros que el comando anterior, y se adiciona la siguiente opción

-- out -o: Establece el nombre del archivo donde se almacenará los resultados.