Centro Logístico de Materiales y Máquinas

Este documento proporciona una descripción completa de la base de datos del Centro Logístico de Materiales y Máquinas, diseñada para gestionar eficientemente el inventario, las solicitudes, movimientos y compras de materiales y máquinas entre diferentes centros de almacenamiento (obras y depósitos). Además, se incluyen las relaciones entre las tablas, así como los triggers, stored procedures, vistas y funciones que facilitan las operaciones diarias.

Introducción

La base de datos CentroLogistico ha sido diseñada para gestionar eficientemente los recursos, materiales, y equipos de una empresa de construcción. Esta base de datos centraliza la información relacionada con el almacenamiento, el movimiento de materiales y máquinas entre distintos centros y obras, y la administración de pedidos de compra. De esta manera, facilita la coordinación entre diferentes sectores de la empresa, asegurando que los recursos estén disponibles cuando y donde se necesiten.

Objetivo

El principal objetivo de CentroLogistico es optimizar la logística interna de la empresa mediante la digitalización y automatización de procesos clave como el control de inventarios, la gestión de solicitudes de materiales y equipos, y la realización de movimientos entre diferentes centros. Al centralizar la información y proporcionar herramientas para la toma de decisiones informadas, la base de datos contribuye a reducir costos, minimizar errores humanos y mejorar la eficiencia operativa en todas las fases de un proyecto de construcción.

Situación Problemática

En el contexto de la construcción, la falta de control y la desorganización en la gestión de materiales y equipos pueden resultar en retrasos en las obras, incrementos en los costos, y una disminución en la calidad del trabajo. Tradicionalmente, la gestión de inventarios y el movimiento de recursos se han realizado de manera manual, lo cual es propenso a errores y difícil de escalar. La ausencia de un sistema centralizado para administrar estos procesos puede llevar a pérdidas de tiempo valioso, sobrecostos por falta de materiales o maquinaria, y una menor capacidad para responder rápidamente a los cambios en las necesidades del proyecto.

Modelo de Negocio

El modelo de negocio que Centro Logístico apoya se basa en la eficiencia y la transparencia en la gestión de recursos dentro de la industria de la construcción. Al proporcionar un sistema robusto para la gestión de inventarios, solicitudes, movimientos, y pedidos, la empresa puede reducir costos operativos y mejorar su capacidad de cumplir con los plazos de entrega y presupuestos estipulados en cada proyecto. Además, el sistema permite un seguimiento preciso de los recursos, lo que facilita la toma de decisiones estratégicas y la planificación futura.

Diagrama Entidad-Relación

El siguiente diagrama muestra el modelo de entidad-relación del sistema:

Diagrama ER en Miro

Contenido

1. Esquema de Base de Datos

• 1.1. Proveedores
• 1.2. Materiales
• 1.3. Máquinas
• 1.4. Clientes
• 1.5. Centros (Obras y Depósitos)
• 1.6. Empleados
• 1.7. Socios Gerentes
• 1.8. Almacenes de Materiales
• 1.9. Almacenes de Máquinas
• 1.10. Solicitudes
• 1.11. Detalle de Solicitudes
• 1.12. Autorizaciones
• 1.13. Movimientos
• 1.14. Detalle de Movimientos
• 1.15. Pedidos de Compras
• 1.16. Detalle de Pedidos de Compras

2. Relaciones entre Tablas

• 2.1. Materiales - Proveedores
• 2.2. Máquinas - Proveedores
• 2.3. Empleados - Centros
• 2.4. Almacenes_Materiales - Centros, Materiales
• 2.5. Almacenes_Maquinas - Centros, Máquinas
• 2.6. Solicitudes - Clientes, Empleados, Proveedores, Centros
• 2.7. Detalle_Solicitudes - Solicitudes, Materiales, Máquinas
• 2.8. Autorizaciones - Solicitudes, Socios Gerentes
• 2.9. Movimientos - Empleados, Autorizaciones
• 2.10. Detalle_Movimientos - Movimientos, Centros, Materiales, Máquinas
• 2.11. Pedidos_Compras - Solicitudes, Empleados
• 2.12. Detalle_Pedidos_Compras - Pedidos_Compras, Materiales

3. Stored Procedures, Triggers, Vistas y Funciones

• 3.1. Vistas
• 3.2. Funciones
• 3.3. Stored Procedures
• 3.4. Triggers

4. Creacion de roles dentro de la base de datos

• 4.1. Deposito_Responsable
• 4.2. Deposito_Administrativo
• 4.3. Obra_Jefe
• 4.4. Obra_Capataz
• 4.5. Compras_Responsable
• 4.6. Compras_Administrativo
• 4.7. Desarrollo_dev
• 4.8. Socio_Gerente

5. Comandos nuevos del Makefile

• 5.1. access-deposito-resp-db
• 5.2. backup-db
• 5.3. restore-db

1. Esquema de Base de Datos

1.1. Proveedores

