utn-cli 2.1.0 → 2.1.2

package/.claude/settings.local.json

@@ -0,0 +1,7 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(pandoc --version)"
+    ]
+  }
+}

package/commands/commit.js

@@ -20,6 +20,8 @@ export async function runCommit() {
     '¿Ya realizó el update de los módulos de UTN?',
     '¿Ya revisó la visualización en móvil?',
     '¿Ya hizo el stage de todos los cambios?',
+    '¿Ya hizo la actualización del manual?',
+    '¿Ya actualizó la función de monitoreo?',
     '¿El archivo app.routes.ts hace uso de la estrategia de "Lazy Loading"?'
   ];
 
@@ -29,8 +31,19 @@ export async function runCommit() {
     [preguntas[i], preguntas[j]] = [preguntas[j], preguntas[i]];
   }
 
+  const PREGUNTA_MANUAL = '¿Ya hizo la actualización del manual?';
+  const PROMPT_MANUAL = `Necesito actualizar el manual Manual.md que se encuentra en la carpeta public, en donde se aborden todas las secciones nuevas que se contemplan en el frontend, el nivel de detalle del manual debe de ser alto, ya que no va a contener imágenes para guiar al usuario en la forma de ejecutar las diferentes acciones, debe ser compatible con las reglas de accesibilidad y para que sea leío programas lectores de pantalla, en el archivo app.routes.ts están las rutas disponibles que se deben incluir en el manual omitiendo las que estén comentadas.`;
+
   for (const pregunta of preguntas) {
-    if (!await confirmarPaso(pregunta)) return closeReadLine();
+    if (!await confirmarPaso(pregunta)) {
+      if (pregunta === PREGUNTA_MANUAL) {
+        console.log('\nPuede usar el siguiente prompt con Claude para actualizar el manual:\n');
+        console.log('─'.repeat(60));
+        console.log(PROMPT_MANUAL);
+        console.log('─'.repeat(60));
+      }
+      return closeReadLine();
+    }
   }
 
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "utn-cli",
-  "version": "2.1.0",
+  "version": "2.1.2",
   "description": "Herramienta CLI unificada para la gestión de plantillas en SIGU.",
   "main": "index.js",
   "type": "module",

package/templates/backend/package.json

@@ -21,11 +21,11 @@
     "bcryptjs": "^2.4.3",
     "cors": "^2.8.6",
     "express": "^4.22.1",
-    "helmet": "^7.2.0",
     "google-auth-library": "^9.15.1",
+    "helmet": "^7.2.0",
     "jsonwebtoken": "^9.0.3",
-    "mysql2": "^3.20.0",
-    "nodemailer": "^8.0.5",
+    "mysql2": "^3.22.3",
+    "nodemailer": "^8.0.7",
     "pdf-lib": "^1.17.1",
     "pdfkit": "^0.15.2"
   }

package/templates/backend/rutas/misc.js

@@ -486,6 +486,23 @@ Router.get('/validarToken', async (solicitud, respuesta, next) => {
   return respuesta.json({ body: await Miscelaneo.validarTokenV2(solicitud.headers.authorization), error: undefined });
 });
 
