utn-cli 1.0.0

package/templates/backend/server.js

@@ -0,0 +1,79 @@
+Error.stackTraceLimit = Infinity;
+const express = require('express');
+const helmet = require('helmet');
+const cors = require('cors');
+const Miscelaneo = require('./servicios/Nucleo/Miscelaneas.js');
+
+const asignarRutasAExpress = require('./rutas/rutas.js');
+
+const app = express();
+app.use(express.json());
+app.use(helmet());
+app.use(async (solicitud, respuesta, next) => {
+  const safeReqData = {
+    timestamp: new Date().toISOString(),
+    httpVersion: solicitud.httpVersion,
+    method: solicitud.method,
+    protocol: solicitud.protocol,
+    secure: solicitud.secure,
+    ip: solicitud.ip,
+    ips: solicitud.ips,
+    hostname: solicitud.hostname,
+    originalUrl: solicitud.originalUrl,
+    baseUrl: solicitud.baseUrl,
+    path: solicitud.path,
+    url: solicitud.url,
+    headers: solicitud.headers,
+    query: solicitud.query,
+    params: solicitud.params,
+    body: solicitud.body,
+    cookies: solicitud.cookies,
+    signedCookies: solicitud.signedCookies,
+    userAgent: solicitud.get('User-Agent'),
+    authUser: solicitud.user ?? null,
+  };
+  try {
+    const { ejecutarConsultaSIGU } = require('./servicios/Nucleo/db.js');
+    const sql = 'INSERT IGNORE `SIGU`.`SIGU_BitacoraDeSolicitudes` (`Solicitud`) VALUES (?)';
+    await ejecutarConsultaSIGU(sql, [JSON.stringify(safeReqData)]);
+  } catch (error) {
+    console.error('Error al guardar el log de la solicitud:', error);
+  }
+  next();
+});
+app.use((solicitud, respuesta, next) => {
+  const origin = solicitud.get("Origin");
+  if (!origin) {
+    return respuesta.status(403).json({ error: "Acceso denegado: Origin no proporcionado" });
+  }
+  next();
+});
+app.use(cors({
+  credentials: true,
+  origin: [/localhost(:\d+)?$/, /\.181\.193\.85\.44\.nip\.io$/, /\.sigu\.utn\.ac\.cr.*$/]
+}));
+
+// Esta función se debe llamar cada vez que inicia el backend
+// Ya que no sólo registra el módulo en el SIGU, sino que determina el rol y permisos a utilizar
+Miscelaneo.registroDelModuloEnSIGU();
+
+asignarRutasAExpress(app);
+
+app.use((error, solicitud, respuesta, next) => {
+  const { envioDeCorreo } = require('./servicios/Nucleo/EnvioDeCorreos.js');
+  envioDeCorreo(process.env.DESTINATARIODEINFORMESDEERROR, 'Informe de error desde: ' + process.env.NOMBRECANONICODELMODULO, error.stack);
+  console.error(error.stack);
+  respuesta.status(500).send('Error interno del servidor, el detalle del mismo fue enviado a ' + process.env.DESTINATARIODEINFORMESDEERROR);
+});
+// process.on('uncaughtException', (err) => {
+//   console.error('Excepción no capturada:', err);
+// });
+
+// process.on('unhandledRejection', (reason, promise) => {
+//   console.error('Promesa no manejada:', reason);
+// });
+
+const servidor = app.listen(process.env.PORT || 80, () => {
+  process.env.HOST = servidor.address().address;
+  console.log('NOMBRE_DEL_REPOSITORIO_DE_BACKEND');
+});

package/templates/backend/servicios/API.js