Tabla que almacena la información de los proveedores de materiales y máquinas.

• ID_Proveedor: Identificador único.
• Nombre: Nombre del proveedor.
• Dirección: Dirección del proveedor.
• Teléfono: Teléfono de contacto.
• Rubro: Tipo de productos que provee.

1.2. Materiales

Tabla que almacena la información de los materiales disponibles.

• ID_Material: Identificador único.
• Nombre: Nombre del material.
• Descripción: Descripción detallada del material.
• Unidad: Unidad de medida del material.
• ID_Proveedor: Identificador del proveedor.

1.3. Máquinas

Tabla que almacena la información de las máquinas disponibles.

• ID_Maquina: Identificador único.
• Nombre: Nombre de la máquina.
• Descripción: Descripción detallada de la máquina.
• Estado: Estado actual de la máquina (e.g., operativa, en reparación).
• ID_Proveedor: Identificador del proveedor.

1.4. Clientes

Tabla que almacena la información de los clientes.

• ID_Cliente: Identificador único.
• Nombre: Nombre del cliente.
• Dirección: Dirección del cliente.
• Teléfono: Teléfono de contacto.

1.5. Centros (Obras y Depósitos)

Tabla que almacena la información de los centros de almacenamiento (obras y depósitos).

• ID_Centro: Identificador único.
• Nombre: Nombre del centro.
• Dirección: Dirección del centro.
• Tipo: Tipo de centro ('Obra' o 'Depósito').

1.6. Empleados

Tabla que almacena la información de los empleados.

• ID_Empleado: Identificador único.
• Nombre: Nombre del empleado.
• Cargo: Cargo del empleado.
• Teléfono: Teléfono de contacto.
• ID_Centro: Identificador del centro donde trabaja el empleado.
• Tipo: Tipo de empleado ('Obra', 'Depósito', 'Compras').

1.7. Socios Gerentes

Tabla que almacena la información de los socios gerentes.

• ID_Socio_Gerente: Identificador único.
• Nombre: Nombre del socio gerente.
• Teléfono: Teléfono de contacto.

1.8. Almacenes de Materiales

Tabla que almacena el inventario de materiales en cada centro.

• ID_Almacen_Material: Identificador único.
• ID_Centro: Identificador del centro.
• ID_Material: Identificador del material.
• Cantidad: Cantidad disponible del material.

1.9. Almacenes de Máquinas

Tabla que almacena el inventario de máquinas en cada centro.

• ID_Almacen_Maquina: Identificador único.
• ID_Centro: Identificador del centro.
• ID_Maquina: Identificador de la máquina.

1.10. Solicitudes

Tabla que registra las solicitudes de materiales y máquinas.

• ID_Solicitud: Identificador único.
• Fecha: Fecha de la solicitud.
• Tipo: Tipo de solicitud ('Material' o 'Máquina').
• ID_Cliente: Identificador del cliente.
• ID_Empleado: Identificador del empleado que realiza la solicitud.
• Estado: Estado de la solicitud ('Pendiente', 'Parcial', 'Aprobada', 'Rechazada').
• ID_Proveedor: Identificador del proveedor.
• ID_Centro: Identificador del centro.

1.11. Detalle de Solicitudes

Tabla que almacena el detalle de las solicitudes.

• ID_Detalle_Solicitud: Identificador único.
• ID_Solicitud: Identificador de la solicitud.
• ID_Material: Identificador del material.
• ID_Maquina: Identificador de la máquina.
• Cantidad: Cantidad solicitada.

1.12. Autorizaciones

Tabla que registra las autorizaciones de los movimientos y solicitudes.

• ID_Autorizacion: Identificador único.
• ID_Solicitud: Identificador de la solicitud.
• ID_Socio_Gerente: Identificador del socio gerente que autoriza.
• Estado: Estado de la autorización ('Aprobada', 'Rechazada', 'Pendiente').
• Fecha: Fecha de la autorización.

1.13. Movimientos

Tabla que registra los movimientos de materiales y máquinas.

• ID_Movimiento: Identificador único.
• Fecha: Fecha del movimiento.
• Tipo: Tipo de movimiento ('Entrada', 'Salida', 'Transferencia').
• ID_Empleado: Identificador del empleado responsable.
• ID_Autorizacion: Identificador de la autorización correspondiente.

1.14. Detalle de Movimientos

Tabla que almacena el detalle de los movimientos de materiales y máquinas.

• ID_Detalle_Movimiento: Identificador único.
• ID_Movimiento: Identificador del movimiento.
• ID_Almacen_Origen: Identificador del centro de origen.
• ID_Almacen_Destino: Identificador del centro de destino.
• ID_Material: Identificador del material (si aplica).
• ID_Maquina: Identificador de la máquina (si aplica).
• Cantidad: Cantidad movida.

1.15. Pedidos de Compras

Tabla que registra los pedidos de compras de materiales.

