VIRIDIAN Digital Banking - Backend 4.2.0

Changelog

• Autorizaciones: Se implementa el envío de notificaciones a los usuarios aprobadores cuando el solicitante anula una transacción que ya cuenta con una o más aprobaciones.
• Banca Web - Cobranza: Se actualiza la etiqueta de la columna en los listados del módulo de Cobranzas (Cobros por cliente, Cargar Archivos, Enviar eMails y Reportes), cambiando “Registros” por “Estado”.
• Banca Web - Cobranza: Se ajusta el orden de campos en el formulario de carga de archivos del módulo de Cobranzas: se posiciona “Cuenta que recibirá el pago” como primer campo y “Tipo de archivo” antes de la selección del archivo.
• Cobranza: Ahora cuando se envían emails de cobranza, se responde rápido al cliente en la Banca Web y los envíos se realizan poco a poco, en el histórico se puede ver el avance del envío al actualizar los datos.
• Cobranza: Se realizaron mejoras para permitir que, cuando se utilice varias veces la opción de envío por email, puedan pagarse todos los QRs generados (tanto los más antiguos como los más recientes), ya que se genera el mismo Código QR en cada envío de emails. Anteriormente se mostraba el mensaje: “No es posible realizar el pago porque el mismo ya fue pagado o existe un Código QR más reciente para realizar”. Con esta mejora, se elimina ésta validación, permitiendo el pago de cualquiera de los QRs generados.
• General: Se implementa el uso de un certificado para todos los ambientes: Stage, Preprod, Prod, en base al certificado CA Viridian. Esta mejora obedece al cambio en los proveedores de certificados que ahora ya no soportarán "Autenticación como cliente y servidor" que nosotros necesitamos en nuestros sistemas, ademas esto elimina una complejidad en el proceso de renovar certificados y pagar por los mismos.

Tags:

• elk
• vault
• kafka
• redis
• viridian-config
• vdb-routes-public
• vdb-routes-internal
• vdb-routes-bank
• gateway-public
• gateway-internal
• bank-gateway
• bank-service
• batchpayments-api
• batchpayments-hosted
• beneficiaries-api
• digitalpay-qr
• manager-api
• notifications-hosted
• onboarding-api
• servicepayments-api
• statements-api
• trade-api
• transactions-api
• transactions-hosted
• utilities-api
• frontend-vdb
• frontend-admin

Modo de aplicación: En frío (con mantenimiento)

Fecha: miércoles, 29 de abril de 2026

Tareas previas

Selección de versión del release

1. En el servidor de administración, ejecutar el siguiente comando ansible:

   ansible-playbook release.yml -t select -e="version=4.2.0"

   info

   Este comando selecciona la versión del release.

Descarga de componentes

1. En el servidor de administración, ejecutar el siguiente comando ansible:

   ansible-playbook release.yml -K -t warmup

   info

   Este comando descarga las nuevas versiones de todos los componentes que serán actualizados.

Instrucciones

Habilitar el mantenimiento

1. En el servidor de administración, ejecutar el siguiente comando ansible:

   ansible-playbook admin.yml -K -t maintenance-enable

   info

   Este comando habilita el modo mantenimiento.

Cambios en base de datos

1. Ejecutar el siguiente script:

   ALTER TABLE company_service ALTER COLUMN invoice_message VARCHAR(150);
   UPDATE company_service SET invoice_message = 'La factura puede ser descargada con la opción correspondiente en la parte inferior' WHERE invoice_message IS NOT NULL AND invoice_message <> '';
   
   CREATE INDEX idx_collect_user_type_date ON collect(qr_id, due_date, type);
   
   ALTER TABLE man_user ADD reason_note VARCHAR(250);
   
   CREATE INDEX idx_firebase_topic_status_id ON firebase_topic (device_status, id);
   
   ALTER TABLE man_user 
   ADD weekly_limit DECIMAL(9, 2),
       monthly_limit DECIMAL(9, 2);
   
   ALTER TABLE trade_transfer
   ADD quotation_data VARCHAR(4096),
       trn_trade_exchange_rate_usd DECIMAL(10,7),
       trn_trade_exchange_rate_ext DECIMAL(10,7);
   
   ALTER TABLE stats_unity_collect_email ADD last_error_code varchar(250);

Cambios en los servidores

1. En el servidor de administración, ejecutar los siguientes comandos ansible:

   ansible-playbook admin.yml -K -t stop-netcore

   ansible-playbook admin.yml -K -t stop-spring

Cambios en certificados SSL

1. En el servidor de administración, ejecutar los siguientes comandos:

   cp tls/cert.pem tls/cert1.pem

   cp tls/key.pem tls/key1.pem

