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.
  • 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.
  • 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

  • Gestión de fechas de caducidad.
  • Lista de la compra automática.
  • Notificaciones push locales.
  • Exportación avanzada a PDF/CSV.
  • Modo offline con sincronización diferida.
  • Estadísticas de consumo mensual.
S
Description
No description provided
Readme
489 KiB
Languages
Kotlin 100%