utn-cli 2.1.3 → 2.1.5

package/package.json

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

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

@@ -2528,7 +2528,7 @@ class Miscelaneo {
 
   async obtenerTarjetasDelContenedor(token) {
     const ConfiguracionDeTarjetas = require('./ConfiguracionDeTarjetas.js');
-    const Personas = require('../Personas.js');
+    // const Personas = require('../Personas.js');
     const path = require('path');
     const serviciosDir = path.join(__dirname, '..');
 
@@ -2536,7 +2536,7 @@ class Miscelaneo {
     const [tarjetas, configuracion, tienePermisoExtra] = await Promise.all([
       this.obtenerTarjetas(),
       ConfiguracionDeTarjetas.obtener({ Identificador: usuario.uid }),
-      Personas.PermisoExtra(token)
+      // Personas.PermisoExtra(token)
     ]);
 
     const cantidadesEntradas = await Promise.all(

package/templates/backend/servicios/Servicio1.js

@@ -9,6 +9,111 @@ class Servicio1 {
 
   RegistrarElServicio() {
     const NombreDelServicio = 'Servicio1';
+
+    // El segundo parámetro de RegistrarElServicio define la tarjeta (o tarjetas) que
+    // aparecerán en el dashboard del módulo. Puede ser un objeto o un arreglo de objetos.
+    // Si se omite, el servicio se registra sin crear ninguna tarjeta.
+    //
+    // Campos comunes a todos los tipos:
+    //   'Tipo'               — 'Única' | 'Múltiple' | 'Reporte' | 'Personalizada'
+    //   'Posición'           — Número entero; menor = aparece antes. Use múltiplos de 10.
+    //   'Título'             — Texto visible en la tarjeta del dashboard.
+    //   'Descripción'        — Texto secundario de la tarjeta.
+    //   'RequierePermisoExtra' — true: solo visible para usuarios con permiso extra.
+    //   'Activa'             — false: la tarjeta existe pero no se muestra.
+    //
+    // ── Tipo 'Única' ────────────────────────────────────────────────────────────────
+    // Tarjeta de acceso directo a una sola ruta.
+    //
+    // Miscelaneas.RegistrarElServicio(NombreDelServicio, {
+    //   'Tipo': 'Única',
+    //   'Posición': 10,
+    //   'Título': 'Mi sección',
+    //   'Descripción': 'Descripción breve de la sección',
+    //   'Ícono': 'settings',           // Nombre de ícono de Material Icons
+    //   'RutaASeguir': 'miRuta',       // Ruta relativa sin barra inicial
+    //   'ColorDeBorde': '#3498db',     // Opcional; omitir para color predeterminado
+    //   'RequierePermisoExtra': false,
+    //   'Activa': true
+    // });
+    //
+    // ── Tipo 'Múltiple' ──────────────────────────────────────────────────────────────
+    // Tarjeta de menú desplegable con varias opciones de navegación.
+    //
+    // Miscelaneas.RegistrarElServicio(NombreDelServicio, {
+    //   'Tipo': 'Múltiple',
+    //   'Posición': 20,
+    //   'Título': 'Mi sección',
+    //   'Descripción': 'Descripción breve de la sección',
+    //   'Rutas': [
+    //     { 'Nombre': 'Opción A', 'Ruta': 'tablaOpcionA' },
+    //     { 'Nombre': 'Opción B', 'Ruta': 'tablaOpcionB' },
+    //     { 'Nombre': 'Opción C', 'Ruta': 'tablaOpcionC' }
+    //   ],
+    //   'RequierePermisoExtra': false,
+    //   'Activa': true
+    // });
+    //
+    // ── Tipo 'Reporte' ───────────────────────────────────────────────────────────────
+    // Tarjeta que, al hacer clic, genera y descarga un reporte.
+    // El valor de 'ReporteAGenerar' debe coincidir con el identificador manejado
+    // en el método GenerarReporte() del componente ContenedorPrincipalComponent.
+    //
+    // Miscelaneas.RegistrarElServicio(NombreDelServicio, {
+    //   'Tipo': 'Reporte',
+    //   'Posición': 30,
+    //   'Título': 'Mi reporte',
+    //   'Descripción': 'Descarga el reporte de ejemplo en formato CSV',
+    //   'Ícono': 'download',
+    //   'ReporteAGenerar': 'ElReporte1', // Identificador del reporte en el frontend
+    //   'RequierePermisoExtra': false,
+    //   'Activa': true
+    // });
+    //
+    // ── Tipo 'Personalizada' ─────────────────────────────────────────────────────────
+    // Tarjeta que ejecuta una acción programada definida en el frontend.
+    // El valor de 'Acción' debe coincidir con el identificador manejado
+    // en el método EjecutarAccionPersonalizada() del componente ContenedorPrincipalComponent.
+    //
+    // Miscelaneas.RegistrarElServicio(NombreDelServicio, {
+    //   'Tipo': 'Personalizada',
+    //   'Posición': 40,
+    //   'Título': 'Mi acción',
+    //   'Descripción': 'Ejecuta una acción personalizada',
+    //   'Ícono': 'bolt',
+    //   'Etiqueta': 'Ejecutar',         // Texto del botón dentro de la tarjeta
+    //   'Acción': 'MiAccionPersonalizada', // Identificador de la acción en el frontend
+    //   'RequierePermisoExtra': false,
+    //   'Activa': true
+    // });
+    //
+    // ── Múltiples tarjetas a la vez ──────────────────────────────────────────────────
+    // El segundo parámetro también acepta un arreglo para registrar varias tarjetas
+    // en una sola llamada (útil cuando un servicio expone más de una sección).
+    //
+    // Miscelaneas.RegistrarElServicio(NombreDelServicio, [
+    //   {
+    //     'Tipo': 'Única',
+    //     'Posición': 10,
+    //     'Título': 'Sección A',
+    //     'Descripción': 'Descripción de la sección A',
+    //     'Ícono': 'dashboard',
+    //     'RutaASeguir': 'tablaSeccionA',
+    //     'RequierePermisoExtra': false,
+    //     'Activa': true
+    //   },
+    //   {
+    //     'Tipo': 'Única',
+    //     'Posición': 20,
+    //     'Título': 'Sección B',
+    //     'Descripción': 'Descripción de la sección B',
+    //     'Ícono': 'bar_chart',
+    //     'RutaASeguir': 'tablaSeccionB',
+    //     'RequierePermisoExtra': false,
+    //     'Activa': true
+    //   }
+    // ]);
+
     Miscelaneas.RegistrarElServicio(NombreDelServicio);
     console.log("Se ha creado el servicio: " + NombreDelServicio);
   }
@@ -39,8 +144,8 @@ class Servicio1 {
   //     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;
@@ -50,7 +155,7 @@ class Servicio1 {
   //   return await ejecutarConsulta("SELECT `BeneficioEstudiantilId`, `Nombre`, `Tipo`, `Estado` FROM `vve-bybe`.`BYBE_BeneficiosEstudiantiles`");
   // }
 
-//   // Ejemplo de listar con paginador
+  //   // Ejemplo de listar con paginador
   // async listar(Parametros) {
   //   let Resultados = undefined;
   //   let ORDERBY = "";
@@ -109,7 +214,7 @@ class Servicio1 {
   // async agergar(Datos) {
   //   return ejecutarConsulta("INSERT INTO `vve-bybe`.`BYBE_BeneficiosEstudiantiles` VALUES (NULL,\
   //       ?, ?, 'Activo', NOW(4), ?)"
-  //     , [Datos.Nombre, Datos.Tipo, Resultado.uid]);
+  //     , [Datos.Nombre, Datos.Tipo, Resultado.Identificador]);
   // }
 
   // async borrar(Datos) {
@@ -122,7 +227,7 @@ class Servicio1 {
   //       SET `Nombre` = ?, `Tipo` = ?, `Estado` = ?\
   //       , `LastUpdate` = NOW(4), `LastUser` = ?\
   //       WHERE `BeneficioEstudiantilId` = ?"
-  //     , [Datos.Nombre, Datos.Tipo, Datos.Estado, Resultado.uid, Datos.BeneficioEstudiantilId]);
+  //     , [Datos.Nombre, Datos.Tipo, Datos.Estado, Resultado.Identificador, Datos.BeneficioEstudiantilId]);
   // }
 
   // async detalle(BeneficioEstudiantilId) {