Skip to content

About

Aplicación de comercio electrónico

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

111 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🛒 E-Commerce Full Stack Platform

Java Spring Boot PostgreSQL React Redux Tailwind CSS Material UI Stripe

Una aplicación de comercio electrónico robusta y escalable desarrollada con Java 25, Spring Boot 4 y React 19.

🌍 Ver Despliegue en Vivo » · Explorar Funcionalidades · Instalación Local


📖 Sobre el Proyecto

Este proyecto es una aplicación full stack de nivel productivo desarrollada para el portfolio personal. El objetivo principal fue construir una arquitectura escalable aplicando buenas prácticas de desarrollo, separación estricta de responsabilidades y las tecnologías más modernas del ecosistema Java y JavaScript.

Incluye el ciclo completo de un eCommerce: desde la gestión de productos y categorías, hasta la autenticación segura de usuarios, gestión del carrito, órdenes de compra e integración de pagos.

✨ Funcionalidades Principales

  • 🔐 Seguridad y Autenticación: Registro e inicio de sesión seguro con Spring Security y JWT. Gestión de roles (Administrador / Usuario Cliente).
  • 🛍️ Catálogo Dinámico: Exploración de productos con búsqueda avanzada, paginación y filtros por categorías.
  • 🛒 Carrito y Checkout: Gestión ágil del carrito de compras, direcciones de envío y un proceso de checkout fluido.
  • 💳 Integración de Pagos: Implementación de flujos de pago con Stripe (Frontend y Backend).
  • 📦 Panel de Administración: Herramientas exclusivas para que los administradores gestionen productos, categorías y el estado de los pedidos.
  • 📱 Diseño Moderno y Responsivo: Interfaz de usuario intuitiva y adaptable a móviles construida con Tailwind CSS y Material UI (MUI).
  • 📄 Documentación Interactiva: API REST completamente documentada y explorable gracias a Swagger (Springdoc OpenAPI).

🛠️ Tecnologías y Herramientas

⚙️ Backend (/ecom-backend)

  • Core: Java 25, Spring Boot 4.0.4
  • Persistencia de Datos: Spring Data JPA, Hibernate, PostgreSQL
  • Seguridad: Spring Security, JWT (JSON Web Tokens)
  • Herramientas: Maven, Lombok, DTOs Pattern
  • Integraciones: Stripe Java, Swagger (Springdoc)

🎨 Frontend (/ecom-frontend)

  • Core: React 19, Vite
  • Gestión de Estado y Enrutamiento: Redux Toolkit, React Router
  • Estilos y Componentes: Tailwind CSS, Material UI (MUI)
  • Formularios y Peticiones: React Hook Form, Axios
  • Integraciones: Stripe React

🚀 Cómo Ejecutar el Proyecto Localmente

Para probar este proyecto en tu máquina local, asegúrate de tener instalado Java 25, Node.js, Maven y PostgreSQL.

1. Clonar el repositorio

git clone https://github.com/tu-usuario/eCommerce-Project.git
cd eCommerce-Project

2. Configurar y levantar el Backend

  1. Navega al directorio del backend:
    cd ecom-backend
  2. Crea una base de datos en PostgreSQL para el proyecto.
  3. Configura tus variables de entorno o edita el archivo application.properties con:
    • Tus credenciales de PostgreSQL.
    • Tu clave secreta para JWT.
    • Tus API Keys de Stripe.
  4. Compila e inicia el servidor:
    mvn clean install
    mvn spring-boot:run
    La API estará disponible en http://localhost:8080 y la documentación de Swagger en http://localhost:8080/swagger-ui.html

3. Configurar y levantar el Frontend

  1. Abre una nueva terminal y navega al directorio del frontend:
    cd ecom-frontend
  2. Instala las dependencias del proyecto:
    npm install
  3. Configura las variables de entorno necesarias (ej. la URL del backend y las claves públicas de Stripe) creando un archivo .env.
  4. Inicia el servidor de desarrollo:
    npm run dev
    La aplicación web estará disponible en http://localhost:5173

📸 Vistas de la Aplicación

Landing Page Catálogo de Productos
Landing Page Catálogo
Carrito de Compras Panel de Administración
Carrito Dashboard

🎯 Conclusiones y Aprendizajes

La creación de este eCommerce me permitió afianzar conocimientos avanzados en el desarrollo Full Stack, específicamente logrando:

  • Diseñar una arquitectura RESTful limpia y mantenible separando responsabilidades en capas.
  • Implementar flujos de seguridad robustos protegiendo endpoints y vistas del lado del cliente.
  • Manejar un estado global complejo en el frontend de forma predecible con Redux Toolkit.
  • Integrar de forma exitosa plataformas de terceros como la pasarela de pagos de Stripe.
  • Prepararme para desafíos mayores en arquitecturas empresariales, microservicios y despliegues en la nube.

Desarrollado por Facundo 👨‍💻
Si te gustó el proyecto no olvides dejar una ⭐

About

Aplicación de comercio electrónico

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages