Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/LVHJ-8/Proyecto_mecanica/llms.txt

Use this file to discover all available pages before exploring further.

El módulo de Productos es el núcleo del catálogo de repuestos de LUVEN Taller & Repuestos. Desde aquí puedes registrar cada pieza o accesorio con su precio en soles, nivel de stock, categoría y marca asociada. Los cambios que realices se reflejan de inmediato en la tienda pública, siempre que el producto esté activo.

Acceso

Navega a ADMIN/productos/CRUDProductos.php desde el panel de administración. La página presenta tres pestañas:
PestañaDescripción
Lista de ProductosTabla con todos los productos registrados en la base de datos
Nuevo ProductoFormulario para crear un nuevo registro
PrevisualizaciónVista previa de cómo lucen las tarjetas de productos en la tienda

Tabla de productos

La lista se construye con la siguiente consulta, que une la tabla productos con categorias y marcas para mostrar nombres legibles en lugar de IDs:
SELECT p.*, c.nombre AS categoria, m.nombre AS marca
FROM productos p
LEFT JOIN categorias c ON p.categoria_id = c.id
LEFT JOIN marcas m ON p.marca_id = m.id
Las columnas que aparecen en la tabla son:
ColumnaDescripción
IDIdentificador único autoincremental del producto
NombreNombre del repuesto o accesorio
CategoríaNombre de la categoría asignada (joined desde categorias)
MarcaNombre de la marca asignada (joined desde marcas), puede estar vacío
Precio (S/.)Precio de venta al público en soles peruanos
StockCantidad de unidades disponibles en inventario
AccionesBotones para editar o eliminar el registro

Crear un nuevo producto

Haz clic en la pestaña Nuevo Producto para desplegar el formulario. Los datos se envían por POST a procesar_producto.php con codificación multipart/form-data para admitir la subida de imagen.
nombre
string
required
Nombre del producto o repuesto. Aparece en la tarjeta de la tienda, en la tabla del admin y en el detalle del producto. Ejemplo: Filtro de aceite Toyota Corolla.
categoria_id
integer
required
ID de la categoría a la que pertenece el producto. El selector se puebla dinámicamente desde la tabla categorias. Determina en qué sección del sidebar de filtros aparecerá el producto en Frontend/productos.php.
marca_id
integer
ID de la marca del fabricante. El selector se puebla desde la tabla marcas. Campo opcional — si no se asigna, el producto aparece sin marca en la tabla y no se vincula a ninguna página de marca.
precio
decimal
required
Precio de venta en soles peruanos (S/.). Acepta dos decimales (paso 0.01). Ejemplo: 45.90. Se muestra con el prefijo S/. tanto en la tienda como en la tabla del admin.
stock
integer
required
Cantidad de unidades disponibles. Controla las alertas de stock bajo en el dashboard y la insignia de pocas unidades en la tienda pública.
imagen
file
Imagen del producto en formato PNG o JPG. El archivo se sube al directorio assets/img/productos/ en el servidor. Campo opcional — si no se sube imagen, la tarjeta mostrará la imagen por defecto del sistema.

Reglas de visibilidad y alertas de stock

El comportamiento del producto en la tienda pública depende del campo activo y del nivel de stock:
CondiciónResultado
activo = 1El producto es visible en Frontend/productos.php
activo = 0El producto está oculto en la tienda, pero permanece en la base de datos
stock <= 3 && stock > 0La tarjeta del producto muestra la insignia “¡Pocas Unidades!” en Frontend/productos.php
stock <= 5El dashboard del admin (ADMIN/admin.php) muestra una alerta de stock bajo para ese producto
stock = 0El producto puede quedar sin disponibilidad; considera desactivarlo temporalmente
Establece activo = 0 directamente en la base de datos (o mediante el formulario de edición) para ocultar un producto de la tienda sin eliminarlo. Esto es útil para productos temporalmente sin stock o en revisión de precio, ya que conserva todo el historial del registro.

Editar un producto

Haz clic en el botón Editar en la fila correspondiente de la tabla. La acción apunta a:
editar_producto.php?id=X
donde X es el id del producto. El formulario de edición se precarga con los valores actuales del registro. Modifica únicamente los campos que necesitas actualizar y guarda los cambios.

Eliminar un producto

Haz clic en el botón Eliminar en la fila del producto. Antes de ejecutar la acción, el sistema muestra un cuadro de confirmación de JavaScript para prevenir eliminaciones accidentales. Al confirmar, la solicitud se envía a:
eliminar_producto.php?id=X
La eliminación es permanente. Si necesitas retirar un producto de la tienda de forma temporal, usa la opción de desactivar (activo = 0) en lugar de eliminar.

Build docs developers (and LLMs) love