Requerimientos

Requerimientos Funcionales

Requerimiento Funcional (RF)	ID	Título de la Historia	Descripción y Comportamiento del Sistema
RF-01. Identificación de alimentos mediante reconocimiento de imágenes	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.
RF-02. Generación de recetas personalizadas	HU01	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.
	HU02	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.
	HU03	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.
RF-03. Comparación de ingredientes disponibles y faltantes	HU01	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.
	HU02	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.
RF-04. Recomendación de establecimientos cercanos	HU01	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.
	HU02	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.
RF-05. Gestión del inventario de alimentos	HU01	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.
	HU02	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.
RF-06. Notificación de vencimiento de productos	HU01	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.
	HU02	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.
RF-07. Filtrado de recetas por preferencias	HU01	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.
	HU02	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.
RF-08. Generación automática de lista de compras	HU01	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.
	HU02	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.
RF-09. Planificación semanal de menús	HU01	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.
	HU02	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.