chore: actualizar develop

.github/workflows/on-pr.yaml

@@ -6,6 +6,7 @@ on:
       - main
       - staging
       - develop
+      - MBI-1
 
 jobs:
   lint:
@@ -18,7 +19,7 @@ jobs:
       - name: Set up Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: "22.14"
+          node-version: '22.14'
 
       - name: Install dependencies
         run: npm install
@@ -35,7 +36,7 @@ jobs:
       - name: Set up Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: "22.14"
+          node-version: '22.14'
 
       - name: Install dependencies
         run: npm install

Categorias/Controladores/actualizarCategoria.controller.js

@@ -0,0 +1,44 @@
+const { actualizarCategoria } = require('@altertex/cat/repos/repositorioActualizarCategorias');
+const MENSAJES = require('@altertex/util/const/mensajesCategorias');
+
+/**
+ * RF49 - Actualizar categoría de productos - https://codeandco-wiki.netlify.app/docs/proyectos/textiles/documentacion/requisitos/RF49
+ *
+ * @param {express.Request} req
+ * @param {express.Response} res
+ * @returns {Promise<void>}
+ */
+exports.actualizarCategoria = async (req, res) => {
+  try {
+    const { idCategoria } = req.params;
+    const { nombreCategoria, descripcion, productos } = req.body;
+
+    if (!idCategoria) {
+      return res.status(400).json(MENSAJES.CATEGORIA_NO_ENCONTRADA);
+    }
+
+    if (!nombreCategoria || typeof nombreCategoria !== 'string' || nombreCategoria.trim() === '') {
+      return res.status(400).json(MENSAJES.NOMBRE_CATEGORIA_INVALIDO);
+    }
+
+    if (!Array.isArray(productos)) {
+      return res.status(400).json({
+        codigo: 400,
+        mensaje: 'El campo productos debe ser un arreglo.',
+      });
+    }
+
+    if (descripcion && typeof descripcion !== 'string') {
+  return res.status(400).json(MENSAJES.DESCRIPCION_INVALIDA);
+  }
+
+    await actualizarCategoria({ idCategoria, nombreCategoria, descripcion, productos });
+
+    return res.status(200).json({
+      codigo: 200,
+      mensaje: 'Categoría actualizada correctamente.',
+    });
+  } catch {
+    return res.status(500).json(MENSAJES.ERROR_CREAR_CATEGORIA);
+  }
+};

Categorias/Controladores/consultarDetalleCategoria.controller.js

@@ -0,0 +1,41 @@
+const repositorio = require('@altertex/cat/repos/repositorioLeerDetalleCategoria');
+const MENSAJES_CATEGORIAS = require('@altertex/util/const/mensajesCategorias');
+
+/**
+ * Consulta el detalle de una categoría de productos, incluyendo sus productos asociados.
+ *
+ * @function
+ * @async
+ * @param {Express.Request} req - Objeto de solicitud HTTP con `req.params.idCategoria`.
+ * @param {Express.Response} res - Objeto de respuesta HTTP para enviar el resultado.
+ *
+ * @returns {Promise<void>} Devuelve una respuesta HTTP con el detalle de la categoría o un mensaje de error.
+ *
+ * @description
+ * Implementa el RF48: Leer categoría de productos.
+ * Si no se encuentra la categoría, devuelve código 404.
+ * Si ocurre un error inesperado, devuelve código 500.
+ *
+ * @see [RF48 - Documentación de requisitos](https://codeandco-wiki.netlify.app/docs/proyectos/textiles/documentacion/requisitos/RF48)
+ */
+exports.consultarDetalleCategoria = async (req, res) => {
+  const idCategoria = parseInt(req.params.idCategoria);
+
+  try {
+    const resultado = await repositorio.leerDetalleCategoria(idCategoria);
+
+    if (!resultado) {
+      return res
+        .status(MENSAJES_CATEGORIAS.CATEGORIA_NO_ENCONTRADA.codigo)
+        .json({ mensaje: MENSAJES_CATEGORIAS.CATEGORIA_NO_ENCONTRADA.mensaje });
+    }
+
+    return res
+      .status(MENSAJES_CATEGORIAS.CATEGORIA_OBTENIDA.codigo)
+      .json({ mensaje: MENSAJES_CATEGORIAS.CATEGORIA_OBTENIDA.mensaje, categoria: resultado });
+  } catch {
+    return res
+      .status(MENSAJES_CATEGORIAS.ERROR_OBTENER_CATEGORIA.codigo)
+      .json({ mensaje: MENSAJES_CATEGORIAS.ERROR_OBTENER_CATEGORIA.mensaje });
+  }
+};

Categorias/Datos/Repositorios/repositorioActualizarCategorias.js

@@ -0,0 +1,22 @@
+const correrQuery = require('@altertex/util/ser/correrQuery');
+const CONSULTAS = require('@altertex/util/const/consultasCategorias');
+
+/**
+ * Actualiza el nombre, descripción y productos de una categoría.
+ *
+ * @param {object} categoria - Objeto con los datos de la categoría.
+ * @param {number} categoria.idCategoria - ID de la categoría a actualizar.
+ * @param {string} categoria.nombreCategoria - Nuevo nombre de la categoría.
+ * @param {string} categoria.descripcion - Nueva descripción.
+ * @param {number[]} categoria.productos - IDs de productos asociados.
+ * @returns {Promise<void>}
+ */
+exports.actualizarCategoria = async ({ idCategoria, nombreCategoria, descripcion, productos }) => {
+  await correrQuery(CONSULTAS.ACTUALIZAR_CATEGORIA, [nombreCategoria, descripcion, idCategoria]);
+  await correrQuery(CONSULTAS.ELIMINAR_PRODUCTOS_CATEGORIA, [idCategoria]);
+
+  if (productos && productos.length > 0) {
+    const valores = productos.map((idProd) => [idCategoria, idProd]);
+    await correrQuery(CONSULTAS.ASIGNAR_PRODUCTOS_A_CATEGORIA, [valores]);
+  }
+};

Categorias/Datos/Repositorios/repositorioLeerDetalleCategoria.js

@@ -0,0 +1,35 @@
+const correrQuery = require('@altertex/util/ser/correrQuery');
+const CONSULTAS = require('@altertex/util/const/consultasCategorias');
+
+/**
+ * Consulta el detalle de una categoría y sus productos asociados.
+ *
+ * @param {number} idCategoria - ID de la categoría a consultar.
+ * @returns {Promise<object|null>} Objeto con la información de la categoría y sus productos, o null si no existe.
+ *
+ * @throws {Error} Si ocurre un error al ejecutar la consulta.
+ *
+ * @see [RF48 - Documentación de requisitos](https://codeandco-wiki.netlify.app/docs/proyectos/textiles/documentacion/requisitos/RF48)
+ */
+exports.leerDetalleCategoria = async (idCategoria) => {
+  const query = CONSULTAS.LEER_DETALLE_CATEGORIA;
+  const resultados = await correrQuery(query, [idCategoria]);
+
+  if (!resultados || resultados.length === 0) return null;
+
+  const { nombreCategoria, descripcion } = resultados[0];
+
+  const productos = resultados
+    .filter(resul => resul.idProducto !== null)
+    .map(produc => ({
+      idProducto: produc.idProducto,
+      nombreComun: produc.nombreComun,
+    }));
+
+  return {
+    idCategoria,
+    nombreCategoria,
+    descripcion,
+    productos,
+  };
+};