====== Ecosistema de Servicios Web (Java 21 - Springboot 3.x) ====== A continuación se listan los nuevos servicios con la nueva tecnología java 21 con springboot 3.x ===== Servicios Core ===== Todos los microservicios del ecosistema deben estar registrado en el servicio de registro y descubrimiento eureka el cual está desplegado en ula siguientes urls según el contexto. Ademas debe estar configurado en el servicio de enrutamiento para ofuscación de rutas. A continuación se listan los servicios Core ^Tipo de Servicio^Contexto^Url^ |Registro y Descubrimiento|Desarrollo|http://10.1.140.21:8761/| |Enrutamiento|Desarrollo|https://ecosystem-gateway-dev.adacsc.co| ===== Librerias Core (Elementos en revisión aún no liberados) ===== Se definen los siguientes componentes los cuales deben ser utilizados según la necesidad del microservicio. ^Libreria^Version^Descripción^ |EcosystemCore|0.0.8-SNAPSHOT|Componente core del ecosistema de servicios.| |EcosystemDomain|0.0.12-SNAPSHOT|Dominio del Negocio (Componente de entidades y dtos).| ===== Servicios del Negocio===== Todos los microservicios del negocio del ecosistema estan registrados en el servicio de registro Eureka como muestra en la siguiente imagen: {{ :ada:howto:sicoferp:factory:servicios_eureka.png?600 |}} ===== Dependencias del Negocio===== Todas las dependencias utilizadas en el ecosistema de microservicios estan registradas en el repositorio de dependencias [[http://10.1.40.130:8081/#browse/browse:ecosystem-ada|Nexus]] ((Solo para usuarios autorizados)) como se muestra en la siguiente imagen: {{ :ada:howto:sicoferp:factory:nexus.png?600 |}} ==== Ver Documentación ==== Para ver la documentación de cada microservicio se debe modificar en cada servicio((columna: Url de la tabla anterior)) el final del path base **api/vx** por el tipo de documentación a visualizar. Tenga presente que la x indica la versión vigente. === Ejemplo: Ver Documentación OpenAPI Json === Para visualizar la documentación en formato json. Se debe reemplazar //**/api/v1**// por //**/api-docs**// en la siguiente tabla se muestra cambio a aplicar para ver la documentación. ^Url base^Url Documentación^ |https://ecosystem-gateway-dev.adacsc.co/ecosystem-config-ws/api/v1|https://ecosystem-gateway-dev.adacsc.co/ecosystem-config-ws/api-docs| |https://ecosystem-gateway-dev.adacsc.co/bpp-attachment-service/api/v1|https://ecosystem-gateway-dev.adacsc.co/bpp-attachment-service/api-docs| |https://ecosystem-gateway-dev.adacsc.co/centros-de-costos/api/v1|https://ecosystem-gateway-dev.adacsc.co/centros-de-costos/api-docs| |https://ecosystem-gateway-dev.adacsc.co/ecosystem-report/api/v1|https://ecosystem-gateway-dev.adacsc.co/ecosystem-report/api-docs| |https://ecosystem-gateway-dev.adacsc.co/ecosystem-kafka-producer/api/v1|https://ecosystem-gateway-dev.adacsc.co/ecosystem-kafka-producer/api-docs| |https://ecosystem-gateway-dev.adacsc.co/contratistas-solicitud/api/v1|https://ecosystem-gateway-dev.adacsc.co/contratistas-solicitud/api-docs| |https://ecosystem-gateway-dev.adacsc.co/contratistas-procesos-atencion/api/v1|https://ecosystem-gateway-dev.adacsc.co/contratistas-procesos-atencion/api-docs| |https://ecosystem-gateway-dev.adacsc.co/contratistas-aprobacion-rechazo/api/v1|https://ecosystem-gateway-dev.adacsc.co/contratistas-aprobacion-rechazo/api-docs| |https://ecosystem-gateway-dev.adacsc.co/contratistas-solicitud-liquidacion/api/v1|https://ecosystem-gateway-dev.adacsc.co/contratistas-solicitud-liquidacion/api-docs| |https://ecosystem-gateway-dev.adacsc.co/supertabla/api/v1|https://ecosystem-gateway-dev.adacsc.co/supertabla/api-docs| |https://ecosystem-gateway-dev.adacsc.co/concepto-comercial/api/v1|https://ecosystem-gateway-dev.adacsc.co/concepto-comercial/api-docs| |https://ecosystem-gateway-dev.adacsc.co/plantillas-contables/api/v1|https://ecosystem-gateway-dev.adacsc.co/plantillas-contables/api-docs| |https://ecosystem-gateway-dev.adacsc.co/terceros/api/v1|https://ecosystem-gateway-dev.adacsc.co/terceros/api-docs| |https://ecosystem-gateway-dev.adacsc.co/recepcion-de-pedidos/api/v1|https://ecosystem-gateway-dev.adacsc.co/recepcion-de-pedidos/api-docs| |https://ecosystem-gateway-dev.adacsc.co/ordenes-de-pago/api/v1|https://ecosystem-gateway-dev.adacsc.co/ordenes-de-pago/api-docs| |https://ecosystem-gateway-dev.adacsc.co/comprobante-de-egreso/api/v1|https://ecosystem-gateway-dev.adacsc.co/comprobante-de-egreso/api-docs| |https://ecosystem-gateway-dev.adacsc.co/cargos/api/v1|https://ecosystem-gateway-dev.adacsc.co/cargos/api-docs| |https://ecosystem-gateway-dev.adacsc.co/contratistas-anulacion-liquidacion/api/v1|https://ecosystem-gateway-dev.adacsc.co/contratistas-anulacion-liquidacion/api-docs| |https://ecosystem-gateway-dev.adacsc.co/contratistas-consulta-procesos-revisados/api/v1|https://ecosystem-gateway-dev.adacsc.co/contratistas-consulta-procesos-revisados/api-docs| |https://ecosystem-gateway-dev.adacsc.co/contratistas-consulta-solicitud/api/v1|https://ecosystem-gateway-dev.adacsc.co/contratistas-consulta-solicitud/api-docs| |https://ecosystem-gateway-dev.adacsc.co/customizing-process-notifications/api/v1|https://ecosystem-gateway-dev.adacsc.co/customizing-process-notifications/api-docs| |https://ecosystem-gateway-dev.adacsc.co/customizing-window-favorites/api/v1|https://ecosystem-gateway-dev.adacsc.co/customizing-window-favorites/api-docs| |https://ecosystem-gateway-dev.adacsc.co/customizing-window-favorites/api/v1|https://ecosystem-gateway-dev.adacsc.co/customizing-window-favorites/api-docs| |https://ecosystem-gateway-dev.adacsc.co/parametros-sistema-presupuesto/api/v1|https://ecosystem-gateway-dev.adacsc.co/parametros-sistema-presupuesto/api-docs| |https://ecosystem-gateway-dev.adacsc.co/usuarios/api/v1|https://ecosystem-gateway-dev.adacsc.co/usuarios/api-docs| |https://ecosystem-gateway-dev.adacsc.co/ecosystem-email/api/v1|https://ecosystem-gateway-dev.adacsc.co/ecosystem-email/api-docs| Se debe copiar el texto generado((el json que se ven el navegador donde abrio la url)), abrir la url del visor swagger https://editor.swagger.io/ y reemplazar todo el contenido de la sección izquierda. A la derecha visualizará la documentación dle microservicio. Nota: v1 indica la versión vigente. === Ejemplo: Ver Documentación en el visor Swagger integrado === Para visualizar la documentación en el visor swagger integrado. Se debe reemplazar //**/api/v1**// por //**/swagger-ui/index.html**// en la siguiente tabla se muestra cmabio a aplicar para ver la documentación. ^Url base^Url Documentación^ |https://ecosystem-gateway-dev.adacsc.co/ecosystem-config-ws/api/v1|https://ecosystem-gateway-dev.adacsc.co/ecosystem-config-ws/swagger-ui/index.html| |https://ecosystem-gateway-dev.adacsc.co/bpp-attachment-service/api/v1|https://ecosystem-gateway-dev.adacsc.co/bpp-attachment-service/swagger-ui/index.html| |https://ecosystem-gateway-dev.adacsc.co/centros-de-costos/api/v1|https://ecosystem-gateway-dev.adacsc.co/centros-de-costos/swagger-ui/index.html| |https://ecosystem-gateway-dev.adacsc.co/ecosystem-report/api/v1|https://ecosystem-gateway-dev.adacsc.co/ecosystem-report/swagger-ui/index.html| |https://ecosystem-gateway-dev.adacsc.co/ecosystem-kafka-producer/api/v1|https://ecosystem-gateway-dev.adacsc.co/ecosystem-kafka-producer/swagger-ui/index.html| |https://ecosystem-gateway-dev.adacsc.co/contratistas-solicitud/api/v1|https://ecosystem-gateway-dev.adacsc.co/contratistas-solicitud/swagger-ui/index.html| |https://ecosystem-gateway-dev.adacsc.co/contratistas-procesos-atencion/api/v1|https://ecosystem-gateway-dev.adacsc.co/contratistas-procesos-atencion/swagger-ui/index.html| |https://ecosystem-gateway-dev.adacsc.co/contratistas-aprobacion-rechazo/api/v1|https://ecosystem-gateway-dev.adacsc.co/contratistas-aprobacion-rechazo/swagger-ui/index.html| |https://ecosystem-gateway-dev.adacsc.co/contratistas-solicitud-liquidacion/api/v1|https://ecosystem-gateway-dev.adacsc.co/contratistas-solicitud-liquidacion/swagger-ui/index.html| |https://ecosystem-gateway-dev.adacsc.co/supertabla/api/v1|https://ecosystem-gateway-dev.adacsc.co/supertabla/swagger-ui/index.html| |https://ecosystem-gateway-dev.adacsc.co/concepto-comercial/api/v1|https://ecosystem-gateway-dev.adacsc.co/concepto-comercial/swagger-ui/index.html| |https://ecosystem-gateway-dev.adacsc.co/plantillas-contables/api/v1|https://ecosystem-gateway-dev.adacsc.co/plantillas-contables/swagger-ui/index.html| |https://ecosystem-gateway-dev.adacsc.co/terceros/api/v1|https://ecosystem-gateway-dev.adacsc.co/terceros/swagger-ui/index.html| |https://ecosystem-gateway-dev.adacsc.co/recepcion-de-pedidos/api/v1|https://ecosystem-gateway-dev.adacsc.co/recepcion-de-pedidos/swagger-ui/index.html| |https://ecosystem-gateway-dev.adacsc.co/ordenes-de-pago/api/v1|https://ecosystem-gateway-dev.adacsc.co/ordenes-de-pago/swagger-ui/index.html| |https://ecosystem-gateway-dev.adacsc.co/comprobante-de-egreso/api/v1|https://ecosystem-gateway-dev.adacsc.co/comprobante-de-egreso/swagger-ui/index.html| |https://ecosystem-gateway-dev.adacsc.co/cargos/api/v1|https://ecosystem-gateway-dev.adacsc.co/cargos/swagger-ui/index.html| |https://ecosystem-gateway-dev.adacsc.co/contratistas-anulacion-liquidacion/api/v1|https://ecosystem-gateway-dev.adacsc.co/contratistas-anulacion-liquidacion/swagger-ui/index.html| |https://ecosystem-gateway-dev.adacsc.co/contratistas-consulta-procesos-revisados/api/v1|https://ecosystem-gateway-dev.adacsc.co/contratistas-consulta-procesos-revisados/swagger-ui/index.html| |https://ecosystem-gateway-dev.adacsc.co/contratistas-consulta-solicitud/api/v1|https://ecosystem-gateway-dev.adacsc.co/contratistas-consulta-solicitud/swagger-ui/index.html| |https://ecosystem-gateway-dev.adacsc.co/customizing-process-notifications/api/v1|https://ecosystem-gateway-dev.adacsc.co/customizing-process-notifications/swagger-ui/index.html| |https://ecosystem-gateway-dev.adacsc.co/customizing-window-favorites/api/v1|https://ecosystem-gateway-dev.adacsc.co/customizing-window-favorites/swagger-ui/index.html| |https://ecosystem-gateway-dev.adacsc.co/customizing-window-favorites/api/v1|https://ecosystem-gateway-dev.adacsc.co/customizing-window-favorites/swagger-ui/index.html| |https://ecosystem-gateway-dev.adacsc.co/parametros-sistema-presupuesto/api/v1|https://ecosystem-gateway-dev.adacsc.co/parametros-sistema-presupuesto/swagger-ui/index.html| |https://ecosystem-gateway-dev.adacsc.co/usuarios/api/v1|https://ecosystem-gateway-dev.adacsc.co/usuarios/swagger-ui/index.html| |https://ecosystem-gateway-dev.adacsc.co/ecosystem-email/api/v1|https://ecosystem-gateway-dev.adacsc.co/ecosystem-email/swagger-ui/index.html| Nota: v1 indica la versión vigente. [[http://example.com|Enlace externo]]==== Documentos ==== Se relacionan los siguientes documentos: * Documento Entrega: {{ :ada:howto:sicoferp:factory:documento_entrega_nueva_arquitectura_de_microservicios.docx |}} * Documento Jenkins: {{ :ada:howto:sicoferp:factory:arquitectura_jenkins.docx |}} * Documento de despliegue: {{ :ada:howto:sicoferp:factory:deploy_ecosystem_ada1.xlsx |}} * Colección de Prueba Backend: [[http://adacsc.co:1443/svn/repository/ADA/Ecosistema/Java/Collections/Ecosystem.postman_collection.json|Colección Pruebas Backend]] [[ada:howto:sicoferp:factory:new-migracion-sicoferp:arquitectura_backend|←Regresar]]