utn-cli 2.1.1 → 2.1.3

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/commands/frontend.js

@@ -42,7 +42,7 @@ export async function initFrontend() {
 
 export async function updateFrontend(opciones = { cerrarAlFinalizar: true }) {
   console.log('Actualizando el proyecto de frontend...');
-  const archivosAExcluir = ['app.routes.ts', 'contenedor-principal.component.ts', '.vscode', 'dist'];
+  const archivosAExcluir = ['app.routes.ts', 'contenedor-principal.component.ts', '.vscode', 'dist', 'Manual.md'];
   const directoriodePlantillas = path.join(__dirname, '../templates/frontend');
   const directorioDestino = process.cwd();
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "utn-cli",
-  "version": "2.1.1",
+  "version": "2.1.3",
   "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

@@ -209,6 +209,24 @@ Router.get('/obtenerDetalleDelModulo', async (solicitud, respuesta, next) => {
   }
 });
 
+Router.get('/VistaDelManual', async (solicitud, respuesta, next) => {
+  try {
+    if (await Miscelaneo.validarTokenV2(solicitud.headers.authorization) && await Miscelaneo.validarAccesoDelOrigen(solicitud)) {
+      try {
+        await Miscelaneo.registrarVistaDelManual(solicitud.headers.authorization);
+        return respuesta.json({ body: undefined, error: undefined });
+      } catch (error) {
+        const MensajeDeError = 'No fue posible registrar la vista del manual';
+        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('/obtenerDatosDelUsuario', async (solicitud, respuesta, next) => {
   try {
     if (await Miscelaneo.validarTokenV2(solicitud.headers.authorization) && await Miscelaneo.validarAccesoDelOrigen(solicitud)) {
@@ -486,6 +504,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 +812,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()
@@ -815,6 +880,14 @@ class Miscelaneo {
     });
   }
 
+  async registrarVistaDelManual(Token) {
+    const { uid } = await this.obtenerDatosDelUsuario(Token);
+    await ejecutarConsulta(
+      "INSERT INTO `DatosMiscelaneos` (`DatoMiscelaneo`, `Datos`, `LastUser`) VALUES ('VistasDelManual', JSON_OBJECT('Total', 1), ?) ON DUPLICATE KEY UPDATE `Datos` = JSON_SET(`Datos`, '$.Total', CAST(JSON_VALUE(`Datos`, '$.Total') AS UNSIGNED) + 1), `LastUser` = ?",
+      [uid, uid]
+    );
+  }
+
   async obtenerMensajesModulares() {
     return await ejecutarConsultaSIGU("SELECT `MensajeModularId`, `Titulo`, `Texto`, `FechaYHoraDeInicio`, `FechaYHoraDeFinalizacion` FROM  `SIGU`.`SIGU_MensajesModulares` WHERE NOW(4) BETWEEN `FechaYHoraDeInicio` AND `FechaYHoraDeFinalizacion` AND `Modulo` = ?"
       , [this.NombreCanonicoDelModulo]);
@@ -867,7 +940,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 +975,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 +989,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 +1446,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 +1538,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 +1563,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 +1606,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 {
@@ -1855,16 +1928,16 @@ class Miscelaneo {
       const informacionDelArchivo = await this.almacenarArchivoEnDisco(Solicitud, Resultado['uid']);
       const Respuesta = await ejecutarConsultaSIGU("INSERT INTO `SIGU`.`SIGU_Adjuntos` (`AdjuntosId`, `Identificador`, `Modulo`, `Seccion`, `Nombre`,\
         `NombreOriginal`, `Ruta`, `Tipo`, `Tamanio`, `Etiqueta`, `LastUpdate`, `LastUser`)\
-        VALUES (NULL, ?, ?, 'No aplica', ?, ?, ?, ?, ?, 'No aplica', NOW(4), ?)"
+        VALUES (NULL, ?, ?, 'No aplica', ?, ?, ?, ?, ?, ?, NOW(4), ?)"
         , [Resultado['uid'], this.NombreCanonicoDelModulo, informacionDelArchivo.nombreDeArchivo, informacionDelArchivo.nombreDeArchivo
           , informacionDelArchivo.rutaDeArchivo, informacionDelArchivo.tipoDeContenido, informacionDelArchivo.tamanioTotal
-          , Resultado['uid']]);
+          , Etiquetas, Resultado['uid']]);
       informacionDelArchivo.insertId = Respuesta.insertId;
       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 +2221,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 +2271,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 +2331,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 +2361,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 +2461,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 +2477,7 @@ class Miscelaneo {
         await new Promise(resolve => setTimeout(resolve, 5000));
       }
     }
+    this._archivoFuenteActual = null;
   }
 
   // async obtenerEnlaceDelModuloPadre() {
@@ -2414,6 +2494,92 @@ 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,
+      Descripcion: detalleDelModulo[0]?.Descripcion ?? configuracion.Descripcion,
+      Detalle: detalleDelModulo[0]?.Detalle ?? configuracion.Detalle,
+      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/backend/servicios/Nucleo/ReportePDF.js

@@ -661,7 +661,7 @@ class ReportePDF {
 
     // Función auxiliar para aplicar el formato y escribir el buffer
     const flushText = (token, isLast) => {
-      if (token === "") return;
+      if (!token) return;
 
       let fontName = this.config.fuenteBase;
       if (isBold && isItalic) fontName = this.config.fuenteNegritaCursiva;

package/templates/bd/docker-scripts/1-crear estructura.sql

@@ -37,3 +37,11 @@ CREATE OR REPLACE TABLE `NOMBRE_DEL_REPOSITORIO_DE_BASE_DE_DATOS`.`Configuracion
   `LastUser` VARCHAR(1000) NOT NULL DEFAULT '-' COMMENT 'Último usuario que modificó la fila',
   PRIMARY KEY (`Identificador`, `Titulo`)
 ) ENGINE = InnoDB DEFAULT CHARSET = utf8mb4 COLLATE = utf8mb4_spanish_ci COMMENT = 'Almacena la configuración de las tarjetas del contenedor principal por usuario';
+
+CREATE OR REPLACE TABLE `NOMBRE_DEL_REPOSITORIO_DE_BASE_DE_DATOS`.`DatosMiscelaneos` (
+  `DatoMiscelaneo` VARCHAR(200) NOT NULL COMMENT 'Nombre del datos misceláneo que se desea almacenar',
+  `Datos`      JSON NOT NULL COMMENT 'Configuración completa de la tarjeta: Tipo, Posición, Título, Descripción, Ícono, RutaASeguir, Rutas, ColorDeBorde, RequierePermisoExtra, Activo',
+  `LastUpdate` DATETIME(4) NOT NULL DEFAULT CURRENT_TIMESTAMP(4) ON UPDATE CURRENT_TIMESTAMP(4) COMMENT 'Fecha de la última actualización de la fila',
+  `LastUser`   VARCHAR(1000) NOT NULL DEFAULT '-' COMMENT 'Último usuario que modificó la fila',
+  PRIMARY KEY (`DatoMiscelaneo`)
+) ENGINE = InnoDB DEFAULT CHARSET = utf8mb4 COLLATE = utf8mb4_spanish_ci COMMENT = 'Datos misceláneos sobre el módulo';

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;