LibriTrack es una aplicación móvil que permite a los usuarios realizar un seguimiento de sus libros leídos y sus películas vistas, crear listas de deseos y saber el punto del libro en el que el usuario se ha podido quedar durante su lectura.
El proyecto se divide en dos partes: una aplicación frontend desarrollada en Ionic con Angular y un backend en Express, que utiliza Sequelize como ORM y MySQL como base de datos. Ambos componentes están alojados en el mismo repositorio.
Sigue estas instrucciones para obtener una copia local del proyecto y prepararla para desarrollo y pruebas en tu entorno.
Necesitas instalar las siguientes herramientas para ejecutar el proyecto localmente:
- Node.js (v14 o superior)
- NPM (v6 o superior)
- Ionic CLI
- Visual Studio Vode (opcional, para trabajar con el código del proyecto)
- MySQL (instalado y configurado)
- MySQL Workbench (opcional, para manejar la base de datos gráficamente)
- Postman (opcional, para probar las API)
- Clona el repositorio en tu máquina local:
git clone https://github.com/SaraCS21/libriTrack.git
- Instala las dependencias del frontend (Ionic + Angular):
Navega a la carpeta libriTrackFE/ y ejecuta:
cd libriTrackFE/
npm install
- Instala las dependencias del backend (Express + Sequelize):
cd libriTrackBE/
npm install
- Configura las variables .env
En el backend hay un fichero .env.example que hay que rellenar y renombrar como .env.
- Configura la base de datos:
Asegúrate de tener MySQL ejecutándose localmente. Puedes ver los datos en local para conectarte a MySQL Workbench dentro de libriTrackBE/config/db.config.js
Ten en cuenta, la primera vez que ejecutes el backend, que en el libriTrackBE/index.js debe estar comentada la línea 19 y descomentada de la 22 a la 24. Cuando ya tengas creada tu base de datos, debes tenerlo al contrario.
- Ejecuta el servidor backend:
cd libriTrackBE/
npm start
El backend estará disponible en http://localhost:8080.
- Ejecuta la aplicación frontend:
cd libriTrackFE/
ionic serve
La aplicación frontend estará disponible en http://localhost:8100.
Para facilitar la prueba de los endpoints del backend, puedes acceder a la colección de Postman desde el siguiente enlace:
Acceder a la colección de Postman
Este enlace contiene todas las peticiones necesarias para interactuar con la API, incluyendo las rutas de registro, inicio de sesión y operaciones CRUD.
- Framework para desarrollo de aplicaciones móviles y web
- Framework para el desarrollo del frontend
- Lenguaje utilizado para el desarrollo del frontend
- Framework para el backend
- ORM para manejo de bases de datos
- Sistema de gestión de bases de datos
-
- Herramienta para pruebas de API
-
- Para la protección de rutas
- Sara del Pino Cabrera Sánchez - Trabajo Inicial - SaraCS21