VIRIDIAN Digital Banking - Backend 5.3.0

Changelog

General: Se implementa el uso de un certificado para todos los ambientes: Stage, Preprod, Prod, en base al certificado CA Viridian.
Mis Finanzas: Los registros importados desde Pago de Servicios, cuando corresponden a recargas prepago, ya no serán considerados como pagos recurrentes.
Mis Finanzas: Se corrige el envío de notificaciones de pagos recurrentes: anteriormente se enviaban incluso si el cliente ya había realizado el pago en el mismo día. Ahora, se reconoce el pago oportunamente y evita el envío de la notificación sin necesidad de que el cliente ingrese a Mis Finanzas.
Mis Finanzas: Se incorpora un nuevo reporte de Ingresos y Gastos, que permite visualizar la información mediante opciones predefinidas como Últimos 7 días, Últimos 30 días, Esta semana, Este mes, Este año, así como por rangos de fechas personalizados.
Mis Finanzas: Se habilita la opción de eliminar las categorías por defecto del sistema, permitiendo al usuario conservar únicamente las que utilice.
Mis Finanzas: Se añaden validaciones para evitar que el usuario cambie el tipo de categorías que estén asociadas a un presupuesto o a una transacción.
Onboarding: Se actualizan las licencias de FacePhi para el ambiente de producción. Estas serán válidas hasta agosto de 2026.
Onboarding - Nuevas cuentas: Las notificaciones push para clientes que dejaron incompleto su proceso de onboarding ahora se envían a partir del día 5, en lugar de iniciarse al día siguiente. Este recordatorio se envia 4 veces cada 5 días.
Pagos QR: Se corrige el error en pagos QR donde, al seleccionar inicialmente una tarjeta de crédito como cuenta de origen y luego cambiar a una caja de ahorro, la comisión se mantenía incorrectamente en el mensaje de confirmación y en el comprobante. Ahora, la comisión se actualiza correctamente según la cuenta seleccionada.

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

Fecha: lunes, 6 de abril de 2026

Tareas previas

info

Les solicitamos por favor realicen los pasos Selección de versión del release y Descarga de componentes en horario de oficina para poder tener todo el equipo a disposición en caso de error.

Selección de versión del release

En el servidor de administración, ejecutar el siguiente comando ansible:
```
ansible-playbook release.yml -t select -e="version=5.3.0"
```
info
Este comando selecciona la versión del release.

Descarga de componentes

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

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

Ejecutar el siguiente script:

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 <> '';

ALTER TABLE my_finances_control ADD categories_migrated smallint;

CREATE INDEX idx_my_finances_transaction_customer_code_currency_account_code_trn_date ON my_finances_transaction (customer_code, currency, account_code, account_type, trn_date);
CREATE INDEX idx_my_finances_transaction_customer_code_currency_trn_date ON my_finances_transaction (customer_code, currency, trn_date);
CREATE INDEX idx_my_finances_transaction_customer_code_trn_date ON my_finances_transaction (customer_code, trn_date);

Cambios en los servidores

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

En el servidor de administración, revisar el archivo cert.pem dentro del directorio viridian-ansible-bec/tls, copiar y quitar el Certificado CA del fullchain:

Antes:

Después:

En el servidor de administración, crear un nuevo archivo ca.pem dentro del directorio viridian-ansible-bec/tls, pegar el Certificado CA que corresponde a cert.pem:
```
-----BEGIN CERTIFICATE-----
    Certificado CA
-----END CERTIFICATE-----
```
En el servidor de administración, crear un nuevo archivo internalcert.pem dentro del directorio viridian-ansible-bec/tls, pegar el contenido del archivo internalcert.pem enviado por VIRIDIAN en certsViridian.zip.
En el servidor de administración, crear un nuevo archivo internalkey.pem dentro del directorio viridian-ansible-bec/tls, pegar el contenido del archivo internalkey.pem enviado por VIRIDIAN en certsViridian.zip.
En el servidor de administración, crear un nuevo archivo internalca.pem dentro del directorio viridian-ansible-bec/tls, pegar el contenido del archivo caViridian.pem enviado por VIRIDIAN en certsViridian.zip.
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

En el servidor de administración, ejecutar el siguiente comando ansible:
```
ansible-playbook elk.yml -K -t init,deploy
```

Cambios en vault

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

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

En el servidor de administración, ejecutar los siguientes comandos ansible:
```
ansible-playbook kafka.yml -K -t deploy
```

Cambios en componentes

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

En el servidor de administración, ejecutar el siguiente comando ansible:
```
ansible-playbook admin.yml -K -t cleanup
```

Verificación de componentes

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

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 5.2.30	release 5.3.0
viridian-config-properties	9.25.1	9.26.0
server-config	9.1.0
server-eureka	9.1.0
vdb-routes-public	9.9.0
vdb-routes-internal	9.3.0
vdb-routes-bank	9.3.0
gateway-public	9.3.1	9.4.0
gateway-internal	9.3.1	9.4.0
gateway-external	9.2.0	9.3.0
bank-gateway	9.6.0	9.7.0
bank-service	9.3.0	9.4.0
batchpayments-api	9.3.0	9.4.0
batchpayments-hosted	9.3.0	9.4.0
beneficiaries-api	9.5.0	9.6.0
digitalcredit-api	9.3.0	9.4.1
digitalpay-qr	9.13.0	9.14.0
guaranteebond-api	9.3.0	9.4.0
manager-api	9.18.0	9.19.0
manager-hosted	9.9.0	9.10.0
myfinances-api	9.4.0	9.5.0
notifications-hosted	9.7.0	9.8.0
onboarding-api	9.14.1	9.15.0
servicepayments-api	9.5.1	9.6.0
statements-api	9.5.0	9.6.0
trade-api	9.5.0	9.6.0
transactions-api	9.9.0	9.10.0
transactions-hosted	9.3.0	9.4.0
utilities-api	9.8.0	9.9.0
wiretransfer-api	9.4.1	9.5.0
insurance-agents	9.3.0	9.4.0
insurance-sales	9.3.0	9.4.0
assistant-requests	9.6.0	9.7.0
frontend-vdb	9.10.0
frontend-vdb-2	9.10.0
frontend-admin	9.6.0
frontend-kiosk	9.2.0

Changelog​

Tareas previas​

Selección de versión del release​

Descarga de componentes​

Instrucciones​

Habilitar el mantenimiento​

Cambios en base de datos​

Cambios en los servidores​

Cambios en certificados SSL​

Cambios en elk​

Cambios en vault​

Cambios en redis​

Cambios en kafka​

Cambios en componentes​

Limpieza de archivos generados por el release​

Verificación de componentes​

Deshabilitar el mantenimiento​

Resumen de versiones​