ANEXO D Manual de Técnico MANUAL TECNICO PROMO APP PROMO PLATFORM PROMO API PROYECTO FINAL

Transcripción

1 ANEXO D Manual de Técnico MANUAL TECNICO PROMO APP PROMO PLATFORM PROMO API PROYECTO FINAL PROTOTIPO DE SOFTWARE DE UN SISTEMA RECOMENDADOR DE PRODUCTOS Y SERVICIOS EN PROMOCIÓN SOBRE UNA ARQUITECTURA WEB ORIENTADA A SERVICIOS CAMILA ALEJANDRA CARDONA OTÁLORA CÓD SAÚL LEONARDO CELIS VALBUENA CÓD UNIVERSIDAD DISTRITAL FRANCISCO JOSE DE CALDAS FACULTAD DE INGENIERIA INGENIERIA DE SISTEMAS BOGOTÁ, COLOMBIA 2015

2

3 CONTENIDO 1. INTRODUCCIÓN OBJETIVO DE ESTE MANUAL REQUISITOS TECNICOS PROMO APP PROMO PLATFORM PROMO API TECNOLOGIAS IMPLEMENTADAS PROMO APP PROMO PLATFORM PROMO API INSTALACIÓN PROMO APP Instalación de IONIC Instalación de ANDROID SDK Configuración de PROMO APP Despliegue de PROMO APP PROMO PLATFORM Instalación de XAMMP Configuración de PROMO PLATFORM PROMO API Instalación de RUBY ON RAILS Despliegue de PROMO API... 13

4 MANUAL TECNICO PROMO APP PROMO PLATFORM PROMO API PROYECTO FINAL PROTOTIPO DE SOFTWARE DE UN SISTEMA RECOMENDADOR DE PRODUCTOS Y SERVICIOS EN PROMOCIÓN SOBRE UNA ARQUITECTURA WEB ORIENTADA A SERVICIOS 1. INTRODUCCIÓN En este documento encontrará información técnica detallada desde tecnologías aplicadas hasta la instalación de PROMO APP, PROMO PLATFORM Y PROMO API. Se llevara paso a paso el proceso de instalación y todos los detalles técnicos de la implementación de cada sistema para su funcionamiento en conjunto. 2. OBJETIVO DE ESTE MANUAL El objetivo primordial de este manual es orientar en los conocimientos técnicos relacionados con las tecnologías implementadas en el prototipo, también detallar los pasos a seguir para la puesta en funcionamiento del prototipo de software y sus componentes. 3. REQUISITOS TECNICOS 3.1. PROMO APP Para la compilación del código fuente de PROMO APP se necesita un equipo con las siguientes características: Intel core I5 4 GB RAM Sistema operativo Windows 7 4

5 Android sdk API 20 Ionic Framework 3.2. PROMO PLATFORM Para la ejecución de PROMO PLATFORM se necesita un equipo de las siguientes características: Intel core I5 4 GB RAM Sistema operativo Windows Servidor apache 3.2. PROMO API Para la ejecución de PROMO API se necesita un equipo de las siguientes características: Intel core I5 4 GB RAM Sistema operativo Linux Ubuntu Servidor Puma Ruby Ruby on Rails Mysql 4. TECNOLOGIAS IMPLEMENTADAS 4.1 PROMO APP PROMO APP utiliza IONIC un framework basado en ANGULARJS que permite crear aplicaciones móviles utilizando HTML y JAVASCRIPT que puedan compilarse en diferentes plataformas. 5

