Muestra las diferencias entre dos versiones de la página.
| Ambos lados, revisión anterior Revisión previa Próxima revisión | Revisión previa | ||
|
ada:howto:sicoferp:factory:internos:adagestor:fordevs [2024/12/13 14:33] 192.168.177.39 |
ada:howto:sicoferp:factory:internos:adagestor:fordevs [2025/02/04 16:56] (actual) 192.168.175.43 [AdaGestor | Para desarrolladores] |
||
|---|---|---|---|
| Línea 3: | Línea 3: | ||
| En esta sección se describe toda la información acerca de los repositorios, compilación, despliegue y dependencias de servicios del proyecto. | En esta sección se describe toda la información acerca de los repositorios, compilación, despliegue y dependencias de servicios del proyecto. | ||
| - | |||
| ==== Repositorios: ==== | ==== Repositorios: ==== | ||
| - | Los repositorios del proyecto se encuentran en el GitLab en esta ruta: [[http://10.1.140.120/ada-microservices-ecosystem/module/adagestor|AdaGestor en GitLab]] | + | Los repositorios del proyecto se encuentran en el GitLab en esta ruta: [[https://repo-ecosystem-ada.adacsc.co/ada-microservices-ecosystemada-microservices-ecosystem/module/adagestor|AdaGestor en GitLab]] |
| - | * El proyecto del front end esta desarrollado con Angular 18.2.0, y se encuentra alojado en este repositorio: [[http://10.1.140.120/ada-microservices-ecosystem/module/adagestor/ng-adagestor|Proyecto Front]] | + | * El proyecto del front end (//ng-adagestor//) esta desarrollado con Angular 18.2.0, y se encuentra alojado en este repositorio: [[http://10.1.140.120/ada-microservices-ecosystem/module/adagestor/ng-adagestor|Proyecto Front]] |
| - | * El proyecto del back end esta desarrollado con Spring Boot 3.3.4, y se encuentra alojado en este repositorio: [[http://10.1.140.120/ada-microservices-ecosystem/module/adagestor/spring-adagestor|Proyecto Back]] | + | * El proyecto del back end (//spring-adagestor//) esta desarrollado con Spring Boot 3.3.4, y se encuentra alojado en este repositorio: [[http://10.1.140.120/ada-microservices-ecosystem/module/adagestor/spring-adagestor|Proyecto Back]] |
| ==== Compilación ==== | ==== Compilación ==== | ||
| Línea 17: | Línea 16: | ||
| * Para compilar el proyecto de Spring se deben ejecutar las tareas de gradle "**clean build**", para limpiar el directorio del proyecto y construir el artefacto **jar**. Una vez finalice el build, el artefacto puede encontrarse bajo el directorio "**build/libs/spring-adagestor-0.0.1-SNAPSHOT.jar**". | * Para compilar el proyecto de Spring se deben ejecutar las tareas de gradle "**clean build**", para limpiar el directorio del proyecto y construir el artefacto **jar**. Una vez finalice el build, el artefacto puede encontrarse bajo el directorio "**build/libs/spring-adagestor-0.0.1-SNAPSHOT.jar**". | ||
| - | Paso a paso del despliegue | + | ==== Despliegue ==== |
| A continuación se describen los pasos para realizar un despliegue del aplicativo. | A continuación se describen los pasos para realizar un despliegue del aplicativo. | ||
| Línea 28: | Línea 27: | ||
| - Ejecutar "**docker compose up**" para que se haga el despliegue de las imágenes configuradas. | - Ejecutar "**docker compose up**" para que se haga el despliegue de las imágenes configuradas. | ||
| - Validar el estado de los contenedores creados, para asegurarse que no haya habido errores al iniciarse. | - Validar el estado de los contenedores creados, para asegurarse que no haya habido errores al iniciarse. | ||
| + | |||
| + | ==== Dependencias ==== | ||
| + | |||
| + | El proyecto depende de los siguientes servicios internos: | ||
| + | == SicofConfig == | ||
| + | Este servicio brinda la funcionalidad de login, registro y modificación de usuarios. Para poder desarrollar AdaGestor en el tiempo estimado inicialmente, fue necesario hacer un fork de SicofConfig para agregar y modificar algunas funcionalidades faltantes requeridas por el proyecto. Este fork se llama "**sicofconfig-ag**", y también se encuentra alojado en el repositorio de [[http://10.1.140.120/ada-microservices-ecosystem/module/adagestor|GitLab de Adagestor]]. | ||
| + | Respecto a SicofConfig, se hicieron modificaciones en UserController, UserService y ConsultarTerceroExistenteService. | ||
| + | |||
| + | Ademas, SicofConfig depende del **servicio de terceros** del ecosistema para hacer las consultas de terceros, lo cual impone unos requisitos adicionales: | ||
| + | |||
| + | Deben estar parametrizados algunos registros en ciertas tablas del esquema SICOFCONFIG en la base de datos a la que este conectado sicofconfig-ag (inicialmente "conexionmul"): | ||
| + | * APPLICATION: Debe haber un registro que identifique a AdaGestor, con un **APP_ID** único. | ||
| + | * CONNECT_DB: Debe haber un registro para AdaGestor con un CONNECT_CODE único, en el que se parametrice la **conexion** a la base de datos de la que se van a consultar los **terceros**, se defina un contexto en **CONNECT_CONTEXT**, y se relacione el **COMPANY_ID** de la empresa. | ||
| + | * SUBSIDIARY: Debe haber un registro para AdaGestor que relacione el **COMPANY_ID** de la empresa. | ||
| + | * APPLICATION_COMPANY: Debe haber un registro que relacione el **APP_ID**, **SUBSIDIARY_ID** y **CONNECT_DB_ID** de los registros anteriores. | ||
| + | |||
| + | == AdaEmailService == | ||
| + | Este servicio brinda la funcionalidad para enviar las notificaciones por correo electrónico. | ||
| + | |||
| + | * El servicio se consume por medio de peticiones HTTP **POST**. | ||
| + | * El cuerpo de la petición debe contener las propiedades: **subject**, **from**, **toEmail**, y **content**, que son los parámetros del correo. | ||
| + | * Además se debe incluir en el header "**token**" un token valido para el servicio, el cual se encuentra parametrizado en las propiedades de spring-adagestor. | ||