@@ -0,0 +1,101 @@
+const Miscelaneo = require('./../servicios/Nucleo/Miscelaneas.js');
+
+class API {
+
+  constructor() {
+
+  };
+
+  // async cursosPorPersonaAnioYPeriodo(Cuerpo) {
+  //   let URL = undefined;
+  //   switch (process.env.ENV) {
+  //     case 'desarrollo':
+  //       URL = 'http://dru-matri-s-backend-desarrollo.181.193.85.44.nip.io';
+  //       break;
+  //     case 'calidad':
+  //       URL = 'http://dru-matri-s-backend-calidad.181.193.85.44.nip.io';
+  //       break;
+  //     case 'pruebas':
+  //       URL = 'http://dru-matri-s-backend-pruebas.181.193.85.44.nip.io';
+  //       break;
+  //     case 'production':
+  //       URL = 'https://dru-matri-s-backend.sigu.utn.ac.cr';
+  //       break;
+  //     default:
+  //       URL = 'http://localhost:82';
+  //   }
+  //   URL += '/api/cursosPorPersonaAnioYPeriodo';
+  //   return await Miscelaneo.consumirBackend(URL, Cuerpo);
+  // };
+
+  // async obtenerOfertaAcademica(PeriodoId) {
+  //   let URL = undefined;
+  //   switch (process.env.ENV) {
+  //     case 'desarrollo':
+  //       URL = 'http://vdoc-trabajoacademico-p-backend-desarrollo.181.193.85.44.nip.io';
+  //       break;
+  //     case 'calidad':
+  //       URL = 'http://vdoc-trabajoacademico-p-backend-calidad.181.193.85.44.nip.io';
+  //       break;
+  //     case 'pruebas':
+  //       URL = 'http://vdoc-trabajoacademico-p-backend-pruebas.181.193.85.44.nip.io';
+  //       break;
+  //     case 'production':
+  //       URL = 'https://vdoc-trabajoacademico-p-backend.sigu.utn.ac.cr';
+  //       break;
+  //     default:
+  //       URL = 'http://localhost:3120';
+  //   }
+  //   URL += '/api/obtenerOfertaAcademica/' + PeriodoId;
+
+  //   let OfertaAcademica = await Miscelaneo.consumirBackend(URL);
+  //   let Materias = await this.obtenerMaterias();
+  //   return OfertaAcademica.map((item, i) => Object.assign({}, item, Materias[i]));
+  // };
+
+  // async obtenerMaterias() {
+  //   let URL = undefined;
+  //   switch (process.env.ENV) {
+  //     case 'desarrollo':
+  //       URL = 'http://dgdh-djur-s-backend-desarrollo.181.193.85.44.nip.io';
+  //       break;
+  //     case 'calidad':
+  //       URL = 'http://dgdh-djur-s-backend-calidad.181.193.85.44.nip.io';
+  //       break;
+  //     case 'pruebas':
+  //       URL = 'http://dgdh-djur-s-backend-pruebas.181.193.85.44.nip.io';
+  //       break;
+  //     case 'production':
+  //       URL = 'https://dgdh-djur-s-backend.sigu.utn.ac.cr';
+  //       break;
+  //     default:
+  //       URL = 'http://localhost:3119';
+  //   }
+  //   URL += '/api/obtenerMaterias';
+  //   return await Miscelaneo.consumirBackend(URL);
+  // };
+
+  // async obtenerCarreras() {
+  //   let URL = undefined;
+  //   switch (process.env.ENV) {
+  //     case 'desarrollo':
+  //       URL = 'http://dgdh-djur-s-backend-desarrollo.181.193.85.44.nip.io';
+  //       break;
+  //     case 'calidad':
+  //       URL = 'http://dgdh-djur-s-backend-calidad.181.193.85.44.nip.io';
+  //       break;
+  //     case 'pruebas':
+  //       URL = 'http://dgdh-djur-s-backend-pruebas.181.193.85.44.nip.io';
+  //       break;
+  //     case 'production':
+  //       URL = 'https://dgdh-djur-s-backend.sigu.utn.ac.cr';
+  //       break;
+  //     default:
+  //       URL = 'http://localhost:3119';
+  //   }
+  //   URL += '/api/obtenerCarreras';
+  //   return await Miscelaneo.consumirBackend(URL);
+  // };
+}
+
+module.exports = new API();

package/templates/backend/servicios/InformacionDelModulo.js

@@ -0,0 +1,70 @@
+class InformacionDelModulo {
+
+  constructor() {
+  };
+
+  getNombreDelModulo() {
+    return 'NOMBRE_DEL_PROYECTO';
+  };
+  getDescripcionDelModulo() {
+    return 'DESCRIPCION_DEL_PROYECTO';
+  };
+  getDetalleDelModulo() {
+    return 'DETALLE_DEL_PROYECTO';
+  };
+  getNombreCanonicoDelModulo() {
+    return 'NOMBRE_DEL_CANONICO_DEL_PROYECTO';
+  };
+  getTipoDeCard() {
+    return 'TIPO_DE_TARJETA';
+  };
+  getNombreDelRol() {
+    return 'NOMBRE_DEL_ROL';
+  };
+  getNombreDelRepositorioDeLaBaseDeDatos() {
+    return 'NOMBRE_DEL_REPOSITORIO_DE_BASE_DE_DATOS';
+  };
+  getNombreDelRepositorioDelBackend() {
+    return 'NOMBRE_DEL_REPOSITORIO_DE_BACKEND';
+  };
+  getNombreDelRepositorioDelFrontend() {
+    return 'NOMBRE_DEL_REPOSITORIO_DE_FRONTEND';
+  };
+  getNombreDelPermiso() {
+    return 'NOMBRE_DEL_PERMISO';
+  };
+  getDescripcionDelPermiso() {
+    return 'DESCRIPCION_DEL_PERMISO';
+  };
+  getMenuPadre() {
+    // MenuPadre hace referencia al NombreCanonicoDelModulo del menú padre
+    // Éste debe existir de lo contrario el registro fallará
+    return 'MENU_PADRE';
+  };
+  getBackEndsQueConsumeEsteModulo() {
+    // BackEndsQueConsumeEsteModulo es un arreglo de strings de la forma ['dgf-presup-modifica-p-back', 'dpu-pide-p-back']
+    // Se debe poner el nombre del repositorio de backend que se necesita consumir
+    // Los repositorios ya deben estar registrados en SIGU o de lo contrario el proceso fallará
+    return [BACKENDS_QUE_CONSUME_ESTE_MODULO];
+  };
+  getPerfilGeneral() {
+    // Si no sabe qué poner, puede dejar Servidor
+    return 'Servidor';
+  };
+  getUsuariosConAccesoInicial() {
+    // UsuariosConAccesoInicial es un arreglo de strings de la forma ['111050570', '111050570']
+    // Este arreglo se usa para asignar acceso a este móudlo, suelen usarse la cédulas de los encargados del proyecto y el desarrollador
+    return ['111050570', '204540859', '602990078', '109840817', '206860639', '155821845336', 'CEDULA_DEL_DESARROLLADOR'];
+  };
+  getColorDelModulo() {
+    return 'COLOR_DEL_MODULO';
+  };
+  getCorreoParaReportes() {
+    return 'CORRECO_PARA_REPORTES';
+  };
+  getVersion() {
+    return 'VERSION';
+  };
+}
+
+module.exports = new InformacionDelModulo();

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

