Fin de aplicación

README.md

@@ -0,0 +1,51 @@
+# Despensapp - Gestión de Despensa Familiar
+
+Aplicación Android diseñada para gestionar el inventario de una despensa de forma compartida, con integración directa a MariaDB y Open Food Facts.
+
+## Funcionalidades Actuales
+
+### 🔐 Autenticación Multiusuario
+*   **Login y Registro:** Conexión directa a una base de datos MariaDB externa (`mariadb.peta9.com`).
+*   **Gestión de Cuentas:** Registro de usuarios con nombre completo, email y contraseña.
+*   **Seguridad:** Uso de hilos secundarios (Coroutines) para no bloquear la interfaz durante la conexión.
+
+### 🍱 Gestión de Inventario
+*   **Visualización en Tiempo Real:** Lista de productos traída directamente desde MariaDB con soporte para unidades (kg, l, gr, etc.).
+*   **Imágenes de Productos:** Integración con **Coil** para mostrar las imágenes de los productos obtenidas de Open Food Facts.
+*   **Detalles Extendidos:** Pantalla de detalles para cada producto con información técnica de MariaDB.
+*   **Búsqueda y Categorización:** Filtro por nombre y categorías dinámicas para una localización rápida.
+*   **Swipe to Delete:** Borrado intuitivo de productos deslizando hacia la izquierda (Material 3).
+*   **Fecha de Caducidad:** Seguimiento de la caducidad de cada producto para evitar desperdicios.
+*   **Filtro Inteligente:** Filtro para ver rápidamente qué productos han caducado o están a punto de hacerlo (7 días o menos).
+*   **Formato de Fecha:** Visualización de fechas en formato amigable (DD/MM/YYYY) en toda la aplicación.
+*   **Lista de la Compra:** Modo dedicado que muestra únicamente los productos con stock bajo.
+*   **Historial de Alta:** Registro automático de la fecha y hora en la que se añadió cada producto.
+*   **Alertas de Stock Bajo:** Indicadores visuales en rojo cuando un producto está por debajo de su cantidad mínima.
+*   **Notificaciones Automáticas:** El sistema revisa diariamente el inventario y envía notificaciones al móvil sobre stock bajo.
+*   **Control Rápido:** Botones de incremento/decremento en la pantalla principal para actualizar el stock rápidamente.
+*   **Edición Completa:** Modo de edición total en la pantalla de detalle para modificar nombre, stock, stock mínimo, categoría y caducidad.
+*   **Compartir Lista:** Botón para compartir la lista de la compra directamente desde la aplicación a servicios de mensajería (WhatsApp, etc.).
+*   **Iconografía Dinámica:** Asignación inteligente de iconos de Material Design basados en la categoría del producto (Lácteos, Carnicería, Fresco, etc.).
+*   **Cierre de Sesión:** Opción para cerrar la sesión actual y volver de forma segura a la pantalla de bienvenida.
+
+### 🎨 Identidad Visual
+*   **Icono Personalizado:** Diseño de icono adaptativo único que representa un mueble de despensa lleno de productos.
+*   **Interfaz Material 3:** Uso de los últimos estándares de diseño de Google para una experiencia fluida y moderna.
+*   **Colores Amigables:** Paleta de colores personalizada para mejorar la legibilidad y la estética familiar.
+
+### 🔍 Integración con APIs y Hardware
+*   **Escáner de Código de Barras:** Uso de **CameraX** y **Google ML Kit** con **Feedback Háptico** (vibración) al detectar productos.
+*   **Linterna:** Botón integrado en el escáner para encender y apagar el flash en entornos oscuros.
+*   **Open Food Facts:** Búsqueda automática de nombres, categorías e imágenes al escanear un código de barras.
+*   **MariaDB Directo:** Conexión JDBC para persistencia de datos compartida.
+
+## Próximos Pasos
+*   [x] Gestión de fechas de caducidad.
+*   [x] Lista de la compra automática basada en el stock bajo.
+*   [ ] Compartir despensas específicas mediante códigos de familia.
+*   [ ] Exportar inventario a PDF/CSV.
+
+## Requisitos Técnicos
+*   Android SDK 34+
+*   Conexión a Internet (para API y DB remota).
+*   Permiso de Cámara (para el escáner).