# Despensapp - Gestión de Despensa Familiar

Aplicación Android moderna y colaborativa diseñada para gestionar el inventario de una despensa de forma compartida, con integración directa a MariaDB y Open Food Facts.

## 🚀 Novedades Recientes
*   **Seguimiento de Cambios:** Ahora puedes ver qué miembro de la familia realizó la última modificación en cada producto.
*   **Easy Family Sync:** Invita a miembros de tu familia compartiendo un código directamente desde los ajustes.
*   **Historial de Precios:** Seguimiento de la evolución de precios por supermercado.
*   **Comparativa de Supermercados:** Identifica dónde encontraste el producto por última vez y a qué precio.
*   **Configuración de Alertas:** Frecuencia de notificaciones personalizable (12h, 24h, 48h o Semanal).
*   **Gestión de Imágenes:** Sube tus propias fotos desde la galería o haz una foto directamente si el producto no tiene imagen en Open Food Facts.
*   **Inventario por Zonas (Smart Zoned Inventory):** Organiza tus productos por ubicación (Despensa, Nevera, Congelador, Baño, etc.) para un control más preciso.
*   **Valoración Financiera:** Visualiza el valor total de tu despensa y el presupuesto necesario para reponer lo que falta.

## 🛠 Funcionalidades Principales

### 🔐 Autenticación y Familia
*   **Acceso Multiusuario:** Registro e inicio de sesión conectado a MariaDB externa.
*   **Seguridad Biométrica:** Inicio de sesión rápido mediante huella dactilar, rostro o iris.
*   **Códigos de Familia:** Posibilidad de unirse a despensas existentes mediante códigos compartidos.
*   **Sesiones Seguras:** Gestión de sesión de usuario local para acceso rápido.

### 🍱 Gestión de Inventario Inteligente
*   **Escáner Avanzado:** Lector de códigos de barras con **Google ML Kit**, feedback háptico (vibración) y control de linterna integrado.
*   **Integración Doble:** Búsqueda automática en **Open Food Facts** con fallback a la base de datos local para productos ya conocidos.
*   **Control de Stock:** Botones de acceso rápido (+/-) en la lista principal y edición detallada.
*   **Alertas Visuales:** Indicadores de stock bajo (barras laterales rojas y iconos de advertencia) basados en mínimos personalizados.
*   **Categorización Dinámica:** Iconografía automática basada en la categoría del producto (Lácteos, Frescos, Limpieza, etc.).

### 📅 Control de Caducidad
*   **Seguimiento de Fechas:** Registro de fecha de caducidad con formato amigable (DD/MM/YYYY).
*   **Filtro Crítico:** Vista rápida de productos caducados o que caducarán en los próximos 7 días.
*   **Historial de Alta:** Registro automático de cuándo se añadió cada producto a la despensa.

### 🛒 Lista de la Compra y Compartir
*   **Generación Automática:** Filtro dedicado para productos bajo mínimos.
*   **Compartir:** Exporta y envía la lista de la compra por WhatsApp, Telegram o email con un solo toque.
*   **Cálculo de Costes:** Estimación del dinero necesario para completar la reposición de stock.

### 🔔 Notificaciones y Segundo Plano
*   **InventoryCheckWorker:** Tareas en segundo plano (WorkManager) que revisan el stock diariamente.
*   **Frecuencia Ajustable:** Elige desde los ajustes cada cuánto quieres recibir alertas de reposición.

## 🎨 Interfaz y Experiencia (UX)
*   **Material 3:** Interfaz moderna con componentes dinámicos y soporte para temas.
*   **Swipe to Action:** Borrado intuitivo deslizando elementos (Swipe-to-Delete).
*   **Feedback Visual:** Cargas progresivas, snackbars de confirmación y estados vacíos informativos.

## ⚙️ Especificaciones Técnicas
*   **Arquitectura:** MVVM-ish con Repositorios para abstracción de datos.
*   **Persistencia:** MariaDB Directo (JDBC) con soporte para red local y remota.
*   **Red:** Retrofit para Open Food Facts API y Coil para carga de imágenes asíncrona.
*   **Cámara:** CameraX para una integración fluida con el hardware.
*   **Mínimo SDK:** Android 31 (Android 12)
*   **Target SDK:** Android 37

## 🛤 Próximos Pasos
*   [x] Gestión de fechas de caducidad.
*   [x] Lista de la compra automática.
*   [x] Notificaciones push locales.
*   [ ] Exportación avanzada a PDF/CSV.
*   [ ] Modo offline con sincronización diferida.
*   [ ] Estadísticas de consumo mensual.