Skip to content

J4t1x/fruteria-app

Repository files navigation

🍊 fruteria-app

fruteria-app es una plataforma de comercio electrónico desarrollada con Angular 19, enfocada en la venta de frutas y verduras frescas, naturales y de origen local. Permite a los usuarios comprar en línea desde un catálogo variado, gestionar su carrito y confirmar pedidos con entrega directa a domicilio o retiro en tienda.


🛠️ Tecnologías utilizadas

  • Angular 19 – Framework principal para SPA robustas.
  • Tailwind CSS – Framework CSS de utilidad para diseño responsive.
  • Flowbite – Componentes UI rápidos y elegantes.
  • TypeScript – Para estructurar la lógica con tipado estricto.
  • LocalStorage – Persistencia de carrito sin login.

🧠 Lógica de negocio

La app se basa en una lógica clara, escalable y funcional:

  • Los productos pueden tener diferentes unidades de medida (kg, unidad, cajas).
  • Cada producto contiene descripción, precio, unidad, imagen y stock.
  • El usuario puede agregar múltiples productos al carrito, modificar cantidades o eliminarlos.
  • Al confirmar el pedido, se recopilan los datos personales, dirección y método de entrega.
  • El sistema calcula automáticamente el total con base en cantidades y precios.
  • Permite distinguir entre retirar en tienda o despacho a domicilio, afectando la validación de datos.

🚀 Funcionalidades principales

  • 🛒 Carrito de compras dinámico

    • Agrega productos al carrito con selector de cantidad.
    • Modifica o elimina productos directamente.
    • Visualiza en tiempo real el subtotal y total acumulado.
    • Persistencia del carrito aunque recargues la página.
  • 📦 Gestión de pedidos

    • Formulario de datos del cliente.
    • Selección de método de entrega: despacho o retiro.
    • Resumen completo del pedido antes de finalizar.
    • Lógica validada por región, comuna y dirección.
  • 🧾 Resumen detallado

    • Cálculo automático del total.
    • Detalle de productos con nombre, precio y cantidad.

🔮 Posibilidades de mejora futuras

  • 🧠 Autenticación y cuenta de usuario.
  • 📍 Cálculo automático de costos de despacho por comuna.
  • 📊 Backend para administración de stock en tiempo real.
  • 💳 Integración con pasarelas de pago.
  • 🧾 Historial de compras para el cliente.
  • 🌐 Internacionalización del idioma.

🔎 Filtros y búsqueda

  • 🔍 Buscador dinámico: Encuentra productos rápidamente por nombre.
  • 🧃 Preparado para filtros: Clasificación futura por categorías (frutas, verduras, orgánicos, ofertas, etc.).

🧺 Productos destacados

  • 🥑 Palta
  • 🍅 Tomate
  • 🍓 Frutilla
  • 🧅 Cebolla
  • 🥕 Zanahoria
  • 🍌 Plátano
  • 🫑 Morrón
  • 📦 Cajas mixtas: 6 kg, 10 kg y 18 kg

Cada producto incluye:

  • Imagen destacada
  • Precio unitario
  • Descripción nutricional/culinaria
  • Botón de “Ver Detalles” y “Agregar al Carrito”

🚚 Flujo de compra y despacho

  1. El usuario elige sus productos y cantidades.
  2. Revisa su carrito y ajusta el pedido si es necesario.
  3. Llena el formulario de cliente y elige:
    • Despacho a domicilio (requiere dirección completa)
    • Retiro en local (se omite dirección)
  4. Se muestra un resumen detallado del pedido.
  5. El pedido se confirma y puede ser procesado manual o automáticamente en un futuro backend.

📱 Diseño responsivo

La interfaz se adapta a dispositivos móviles y desktop con una experiencia visual fluida, moderna y limpia. Usa íconos, colores vibrantes y botones claros para facilitar la navegación y aumentar la conversión.


🧑‍🌾 Misión

Apoyar la economía local conectando directamente a los consumidores con productores agrícolas. Promueve la alimentación saludable, los productos sin intermediarios y el consumo consciente.


📇 Créditos

Desarrollado por Jardcode.cl
© 2025 – Todos los derechos reservados.

About

🍊 Plataforma web de venta de frutas y verduras frescas, con carrito de compras, confirmación de pedidos y despacho a domicilio. Desarrollada en Angular 19, Tailwind CSS y Flowbite. Promueve el consumo local con filtros, buscador en tiempo real y diseño responsive

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors