Productos

La pagina de Productos gestiona el catalogo de articulos que su cibercafe o centro de gaming vende. Esto incluye comida, bebidas, bocadillos, accesorios y cualquier otro bien fisico ofrecido a los clientes. Cada producto tiene un precio definido, categoria, tasa de impuesto y nivel de stock. Los productos se integran con el sistema de pedidos, permitiendo a los cajeros crear pedidos, hacer seguimiento de ventas y gestionar el inventario.

Campos del producto

Cada registro de producto contiene la siguiente informacion:

Campo	Descripcion
`name`	El nombre del producto mostrado en la interfaz de pedidos. Debe ser unico (sin distincion de mayusculas).
`category`	Una etiqueta de texto que agrupa productos relacionados (por ejemplo, "Bebidas", "Bocadillos", "Accesorios"). Se usa para filtrado y reportes.
`unit`	La unidad de medida para el seguimiento de stock (por ejemplo, "pieza", "kg", "litro", "lata", "botella").
`barcode`	Un valor de codigo de barras opcional para integracion con escaner. Los cajeros pueden escanear el codigo de barras de un producto para agregarlo rapidamente a un pedido.
`sale_price`	El precio de venta en unidades menores de moneda (por ejemplo, centavos). Este es el monto cobrado al cliente por unidad.
`vat_rate`	El porcentaje de IVA aplicado a este producto (por ejemplo, 18 para 18% de IVA). Se usa para calcular el componente de impuesto de cada venta.
`stock`	El nivel de stock actual como cantidad decimal. Se actualiza automaticamente cuando se realizan pedidos y cuando se registran compras de inventario.
`active`	Un interruptor que controla si el producto aparece en la interfaz de pedidos. Los productos inactivos se ocultan de los cajeros pero se conservan en la base de datos para reportes historicos.
`description`	Una descripcion de texto opcional para detalles adicionales del producto.

Interruptor activo / inactivo

Los productos pueden alternarse entre estados activo e inactivo:

Los productos activos aparecen en la interfaz de pedidos y pueden agregarse a nuevos pedidos.
Los productos inactivos se ocultan de la interfaz de pedidos pero permanecen en la base de datos. Los pedidos anteriores que incluian el producto conservan sus referencias para que los datos historicos de ventas se preserven.

Esto es util para articulos de temporada, productos descontinuados o articulos que estan temporalmente agotados y no deben ofrecerse a los clientes.

Seguimiento de stock

HandyCafe mantiene un conteo de stock actualizado para cada producto. Este valor se actualiza automaticamente por el sistema en respuesta a:

Ventas: Cuando un producto se vende a traves de un pedido, el stock disminuye por la cantidad pedida.
Compras de inventario: Cuando se recibe nuevo stock y se registra en la pagina de Inventario, el stock aumenta correspondientemente.
Ajustes manuales: Los cajeros o administradores pueden ajustar manualmente el nivel de stock para contabilizar desperdicio, roturas, errores de conteo u otras discrepancias.

Registro de stock del producto

Cada cambio en el nivel de stock de un producto se registra en el registro de stock del producto, creando una pista de auditoria completa:

Razon	Descripcion
`sale`	El stock disminuyo por un pedido de cliente. Se vincula al registro de pedido especifico.
`purchase`	El stock aumento por una compra de inventario. Se vincula a la entrada de inventario especifica.
`adjustment`	El stock fue ajustado manualmente por un cajero o administrador.
`waste`	El stock disminuyo por desperdicio, rotura o baja.
`return`	El stock aumento por una devolucion de cliente o cancelacion de pedido.

Cada entrada del registro registra el cambio de cantidad (positivo para incrementos, negativo para decrementos), el nuevo nivel de stock despues del cambio, quien hizo el cambio y una nota opcional explicando la razon.

Categorias de productos

Los productos se agrupan por categoria usando un campo de texto libre. Las categorias comunes incluyen:

Bebidas (refrescos, agua, bebidas energeticas)
Bebidas calientes (cafe, te, chocolate caliente)
Bocadillos (papas, dulces, barras de chocolate)
Comida (sandwiches, wraps, comidas calientes)
Accesorios (audifonos, memorias USB, alfombrillas de raton)

Las categorias se usan para filtrado en la interfaz de pedidos. Los cajeros pueden cambiar rapidamente entre categorias para encontrar el producto correcto. Las categorias tambien sirven para agrupar en reportes de ventas.

No hay una interfaz de gestion de categorias separada. Las categorias se crean implicitamente cuando asigna un nombre de categoria a un producto. Para renombrar una categoria, actualice el campo de categoria en todos los productos que usan el nombre anterior.

Crear un producto

Para agregar un nuevo producto al catalogo:

Navegue a la pagina de Productos desde la barra lateral.
Haga clic en el boton Agregar producto en la barra de herramientas.
Ingrese el nombre (debe ser unico).
Seleccione o escriba una categoria.
Elija la unidad de medida.
Establezca el precio de venta (el monto cobrado a los clientes, en unidades menores de moneda).
Establezca la tasa de IVA (como decimal, por ejemplo, 0.08 para 8%).
Opcionalmente ingrese un codigo de barras para soporte de escaner.
Establezca el nivel de stock inicial si aplica.
Haga clic en Guardar.

Editar un producto

Seleccione un producto de la lista para abrir su vista de detalle. Puede actualizar cualquier campo incluyendo nombre, precio, categoria, tasa de IVA, nivel de stock y estado activo. Los cambios toman efecto inmediatamente. Si actualiza el precio, el nuevo precio aplica a todos los pedidos futuros.

Los pedidos anteriores no se ven afectados por los cambios de precio. Cada articulo de pedido almacena el unit_price al momento de la venta como una instantanea.

Integracion con pedidos

Cuando un cajero crea un pedido y agrega un producto:

El precio de venta actual del producto y la tasa de IVA se copian al articulo del pedido como instantaneas.
El total de linea se calcula como unit_price * qty.
Cuando el pedido se completa, el nivel de stock del producto se decrementa por la cantidad pedida.
Se crea una entrada de registro de stock con reason = 'sale' vinculada al pedido.

Si el pedido se cancela o reembolsa posteriormente, el stock puede restaurarse a traves de una entrada de registro de stock de devolucion.