• ID_Pedido: Identificador único.
• ID_Solicitud: Identificador de la solicitud.
• Fecha: Fecha del pedido.
• ID_Empleado_Compras: Identificador del empleado de compras.

1.16. Detalle de Pedidos de Compras

Tabla que almacena el detalle de los pedidos de compras de materiales.

• ID_Detalle_Pedido: Identificador único.
• ID_Pedido: Identificador del pedido.
• ID_Material: Identificador del material.
• Cantidad: Cantidad pendiente de recibir.

2. Relaciones entre Tablas

Se establecen las siguientes relaciones clave entre las tablas:

2.1. Materiales - Proveedores:

• Materiales.ID_Proveedor → Proveedores.ID_Proveedor, relación: 1 Proveedor - * Materiales

2.2. Máquinas - Proveedores:

• Maquinas.ID_Proveedor → Proveedores.ID_Proveedor, relación: 1 Proveedor - * Maquinas

2.3. Empleados - Centros:

• Empleados.ID_Centro → Centros.ID_Centro, relación: 1 Centro - * Empleados

2.4. Almacenes_Materiales - Centros, Materiales:

• Almacenes_Materiales.ID_Centro → Centros.ID_Centro, relación: 1 Centro - * Almacenes_Materiales
• Almacenes_Materiales.ID_Material → Materiales.ID_Material, relación: * Materiales - * Almacenes_Materiales

2.5. Almacenes_Maquinas - Centros, Máquinas:

• Almacenes_Maquinas.ID_Centro → Centros.ID_Centro, relación: 1 Centro - * Almacenes_Maquinas
• Almacenes_Maquinas.ID_Maquina → Maquinas.ID_Maquina, relación: * Maquinas - * Almacenes_Maquinas

2.6. Solicitudes - Clientes, Empleados, Proveedores, Centros:

• Solicitudes.ID_Cliente → Clientes.ID_Cliente, relación: 1 Cliente - * Solicitudes
• Solicitudes.ID_Empleado → Empleados.ID_Empleado, relación: 1 Empleado - * Solicitudes
• Solicitudes.ID_Proveedor → Proveedores.ID_Proveedor, relación: 1 Proveedor - * Solicitudes
• Solicitudes.ID_Centro → Centros.ID_Centro, relación: 1 Centro - * Solicitudes

2.7. Detalle_Solicitudes - Solicitudes, Materiales, Máquinas:

• Detalle_Solicitudes.ID_Solicitud → Solicitudes.ID_Solicitud, relación: 1 Solicitud - * Detalle_Solicitudes
• Detalle_Solicitudes.ID_Material → Materiales.ID_Material, relación: * Materiales - * Detalle_Solicitudes
• Detalle_Solicitudes.ID_Maquina → Maquinas.ID_Maquina, relación: * Maquinas - * Detalle_Solicitudes

2.8. Autorizaciones - Solicitudes, Socios Gerentes:

• Autorizaciones.ID_Solicitud → Solicitudes.ID_Solicitud, relación: 1 Autorización - 1 Solicitud
• Autorizaciones.ID_Socio_Gerente → Socios_Gerentes.ID_Socio_Gerente, relación: 1 Socio_Gerente - * Autorizaciones

2.9. Movimientos - Empleados, Autorizaciones:

• Movimientos.ID_Empleado → Empleados.ID_Empleado, relación: 1 Empleado - * Movimientos
• Movimientos.ID_Autorizacion → Autorizaciones.ID_Autorizacion, relación: 1 Autorización - * Movimientos

2.10. Detalle_Movimientos - Movimientos, Centros, Materiales, Máquinas:

• Detalle_Movimientos.ID_Movimiento → Movimientos.ID_Movimiento, relación: 1 Movimiento - * Detalle_Movimientos
• Detalle_Movimientos.ID_Almacen_Origen → Centros.ID_Centro, relación: 1 Centro origen - * Detalle_Movimientos
• Detalle_Movimientos.ID_Almacen_Destino → Centros.ID_Centro, relación: 1 Centro destino - * Detalle_Movimientos
• Detalle_Movimientos.ID_Material → Materiales.ID_Material, relación: * Materiales - * Detalle_Movimientos
• Detalle_Movimientos.ID_Maquina → Maquinas.ID_Maquina, relación: * Maquinas - * Detalle_Movimientos

2.11. Pedidos_Compras - Solicitudes, Empleados:

• Pedidos_Compras.ID_Solicitud → Solicitudes.ID_Solicitud, relación: 1 Solicitud - * Pedidos_Compras
• Pedidos_Compras.ID_Empleado_Compras → Empleados.ID_Empleado, relación: 1 Empleado - * Pedidos_Compras

2.12. Detalle_Pedidos_Compras - Pedidos_Compras, Materiales:

• Detalle_Pedidos_Compras.ID_Pedido → Pedidos_Compras.ID_Pedido, relación: 1 Pedido_Compras - * Detalles_Pedido_Compras Detalle_Pedidos_Compras.ID_Material → Materiales.ID_Material, relación: * Materiales - * Detalle_Pedido_Compras