2. En el servidor de administración, quitar el certificado CA del archivo cert.pem dentro del directorio viridian-ansible-bsol/tls:

   cert.pem:

   -----BEGIN CERTIFICATE-----
        Certificado del servidor
   -----END CERTIFICATE-----
   -----BEGIN CERTIFICATE-----
        Certificado intermedio 1
   -----END CERTIFICATE-----
   -----BEGIN CERTIFICATE-----
        Certificado intermedio 2 (si fuera necesario)
   -----END CERTIFICATE-----

3. En el servidor de administración, crear un nuevo archivo ca.pem dentro del directorio viridian-ansible-bsol/tls, pegar el Certificado CA que corresponde a cert.pem:

   -----BEGIN CERTIFICATE-----
       Certificado CA
   -----END CERTIFICATE-----

4. En el servidor de administración, crear un nuevo archivo internalcert.pem dentro del directorio viridian-ansible-bsol/tls, pegar el contenido del archivo internalcert.pem enviado por VIRIDIAN en certsViridian.zip que corresponde al entorno.

5. En el servidor de administración, crear un nuevo archivo internalkey.pem dentro del directorio viridian-ansible-bsol/tls, pegar el contenido del archivo internalkey.pem enviado por VIRIDIAN en certsViridian.zip que corresponde al entorno.

6. En el servidor de administración, crear un nuevo archivo internalca.pem dentro del directorio viridian-ansible-bsol/tls, pegar el contenido del archivo caViridian.pem enviado por VIRIDIAN en certsViridian.zip.

7. En el servidor de administración, ejecutar el siguiente comando ansible:

   ansible-playbook tls.yml -K -t deploy

   info

   Este comando deploya los certificados SSL, sus CA's y sus llaves privadas en todos los servidores.

Cambios en elk

1. En el servidor de administración, ejecutar el siguiente comando ansible:

   ansible-playbook elk.yml -K -t init,deploy

Cambios en vault

1. En el servidor de administración, ejecutar los siguientes comandos ansible:

   ansible-playbook vault.yml -K -t backup

   ansible-playbook vault.yml -K -t deploy

   ansible-playbook vault.yml -K -t unseal

Cambios en redis

1. En el servidor de administración, ejecutar el siguiente comando ansible:

   ansible-playbook redis.yml -K -t deploy

   ansible-playbook admin.yml -K -t restart-redis

Cambios en kafka

1. En el servidor de administración, ejecutar los siguientes comandos ansible:

   ansible-playbook kafka.yml -K -t deploy

Cambios en componentes

1. En el servidor de administración, ejecutar el siguiente comando ansible:

   ansible-playbook release.yml -K -t deploy -e "type=cold"

Limpieza de archivos generados por el release

1. En el servidor de administración, ejecutar el siguiente comando ansible:

   ansible-playbook admin.yml -K -t cleanup

Verificación de componentes

1. En los servidores de aplicaciones, ejecutar el siguiente comando:

   docker ps -vs

   info

   Este comando muestra el estado de todos los docker containers ordenados alfabéticamente.

2. Revisar el output del comando y asegurarse de que todos los docker containers tengan un status UP y no haya ningún docker container detenido.

Deshabilitar el mantenimiento

1. En el servidor de administración, ejecutar el siguiente comando ansible:

   ansible-playbook admin.yml -K -t maintenance-disable

   info

   Este comando deshabilita el modo mantenimiento.

Resumen de versiones

componente	release 4.1.10	release 4.2.0
viridian-config-properties	9.9.1	9.10.0
server-config	9.1.0
server-eureka	9.1.0
vdb-routes-public	9.3.0	9.4.0
vdb-routes-internal	9.2.0	9.3.0
vdb-routes-bank	9.2.0	9.3.0
gateway-public	9.2.0	9.3.0
gateway-internal	9.2.0	9.3.0
bank-gateway	9.2.0	9.3.0
bank-service	9.2.0	9.3.0
batchpayments-api	9.2.0	9.3.0
batchpayments-hosted	9.2.0	9.3.0
beneficiaries-api	9.2.0	9.3.0
digitalpay-qr	9.5.0	9.6.0
manager-api	9.7.0	9.8.1
manager-hosted	9.4.0	9.5.1
notifications-hosted	9.2.0	9.3.0
onboarding-api	9.2.0	9.3.0
servicepayments-api	9.2.0	9.3.0
statements-api	9.2.0	9.3.0
trade-api	9.2.0	9.3.0
transactions-api	9.3.0	9.4.0
transactions-hosted	9.2.0	9.3.0
utilities-api	9.3.0	9.4.0
frontend-vdb	9.3.0	9.4.1
frontend-admin	9.1.0	9.2.0