6 En este caso la aplicación se compiló en ANDROID, Utilizando el ANDROID SDK API 20. Con los beneficios de ANGULAR JS los servicios que se consumen de PROMO API son fáciles de implementar y su arquitectura MVC permite una buena modularidad. 4.2 PROMO PLATFORM PROMO PLATFORM se construyó utilizando el framework ANGULAR JS. PROMO PLATFORM utiliza librerías como SWEET ALERT, NGROUTE, ANGULARSPINNER Y CHARTJS. 4.3 PROMO API PROMO API está desarrollada bajo RUBYONRAILS usando la gema RAILSAPI y el servidor de aplicaciones PUMA basado en hilos de ejecución para mayor rendimiento. 5. INSTALACIÓN 5.1 PROMO APP Instalación de IONIC En primer lugar para instalar IONIC se debe instalar NODEJS este se puede encontrar en la página: para sistema operativo Windows. El instalador que debe encontrar se muestra en la Figura 1 6

7 Figura 1 Instalador Node JS Fuente: Autores Luego de la instalación de NODE JS se procede a abrir una consola de Windows para instalar IONIC utilizando NPM(Instalador de NODE JS). Se debe escribir el comando npm install -g ionic como se muestra en la Figura 2. Figura 2 Instalar IONIC por línea de comandos Fuente: Autores 7

8 5.1.2 Instalación de ANDROID SDK Para la instalación de ANDROID SDK descargue el instalador desde esta pagina web: después de descargar el zip se descomprime. Cuando se tenga la carpeta se debe añadir al PATH de Windows tal y como muestra la Figura 3. Figura 3 Añadir ANDROID SDK al PATH Fuente: autores Luego se debe descargar ANDROID SDK API 20. Desde la carpeta que se descargó se abre el SDK manager y se descarga el ANDROID SDK API 20 ver Figura 4. 8

9 Figura 4 Instalar ANDROID SDK API 20 Fuente: Autores Configuración de PROMO APP En el código fuente en la siguiente ruta: \promo-app\www\js abra el archivo cuyo nombre es app.js y modifique las direcciones IP donde debe consultar a PROMO API es decir las respectivas direcciones o DNS de su dominio Despliegue de PROMO APP Para el despliegue de PROMO APP conecte su dispositivo ANDROID diríjase a la carpeta donde está el código fuente de la aplicación y escriba ionic run android ver Figura 5. 9

10 Figura 5 Despliegue de PROMO APP Fuente: Autores Luego de seguir estos pasos la aplicación PROMO APP debe estar funcionando en su dispositivo. 5.2 PROMO PLATFORM Instalación de XAMMP XAMMP es un servidor portable de Apache que también se puede instalar como servicio en este caso lo instalaremos en el sistema operativo Windows bajando el instalador de la siguiente url: y luego ejecutamos el instalador que muestra la Figura 6. 10

11 Figura 6 Instalador de XAMPP Fuente: Autores Luego copie todo el proyecto a la carpeta htdocs que genera xampp y ejecútelo desde su explorador activando el servicio como se muestra en la Figura 7. 11

12 Figura 7 Activar el servicio de Apache de XAMPP Fuente: Autores Después de seguir estos pasos ya puede utilizar PROMO PLATFORM Configuración de PROMO PLATFORM En el código fuente en la siguiente ruta: \promo-platform\app\scripts abra el archivo cuyo nombre es app.js y modifique las direcciones IP donde debe consultar a PROMO API es decir las respectivas direcciones o DNS de su dominio. 12

13 5.3 PROMO API Instalación de RUBY ON RAILS Para instalar RUBY ON RAILS escriba los siguientes comando en su terminal de Linux: sudo apt-get update sudo apt-get install curl \curl -L bash -s stable source ~/.rvm/scripts/rvm rvm requirements rvm install ruby rvm use ruby default rvm rubygems current gem install rails A este punto ya debe tener instalado RUBY ON RAILS Despliegue de PROMO API Para desplegar PROMO API copie la carpeta del proyecto en su lugar preferido luego ejecute los comandos. sudo apt-get install mysql rake db:create rake db:migrate rake:db:seed bundle install rails serve Después de esto PROMO API estará ejecutándose en su máquina sobre el puerto 3000 para ser utilizada. El sistema viene con 195 productos por defecto además de 64 categorías e información para la recomendación que se obtuvo del estudio producto de la monografía. 13