3. Stored Procedures, Triggers, Vistas y Funciones

3.1 Vistas

3.1.1. Vista_SolicitudesPendientes

Descripción:

Muestra una lista de todas las solicitudes que están pendientes de aprobación. Incluye detalles sobre la solicitud, el cliente asociado y el empleado que la creó.

Campos:

• ID_Solicitud: Identificador único de la solicitud.
• Cliente: Nombre del cliente asociado a la solicitud.
• Empleado: Nombre del empleado que creó la solicitud.
• Tipo: Tipo de la solicitud (materiales, máquinas, etc.).
• Estado: Estado actual de la solicitud (en este caso, debe ser 'Pendiente').

Uso:

Esta vista es útil para los gestores y responsables que necesitan revisar y aprobar las solicitudes que están pendientes en el sistema.

SELECT * FROM Vista_SolicitudesPendientes;

3.1.2. Vista_Materiales_Centro

Descripción:

Muestra los materiales disponibles en un centro específico que está clasificado como depósito. Incluye el nombre del centro, el nombre del material y la cantidad disponible.

Campos:

• Nombre_Centro: Nombre del centro donde están almacenados los materiales.
• Nombre_Material: Nombre del material disponible.
• Cantidad: Cantidad disponible del material en el centro.

Uso:

Esta vista permite a los usuarios consultar rápidamente los materiales disponibles en centros clasificados como depósitos, facilitando la gestión de inventario y el seguimiento de existencias.

SELECT * FROM Vista_Materiales_Centro;

3.1.3. Vista_Maquinas_Centro

Descripción:

Muestra las máquinas disponibles en un centro específico clasificado como depósito. Incluye el nombre del centro, el nombre de la máquina, una breve descripción y el estado de la máquina.

Campos:

• Nombre_Centro: Nombre del centro donde están almacenadas las máquinas.
• Nombre_Maquina: Nombre de la máquina disponible.
• Descripcion: Descripción de la máquina.
• Estado: Estado actual de la máquina (por ejemplo, disponible, en reparación, etc.).

Uso:

Esta vista es útil para consultar el inventario de máquinas en los centros de depósito, ayudando en la planificación y gestión de los recursos disponibles.

SELECT * FROM Vista_Maquinas_Centro;

3.1.4. Vista_Movimientos

Descripción:

Proporciona información detallada sobre los movimientos de materiales y máquinas, incluyendo la fecha del movimiento, el tipo, el centro involucrado, el empleado responsable, y los detalles específicos del material o máquina movida.

Campos:

• ID_Movimiento: Identificador único del movimiento.
• Fecha: Fecha en que se realizó el movimiento.
• Tipo: Tipo de movimiento (entrada, salida, traslado, etc.).
• Nombre_Centro: Nombre del centro donde se realizó el movimiento.
• Nombre_Empleado: Nombre del empleado que realizó el movimiento.
• ID_Material: Identificador del material involucrado en el movimiento.
• ID_Maquina: Identificador de la máquina involucrada en el movimiento.
• Cantidad: Cantidad de material o máquinas movidas.
• Nombre_Item: Nombre del material o máquina, dependiendo de cuál esté involucrado.

Uso:

Esta vista es útil para hacer un seguimiento de todos los movimientos de inventario, facilitando la auditoría y el análisis de la gestión de recursos.

SELECT * FROM Vista_Movimientos;

3.1.5. Vista_Solicitudes

Descripción:

Muestra información detallada sobre las solicitudes, incluyendo la fecha, tipo, cliente, empleado, centro asociado, y los detalles de los materiales y máquinas solicitados.

Campos:

• ID_Solicitud: Identificador único de la solicitud.
• Fecha: Fecha en que se realizó la solicitud.
• Tipo: Tipo de solicitud (materiales, máquinas, etc.).
• Nombre_Cliente: Nombre del cliente asociado a la solicitud.
• Nombre_Empleado: Nombre del empleado que realizó la solicitud.
• Nombre_Centro: Nombre del centro donde se requiere el material o máquina.
• ID_Material: Identificador del material solicitado.
• ID_Maquina: Identificador de la máquina solicitada.
• Cantidad: Cantidad de material o máquinas solicitadas.
• Nombre_Item: Nombre del material o máquina solicitado.
• Estado: Estado actual de la solicitud.

Uso:

Esta vista permite consultar la información detallada de todas las solicitudes en el sistema, facilitando el análisis y seguimiento de las mismas.

SELECT * FROM Vista_Solicitudes;

3.1.6. Vista_Stock_Materiales

La vista Stock_Materiales proporciona un resumen del stock actual de materiales en cada centro de almacenamiento.

Estructura de la Vista

• ID_Centro: Identificador único del centro de almacenamiento.
• ID_Material: Identificador único del material.
• Nombre_Material: Nombre del material.
• Stock_Actual: Cantidad total del material disponible en el centro de almacenamiento.

