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. | ||