Este repositorio contiene todos los archivos relacionados con el Laboratorio N°1 del Laboratorio de Taller de Base de Datos (Base de Datos Avanzadas 13317) desarrollado por el equipo 5.
- IMPORTANTE: Para poder conectarse correctamente a la Base de Datos, se deben colocar el username y password con el que se configuró postgresSQL en el archivo aplication.properties dentro de la carpeta resources en Backend
El Laboratorio consiste en desarrollar CRUD utilizando Java y el servicio REST API con Sql2 y crear vistas utilizando VUE.js + Nuxt para poder realizar ciertos requisitos del Laboratorio N°1 del curso.
El repositorio incluye tres carpetas principales:
- Carpeta Backend: Contiene todos los archivos del Backend del proyecto y las clases de las entidades del modelo. Se distribuyen las clases en los paquetes Services, Repositories y Models
- Carpeta Database: Contiene los archivos dbCreate.sql, el cual contiene los scripts necesarios para crear la Base de Datos y las tablas del modelo, y el archivo loadData.sql, el cual contiene datos dummy para poblar las tablas.
- Carpeta Frontend: Contiene todos los archivos del Frontend y las vistas realizas utilizando Vue + Nuxt.JS. Principalmente, está el formulario para crear emergencias, el cual es uno de los requisitos solicitados para nuestro equipo.
Para ejecutar correctamente todo el proyecto, además de los archivos del repositorio se requieren las siguientes tecnologías:
- Postgres SQL versión 12 o superior.
- PgAdmin versión 4.
- IntelliJ IDEA Ultimate versión 2022.2.1, aunque debería funcionar con cualquier versión.
- JDK Versión 17 (Se debe configurar tanto en el proyecto como en Gradle)
- Nuxt + VUE versión 3.
- Postman versión 9.4
También, para el desarrollo del proyecto se utilizó:
- Visual Studio Code versión 1.72
- GitKraken versión 8.9.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/nic0q/TBD-Lab1-Grupo-5.git- Instalar PostgreSQL 12 y PGAdmin 4: 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.
- Instalar IntelliJ IDEA Ultimate: Ingresar al sitio web oficial de IntelliJ IDEA y seleccionar el instalador dependiendo del Sistema Operativo en uso:
- Para Windows, utilizar el siguiente link.
- Para Linux, utilizar el siguiente link.
- Para MacOs, utilizar el siguiente link.
- Al abrir IntelliJ IDEA Ultimate, abrir un nuevo proyecto y seleccionar la carpeta Backend. Debemos esperar a que el proyecto se configure y se instalen los plugins necesarios.
- Seguir el siguiente orden de carpetas para llegar al archivo application.properties: src -> main -> resources . Luego cambiar database.user y database.password al username y password configurados en el paso 2
- Configurar el JDK: Al abrir una clase IntelliJ nos solicitará configurar un JDK. Debemos asegurarnos de seleccionar JDK versión 17. Si no tenemos JDK 17, IntelliJ nos proporciona una opción para instalarlo automáticamente.
- Ir al siguiente link e instalar la última versión de Node.js, siguiendo las instrucciones de instalación.
- 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- Ir al siguiente link e instalar la última versión de Postman.
Con esto ya estamos listos con todo lo que es la instalación del proyecto y se puede continuar a las instrucciones de uso.
- En PgAdmin, seleccionar la opción "Query tool" y copiar la primera parte del script dbCreate.sql para solo crear la Base de Datos.
- Abrir la opción Query tool nuevamente, pero dentro de VoluntariadoDB (La Base de Datos que se crea en el paso 1) y copiar el resto de dbCreate
- Copiar todo el contenido de loadData.sql y ejecutarlo dentro de Query tool
- Utilizando IntelliJ IDEA Ultimate, asegurarse de que se detecte correctamente Spring Boot y Gradle. Ejecutar la aplicación haciendo click en la opción "Run" dentro de IntelliJ IDEA.
- Dentro de la carpeta Frontend, abrir una consola / terminal. Ejecutar el siguiente comando:
npm run dev- Con esto ya tenemos levantado FrontEnd y Backend
- Para probar el CRUD de una tabla, debemos colocar la ruta en Postman (Por ejemplo, http://127.0.0.1:8000/institutions). Luego seleccionar uno de los métodos a aplicar, dependiendo de si quieres crear, mostrar, editar o eliminar un elemento.
- Para ir a la vista de creación de emergencias, se debe ir a localhost:3000/createEmergency
- Para probar los Triggers, estos se pueden hacer en PgAdmin (más detalles en el video entregado junto con la entrega)