Historias

HISTORIAS DE USUARIO

ID	Título de la Historia	Descripción y Comportamiento del Sistema
HU01	Captura y Procesamiento de Imagen	Como usuario, quiero tomar una foto con mi cámara o seleccionar una de la galería para identificar automáticamente los alimentos visibles. El sistema cargará la imagen y la procesará mediante un modelo de IA, detectando y clasificando alimentos (frutas, verduras, etc.). Si el servicio de IA falla, mostrará un mensaje de error.
HU02	Revisión y Validación de Resultados	Como usuario, quiero ver la lista de alimentos identificados para confirmar, corregir o descartar elementos antes de guardarlos. El sistema mostrará los resultados. Si la identificación es incierta, pedirá corrección manual. No registrará nada automáticamente sin verificación.
HU03	Incorporación al Inventario	Como usuario, quiero que los alimentos que he confirmado se agreguen a mi inventario para mantener mis existencias actualizadas. El sistema tomará los alimentos validados por el usuario y los guardará en la base de datos del inventario.
HU04	Sugerencias Basadas en Inventario	Como usuario, quiero recibir recomendaciones de recetas basadas en mis alimentos para aprovechar al máximo lo que ya tengo. El sistema analizará el inventario, buscará recetas compatibles y priorizará aquellas que usen la mayor cantidad de ingredientes disponibles.
HU05	Configuración de Parámetros de Recetas	Como usuario, quiero ajustar número de personas, tipo de comida, tiempo y restricciones para recibir recetas a mi medida. El sistema aplicará estos parámetros sobre los resultados de búsqueda para filtrar y ajustar las porciones recomendadas.
HU06	Detalle de Receta Recomendada	Como usuario, quiero ver los detalles completos de una receta recomendada para saber cómo prepararla y qué necesito. El sistema mostrará nombre, ingredientes requeridos (diferenciando disponibles y faltantes), cantidades y paso a paso.
HU07	Determinación del Estado de Ingredientes	Como usuario, quiero saber si tengo los ingredientes de una receta (total, parcial o nada) para planificar mi preparación. El sistema comparará la receta con el inventario, evaluará las cantidades y etiquetará cada ingrediente como disponible, parcial o faltante.
HU08	Cálculo de Porcentaje de Coincidencia	Como usuario, quiero ver un porcentaje de coincidencia en cada receta para saber qué tan viable es cocinarla hoy. El sistema calculará y mostrará el porcentaje basado en la relación entre los ingredientes requeridos y los disponibles en inventario.
HU09	Búsqueda de Establecimientos por Geolocalización	Como usuario, quiero encontrar tiendas cercanas para comprar los ingredientes que me faltan. El sistema solicitará permisos de ubicación (o permitirá ingreso manual) y consultará servicios de mapas, filtrando por proximidad.
HU10	Información y Rutas del Establecimiento	Como usuario, quiero ver los detalles de la tienda y cómo llegar para facilitar mi compra. El sistema mostrará nombre, distancia, horario, ubicación en mapa y, si la integración lo permite, indicaciones para llegar.
HU11	Administración Manual del Inventario	Como usuario, quiero ver mi inventario, agregar productos manualmente y modificar o eliminar los existentes para mantener el control. El sistema proveerá una interfaz para consultar y editar datos (nombre, cantidad, unidad, vencimiento) y eliminar productos erróneos o consumidos.
HU12	Sincronización en Tiempo Real	Como usuario, quiero que mis cambios en el inventario afecten inmediatamente las recomendaciones para tener información útil. El sistema sincronizará los cambios al instante, actualizando recetas sugeridas, alertas y listas de compras.
HU13	Generación de Alertas de Vencimiento	Como usuario, quiero recibir notificaciones previas sobre alimentos próximos a vencer para evitar que se echen a perder. El sistema comparará periódicamente las fechas, generará la alerta según la anticipación configurada y permitirá acceder al producto desde la notificación.
HU14	Control de Fechas de Caducidad	Como usuario, quiero poder agregar, editar o quitar fechas de vencimiento, o decidir la anticipación de la alerta. El sistema permitirá estas configuraciones y omitirá de las alertas a los productos que no tengan fecha registrada.
HU15	Aplicación y Combinación de Filtros	Como usuario, quiero aplicar múltiples filtros (vegano, sin gluten, etc.) para ver solo recetas aptas para mí. El sistema evaluará las recetas, aplicará los filtros activados (solos o combinados) y actualizará la lista de resultados.
HU16	Búsquedas sin Resultados	Como usuario, quiero saber si ninguna receta cumple con mis filtros para poder ajustar mi búsqueda. El sistema mostrará un mensaje claro indicando que no hay coincidencias simultáneas cuando la combinación de filtros sea muy restrictiva.
HU17	Consolidación de Lista de Compras	Como usuario, quiero generar una lista de compras automática a partir de varias recetas para saber exactamente qué comprar. El sistema identificará ingredientes faltantes, consolidará los repetidos sumando sus cantidades y omitirá lo que ya tengo.
HU18	Gestión y Seguimiento de Compras	Como usuario, quiero editar mi lista, agregar cosas extra y marcar productos como comprados mientras estoy en la tienda. El sistema permitirá agregar/eliminar ítems, cambiar estados (pendiente/comprado) y guardará la lista para consultas futuras.
HU19	Organización en Calendario Semanal	Como usuario, quiero asignar recetas a diferentes días y comidas (desayuno, cena, etc.) para organizar mi semana. El sistema mostrará un calendario interactivo donde se podrán asignar, modificar, reemplazar o eliminar recetas libremente.
HU20	Sugerencias Inteligentes y Control de Faltantes	Como usuario, quiero que el calendario me sugiera recetas con productos por vencer y me diga qué me falta para la semana. El sistema priorizará alimentos próximos a caducar en las sugerencias y permitirá generar una lista de compras basada en los faltantes del plan semanal.
HU21	Sugerencia de almacenamiento, recetas a partir de ingredientes guardados	Como usuario, quiero recibir sugerencias sobre cómo almacenar correctamente los ingredientes que tengo guardados y recetas que pueda preparar con ellos, para conservar mejor mis alimentos y aprovecharlos antes de que se deterioren. El sistema analizará los ingredientes registrados, sus cantidades y fechas de vencimiento para recomendar condiciones o métodos de almacenamiento adecuados y sugerir recetas que utilicen principalmente los productos disponibles, priorizando aquellos próximos a vencer. También indicará los ingredientes faltantes necesarios para preparar cada receta sugerida