@@ -0,0 +1,45 @@
+const nodemailer = require('nodemailer');
+
+function envioDeCorreo(Destinatario, Asunto, MensajeEnHTML, rutasDelosAdjuntos = undefined) {
+
+  const Transportador = nodemailer.createTransport({
+    host: process.env.SERVIDORSMTP,
+    port: process.env.PUERTOSMTP,
+    secure: false,
+    auth: {
+      user: process.env.USUARIOSMTP,
+      pass: process.env.CLAVESMTP
+    },
+    tls: {
+      rejectUnauthorized: false,
+    }
+  });
+  const Correo = {
+    from: process.env.USUARIOSMTP,
+    to: Destinatario,
+    subject: Asunto,
+    html: MensajeEnHTML
+  };
+  Transportador.verify(function (error, success) {
+    if (error) {
+      console.error(`Error en el servicio de correo: ${error}`);
+    }
+  });
+  if (rutasDelosAdjuntos) {
+    const Adjuntos = [];
+    rutasDelosAdjuntos.forEach((archivo) => {
+      const Adjunto = {
+        "path": archivo
+      };
+      Adjuntos.push(Adjunto);
+    });
+    Correo.attachments = Adjuntos;
+  }
+  Transportador.sendMail(Correo, function(error, info){
+    if (error){
+      console.error(`No fue posible enviar el correo debido al error: ${error}`);
+    }
+  });
+}
+
+module.exports = { envioDeCorreo };

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

@@ -0,0 +1,54 @@
+const { envioDeCorreo } = require('./EnvioDeCorreos.js');
+
+class ManejadorDeErrores extends Error {
+
+  constructor(descripcionDelError, numeroDeLinea, informarError = true, informacionExtra = undefined) {
+    super(descripcionDelError);
+    Object.setPrototypeOf(this, new.target.prototype);
+    Error.captureStackTrace(this, this.constructor);
+    console.error(descripcionDelError + numeroDeLinea);
+    if (informarError && process.env.ENV === 'production') {
+      envioDeCorreo(process.env.DESTINATARIODEINFORMESDEERROR, 'Informe de error desde: ' + process.env.NOMBRECANONICODELMODULO
+        , descripcionDelError + ' ' + numeroDeLinea + '<BR /><BR />' + informacionExtra);
+    }
+  };
+
+  static obtenerNumeroDeLinea() {
+    const error = new Error();
+    return error.stack.split("\n")[2];
+  }
+
+  static mensajeDeError401() {
+    return "No está autorizado para consultar los datos";
+  }
+
+  static mensajeDeErrorAccesoAAPI(InformacionExtra = undefined) {
+    if (InformacionExtra) {
+      return `No fue posible obtener los datos del backend destino. ${InformacionExtra}`;
+    } else {
+      return "No fue posible obtener los datos del backend destino";
+    }
+  }
+
+  static mensajeDeErrorEncabezadoDeAutorizacion() {
+    return "No fue posible determinar el identificacdor o token en el encabezado de autorización";
+  }
+
+  static mensajeDeErrorVerificacionDeToken() {
+    return "No fue posible verificar el token";
+  }
+
+  static mensajeDeErrorTokenInvalido() {
+    return "Token inválido";
+  }
+
+  static mensajeDeErrorPermisosInsuficientes() {
+    return "No tiene permisos para acceder al recurso solicitado";
+  }
+
+  static mensajeDeErrorRepositorioOrigen() {
+    return "No fue posible determinar el nombre del repositorio origen o su identificador";
+  }
+}
+
+module.exports = ManejadorDeErrores;