udistrital / planeacion_cliente

:heavy_check_mark: Check: Cliente del proyecto de planeación de la universidad Distrital
0 stars 0 forks source link

Salida a producción 2024-I #1134

Closed milo19980525 closed 2 months ago

milo19980525 commented 5 months ago

Se requiere realizar la salida a producción de todas las funcionalidades desarrolladas en SISGPLAN a la fecha, teniendo en cuenta los siguientes requerimientos:

Definition of Done - DoD - Despliegues

Nota: Este sistema tiene creado un ambiente de producción para las APIs MID y CRUD y para el Cliente, por lo que se requiere tener mucho cuidado con el incremento para no afectar data en producción.

milo19980525 commented 5 months ago

Plantilla de Manual técnico: E-03- Aprobación de entregable Funcionamiento (1).docx

Manual técnico guía: Descripción técnica Evaluaciones.docx

Descripción técnica SGA módulos inscripción y admisión

Observaciones adicionales:

  1. En la parte de consumos, incluir el detalle de que información se está consultando.
  2. Incluir un apartado para pruebas funcionales junto con el link asociado.

Carpeta dónde debe ir el documento técnico; https://udistritaleduco-my.sharepoint.com/:f:/g/personal/computo_udistrital_edu_co/EiXN6TjOfY1Mg00JcPWnsyoBMdX8_KWSHWCa2Za7PfcVdA?e=6g6YOX

milo19980525 commented 5 months ago

Material de apoyo para pruebas Unitarias:

Revisar esta plantilla como guía para el desarrollo de pruebas unitarias, así como los lineamientos de la OATI asociados a las mimas.

Adicionalmente, se adjuntan los siguientes issues como guía: https://github.com/udistrital/resoluciones_mid_v2/issues/13 https://github.com/udistrital/resoluciones_mid_v2/issues/49

a52290451 commented 5 months ago

Se relaciona Issue para pruebas unitarias #1148 .

a52290451 commented 5 months ago

La documentación técnica de SISGPLAN queda a cargo de @Oscarjaimes1710 .

a52290451 commented 4 months ago

Manual de usuario en proceso de correcciones:

V1: https://udistritaleduco-my.sharepoint.com/:w:/g/personal/computo_udistrital_edu_co/ER4hV5Ec24ZLmPvIVqtpcugB_yx-VR5jWFW2qrL2ovCi7A?e=1iel6C

Se realizan las siguientes observaciones a Viviana:

" Ya revise el documento:

Te realice algunos comentarios internamente para que los revises por favor.

Adicionalmente:

  1. En alineación, Justificar los parrafos, para tema de visualización y formato.
  2. Para cada sección agrega un salto de página.
  3. Falta la transición a través de los diferentes estados en Formulación, porque solo se muestra su formulación, pero no su revisión, observaciones, etc...
  4. Para seguimiento, de igual modo, se requiere completar con los diferentes estados y acciones posibles.
  5. Finalmente, ese proceso esta descrito para el ROL "PLANEACIÓN", pero existen 4 Roles en el sistema. De urgencia necesitamos el manual de usuario para el rol "JEFE UNIDAD" "
a52290451 commented 4 months ago

@Oscarjaimes1710 queda encargado de "Revisión de actualización de APIs consumidas (terceros, transversales)"

milo19980525 commented 4 months ago

@ccmendezt y @Mechaz123 Por favor revisar la relación de menús y roles en el aplicativo de configuración.

milo19980525 commented 4 months ago

@Mechaz123 y @ccmendezt se encargarán de revisar las variables de entorno, sincronización de bases de datos y ETL.

ccmendezt commented 4 months ago

Evidencias - Avance Salida a producción

25/06/2024 - 21:40

Notas importantes:

i. Mañana se realizará el script que permita cambiar los códigos de abreviación de los registros existentes en las colecciones de producción y agregación de nuevos registros.

Mechaz123 commented 4 months ago

CLIENTE

MID

Mechaz123 commented 4 months ago

ROLES EN EL SISTEMA

Image

NOTA

Producción:

Image

Pruebas:

Image

!!! IMPORTANTE !!

a52290451 commented 4 months ago

Se valida y aprueba V1 del Manual técnico para SISGPLAN.

Mechaz123 commented 4 months ago

Eliminación de menús en los diferentes roles

A continuación, se presenta el listado de ajustes con respecto a los menús en ambiente de pruebas, para cada uno de los roles en el sistema de SISGPLAN.

PARA EL ROL DE PLANEACION

Se elimina:

PARA EL ROL DE JEFE DEPENDENCIA

Se elimina:

PARA EL ROL ASISTENTE DE DEPENDENCIA

Se elimina:

PARA EL ROL ASISTENTE DE PLANEACION

Se elimina:

Oscarjaimes1710 commented 4 months ago

@Oscarjaimes1710 queda encargado de "Revisión de actualización de APIs consumidas (terceros, transversales)"

