ms-arq-tool

Este programa consta de dos proyectos, un proyecto en java para el Backend y un proyecto en React para el frontend.

Backend

Para ejectuar el backend se debe tener instalado Maven, Java 15, Apache Tomcat 9 y PostgreSql.

El proyecto cuenta con distintos perfiles de maven para el manejo de propiedades utilizados por los desarrolladores, en caso de querer dirigirse a la base de testing se deberá usar el perfil testing. En caso contrario se puede utilizar el perfil mariano, el cual buscará una base de datos con nombre "architecture-adviser" en la dirección localhost:5432.

Para usarlo de forma local se deberá crear previamente dicha base de datos de tipo PostgreSql, y sus credenciales deben ser username: postgres password: password

Una vez que se tiene la base de datos creada, se debe abrir una terminal en la carpeta del proyecto y dirigirse a la carpeta architecture-adviser, luego debemos ejecutar el comando mvn clean install con el perfil elegido.

mvn clean install -P mariano

Esto generará una carpeta target con el archivo architecture-adviser.war. Luego se debe ingresar a la carpeta en donde está instalado Tomcat y dentro de la carpeta webapps pondremos el archivo architecture-adviser.war.

Por último basta con ejecutar tomcat y tendremos corriendo el backend.

Frontend

Para ejecutar el frontend debemos tener instalado Node.

Una vez que se tiene Node instalado, se debe abrir una terminal en la carpeta del proyecto y acceder a la carpeta architecture-adviser-app. Luego se debe instalar las bibliotecas necesarias, para esto se debe ejecutar el comando

npm install

Debemos asegurarnos de que las consultas serán dirigidas a la instancia de backend que deseamos, en este caso la que esta corriendo localmente en tomcat. Para esto debemos verificar que el archivo "architecture-adviser-app/src/config/api.js" tenga el atributo baseURL como sigue.

const instance = axios.create({ baseURL: "http://localhost:8080/architectureadviser/", });

por ultimo, para ejecutar el proyecto se debe ejecutar el comando

npm start

Ahora puede acceder al sitio en la url http://localhost:3000

Carga de datos

Para la carga de datos hay varios scripts sql que se encuentran architecture-adviser/src/main/resources/scripts

El primero que debemos ejecutar es model_data.sql, este script crea los datos necesarios para el funcionamiento de la toma de decisiones y la herramienta. El segundo script que debemos ejecutar es component_descriptions.sql, el cual ingresa descripciones para algunos compoentes en el sistema. En tercer lugar debemos ejecutar files.sql, este script contiene los archivos referenciados desde las descripciones de los componentes y desde las fuentes de información. Por ultimo debemos ejecutar el script information_sources.sql, el cual contiene las fuentes de información para los distintos componentes.