Uso:

Visualiza la cantidad de materiales que tiene cada centro

SELECT * FROM Vista_Stock_Materiales;

3.1.7. Vista_Stock_Maquinas

La vista Stock_Maquinas proporciona un resumen del stock actual de máquinas en cada centro de almacenamiento.

Estructura de la Vista

• ID_Centro: Identificador único del centro de almacenamiento.
• ID_Maquina: Identificador único de la máquina.
• Nombre_Maquina: Nombre de la máquina.
• Stock_Actual: Cantidad de unidades de la máquina disponible en el centro de almacenamiento.

Uso:

Permite visualizar en una tabla todas las maquinas para los diferentes centros

SELECT * FROM Vista_Stock_Maquinas;

3.2. Funciones

3.2.1. Funcion_ObtenerEstadoMaquina

Descripción:

Devuelve el estado de una máquina específica en función de su identificador.

Parámetros:

ID_Maquina: INT — Identificador de la máquina para la que se desea obtener el estado.

Valor Retornado:

VARCHAR(50) — Estado de la máquina.

Ejemplo de Uso:

SELECT Funcion_ObtenerEstadoMaquina(1);

Este ejemplo devolverá el estado de la máquina con ID_Maquina igual a 1.

3.2.2. Funcion_ObtenerCantidadMaterialPorCentro

Descripción:

Verifica y devuelve la cantidad de un material específico en todos los centros. La función utiliza un cursor para iterar sobre los centros y concatenar los resultados en una cadena de texto.

Parámetros:

p_ID_Material: INT — Identificador del material para el cual se desea conocer la cantidad en los diferentes centros. Valor Retornado:

TEXT — Una cadena de texto que enumera cada centro y la cantidad del material en ese centro.

Ejemplo de Uso:

SELECT Funcion_ObtenerCantidadMaterialPorCentro(1);

Este ejemplo devolverá una cadena de texto con la cantidad del material con ID_Material igual a 5 en cada centro.

3.2.3. Funcion_ObtenerCantidadMaterialCentro

Descripción:

Calcula y devuelve la cantidad de un material específico en un centro determinado. Si el material no está disponible en el centro, la función retorna 0.

Parámetros:

centro_id: INT — Identificador del centro en el cual se desea verificar la cantidad del material. material_id: INT — Identificador del material cuya cantidad se desea conocer en el centro especificado. Valor Retornado:

INT — Cantidad del material en el centro. Retorna 0 si el material no está presente en el centro.

Ejemplo de Uso:

SELECT Funcion_ObtenerCantidadMaterialCentro(2, 2);

Este ejemplo devolverá la cantidad del material con ID_Material igual a 2 en el centro con ID_Centro igual a 2.

3.3. Stored Procedures

3.3.1. SP_AprobarORechazarSolicitud

Descripción:

Aprueba o rechaza una solicitud de materiales o máquinas. Actualiza el estado en las tablas Autorizaciones y Solicitudes.

Parámetros:

• p_ID_Solicitud: INT — Identificador de la solicitud que se desea aprobar o rechazar.
• p_ID_Socio_Gerente: INT — Identificador del socio gerente que está realizando la acción.
• p_Accion: VARCHAR(10) — Acción a realizar. Debe ser 'Aprobar' o 'Rechazar'.

Valor Retornado:

Ninguno.

Ejemplo de Uso:

CALL SP_AprobarORechazarSolicitud(16,1, 'Aprobada');

Este ejemplo aprueba la solicitud con ID_Solicitud igual a 1 por parte del socio gerente con ID_Socio_Gerente igual a 1.

3.3.2. SP_CrearSolicitud

Descripción:

Registra una nueva solicitud de materiales o máquinas. Crea una entrada en la tabla Solicitudes y añade detalles a Detalle_Solicitudes a partir de un JSON que contiene los elementos y cantidades.

Parámetros:

• p_Tipo: ENUM('Material', 'Maquina') — Tipo de solicitud. Puede ser 'Material' o 'Maquina'.
• p_ID_Cliente: INT — Identificador del cliente que realiza la solicitud.
• p_ID_Empleado: INT — Identificador del empleado que realiza la solicitud.
• p_ID_Centro: INT — Identificador del centro donde se requiere el material o máquina.
• p_DetallesSolicitud: JSON — JSON que contiene los detalles de la solicitud, incluyendo IDs de materiales o máquinas y sus cantidades.

Valor Retornado:

Ninguno.

Ejemplo de Uso:

CALL SP_CrearSolicitud('Material',1,3,6,'[{"ID_Item": 1, "Cantidad": 20}, {"ID_Item": 2, "Cantidad": 50}]');

Este ejemplo crea una solicitud de materiales para el cliente con ID_Cliente igual a 1, el empleado con ID_Empleado igual a 202, en el centro con ID_Centro igual a 303, solicitando 10 unidades del material con ID_Item igual a 5.

3.3.3. SP_RegistrarIngreso

