HU - Yirene58/Menu-Inteligente GitHub Wiki
| 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 Selección de Imagen |
Como usuario, quiero tomar una foto directamente o seleccionar una de la galería para enviar la fotografía de los alimentos a registrar. El sistema solicitará permisos de cámara/almacenamiento. Una vez otorgados, el usuario podrá elegir la fuente y ver una vista previa antes de enviar. |
| HU02 | Detección y Clasificación Automática de Alimentos |
Como usuario, quiero que la app analice la imagen con IA para obtener una lista previa de alimentos sin ingresarlos manualmente. El sistema identificará categorías (frutas, verduras, etc.). Si la precisión es baja, marcará el estado como incierto. Si no hay elementos, informará al usuario. |
|
| HU03 | Revisión y Validación de Resultados |
Como usuario, quiero revisar la lista detectada para confirmar, editar o descartar objetos. Ningún producto se registrará sin aprobación. El sistema ofrecerá controles individuales por elemento (confirmar, modificar, eliminar) y permitirá agregar manualmente alimentos no detectados. |
|
| HU04 | Confirmación e Incorporación al Inventario |
Como usuario, quiero guardar solo los alimentos verificados para mantener un registro preciso. El sistema procesará solo ítems confirmados, descartando los rechazados, y mostrará un mensaje de éxito al finalizar. |
|
| RF-02. Generación de recetas personalizadas | HU01 | Configuración de Parámetros y Filtros de Recetas |
Como usuario, quiero definir comensales, tipo de comida, tiempo y restricciones para recibir propuestas adaptadas. El sistema presentará una interfaz para estos parámetros, guardando y aplicando las restricciones predeterminadas del usuario. |
| HU02 | Análisis e Identificación de Recetas Compatibles |
Como usuario, quiero que la app compare mi inventario con el catálogo de recetas para aprovechar mis ingredientes. El algoritmo evaluará los insumos activos, encontrando coincidencias totales o parciales, y descartará recetas con ingredientes restringidos. |
|
| HU03 | Priorización y Listado Sugerido de Recetas |
Como usuario, quiero ver una lista ordenada donde destaquen las recetas que usen más de mis ingredientes. El sistema listará jerárquicamente las recetas (menor cantidad de faltantes arriba), mostrando vista previa, tiempo y nivel de aprovechamiento. |
|
| HU04 | Visualización Detallada de la Receta y Balance |
Como usuario, quiero ver el detalle de la receta, diferenciando ingredientes disponibles de faltantes. El sistema mostrará porciones, instrucciones paso a paso y un desglose de cantidades dividido en "disponibles" y "faltantes". |
|
| RF-03. Comparación de ingredientes disponibles y faltantes | HU01 | Comparación Automática de Ingredientes |
Como usuario, quiero que la app compare automáticamente la receta con mi inventario para saber qué tengo. El sistema buscará coincidencias exactas por nombre y marcará si el producto existe o está ausente. |
| HU02 | Detección de Cantidades e Ingredientes Parciales |
Como usuario, quiero comparar cantidades para saber si me alcanza. El sistema marcará como "Disponible" (cantidad completa), "Parcial" (no alcanza) o "Faltante" (no hay nada). |
|
| HU03 | Cálculo del Porcentaje de Coincidencia |
Como usuario, quiero ver un porcentaje de coincidencia para saber qué tan cerca estoy de poder cocinarla. El sistema dividirá los ingredientes disponibles entre el total y mostrará un porcentaje simple (por ejemplo, 80%). |
|
| HU04 | Vista Clasificada de Ingredientes |
Como usuario, quiero ver los ingredientes organizados en tres listas simples para revisar rápidamente. El sistema agrupará los ingredientes en Disponibles, Parciales y Faltantes con sus cantidades. |
|
| RF-04. Recomendación de establecimientos cercanos | HU01 | Acceso y Selección de Ubicación |
Como usuario, quiero permitir el acceso a mi ubicación o ingresar una dirección para buscar comercios. El sistema pedirá permisos; si se aceptan, detectará coordenadas. Si no, habilitará un campo de texto. |
| HU02 | Búsqueda y Lista de Establecimientos Cercanos |
Como usuario, quiero ver una lista de supermercados/tiendas cercanas para comprar faltantes. El sistema consultará un mapa (Google Maps/Mapbox) y desplegará comercios ordenados por distancia. |
|
| HU03 | Visualización de Comercios en Mapa y Detalles |
Como usuario, quiero ver las tiendas en un mapa interactivo con sus detalles básicos. El sistema mostrará un mapa con marcadores y tarjetas de detalle (nombre, dirección, distancia, horario). |
|
| HU04 | Indicaciones para Llegar al Establecimiento |
Como usuario, quiero presionar un botón para obtener la ruta hacia la tienda. El sistema redirigirá a la app externa de mapas del dispositivo con la ruta trazada. |
|
| RF-05. Gestión del inventario de alimentos | HU01 | Consulta Visual del Inventario |
Como usuario, quiero ver una lista de todos mis alimentos guardados para saber con qué cuento. El sistema mostrará nombre, cantidad, unidad y fecha de vencimiento de cada producto. |
| HU02 | Registro Manual de Alimentos |
Como usuario, quiero agregar alimentos manualmente mediante un formulario sencillo. El sistema ofrecerá un botón para ingresar nombre, cantidad, unidad de medida y caducidad opcional. |
|
| HU03 | Edición de Productos del Inventario |
Como usuario, quiero modificar la información/cantidad de cualquier alimento. El sistema permitirá seleccionar un producto, editar sus campos y guardar los cambios inmediatamente. |
|
| HU04 | Eliminación de Alimentos |
Como usuario, quiero borrar productos de mi inventario (consumidos, caducados o errores). El sistema pedirá confirmación rápida y removerá el producto de la base de datos. |
|
| HU05 | Sincronización Inmediata del Inventario |
Como usuario, quiero que los cambios se actualicen al instante para que el generador de recetas use datos reales. El sistema actualizará la BD tras crear, editar o eliminar, garantizando saldos vigentes. |
|
| RF-06. Notificación de vencimiento de productos | HU01 | Configuración del Tiempo de Anticipación para Alertas |
Como usuario, quiero definir los días de anticipación de los avisos de vencimiento. El sistema incluirá un ajuste para esto (ej. 1, 3 o 5 días). Por defecto, usará 3 días. |
| HU02 | Verificación Automática y Alertas de Vencimiento |
Como usuario, quiero recibir notificaciones sobre alimentos próximos a caducar. El sistema verificará periódicamente las fechas y enviará una notificación con el nombre y fecha límite del producto. |
|
| HU03 | Acceso Directo al Producto desde la Notificación |
Como usuario, quiero presionar la notificación para ir directo a la vista del alimento. El sistema abrirá la app y navegará al detalle del producto para permitir consumirlo, editarlo o buscar recetas. |
|
| HU04 | Exclusión y Control de Fechas de Caducidad |
Como usuario, quiero modificar/quitar fechas de caducidad para evitar falsas alarmas. El sistema omitirá chequeos de productos sin fecha y permitirá editar o eliminar este dato desde el formulario. |
|
| RF-07. Filtrado de recetas por preferencias | HU01 | Selección y Combinación de Filtros Alimentarios |
Como usuario, quiero seleccionar filtros (vegetariano, sin gluten, etc.) para ver recetas adaptadas a mí. El sistema mostrará un menú con opciones combinables que se pueden activar/desactivar. |
| HU02 | Aplicación y Actualización de Resultados |
Como usuario, quiero que la lista se actualice al instante al cambiar un filtro. El sistema evaluará el catálogo y mostrará solo las recetas que cumplan con todos los criterios activos. |
|
| HU03 | Manejo de Búsquedas sin Coincidencias |
Como usuario, quiero ver un aviso claro cuando no haya recetas que cumplan mis filtros. El sistema mostrará un mensaje amigable indicando la ausencia de resultados y sugerirá modificar los filtros. |
|
| RF-08. Generación automática de lista de compras | HU01 | Consolidación y Agrupación Automática de Faltantes |
Como usuario, quiero que la app genere automáticamente una lista de compras basada en recetas seleccionadas. El sistema comparará insumos con el inventario, sumará ingredientes repetidos y creará una lista consolidada sin duplicados. |
| HU02 | Gestión Manual de Productos en la Lista |
Como usuario, quiero agregar o borrar productos manualmente de mi lista de compras. El sistema ofrecerá un campo rápido para añadir extras y una opción para eliminar cualquier ítem. |
|
| HU03 | Marcado de Productos Comprados y Guardado |
Como usuario, quiero tachar productos como comprados en la tienda y conservar la lista. El sistema permitirá cambiar el estado de cada ítem y guardará la lista automáticamente para futuras consultas. |
|
| RF-09. Planificación semanal de menús | HU01 | Asignación de Recetas al Calendario Semanal |
Como usuario, quiero organizar comidas asignando recetas a días y horarios (desayuno, almuerzo, etc.). El sistema mostrará un calendario donde el usuario podrá vincular recetas del catálogo a días específicos. |
| HU02 | Sugerencias Inteligentes por Vencimiento |
Como usuario, quiero que el planificador recomiende recetas con ingredientes próximos a vencer. El sistema destacará opciones que aprovechen los productos más cercanos a su caducidad. |
|
| HU03 | Verificación de Ingredientes y Compras desde Menú |
Como usuario, quiero ver qué ingredientes faltan para el plan semanal y enviarlos a la lista de compras. El sistema evaluará el inventario frente a las recetas agendadas y ofrecerá un botón para agregar faltantes a la lista. |
|
| HU04 | Edición y Reorganización del Plan Semanal |
Como usuario, quiero cambiar o eliminar recetas de mi calendario para ajustar mis planes. El sistema permitirá arrastrar, sustituir o borrar recetas del calendario semanal de forma rápida. |