Skip to content

YoussefAKQ/SmartCart

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 

Repository files navigation

🛒 SmartCart

SmartCart es una aplicación innovadora para la planificación de compras en supermercados. Con ella, podrás crear listas de productos, encontrar opciones más económicas y obtener recomendaciones de recetas basadas en los productos seleccionados.

‼️ NOTA 1: Debido a las limitaciones con las APIs disponibles, no pude acceder a todos los datos necesarios, por lo que implementé varias soluciones improvisadas. Por ejemplo, el precio de los productos y las recomendaciones de productos en función del precio se generan mediante una función aleatoria. En cuanto a las recomendaciones de recetas, creé un archivo .js con una selección de recetas, ya que no pude encontrar ninguna API confiable en español para integrarla.

‼️ NOTA 2: El archivo firebaseConfig.js no se incluye, ya que contiene información sensible.


‼️ Funcionalidades

  • 📋 Crear y gestionar listas de productos: Organiza tus compras de manera eficiente y accesible.
  • 💡 Sugerencias de ahorro: Encuentra alternativas más económicas a los productos que estás comprando.
  • 📊 Cálculo del total en tiempo real: Visualiza el total de tu compra mientras añades productos.
  • 🍽️ Recomendaciones de recetas: Recibe sugerencias de recetas personalizadas según los productos de tu lista.

🛠️ Instrucciones de Uso

🔑 Iniciar Sesión

  1. Abre la aplicación.
  2. Ingresa tus credenciales y presiona "Iniciar Sesión".
  3. Si no tienes una cuenta, selecciona "Registrarse" y sigue las instrucciones.
  4. Una vez creada tu cuenta, inicia sesión.

🏠 Pantalla de Inicio

  1. Al iniciar sesión, accederás a la pantalla de inicio.
  2. En la parte superior encontrarás:
    • El logo de SmartCart.
    • Tu foto de perfil (tócala para gestionar tu cuenta).
  3. Tarjetas disponibles:
    • Total de Ahorro y Total de Gasto.
  4. En la sección "Listas" puedes ver cuántas listas tienes creadas.

Añadir y Administrar Listas

  1. Toca la tarjeta "Listas" para gestionar tus listas de productos.
  2. Añade una nueva lista ingresando un nombre y tocando "Añadir".
  3. Toca una lista existente para:
    • Ver sus detalles.
    • Agregar o eliminar productos.
  4. Para eliminar una lista:
    • Mantén presionada la lista que deseas eliminar.
    • Confirma la acción.

🛍️ Agregar Productos a una Lista

Opciones disponibles:

  1. Manualmente desde "Listas":

    • Ingresa el nombre del producto y su precio.
    • Toca "Añadir" para incluirlo.
    • Los productos aparecerán con su nombre y precio.
    • Para eliminar un producto, usa el botón "Eliminar".
  2. Automáticamente desde "Productos":

    • Ve a la pantalla de "Productos".
    • Busca el producto ingresando su nombre en el campo de búsqueda.
    • Selecciona un producto de la lista de resultados para agregarlo.
    • Si existe una opción más barata, se te notificará y podrás elegirla.

👤 Perfil del Usuario

  1. Accede tocando tu foto de perfil en la pantalla de inicio.
  2. En el perfil, puedes:
    • Ver tus datos de usuario.
    • Cambiar tu foto de perfil.
    • Cerrar sesión.
    • Restablecer tu contraseña (mediante correo de confirmación).
  3. Para cambiar la foto de perfil:
    • Toca la imagen actual y selecciona una nueva desde tu galería.
  4. Para cerrar sesión, presiona "Cerrar Sesión".
  5. Para restablecer tu contraseña, selecciona "Cambiar Contraseña" y sigue las instrucciones.

🚀 Actualizaciones

  • 05/12/2024:
    • Cambiar foto de perfil.
    • Gasto total visible en la HomeScreen.
    • Ahorro y cantidad de listas visibles en la HomeScreen.
    • Recetas sugeridas según productos.
    • Añadido icono de la aplicación.
  • 30/11/2024:
    • Mejoras en la manipulación y gestión de listas y productos.
    • Agregar productos dentro de listas específicas.
    • Búsqueda de productos mediante API externa.
  • 23/11/2024:
    • Cambio de contraseña desde el perfil.
    • Vista de perfil del usuario.
    • Autenticación segura con Firebase.

🖼️ Previsualización

Previsualización de SmartCart

Previsualización 1 Previsualización 2 Previsualización 3 Previsualización 4 Previsualización 5 Previsualización 6

Vídeo de funcionalidades básicas

Ver en YouTube

About

SmartCart es una aplicación innovadora para la planificación de compras en supermercados. Con ella, podrás crear listas de productos, encontrar opciones más económicas y obtener recomendaciones de recetas basadas en los productos seleccionados.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors