Con este proyecto se pretende ofrecer sugerencias al usuario según sus preferencias y el contexto en el que se encuentre.
El problema que va a tratar de solucionarse con esta aplicación es un problema que nos encontramos en el día a día. A veces, salimos a la calle y no sabemos qué plan hacer o a qué lugar ir a tomar algo. Otras veces, simplemente, no sabemos todas las opciones de actividades disponibles que existen por una determinada zona de la ciudad. Con esta aplicación se podrá conocer la zona a la que el usuario quiere ir, el tipo de plan que quiere hacer (comida/cena en bares/restaurantes, meriendas, actividades culturales, ocio, turismo...), el presupuesto del que dispone... Todas estas preferencias se procesarán y se ofrecerá la opción que mejor se adecúe al usuario.
Cómo abordar el problema
Inicialmente, se abordará el problema centrándose en el problema de la mochila. Se establecerá un precio (que corresponderá con el presupuesto del usuario) y un tipo de actividad, la aplicación devolverá un determinado número de actividades que puedan realizarse con esos requisitos. Por ejemplo, si se tiene un presupuesto de 5 euros y como tipo de actividad se elige 'Tapas', la aplicación elegirá, entre varios bares, los que mejor que ajusten al presupuesto y sirvan tapas.
Para llevar a cabo la planificación de este proyecto, se ha organizado en Historias de Usuario:paperclips: (Issues) y Milestones:paperclips:. El proceso que se ha seguido para crear las Historias de Usuario se basa en la metodología de personas. Esta metodología se apoya en un conjunto de biografías ficticias que describen a las personas que utilizarán la aplicación. Puede encontrar estas biografías en la wiki del repo:paperclips:.
Encontrará más información sobre la metodología de personas, user journeys y tipos de clientes de la aplicación en la Documentación 🖇️.
Se dispone de la siguiente orden para comprobar la sintaxis:
npm run check
Para la compilación,está disponible el siguiente comando:
npm run build
Para ejecutar los tests implementados hasta el momento:
npm run test
En cuanto a la justificación de las decisiones que se han tomado sobre el lenguaje y el gestor de dependencias y de tareas elegidos, puede encontrar más información en la documentación adicional 🖇️
Para lanzar los tests que se han implementado, se ha integrado esta tarea en el gestor de tareas que se está utilizando en el proyecto, npm. Para ello, simplemente he establecido lo siguiente en el fichero package.json:
"scripts": {
"check": "tsc --noEmit",
"build": "tsc",
"test": "jest"
},
De esta forma, se lanzarán los tests utilizando el test runner jest con el comando:
npm run test
Si quiere lanzar los tests disponibles por separado, puede hacerlo con los siguientes comandos:
npm run test -t Handler
npm run test -t User
npm run test -t Activity
Encontrará más información sobre la justificación de las herramientas elegidas, cómo se han creado los tests y su justificación en la sección Objetivo 4 -Tests de la documentación adicional 🖇️
Para construir el contenedor de pruebas, tiene disponible el comando:
npm run docker:build
Para lanzarlo y que se ejecuten los tests:
npm run docker:run
Encontrará más información sobre la justificación de la imagen elegida en la sección Objetivo 5 - Creación de un contenedor para pruebas de la documentación adicional 🖇️
Puede encontrar más información sobre los sistemas de integración continua elegidos y las versiones que se han comprobado en la sección Objetivo 6 - Integración continua de la documentación adicional 🖇️
- La información adicional relativa al desarrollo de cada objetivo se encuentra en el siguiente enlace: Documentación 🖇️