================================================================================ MANUAL DE AYUDA — EDITOR DE MATERIA PRIMA ================================================================================ 1. DESCRIPCIÓN Y PROPÓSITO GENERAL -------------------------------------------------------------------------------- Este módulo implementa el formulario modal de alta y edición de materias primas, heredando de TfrmBase. Permite gestionar el código, descripción, familia asociada, código de barras, observaciones, stock mínimo, peso, dimensiones, estado activo/inventariable de cada materia prima de pastelería, así como la consulta en pestaña dedicada de las referencias y artículos de los proveedores asignados desde ge_proveedores_materias_primas y la gestión documental completa (subida, apertura y eliminación de archivos adjuntos como fichas técnicas o especificaciones) almacenados en la tabla central ge_documentos. 2. GUÍA DE USO Y PROCEDIMIENTO PASO A PASO -------------------------------------------------------------------------------- ▶ Paso 1: Introducción de Datos: Rellene los campos obligatorios del formulario (identificados con etiqueta destacada) y navegue entre las distintas pestañas de información ("Datos Generales", "Artículos de Proveedores" y "Documentación"). ▶ Paso 2: Validación de Información: Verifique que los importes, fechas o clasificaciones introducidas sean correctas antes de confirmar. ▶ Paso 3: Guardar Cambios: Pulse el botón "Guardar" ([💾]) para validar y almacenar la información en el sistema. ▶ Paso 4: Gestión de Documentos: En la pestaña "Documentación", utilice el botón "Subir" para adjuntar nuevos archivos, "Ver" (o doble clic sobre el registro) para abrir el documento en el visor predeterminado del equipo, y "Eliminar" para retirar un archivo no deseado. ▶ Paso 5: Descartar Modificaciones: Si desea anular los cambios antes de guardar, pulse "Cancelar" ([✖]) para restaurar los valores originales. ▶ Paso 6: Navegación entre Registros: Utilice los botones de navegación ("Primero", "Anterior", "Siguiente", "Último") para revisar otras fichas del listado sin cerrar el editor. ▶ Paso 7: Cerrar Ventana: Pulse "Salir" ([🚪]) o la tecla [Escape] para volver a la pantalla principal. 3. GUÍA DE CAMPOS Y CONTROLES PRINCIPALES -------------------------------------------------------------------------------- • Campos Principales: Identificadores de cabecera (Código, Descripción, Familia, Cód. Barras, Estado). • Casilla "Activo": Permite habilitar o deshabilitar la materia prima en el sistema. • Casilla "Controlar stock": Determina si la materia prima es inventariable. • Pestaña "Datos Generales": Datos maestros, existencias, precios e imagen del producto. • Pestaña "Artículos de Proveedores": Muestra las referencias y últimos precios de compra de los proveedores asociados. • Pestaña "Documentación": Listado de documentos digitalizados asociados (PDFs, especificaciones, etc.) con columnas de Fecha, Descripción, Nombre y Extensión. Permite ordenar al hacer clic en las cabeceras. 4. ACCIONES Y BOTONES DE LA BARRA DE HERRAMIENTAS Y PESTAÑAS -------------------------------------------------------------------------------- * [💾] Guardar : Valida y almacena los datos introducidos en la base de datos. * [✖] Cancelar : Descarta los cambios no guardados y restaura el estado original. * [➕] Añadir : Limpia los campos del formulario para iniciar una nueva alta. * [🗑] Eliminar : Elimina el registro actual previa confirmación. * [⏮] Primero : Se desplaza al primer registro del catálogo. * [◀] Anterior : Retrocede al registro anterior. * [▶] Siguiente : Avanza al siguiente registro. * [⏭] Último : Se desplaza al último registro del catálogo. * [🚪] Salir : Cierra la ventana de edición. * [❓] Ayuda : Muestra la guía de uso de esta ficha. * [Subir] : Sube y asocia un documento físico a la materia prima en ge_documentos. * [Ver] : Descarga temporalmente y visualiza el archivo seleccionado. * [Eliminar] : Elimina el archivo adjunto seleccionado de la base de datos. 5. ATAJOS DE TECLADO Y NAVEGACIÓN RÁPIDA -------------------------------------------------------------------------------- • [Enter] : Confirma la selección, abre la ficha o avanza al siguiente campo. • [Escape] : Cierra la ventana actual o cancela la edición en curso. • [Espacio] : Marca o desmarca casillas de verificación (Checkboxes) en rejilla. • [Doble Clic] : En la rejilla de documentos, abre inmediatamente el documento seleccionado. • [F5] : Refresca inmediatamente los datos desde el servidor. • [Flechas Arriba/Abajo] : Desplaza el cursor entre registros de la lista. 6. REGLAS DE NEGOCIO Y NOTAS IMPORTANTES -------------------------------------------------------------------------------- ⚠ Código ID de Solo Lectura: El control edtCodigo se configura como ReadOnly := True y Color := clBtnFace tanto a nivel de diseño en el DFM como en tiempo de ejecución. Muestra el identificador incremental id autogenerado de la base de datos tras el guardado de un nuevo registro, o la palabra "AUTO" si está en modo de adición. ⚠ Control de Parámetros Nulos (FireDAC): Previene errores de tipo desconocido en campos opcionales (familia_id, codigo_barras, stock_minimo, peso, dimensiones). Para esto, se llama a Clear primero y luego se asigna explícitamente el DataType (ftString o ftFloat), ya que el método Clear de FireDAC restablece el tipo de dato a ftUnknown. ⚠ Documentos en Base de Datos: Los archivos adjuntos se almacenan de manera centralizada en la tabla ge_documentos enlazados por id_materia_prima, asegurando la integridad referencial y su disponibilidad sin depender de rutas locales en disco.