+Router.get('/inicializar', async (solicitud, respuesta, next) => {
+  try {
+    if (await Miscelaneo.validarTokenV2(solicitud.headers.authorization) && await Miscelaneo.validarAccesoDelOrigen(solicitud)) {
+      try {
+        return respuesta.json({ body: await Miscelaneo.inicializar(solicitud), error: undefined });
+      } catch (error) {
+        const MensajeDeError = 'No fue posible inicializar el módulo';
+        console.error(new ManejadorDeErrores(MensajeDeError, ManejadorDeErrores.obtenerNumeroDeLinea(), true, `Dirección IP: ${solicitud.ip}`));
+        return respuesta.status(500).json({ body: undefined, error: MensajeDeError });
+      }
+    }
+    return respuesta.status(401).json({ body: undefined, error: ManejadorDeErrores.mensajeDeError401() });
+  } catch (error) {
+    next(error);
+  }
+});
+
 Router.get('/descargarArchivo/:ArchivoId', async (solicitud, respuesta, next) => {
   try {
     if (await Miscelaneo.validarTokenV2(solicitud.headers.authorization) && await Miscelaneo.validarAccesoDelOrigen(solicitud)) {
@@ -777,4 +794,38 @@ Router.get('/obtenerIdentificacion/:Identificador', async (solicitud, respuesta,
   }
 });
 
+Router.get('/obtenerTarjetasDelContenedor', async (solicitud, respuesta, next) => {
+  try {
+    if (await Miscelaneo.validarTokenV2(solicitud.headers.authorization) && await Miscelaneo.validarAccesoDelOrigen(solicitud)) {
+      try {
+        return respuesta.json({ body: await Miscelaneo.obtenerTarjetasDelContenedor(solicitud.headers.authorization), error: undefined });
+      } catch (error) {
+        const MensajeDeError = 'No fue posible obtener las tarjetas del contenedor';
+        console.error(new ManejadorDeErrores(MensajeDeError, ManejadorDeErrores.obtenerNumeroDeLinea(), true, `Dirección IP: ${solicitud.ip}`));
+        return respuesta.status(500).json({ body: undefined, error: MensajeDeError });
+      }
+    }
+    return respuesta.status(401).json({ body: undefined, error: ManejadorDeErrores.mensajeDeError401() });
+  } catch (error) {
+    next(error);
+  }
+});
+
+Router.get('/obtenerTarjetas', async (solicitud, respuesta, next) => {
+  try {
+    if (await Miscelaneo.validarTokenV2(solicitud.headers.authorization) && await Miscelaneo.validarAccesoDelOrigen(solicitud)) {
+      try {
+        return respuesta.json({ body: await Miscelaneo.obtenerTarjetas(), error: undefined });
+      } catch (error) {
+        const MensajeDeError = 'No fue posible obtener las tarjetas';
+        console.error(new ManejadorDeErrores(MensajeDeError, ManejadorDeErrores.obtenerNumeroDeLinea(), true, `Dirección IP: ${solicitud.ip}`));
+        return respuesta.status(500).json({ body: undefined, error: MensajeDeError });
+      }
+    }
+    return respuesta.status(401).json({ body: undefined, error: ManejadorDeErrores.mensajeDeError401() });
+  } catch (error) {
+    next(error);
+  }
+});
+
 module.exports = Router;

package/templates/backend/servicios/Nucleo/Miscelaneas.js

@@ -250,7 +250,8 @@ class Miscelaneo {
     }
   }
 
-  async RegistrarElServicio(Servicio) {
+  async RegistrarElServicio(Servicio, Tarjetas = null) {
+    const archivo = this._archivoFuenteActual;
     try {
       await ejecutarConsultaSIGU("REPLACE INTO `SIGU`.`SIGU_ModulosV2Secciones` (`Modulo`, `Descripcion`) VALUES (?, ?)"
         , [this.NombreCanonicoDelModulo, Servicio]);
@@ -258,6 +259,70 @@ class Miscelaneo {
     } catch (error) {
       console.error(error.message);
     }
+
+    if (!Tarjetas) return;
+
+    const listaTarjetas = Array.isArray(Tarjetas) ? Tarjetas : [Tarjetas];
+
+    for (const tarjeta of listaTarjetas) {
+      try {
+        const titulo = tarjeta['Título'];
+        const existentes = await ejecutarConsultaSIGU(
+          `SELECT CAST(JSON_VALUE(\`Datos\`, '$."Posición"') AS UNSIGNED) AS Posicion, JSON_VALUE(\`Datos\`, '$."Título"') AS Titulo, JSON_VALUE(\`Datos\`, '$."Descripción"') AS Descripcion FROM \`SIGU\`.\`ModulosV2Tarjetas\` WHERE \`Modulo\` = ? AND JSON_VALUE(\`Datos\`, '$."Título"') = ?`,
+          [this.NombreCanonicoDelModulo, titulo]
+        );
+
+        let datosFinales;
+        if (existentes.length > 0) {
+          datosFinales = { ...tarjeta, 'Posición': existentes[0].Posicion, 'Título': existentes[0].Titulo, 'Descripción': existentes[0].Descripcion, 'Archivo': archivo };
+          await ejecutarConsultaSIGU(
+            `UPDATE \`SIGU\`.\`ModulosV2Tarjetas\` SET \`Datos\` = ?, \`LastUser\` = 'Sistema' WHERE \`Modulo\` = ? AND JSON_VALUE(\`Datos\`, '$."Título"') = ?`,
+            [JSON.stringify(datosFinales), this.NombreCanonicoDelModulo, titulo]
+          );
+        } else {
+          let posicion = tarjeta['Posición'];
+          if (posicion === undefined) {
+            const [{ NuevaPosicion }] = await ejecutarConsultaSIGU(
+              `SELECT COALESCE(MAX(CAST(JSON_VALUE(\`Datos\`, '$."Posición"') AS UNSIGNED)), 0) + 10 AS NuevaPosicion FROM \`SIGU\`.\`ModulosV2Tarjetas\` WHERE \`Modulo\` = ?`,
+              [this.NombreCanonicoDelModulo]
+            );
+            posicion = NuevaPosicion;
+          }
+          datosFinales = { ...tarjeta, 'Posición': posicion, 'Archivo': archivo };
+          await ejecutarConsultaSIGU(
+            `INSERT INTO \`SIGU\`.\`ModulosV2Tarjetas\` (\`Modulo\`, \`Datos\`, \`LastUser\`) VALUES (?, ?, 'Sistema')`,
+            [this.NombreCanonicoDelModulo, JSON.stringify(datosFinales)]
+          );
+        }
+        console.log(`Tarjeta "${titulo}" registrada correctamente`);
+      } catch (error) {
+        console.error(`Error al registrar tarjeta "${tarjeta['Título']}":`, error.message);
+      }
+    }
+  }
+
+  _archivoFuenteActual = null;
+  _archivoCache = new Map();
+
+  _buscarArchivoRecursivo(dir, nombre) {
+    if (this._archivoCache.has(nombre)) return this._archivoCache.get(nombre);
+    const fs = require('fs');
+    const path = require('path');
+    const buscar = (directorio) => {
+      for (const entrada of fs.readdirSync(directorio, { withFileTypes: true })) {
+        const ruta = path.join(directorio, entrada.name);
+        if (entrada.isDirectory()) {
+          const resultado = buscar(ruta);
+          if (resultado) return resultado;
+        } else if (entrada.name === nombre) {
+          return ruta;
+        }
+      }
+      return null;
+    };
+    const resultado = buscar(dir);
+    this._archivoCache.set(nombre, resultado);
+    return resultado;
   }
 
   async DatosParaReporteCSV() {
@@ -381,7 +446,7 @@ class Miscelaneo {
     // }
     let LastUser = '';
     if (Resultado) {
-      LastUser = Resultado.uid;
+      LastUser = Resultado.Identificador;
     }
     LastUser = LastUser + '@' + Solicitud.headers.host.trim()
       + '@' + Solicitud.headers["user-agent"].trim()
@@ -867,7 +932,7 @@ class Miscelaneo {
       return;
     }
     const Permisos = await ejecutarConsultaSIGU("SELECT `PermisoId` FROM `SIGU`.`SIGU_PermisosPersonasV2` WHERE `Identificador` = ?"
-      , [Resultado.uid]);
+      , [Resultado.Identificador]);
     const Modulos = await ejecutarConsultaSIGU("SELECT `a`.`Nombre`, `a`.`Padre`, `a`.`Descripcion`, `a`.`Detalle`,\
         `a`.`Tipo`, IF(`a`.`Icono` <> '', CONCAT('https://storage.sigu.utn.ac.cr/images/cards/', `a`.`Icono`), '') AS `Icono`, `a`.`Color`, `a`.`Correo`,\
         `a`.`Version`, `a`.`FechaDePublicacion`, `a`.`AcuerdoDeNivelDeServicio`, `a`.`DiccionarioDeDatos`, `a`.`Repositorios`,\
@@ -902,7 +967,7 @@ class Miscelaneo {
       return;
     }
     return await ejecutarConsultaSIGU("UPDATE `SIGU`.`SIGU_NotificacionesV2` SET `Estado` = 'Leída' WHERE `Identificador` = ? AND `FechaYHoraDeCreacion` = ?"
-      , [Resultado.uid, FechaYHoraDeCreacion]);
+      , [Resultado.Identificador, FechaYHoraDeCreacion]);
   }
 
   async obtenerNotificaciones(Token) {
@@ -916,7 +981,7 @@ class Miscelaneo {
       console.log(error);
       return;
     }
-    return await ejecutarConsultaSIGU("SELECT `Notificacion` AS `valor`, CONCAT(`FechaYHoraDeCreacion`) AS `llave`, false AS `tachado` FROM `SIGU`.`SIGU_NotificacionesV2` WHERE `Identificador` = ? AND `Estado` = 'Sin leer' ORDER BY `FechaYHoraDeCreacion` DESC LIMIT 10", [Resultado.uid]);
+    return await ejecutarConsultaSIGU("SELECT `Notificacion` AS `valor`, CONCAT(`FechaYHoraDeCreacion`) AS `llave`, false AS `tachado` FROM `SIGU`.`SIGU_NotificacionesV2` WHERE `Identificador` = ? AND `Estado` = 'Sin leer' ORDER BY `FechaYHoraDeCreacion` DESC LIMIT 10", [Resultado.Identificador]);
   }
 
   async reporteDeIncidencia(Solicitud, Datos) {
@@ -1373,7 +1438,7 @@ class Miscelaneo {
       , `a`.`Nombre`, `a`.`PrimerApellido`, `a`.`SegundoApellido`\
       , (SELECT GROUP_CONCAT(`b`.`CuentaIBAN`) FROM `SIGU`.`SIGU_CuentasBancariasPersonas` `b` WHERE `b`.`Estado` = TRUE AND `a`.`Identificador` = `b`.`Identificador`) AS `CuentasIBAN`\
       FROM `SIGU`.`SIGU_Personas` `a` WHERE `a`.`Identificador` = ?"
-      , [Resultado.uid]);
+      , [Resultado.Identificador]);
   }
 
   async obtenerDatosDeLaPersonaPorIdentificacion(Identificacion) {
@@ -1465,7 +1530,7 @@ class Miscelaneo {
       Resultado.token = token;
       const DatosDeLaPersona = await ejecutarConsultaSIGU("SELECT `Identificacion`, `Nombre`, `PrimerApellido`,\
         `SegundoApellido`, CONCAT(`FechaNacimiento`) AS `FechaDeNacimiento`\
-        FROM `SIGU`.`SIGU_Personas` WHERE `Identificador` = ?", [Resultado.uid]);
+        FROM `SIGU`.`SIGU_Personas` WHERE `Identificador` = ?", [Resultado.Identificador]);
       Resultado.Identificacion = DatosDeLaPersona[0]['Identificacion'];
       Resultado.Nombre = DatosDeLaPersona[0]['Nombre'];
       Resultado.PrimerApellido = DatosDeLaPersona[0]['PrimerApellido'];
@@ -1490,16 +1555,16 @@ class Miscelaneo {
       try {
         // Validación del token en la sesión
         const tokenAlmacenado = await ejecutarConsultaSIGU("SELECT COUNT(*) AS `Total` FROM `SIGU`.`SIGU_Sesiones`\
-          WHERE `Identificador` = ? AND `Token` = ?", [Resultado.uid, Resultado.token]);
+          WHERE `Identificador` = ? AND `Token` = ?", [Resultado.Identificador, Resultado.token]);
         if (tokenAlmacenado[0]['Total'] >= 1) {
           // Validación de permisos
           const rolPermisoId = await this.permisoIdV2();
           const permisos = await ejecutarConsultaSIGU("SELECT COUNT(*) AS `Total` FROM `SIGU`.`SIGU_PermisosPersonasV2`\
-            WHERE `PermisoId` = ? AND `Identificador` = ?", [rolPermisoId, Resultado.uid]);
+            WHERE `PermisoId` = ? AND `Identificador` = ?", [rolPermisoId, Resultado.Identificador]);
           if (permisos[0]['Total'] === 1) {
             if (permisoExtraId) {
               const ValidacionPermisoExtra = await ejecutarConsultaSIGU("SELECT COUNT(*) AS `Total` FROM `SIGU`.`SIGU_PermisosExtraPersonasV2`\
-                WHERE `PermisoExtraId` = ? AND `Identificador` = ?", [permisoExtraId, Resultado.uid]);
+                WHERE `PermisoExtraId` = ? AND `Identificador` = ?", [permisoExtraId, Resultado.Identificador]);
               if (ValidacionPermisoExtra[0]['Total'] === 1) {
                 return true;
               }
@@ -1533,13 +1598,13 @@ class Miscelaneo {
     //   try {
     //     // Validación del token en la sesión
     //     const tokenAlmacenado = await ejecutarConsultaSIGU("SELECT COUNT(*) AS `Total` FROM `SIGU`.`SIGU_Sesiones`\
-    //       WHERE `Identificador` = ? AND `Token` = ?", [Resultado.uid, Resultado.token]);
+    //       WHERE `Identificador` = ? AND `Token` = ?", [Resultado.Identificador, Resultado.token]);
     //     if (tokenAlmacenado[0]['Total'] >= 1) { // Se compara con >= para preveer multisesiones
     //       // Validación de permisos
     //       const perfilGeneralId = await this.perfilGeneralId();
     //       const rolPermisoId = await this.rolPermisoIdDelModulo();
     //       const permisos = await ejecutarConsultaSIGU("SELECT COUNT(*) AS `Total` FROM `SIGU`.`SIGU_RolesPersonas`\
-    //         WHERE `RolPermisoId` = ? AND `Identificador` = ? AND `PerfilGeneralId` = ?", [rolPermisoId, Resultado.uid, perfilGeneralId]);
+    //         WHERE `RolPermisoId` = ? AND `Identificador` = ? AND `PerfilGeneralId` = ?", [rolPermisoId, Resultado.Identificador, perfilGeneralId]);
     //       if (permisos[0]['Total'] === 1) {
     //         return true;
     //       } else {
@@ -1863,8 +1928,8 @@ class Miscelaneo {
       informacionDelArchivo.Etiquetas = Etiquetas;
       await ejecutarConsulta("INSERT INTO `" + this.NombreDelRepositorioDeLaBaseDeDatos.slice(0, -3) + "`.`Archivos`\
         VALUES (?, ?, ?, ?, ?, NOW(4), ?)"
-        , [Respuesta.insertId, Resultado.uid, informacionDelArchivo.rutaDeArchivo, informacionDelArchivo.nombreDeArchivo
-          , Etiquetas, Resultado.uid]);
+        , [Respuesta.insertId, Resultado.Identificador, informacionDelArchivo.rutaDeArchivo, informacionDelArchivo.nombreDeArchivo
+          , Etiquetas, Resultado.Identificador]);
       return informacionDelArchivo;
     }
     return;
@@ -2148,7 +2213,7 @@ class Miscelaneo {
     let Token = undefined;
     if (this.NombresParalocalhost().includes(process.env.HOST) && (typeof process.env.DB_HOST_SIGU === "undefined")) {
       const jwt = require('jsonwebtoken');
-      Token = await jwt.sign({ uid: Identificador }, await this.palabraSecretaParaTokens(), { expiresIn: '10h' });
+      Token = await jwt.sign({ uid: Identificador, Identificador }, await this.palabraSecretaParaTokens(), { expiresIn: '10h' });
       await ejecutarConsultaSIGU("DELETE FROM `SIGU`.`SIGU_Sesiones` WHERE `Identificador` = ?", [Identificador]);
       await ejecutarConsultaSIGU("INSERT INTO `SIGU`.`SIGU_Sesiones` VALUES (?, 'Backend', ?, NOW(4), USER())", [Identificador, Token]);
     }
@@ -2198,7 +2263,7 @@ class Miscelaneo {
       return await ejecutarConsulta("SELECT `ArchivoId`, `Identificador`, `Ruta`, CONCAT(`Nombre`, ' (', DATE_FORMAT(`LastUpdate`, '%Y-%M-%d %H:%i'), ')') AS `Nombre`, `Etiquetas`\
         FROM `" + this.NombreDelRepositorioDeLaBaseDeDatos.slice(0, -3) + "`.`Archivos`\
         WHERE `Identificador` = ? AND `Etiquetas` = ?"
-        , [Resultado.uid, Etiquetas]);
+        , [Resultado.Identificador, Etiquetas]);
     }
     if (ultimaParte === 'Servicio') {
       return await ejecutarConsulta("SELECT `ArchivoId`, `Identificador`, `Ruta`, CONCAT(`Nombre`, ' (', DATE_FORMAT(`LastUpdate`, '%Y-%M-%d %H:%i'), ')') AS `Nombre`, `Etiquetas`\
@@ -2258,14 +2323,14 @@ class Miscelaneo {
     const Archivo = await ejecutarConsulta("SELECT `Ruta`\
       FROM `" + this.NombreDelRepositorioDeLaBaseDeDatos.slice(0, -3) + "`.`Archivos`\
       WHERE `Identificador` = ? AND `ArchivoId` = ?"
-      , [Resultado.uid, Datos.ArchivoId]);
+      , [Resultado.Identificador, Datos.ArchivoId]);
     fs.unlinkSync(Archivo[0]['Ruta']);
     await ejecutarConsulta("DELETE FROM `" + this.NombreDelRepositorioDeLaBaseDeDatos.slice(0, -3) + "`.`Archivos`\
       WHERE `Identificador` = ? AND `ArchivoId` = ?"
-      , [Resultado.uid, Datos.ArchivoId]);
+      , [Resultado.Identificador, Datos.ArchivoId]);
     await ejecutarConsultaSIGU("DELETE FROM `SIGU`.`SIGU_Adjuntos`\
       WHERE `Identificador` = ? AND `AdjuntosId` = ?"
-      , [Resultado.uid, Datos.ArchivoId]);
+      , [Resultado.Identificador, Datos.ArchivoId]);
     return;
   }
 
@@ -2288,7 +2353,7 @@ class Miscelaneo {
       RutaDelArchivo = await ejecutarConsulta("SELECT `Ruta`\
           FROM `" + this.NombreDelRepositorioDeLaBaseDeDatos.slice(0, -3) + "`.`Archivos`\
           WHERE `Identificador` = ? AND `ArchivoId` = ?"
-        , [Resultado.uid, ArchivoId]);
+        , [Resultado.Identificador, ArchivoId]);
     }
     if (ultimaParte === 'Servicio') {
       RutaDelArchivo = await ejecutarConsulta("SELECT `Ruta`\
@@ -2388,8 +2453,14 @@ class Miscelaneo {
   }
 
   async ejecucionDiferida(callback) {
+    const stackLines = new Error().stack.split('\n');
+    const lineaCaller = stackLines[2] ?? '';
+    const match = lineaCaller.match(/\((.+?):\d+:\d+\)/) ?? lineaCaller.match(/at (.+?):\d+:\d+/);
+    const archivo = match ? require('path').basename(match[1]) : null;
+
     while (true) {
       try {
+        this._archivoFuenteActual = archivo;
         await callback();
         break;
       } catch (error) {
@@ -2398,6 +2469,7 @@ class Miscelaneo {
         await new Promise(resolve => setTimeout(resolve, 5000));
       }
     }
+    this._archivoFuenteActual = null;
   }
 
   // async obtenerEnlaceDelModuloPadre() {
@@ -2414,6 +2486,90 @@ class Miscelaneo {
   async obtenerEnlaceDePerfil() {
     return this.EnlaceDePerfil;
   }
+
+  async obtenerTarjetas() {
+    const resultados = await ejecutarConsultaSIGU(
+      "SELECT `Datos` FROM `SIGU`.`ModulosV2Tarjetas` WHERE `Modulo` = ? AND JSON_EXTRACT(`Datos`, '$.Activa') = TRUE",
+      [this.NombreCanonicoDelModulo]
+    );
+    return resultados.map(fila => typeof fila.Datos === 'string' ? JSON.parse(fila.Datos) : fila.Datos);
+  }
+
+  async inicializar(solicitud) {
+    const ConsentimientoInformado = require('./ConsentimientoInformado.js');
+    const LastUser = await this.generarLastUser(solicitud);
+    const [configuracion, detalleDelModulo, notificaciones, mensajesModulares, consentimiento] = await Promise.all([
+      this.configurarFrontend(solicitud.headers.authorization),
+      this.obtenerDetalleDelModulo(),
+      this.obtenerNotificaciones(solicitud.headers.authorization),
+      this.obtenerMensajesModulares(),
+      ConsentimientoInformado.ConsentimientoInformado({ LastUser })
+    ]);
+    return {
+      TienePermiso: true,
+      ...configuracion,
+      EnlaceDelManual: detalleDelModulo[0]?.EnlaceDelManual ?? '-',
+      EnlaceDelVideo: detalleDelModulo[0]?.EnlaceDelVideo ?? '-',
+      Notificaciones: notificaciones,
+      MensajesModulares: mensajesModulares,
+      Consentimiento: consentimiento
+    };
+  }
+
+  async obtenerTarjetasDelContenedor(token) {
+    const ConfiguracionDeTarjetas = require('./ConfiguracionDeTarjetas.js');
+    const Personas = require('../Personas.js');
+    const path = require('path');
+    const serviciosDir = path.join(__dirname, '..');
+
+    const usuario = await this.obtenerDatosDelUsuario(token);
+    const [tarjetas, configuracion, tienePermisoExtra] = await Promise.all([
+      this.obtenerTarjetas(),
+      ConfiguracionDeTarjetas.obtener({ Identificador: usuario.uid }),
+      Personas.PermisoExtra(token)
+    ]);
+
+    const cantidadesEntradas = await Promise.all(
+      tarjetas
+        .filter(t => t.Archivo)
+        .map(async t => {
+          try {
+            const rutaArchivo = this._buscarArchivoRecursivo(serviciosDir, t.Archivo);
+            if (!rutaArchivo) return null;
+            const servicio = require(rutaArchivo);
+            if (typeof servicio.Cantidades !== 'function') return null;
+            const cantidades = await servicio.Cantidades(token);
+            return [t['Título'], cantidades];
+          } catch { return null; }
+        })
+    );
+
+    const cantidadesPorTitulo = Object.fromEntries(cantidadesEntradas.filter(Boolean));
+
+    const titulosAExcluir = new Set(
+      Object.entries(cantidadesPorTitulo)
+        .filter(([, c]) => !(c.cantidadMaxima > 0))
+        .map(([titulo]) => titulo)
+    );
+
+    return tarjetas
+      .filter(t => !t.RequierePermisoExtra || tienePermisoExtra)
+      .filter(t => !titulosAExcluir.has(t['Título']))
+      .map(t => {
+        const config = configuracion.find(c => c.Titulo === t['Título']);
+        if (config) {
+          t['Posición'] = config.Posicion;
+          if (config.ColorDeBorde) t.ColorDeBorde = config.ColorDeBorde;
+        }
+        const cantidades = cantidadesPorTitulo[t['Título']];
+        if (cantidades) {
+          t['Cantidad'] = cantidades.cantidad;
+          t['CantidadMaxima'] = cantidades.cantidadMaxima;
+        }
+        return t;
+      })
+      .sort((a, b) => a['Posición'] - b['Posición']);
+  }
 }
 
 module.exports = new Miscelaneo();

package/templates/frontend/package.json

@@ -16,22 +16,23 @@
     "@angular/common": "^21.0.0",
     "@angular/compiler": "^21.0.0",
     "@angular/core": "^21.0.0",
-    "@angular/forms": "^21.2.8",
-    "@angular/material": "^21.2.5",
+    "@angular/forms": "^21.2.11",
+    "@angular/material": "^21.2.9",
     "@angular/platform-browser": "^21.0.0",
-    "@angular/platform-browser-dynamic": "^21.2.8",
-    "@angular/router": "^21.2.8",
+    "@angular/platform-browser-dynamic": "^21.2.11",
+    "@angular/router": "^21.2.11",
     "chart.js": "^4.5.1",
+    "marked": "^18.0.3",
     "ng2-charts": "^8.0.0",
     "rxjs": "~7.8.0",
     "tslib": "^2.3.0",
     "zone.js": "^0.16.1"
   },
   "devDependencies": {
-    "@angular-devkit/build-angular": "^21.2.7",
+    "@angular-devkit/build-angular": "^21.2.9",
     "@angular/build": "^21.0.3",
-    "@angular/cli": "^21.2.7",
-    "@angular/compiler-cli": "^21.2.8",
+    "@angular/cli": "^21.2.9",
+    "@angular/compiler-cli": "^21.2.11",
     "@types/jasmine": "^5.1.15",
     "jasmine-core": "^5.13.0",
     "jsdom": "^27.4.0",
@@ -41,6 +42,6 @@
     "karma-jasmine": "^5.1.0",
     "karma-jasmine-html-reporter": "^2.2.0",
     "typescript": "~5.9.2",
-    "vitest": "^4.1.3"
+    "vitest": "^4.1.5"
   }
 }

package/templates/frontend/public/Manual.md

@@ -0,0 +1 @@
+# Manual de Usuario — Módulo de Mantenimientos V2

package/templates/frontend/src/app/Componentes/Nucleo/gestion-actividad/gestion-actividad.component.ts

@@ -1,4 +1,4 @@
-import { Component, OnInit } from '@angular/core';
+import { Component, OnDestroy, OnInit } from '@angular/core';
 import { CommonModule } from '@angular/common';
 import { HttpClient } from '@angular/common/http';
 import { MatIconModule } from '@angular/material/icon';
@@ -8,6 +8,8 @@ import { MatButtonModule } from '@angular/material/button';
 import { MatDialog } from '@angular/material/dialog';
 import { MensajeConfirmacionComponent } from '../mensaje-confirmacion/mensaje-confirmacion';
 import { DatosGlobalesService } from '../../../datos-globales.service';
+import { Subject } from 'rxjs';
+import { takeUntil } from 'rxjs/operators';
 
 @Component({
   selector: 'app-gestion-actividad',
@@ -16,10 +18,11 @@ import { DatosGlobalesService } from '../../../datos-globales.service';
   templateUrl: './gestion-actividad.component.html',
   styleUrls: ['./gestion-actividad.component.css']
 })
-export class GestionActividadComponent implements OnInit {
+export class GestionActividadComponent implements OnInit, OnDestroy {
   public actividad: any[] = [];
   public cargando = false;
   private tokenActual = '';
+  private _destroy$ = new Subject<void>();
 
   constructor(private http: HttpClient, private datosGlobalesService: DatosGlobalesService, private dialog: MatDialog) { }
 
@@ -30,7 +33,7 @@ export class GestionActividadComponent implements OnInit {
 
   obtenerActividad(): void {
     this.cargando = true;
-    this.http.get(`${this.datosGlobalesService.ObtenerURL()}misc/ListarActividades`).subscribe({
+    this.http.get(`${this.datosGlobalesService.ObtenerURL()}misc/ListarActividades`).pipe(takeUntil(this._destroy$)).subscribe({
       next: (datos: any) => {
         this.actividad = datos.body;
       },
@@ -69,6 +72,11 @@ export class GestionActividadComponent implements OnInit {
       },
     });
   }
+  ngOnDestroy(): void {
+    this._destroy$.next();
+    this._destroy$.complete();
+  }
+
   esSesionActual(token: string): boolean {
 
     return token === this.tokenActual;

package/templates/frontend/src/app/Componentes/Nucleo/graficos/graficos.component.ts

@@ -1,4 +1,4 @@
-import { Component, Input } from '@angular/core';
+import { Component, Input, OnChanges } from '@angular/core';
 import { BaseChartDirective } from 'ng2-charts';
 import { ChartConfiguration, ChartData, Plugin } from 'chart.js';
 
@@ -9,7 +9,7 @@ import { ChartConfiguration, ChartData, Plugin } from 'chart.js';
   templateUrl: './graficos.component.html',
   styleUrl: './graficos.component.css'
 })
-export class GraficosComponent {
+export class GraficosComponent implements OnChanges {
 
   @Input() public TipoDeGrafico: string = '';
   @Input() public Datos: any[] = [];
@@ -162,8 +162,6 @@ export class GraficosComponent {
     }
   };
 
-  constructor() { }
-
   ngOnChanges() {
 
     // ✅ Si no hay datos, limpia todo para evitar gráficos raros