Se realiza la validación de consumos de apis externas de planeación cliente y se encuentra que en su mayoría responden correctamente. a excepción de documentos_service que arroja un error.

CONSUMOS DE APIS EXTERNAS DEL CLIENTE.xlsx

@a52290451

a52290451 commented 4 months ago

Estado pruebas unitarias #1148 .

a52290451 commented 4 months ago

Se realiza solicitud de pruebas de Carga y Seguridad:

https://tuleap.portaloas.udistrital.edu.co/plugins/tracker/?aid=62069

a52290451 commented 4 months ago

Manuales de Usuario:

PLANEACION: https://udistritaleduco-my.sharepoint.com/:w:/g/personal/computo_udistrital_edu_co/ER4hV5Ec24ZLmPvIVqtpcugB_yx-VR5jWFW2qrL2ovCi7A?e=AekgFu

JEFE_DEPENDENCIA: https://udistritaleduco-my.sharepoint.com/:w:/g/personal/computo_udistrital_edu_co/ERJJnbXTRcVPjQZiD4T77nkB12e7svarx4ymuguZeVG4Nw

ccmendezt commented 4 months ago

Evidencias - Avance Salida a producción

27/06/2024 - 16:50

Sincronización Bases de Datos

Revisión de Variables de Entorno

Se encuentra que únicamente se debe agregar la variable RESOLUCIONES_DOCENTES_SERVICE en planeacion_mid.

Pull Request Asociados a Issue:

- planes_crud: https://github.com/udistrital/planes_crud/pull/105 En planes_crud se agregaron los siguientes campos en la colección periodo-seguimiento:

  1. nueva_estructura
  2. usuario_modificacion

- planeacion_mid: https://github.com/udistrital/planeacion_mid/pull/573 En planeacion_mid se agregó validación de generación de reportes de planes de acción para una dependencia específica con una única actividad (lanzaba un panic cuando el plan tenía una sola actividad, ej: plan 2024 prueba ccmendezt

Notas importantes:

i. Ambos scripts fueron realizados usando la versión de Node 18.18.2 así que se recomienda usar esa para la sincronización de la base de datos y la ejecución de la migración del esquema de datos. ii. Se debe corregir el script de sincronización de planes_crud quitando los registros de tipo-plan no usados de acuerdo a la reunión con el SM. iii. Se debe crear un script de sincronización con parametros_crud para tener todos los parámetros usados por SISGPLAN.

ccmendezt commented 4 months ago

Evidencias - Avance Salida a producción

02/06/2024 - 18:30

Se realizó nuevamente la revisión de los items asignados.

Sincronización Bases de Datos

Nota: Se recomienda primero ejecutar el script de sincronización ETL, posteriormente el script de migración y luego seguir los pasos del archivo de en parametros_crud.

Pasos para ejecución de scripts en Node:

  1. Ejecutar el siguiente código npm install dotenv axios mongodb o npm i, ya que son módulos requeridos en ambos scripts para realizar las operaciones. 1.1 Paso especial para script MigracionDBMongo: Se debe cambiar el token usado en la línea 29 de MigracionDBMongo por un token de producción ya que se necesita para obtener datos de planeacion_mid, para esto se recomienda iniciar sesión en el aplicativo de planeación y utilizar el access_token generado al realizar el login. NO realizarlo con un token de desarrollo.
  2. Comentar el string de conexión a la base de datos usado para desarrollo y descomentar el string de conexión usado para producción. Estos se encuentran en las líneas 17 y 18 respectivamente para el script SincronizacionDBMongo y líneas 41 y 42 para el script MigracionDBMongo
  3. Llenar las variables de entorno en un archivo llamado .env usando como ejemplo las variables del archivo .env.example
  4. Correr el script

Revisión de Variables de Entorno

Se encuentra que únicamente se debe agregar la variable RESOLUCIONES_DOCENTES_SERVICE en planeacion_mid.

Notas importantes:

i. Ambos scripts fueron realizados usando la versión de Node 18.18.2 así que se recomienda usar esa para la sincronización de la base de datos y la ejecución de la migración del esquema de datos. ii. Se corrigió el script de sincronización de planes_crud quitando los registros de tipo-plan no usados de acuerdo a la reunión con el SM. iii. Se creó un archivo de sincronización con parametros_crud para tener todos los parámetros usados por SISGPLAN. iv. Teniendo en cuenta que se quitaron los registros relacionados a planes de acción de inversión en la colección tipo-plan, se debe revisar si se omite la inserción de los registros asociados a planes de acción de inversión en la colección tipo-seguimiento.

milo19980525 commented 4 months ago

Solicitud tuleap actualización variables de producción planeacion_mid: https://tuleap.portaloas.udistrital.edu.co/plugins/tracker/?aid=62072

milo19980525 commented 4 months ago

Se solicita caso DBAs para ejecución de scripts e inserción de datos: https://tuleap.portaloas.udistrital.edu.co/plugins/tracker/?aid=62092&group_id=177