Descripción:

Registra el ingreso de materiales o máquinas a un centro. Crea un registro en la tabla Movimientos y actualiza o inserta en la tabla correspondiente (Almacenes_Materiales o Almacenes_Maquinas).

Parámetros:

p_Tipo: ENUM('Material', 'Maquina') — Tipo de ítem. Puede ser 'Material' o 'Maquina'. p_ID_Centro: INT — Identificador del centro al que se ingresa el material o máquina. p_ID_Item: INT — Identificador del material o máquina que se está ingresando. p_Cantidad: INT — Cantidad del material a ingresar. Ignorado para máquinas. p_ID_Empleado: INT — Identificador del empleado que realiza el ingreso. Valor Retornado: Ninguno.

Ejemplo de Uso:

CALL SP_RegistrarEntrada('Material', 3, 5, 1, 2);

3.3.4. SP_RegistrarSalida

Descripción:

Registra la salida de materiales o máquinas de un centro. Crea un registro en la tabla Movimientos y actualiza la tabla correspondiente (Almacenes_Materiales o Almacenes_Maquinas).

Parámetros:

p_Tipo: ENUM('Material', 'Maquina') — Tipo de ítem. Puede ser 'Material' o 'Maquina'. p_ID_Centro: INT — Identificador del centro del que se realiza la salida. p_ID_Item: INT — Identificador del material o máquina que se está retirando. p_Cantidad: INT — Cantidad del material a retirar. Ignorado para máquinas. p_ID_Empleado: INT — Identificador del empleado que realiza la salida.

Valor Retornado:

Ninguno.

Ejemplo de Uso:

CALL SP_RegistrarSalida('Material', 3, 5, 1, 2);

Este ejemplo registra la salida de 1 unidades del material con ID_Material igual a 5 del centro con ID_Centro igual a 3, realizada por el empleado con ID_Empleado igual a 2.

3.3.5. SP_RealizarMovimientoMateriales

Descripción:

El procedimiento SP_RealizarMovimientoMateriales se encarga de registrar el movimiento de materiales desde un almacén de origen a un almacén de destino, basándose en una solicitud aprobada. Asegura que solo se muevan materiales si la solicitud está aprobada y es del tipo "Material".

Parámetros:

• p_ID_Solicitud: (INT) ID de la solicitud aprobada.
• p_ID_Empleado: (INT) ID del empleado que realiza el movimiento.
• p_ID_Almacen_Origen: (INT) ID del almacén de origen de donde se moverán los materiales.
• p_Materiales: (JSON) JSON con los materiales y cantidades a mover, en formato [{ID_Material: , Cantidad: }, ...].

Uso:

CALL SP_RealizarMovimientoMateriales(2 ,2 , 8 ,'[{"ID_Material": 1, "Cantidad": 50}]');

Consideraciones:

La solicitud debe estar en estado "Aprobada" y ser de tipo "Material". Verifica que haya suficiente cantidad de material en el almacén de origen antes de realizar el movimiento.

3.3.6. SP_RealizarMovimientoMaquinas

Descripción:

El procedimiento SP_RealizarMovimientoMaquinas se encarga de registrar el movimiento de máquinas desde un almacén de origen a un almacén de destino, basándose en una solicitud aprobada. Asegura que solo se muevan máquinas si la solicitud está aprobada y es del tipo "Maquina".

Parámetros:

• p_ID_Solicitud: (INT) ID de la solicitud aprobada.
• p_ID_Empleado: (INT) ID del empleado que realiza el movimiento.
• p_ID_Almacen_Origen: (INT) ID del almacén de origen de donde se moverán las máquinas.
• p_Maquinas: (JSON) JSON con las máquinas a mover, en formato [{ID_Maquina: }, ...].

Uso:

CALL SP_RealizarMovimientoMaquinas( 15, 3, 1,'[{"ID_Maquina": 2}]');

Consideraciones:

La solicitud debe estar en estado "Aprobada" y ser de tipo "Maquina". Verifica que la máquina esté disponible en el almacén de origen antes de realizar el movimiento. Estos procedimientos almacenados están diseñados para manejar movimientos logísticos de materiales y máquinas dentro de un sistema de gestión de centros logísticos, asegurando que solo se procesen solicitudes válidas y aprobadas, y controlando adecuadamente el stock disponible en cada almacén.

3.3.7. SP_GenerarPedidoCompras

Propósito

El procedimiento SP_GenerarPedidoCompras se utiliza para generar un pedido de compras basado en una solicitud de materiales aprobada. Este procedimiento asegura que se compre solo la cantidad de materiales que no está disponible en los centros clasificados como depósitos.

Parámetros

ID_Solicitud (INT):

• Descripción: El identificador único de la solicitud aprobada que se está procesando.
• Requisitos: La solicitud debe estar en estado "Aprobada".

ID_Empleado_Compras (INT):

