Encuentra la mejor máquina expendedora cuando más la necesitas.

---

Encuentra nuestra web aquí.

https://jcerveto.github.io/taes/

Proyecto creado durante el curso 2023-2024 en la asignatura de TAES (TÉCNICAS AVANZADAS DE ESPECIFICACIÓN SOFTWARE) de la Escola Politècnica Superior en la Universitat d'Alacant.

🚩 Tabla de contenidos

• ¿Por qué usar maquinua?
• Levantar el proyecto en local
• Tecnologías utilizadas
• Maquinua Team
• Reportar un problema
• Contributing
• License

🤖 ¿Por qué maquinua?

maquinua es una aplicación web que te permite encontrar la máquina expendedora más cercana a tu ubicación en la Universitat d'Alacant. Puedes filtrar por tu facultad, nombre del producto y muchos más. Encontrás la ubicación de la máquina en un mapa.

🔎 Tipos de filtros.

• Facultad: Filtra por la facultad en la que te encuentras.
• Tipo de máquina: Filtra por el tipo de máquina que buscas.
• Nombre del producto: Filtra por el nombre del producto que buscas.
• Precio del producto: Filtra por el precio del producto que buscas.
• Empresa: Filtra por la empresa que gestiona la máquina.

🚀 Levantar el proyecto en local

Descarga el proyecto en tu máquina local siguiendo los siguientes pasos:

git clone https://github.com/jcerveto/maquinua.git
cd maquinua

Levanta la página web en tu máquina local siguiendo los siguientes pasos:

Ves a la carpeta frontend/maquinua.

cd frontend/maquinua

Descarga las dependencias del proyecto.

npm install

Compiles and hot-reloads for development

npm run serve

Lints and fixes files

npm run lint

Deploy the project

Este proyecto tiene automatizado el despliegue en GitHub Pages. Usa un workflow de GitHub Actions para ello.

Sin embargo, si quieres desplegarlo manualmente, sigue los siguientes pasos:

1. Build the project

npm run build

2. Test the project in local

npm install -g serve
# -s flag means serve it in Single-Page Application mode
# which deals with the routing problem below
serve -s dist

3. Deploy the frontend to GitHub Pages

npm run predeploy
npm run deploy

Customize configuration See Configuration Reference.

---

Levanta la base de datos en tu máquina local siguiendo los siguientes pasos:

Ves a la carpeta backend.

cd backend

Ejecuta el docker-compose para levantar la base de datos y el servidor HTTP.

docker-compose up -d

Con más detalles:

Levantar todo: BBDD (MongoDB) + Backend HTTP (NodeJs Express)

docker-compose up

Se pueden levantar por separado los contenedores. Pero habría que configurar también la network.

Levantar base de datos

docker-compose run <container-name>

Una vez el contenedor ya esté corriendo, podemos entrar dentro con el siguiente comando:

docker exec -it backend-maquinua-container sh

Desde aquí podemos ejecutar test como node src/services/db.test.js de manera interactiva.

¡OJO en Windows! Si estás en Windows y no te funciona, aasegúrate de estar ejecutando Docker desktop, no solamente los comandos por terminal.

🛠 Tecnologías utilizadas

En este proyecto se han utilizado las siguientes tecnologías:

Node.js

Vue.js

Express.js

Git

Docker

MongoDB

OpenStreetMap

📚 Maquinua Team

Profesorado

• Javier Fernández Martínez
• Pla Sempere, Leopoldo

Alumnado

• Joan Cerveto Serrano
• Adrián Romero Romero
• etc

🚨 Reportar un problema

• Crea un Issue en este repositorio.
• Explica claramente el problema y proporciona información sobre cómo reproducirlo.

💬 Contributing

Colabora con nosotros para mejorar maquinua.

Ves a Contributing.md para más información.

📜 License

This software is licensed under the APACHE VERSION 2.0.