Oscarjaimes1710 commented 4 months ago

Consumos a terceros desde el cliente :

APIS CONSUMIDAS POR PRODUCCIÓN --> MID:

-PlanesService = ${PLANES_SERVICE} -PlanCuentasService = ${PLAN_CUENTAS_SERVICE} -OikosService = ${OIKOS_SERVICE} -ParametrosService = ${PARAMETROS_SERVICE} -TercerosService = ${TERCEROS_SERVICE} -GestorDocumental = ${GESTOR_DOCUMENTAL_SERVICE}

APIS Consumidas por pruebas pero no en producción --> MID:

Apis que no se están consumiendo en producción pero si en el cliente de pruebas :

Apis que no se están consumiendo en el cliente de pruebas pero si en producción :

Se encuentra un error al correr este endpoint en ambiente de produccion : https://pruebasapi.intranetoas.udistrital.edu.co:8094/v1/documento

imagen

mientras que en ambiente de pruebas responde bien: https://autenticacion.portaloas.udistrital.edu.co/apioas/documento_crud/v2/documento

Oscarjaimes1710 commented 4 months ago

Se hace ajustes en el archivo de consumos de las apis externas como lo solicito @a52290451.

Documento : https://udistritaleduco-my.sharepoint.com/:x:/g/personal/computo_udistrital_edu_co/EaahSbIt-PxNsGZeRYIqIMYBNgP8EenUQk8b7dX6wWOwSA?e=ihLfYh

Las apis externas a las cuales no se les hace mención o cuadro de endpoint es porque se nombran en el environments pero no se consumen en ningun modulo de la aplicacion.

felimarod commented 4 months ago

Pruebas sobre la refactorización de la lógica en los indicadores de seguimiento: Comportamiento actual en pruebas:

Comportamiento actual en pruebas

Comportamiento con los ajustes realizados:

Comportamiento con los ajustes realizados

Se puede evidenciar que los resultados son los mismos en los indicadores y el comportamiento es el mismo

Nota: En un inicio se planteo "solucionar" los indicadores. Se investigó con Rony y la lógica esta correcta, el fallo puede ser por parte del usuario al no diferenciar los tipos de indicadores y sus diferencias respecto a las formulas y diferentes usos con respecto a numeradores y denominadores

a52290451 commented 4 months ago

Se finalizan pruebas unitarias: https://github.com/udistrital/planeacion_cliente/issues/1148

ccmendezt commented 4 months ago

Evidencias - Avance Salida a producción

09/07/2024 - 12:00

Sincronización Bases de Datos

Se eliminaron los registros asociados a planes de acción de inversión en la colección tipo-seguimiento. Se realizó el ejercicio de la migración en un entorno local ejecutando los scrips y se encontró que faltó un registro por añadir en el script MigracionDBMongo, concretamente se añadió un registro más en la colección _periodoseguimiento correspondiente a las fechas de formulación para el plan de acción 2024 cuyo periodo_id es 32 (id de la vigencia 2024 en producción).

ccmendezt commented 4 months ago

Evidencias - Avance Salida a producción

09/07/2024 - 15:05

Sincronización Bases de Datos

Se encontró un registro en base de datos que tiene la propiedad padre_plan_id: "" causando que NO se cargue correctamente la tabla de formulación desde el rol PLANEACION: image

El registro en cuestión es: image

Así que se actualizó el script de Migración de modelo de datos para quitar esa propiedad de los planes que la tienen en vacía con el siguiente código: image

- Script: 2-MigracionBDMongo.zip

milo19980525 commented 4 months ago

Se actualiza la solicitud de tuleap relacionada con DBAs (https://tuleap.portaloas.udistrital.edu.co/plugins/tracker/?aid=62092) con base en la reunión con funcionamiento el día 3 de julio y unos ajustes realizados en los scripts para que funcionen con la data de producción.

milo19980525 commented 3 months ago

Se actualiza la solicitud de tuleap relacionada con DBAs (https://tuleap.portaloas.udistrital.edu.co/plugins/tracker/?aid=62092) con base en la reunión con funcionamiento el día 3 de julio y unos ajustes realizados en los scripts para que funcionen con la data de producción.

Se actualiza KB nuevamente, dados ajustes uno de los scripts #1259

milo19980525 commented 3 months ago

Se actualiza la solicitud de tuleap relacionada con DBAs (https://tuleap.portaloas.udistrital.edu.co/plugins/tracker/?aid=62092) con base en la reunión con funcionamiento el día 3 de julio y unos ajustes realizados en los scripts para que funcionen con la data de producción.

Se actualiza KB nuevamente, dados ajustes uno de los scripts #1259

Se actualiza KB con el script de migración actualizado

milo19980525 commented 2 months ago

@a52290451 por favor indicar a quien se le entrega el avance actual de la verificación de parámetros por sincronizar en producción.

milo19980525 commented 2 months ago

Se despliega en producción el día 9 de septiembre