• Descripción: El identificador del empleado responsable de realizar el pedido de compras.
• Requisitos: Debe existir en la tabla Empleados.

Funcionamiento

1. Verificación de la Solicitud:

   • Se verifica que la solicitud esté en estado "Aprobada". Si no lo está, el procedimiento lanza una excepción con el mensaje "La solicitud no está aprobada".

2. Registro del Pedido de Compras:

   • Se inserta un nuevo registro en la tabla Pedidos_Compras con el ID_Solicitud, la fecha actual, y el ID_Empleado_Compras.

3. Cálculo de Materiales Faltantes:

   • Se calcula la cantidad de materiales faltantes para cada material solicitado en función del stock disponible en centros clasificados como "Depósito".
   • Solo se incluye en el pedido de compras la cantidad faltante, es decir, la diferencia entre la cantidad solicitada y la cantidad disponible en depósitos.

4. Inserción de Detalles del Pedido de Compras:

   • Se insertan los detalles del pedido de compras en la tabla Detalle_Pedidos_Compras, especificando el material y la cantidad faltante para cada material que no esté completamente disponible en los depósitos.

Excepciones

• El procedimiento lanza una excepción si la solicitud no está aprobada.
• Si se proporcionan datos inválidos o inconsistentes, el procedimiento puede fallar y registrar el error correspondiente.

Ejemplo de Uso

-- ejemplo pedido tomado completamente
CALL SP_GenerarPedidoCompras( 20, 3);
-- ejemplo pedido que no se toma
CALL SP_GenerarPedidoCompras( 16, 3);

Este procedimiento es crucial para gestionar eficientemente los pedidos de materiales, asegurando que solo se compren materiales que realmente se necesitan y no están disponibles en los depósitos.

3.4. Triggers en la Base de Datos

3.4.1. Trigger_ValidarEstadoSolicitud

Descripción

Este trigger se activa antes de insertar un nuevo registro en la tabla Autorizaciones y valida que el estado de la solicitud correspondiente sea 'Pendiente'.

Propósito

Garantizar que solo se puedan autorizar solicitudes que estén en estado 'Pendiente'.

3.4.2. Trigger_ActualizarEstadoSolicitudAprobada

Descripción

Este trigger se activa después de insertar un registro en Autorizaciones y actualiza el estado de la solicitud a 'Aprobada' si la autorización fue aprobada.

Propósito

Automatizar la actualización del estado de las solicitudes cuando se aprueban las autorizaciones.

3.4.3. Trigger_VerificarIngresoMaquinas

Descripción

Este trigger se activa antes de insertar un registro en Almacenes_Maquinas y asegura que una máquina no sea registrada en más de un centro.

Propósito

Evitar duplicidad de registros de máquinas en distintos centros.

3.4.4. Trigger_VerificarSalidaTransferenciaMaquinas

Descripción

Este trigger se activa antes de insertar un registro en Detalle_Movimientos para verificar que haya suficiente stock de máquinas en el centro de origen antes de una salida o transferencia.

Propósito

Asegurar que no se intenten salidas o transferencias con stock insuficiente.

3.4.5. Trigger_VerificarMovimientoMateriales

Descripción

Este trigger se activa antes de insertar un registro en Almacenes_Materiales para verificar la disponibilidad de stock para movimientos de salida o transferencia de materiales.

Propósito

Garantizar que los movimientos de salida o transferencia de materiales se realicen solo si hay suficiente stock disponible.

4. Creacion de roles dentro de la base de datos

Se han creado ocho roles con permisos específicos sobre la base de datos CentroLogistico. A continuación, se describen los roles y sus privilegios:

4.1. Deposito_Responsable:

• Control completo sobre las tablas relacionadas con depósitos (Almacenes_Materiales, Almacenes_Maquinas, Movimientos,Detalle_Movimientos, Solicitudes, Detalle_Solicitudes).
• Acceso de solo lectura a las tablas Pedidos_Compras y Autorizaciones.
• Acceso a vistas relacionadas con depósitos y movimientos.
• Ejecución de funciones para obtener estados de máquinas y cantidades de materiales.

4.2. Deposito_Administrativo:

• Permisos para seleccionar, insertar y actualizar registros en las tablas relacionadas con depósitos y movimientos.
• Acceso a vistas relacionadas con depósitos y stock.
• Ejecución de procedimientos para registrar entradas y salidas de materiales o máquinas.

4.3. Obra_Jefe:

• Control sobre las tablas relacionadas con las obras (Almacenes_Materiales, Almacenes_Maquinas, Solicitudes, Detalle_Solicitudes, Movimientos, Detalle_Movimientos).
• Acceso de solo lectura a la tabla Autorizaciones.
• Acceso a vistas de solicitudes y movimientos.
• Ejecución de funciones y procedimientos para obtener estados de máquinas, realizar solicitudes y ver cantidades de materiales.

4.4. Obra_Capataz:

• Permisos de lectura y actualización sobre las tablas Solicitudes y Detalle_Solicitudes.
• Acceso a vistas de solicitudes.

