64 lines
4.2 KiB
Markdown
64 lines
4.2 KiB
Markdown
# 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.
|