Autores: Laura González Falque (@laurafalque14), Mariana de la Caridad Villar Rojas (@marianavillar), Maryny Zara Castada Collado (@marynyzcc), Mateo González de Miguel (@matgon) y Richard Junior Mercado Correa (@potchi23)
- Python3
- Si falta alguna librería (el IDE y el terminal os lo dirá), podéis instalarlo desde el terminal con
pip install <libreria>
. Otra opción es entrar en la carpetaTFG/src/backend
y ejecutarpip install -r requirements.txt
para instalar todas las dependencias del backend.
- Si falta alguna librería (el IDE y el terminal os lo dirá), podéis instalarlo desde el terminal con
- XAMPP
Se necesitan principalmente:- Apache
- MySQL y phpMyAdmin
En src
se encuentra el código del proyecto. Tenemos tres carpetas:
backend
: Contiene toda la lógica de la aplicación. Dentro se encuentra la API hecha con Flask. Tambien se encuentra el ficherorequirements.txt
con las dependencias necesarias para nuestro servidor.frontend
: Contiene la GUI de la aplicación. Dentro se incluyen los ficheros HTML, CSS, PHP y Javascript.sql
: Contiene un fichero con la base de datos. Se puede importar directamente en phpMyAdmin.
Importante: El servidor de Flask solo funciona si MySQL está en ejecución. Arrancar primero MySQL antes de iniciar Flask.
Para lanzar la aplicación, tanto el backend como el frontend deben de estar ejecutándose en algún tipo de servidor. Se presupone que todos los requisitos mencionados en Requisitos se cumplen.
- Entrar dentro de la carpeta
TFG/src/backend
- Iniciar una terminal en la carpeta
TFG/src/backend
- Ejecutar el comando
pip install -r requirements.txt
para instalar las dependencias del servidor - Ejecutar el comando
python tfg_server.py
en Windows o Mac opython3 tfg_server.py
en Linux - En el navegador, entrar en
localhost:5000
y comprobar que devuelve{ "message" : "Server is running" }
- Abrir XAMPP
Nota: Si ya teneis configurado XAMPP, saltar directamente al Paso 6 - Parar todos los servicios en ejecución
- En la columna Actions, entrar Config > Apache(httpd.conf)
- Buscar dentro del fichero la línea
DocumentRoot "C:\xampp\htdocs"
y sustituirla porDocumentRoot "C:\<ruta_TFG>\TFG\src\frontend"
Ejemplo:DocumentRoot "C:\Users\<nombre>\Documents\GitHub\TFG\src\frontend"
- Buscar dentro del fichero la línea
<Directory "C:\xampp\htdocs">
y sustituirla por<Directory "C:\<ruta_TFG>\TFG\src\frontend">
Ejemplo:<Directory "C:\Users\<nombre>\Documents\GitHub\TFG\src\frontend">
- Iniciar Apache
- En el navegador, entrar en
localhost
o enlocalhost:80
y comprobar que devuelve el contenido deTFG/src/frontend/index.php