4.5. Compras_Responsable:

• Control sobre las tablas relacionadas con pedidos de compras (Pedidos_Compras, Detalle_Pedidos_Compras).
• Permisos para seleccionar, insertar y actualizar la tabla Proveedores.
• Acceso de solo lectura a la tabla Autorizaciones.
• Acceso a vistas de stock y movimientos.
• Ejecución de funciones para obtener cantidades de materiales por centro y stock en particular.

4.6. Compras_Administrativo:

• Permisos para seleccionar, insertar y actualizar los registros en las tablas Pedidos_Compras y Detalle_Pedidos_Compras.
• Acceso a vistas de stock.
• Ejecución de funciones para obtener cantidades de materiales por centro y stock en particular.

4.7. Desarrollo_Dev:

• Permisos sobre todas las tablas para realizar desarrollos y testear actualizaciones.

4.8. Socio_Gerente:

• Privilegios de visualización completos sobre todas las tablas, debido a su rol de gestión.
• Acceso a todas las vistas.
• Ejecución del procedimiento de autorizacion de solicitudes.

5. Comandos nuevos del Makefile

El Makefile incluye comandos esenciales para la gestión de la base de datos CentroLogistico dentro de un entorno Docker. A continuación se describe el propósito de los nuevos comandos creados para ingresar por usuario de deposito y gestionar el backup de la base de datos:

5.1. access-deposito-resp-db:

• Descripción: Este comando permite acceder al cliente de MySQL utilizando las credenciales del usuario deposito_resp_user. Es útil para realizar consultas o modificaciones directamente en la base de datos desde la línea de comandos.
• Uso:

make access-deposito-resp-db

• Detalles Técnicos:
  • "docker exec -it $(SERVICE_NAME) mysql -udeposito_resp_user -p1234": Ejecuta un comando dentro del contenedor Docker, iniciando una sesión interactiva en MySQL con el usuario deposito_resp_user y la contraseña 1234.
  • "$(SERVICE_NAME)": Variable que representa el nombre del servicio Docker (generalmente el nombre del contenedor de la base de datos).

5.2. backup-db:

• Descripción: Este comando realiza una copia de seguridad de la base de datos CentroLogistico, incluyendo tanto la estructura como los datos, así como los procedimientos almacenados y funciones (gracias al flag --routines=true).
• Uso:

make backup-db

• Detalles Técnicos:
  • docker exec -it "$(SERVICE_NAME)" mysqldump --routines=true -"u$(MYSQL_USER)" -"p$(PASSWORD)" --host 127.0.0.1 --port 3306 "$(DATABASE)" > ./backup/"$(DATABASE)"-backup.sql: Ejecuta un mysqldump dentro del contenedor Docker para generar un archivo de volcado (.sql) que contiene la estructura de la base de datos, los datos y los procedimientos almacenados.
  • "$(SERVICE_NAME)": Nombre del servicio Docker que corre MySQL.
  • "$(MYSQL_USER)" y "$(PASSWORD)": Credenciales del usuario de MySQL configurado.
  • "$(DATABASE)": Nombre de la base de datos que se va a respaldar.
  • "--routines=true": Instruye a mysqldump para que incluya procedimientos almacenados y funciones en el respaldo.

5.3. restore-db:

• Descripción: Este comando restaura la base de datos desde un archivo de respaldo previamente generado. Es necesario editar el archivo de respaldo antes de restaurarlo.
• Uso:

make restore-db

• Detalles Técnicos:
  • Antes de ejecutar:
    • Editar el archivo de respaldo:
    • Añadir las líneas DROP DATABASE IF EXISTS CentroLogistico;, CREATE DATABASE CentroLogistico; y USE CentroLogistico; al comienzo del archivo de respaldo para asegurarse de que la base de datos se restaure correctamente.
    • Comentar la primera línea: Si el archivo incluye una advertencia sobre contraseñas, comente esa línea para evitar problemas durante la restauración.
  • docker exec -i "$(SERVICE_NAME)" mysql -"u$(MYSQL_USER)" -"p$(PASSWORD)" < ./backup/"$(DATABASE)"-backup.sql: Restaura la base de datos ejecutando el archivo .sql dentro del contenedor Docker.
  • "$(SERVICE_NAME)": Nombre del servicio Docker que corre MySQL.
  • "$(MYSQL_USER)" y "$(PASSWORD)": Credenciales del usuario de MySQL configurado.
  • "$(DATABASE)": Nombre de la base de datos que se va a restaurar.

Consideraciones

• Edición del archivo de respaldo: Antes de ejecutar el comando restore-db, es crucial editar el archivo de respaldo como se indicó anteriormente para asegurar que el proceso de restauración se realice sin problemas.
• Directorio de respaldo: El archivo de respaldo se guarda en el directorio ./backup/ y lleva el nombre $(DATABASE)-backup.sql, lo cual facilita la organización de los respaldos.