Laboratorio N°2 - Taller de Bases de Datos

Laboratorio de Taller de Bases de Datos desarrollado por el equipo 6.

Integrantes

• Javiera Godoy
• Ignacio Lara
• David Martinez
• Claudio Palma
• Paloma Zepeda
• Alejandro Rojas

Descripción

PóneleVoluntAPP surge como solución a la necesidad de coordinar eficazmente el flujo de voluntarios espontáneos en situaciones de emergencia en Chile.

Esta plataforma facilita la gestión de esfuerzos voluntarios, emparejando habilidades y disponibilidades con las necesidades específicas de cada emergencia, y permitiendo a los coordinadores organizar y asignar tareas de forma estratégica para una respuesta ágil y efectiva ante desastres naturales.

El repositorio incluye las siguientes carpetas principales:

• Carpeta Backend: Contiene todo el Backend y las clases de las entidades las cuales se distribuyen en los paquetes: Controllers, Entities, Services y Repositories.
• Carpeta Frontend: Contiene todo el Frontend y las vistas utilizadas con Vue.
• Carpeta Database: Contiene el archivo dbCreate.sql, el cual contiene el script para crear la Base de Datosy el archivo loadData.sql, que sirve para poblar las tablas.

Requisitos y Versiones de las Tecnologías.

• Postgres SQL versión 12 o superior.
• SQL2O versión 1.6.0.
• JJWT versión 0.12.5.
• PgAdmin versión 4.
• IntelliJ IDEA Ultimate versión 2024.1, aunque debería funcionar con cualquier versión.
• JDK Versión 17.
• VUE versión 2.x.
• axios versión 1.6.8.
• Postman versión Postman 10.24.22.

Instrucciones de Instalación.

1. Clonar el repositorio: Esto proporcionará las tres carpetas principales para el proyecto de Laboratorio. Para clonarlo, se debe usar el siguiente comando en el directorio deseado:

git clone https://github.com/kappita/lab-tbd

2. Instalar PostgreSQL y PGAdmin4: Para ello, se puede instalar un pack en conjunto desde el siguiente link. Se debe seleccionar la versión deseada para el Sistema Operativo deseado y seguir las instrucciones de instalación. Durante la instalación es necesario configurar un username y un password para utilizar con PostgreSQL. Estos serán luego necesarios para la creación de la Base de Datos junto con sus tablas. DISCLAIMER: Para poder conectarse a la Base de Datos correctamente, se deben configurar las mismas credenciales que están puestas en aplication.properties en el backend.

3. Instalar IntelliJ IDEA Ultimate: Ingresar al sitio web oficial de IntelliJ IDEA y seleccionar una opción dependiendo del Sistema Operativo que use:

• Para Windows, utilizar el siguiente link.
• Para Linux, utilizar el siguiente link.
• Para MacOs, utilizar el siguiente link.

4. Abrir IntelliJ IDEA Ultimate, abrir un nuevo proyecto y seleccionar la carpeta Backend. Debemos esperar unos minutos a que el proyecto se configure y se instalen los plugins necesarios.
5. Configurar las credenciales del aplication.properties del disclaimer del punto 2.
6. Configurar el JDK: Al abrir una clase IntelliJ nos solicitará configurar un JDK. Debemos asegurarnos de seleccionar JDK versión 17. De no tener JDK 17, IntelliJ nos proporciona una opción para instalarlo automáticamente.

• Si no nos aparece esta opción porque ya tenía IntelliJ instalado anteriormente, basta con ir a la navbar. File -> Proyect Structure. En esa sección en el apartado de SDK, se podrá cambiar la versión.

7. Ir al siguiente link e instalar la última versión de Node.js, siguiendo las instrucciones de instalación.
8. Abrir una consola / terminal dentro de la carpeta Frontend y aplicar el siguiente comando, el cual instalará todas las dependencias necesarias para el proyecto:

npm install

• Si por algún motivo lo anterior falla, se puede utilizar:

npm install --force

9. Ir al siguiente link e instalar la última versión de Postman.

Una vez finalizado estos nueve pasos, podemos seguir con las instrucciones de uso.

Instrucciones de Uso.

Instrucciones de uso

1. En PgAdmin, crear una BD llamada "Tebede", ir a Schemas -> Public y seleccionar la opción "Query tool", y abrir el archivo dbCreate.sql

2. Abrir el archivo loadData.sql y ejecutarlo en la Query tool.

3. Utilizando IntelliJ IDEA Ultimate, asegurarse de que se detecte correctamente Spring Boot y Gradle.

4. Antes de ejecutar el proyecto, asegurarse de que en el archivo backend/src/main/resources/application.properties se encuentren las credenciales correctas de la base de datos

5. Ejecutar la aplicación haciendo click en la opción "Run" dentro de IntelliJ IDEA.

6. Dentro de la carpeta Frontend, abrir una consola / terminal. Ejecutar el siguiente comando:

npm install

Una vez instalado, ejecutar el siguiente comando:

npm run dev

7. Con esto ya tenemos levantado FrontEnd y Backend.
8. Para probar el CRUD de una tabla, debemos colocar la ruta en Postman (Por ejemplo, localhost:8080/{voluntarios o el nombre de la tabla}/{save,delete,update,getById,getAll}). Luego seleccionar uno de los métodos a aplicar, dependiendo de si quieres crear, mostrar, editar o eliminar un elemento.
9. Para ir a la vista de Registro, por ejemplo, se debe ir a http://localhost:5173/registro.