$cd/projects/shopup

🚧 En Desarrollo Activo

Backend

📅 Sprint 4/∞

ShopUp - Plataforma E-commerce con Microservicios

Plataforma integral de comercio electrónico con arquitectura de microservicios, funcionalidades potenciadas por IA y autenticación basada en roles para pequeñas y medianas empresas.

Agosto 2024 - Presente (Sprint 8/∞ - En desarrollo activo)

Proyecto Final ISI - Equipo de 4 desarrolladores

25 tecnologías

Ver Demo

$ cat tech-stack.json

Características destacadas

Arquitectura de microservicios con Spring Cloud Gateway

Funcionalidades IA: carga de voz, búsqueda semántica, embeddings

Autenticación basada en roles con Keycloak (emprendedor, comprador, admin)

Autorización a nivel de recursos con comparación UUID JWT

Arquitectura hexagonal con separación limpia de responsabilidades

Actualizaciones dirigidas por eventos para indexación de búsqueda

Procesamiento de audio en tiempo real con API Whisper

Integración completa de pagos con MercadoPago

Sistema de carrito de compras y gestión de pedidos

Geolocalización de negocios con integración Google Maps

Stack tecnológico

Java 24

Spring Boot 3.4+

Spring Cloud Gateway

Spring Security

Spring Data JPA

PostgreSQL

OpenSearch

Keycloak

React 19

Vite

Material-UI v7

Redux Toolkit

Python

FastAPI

OpenAI API

Whisper

Embeddings

Docker

Docker Compose

Nginx

Maven

Swagger/OpenAPI

JWT

MercadoPago API

Google Maps API

🎯 Problema

Las pequeñas y medianas empresas necesitan una plataforma integral para gestionar catálogos de productos, aumentar visibilidad, manejar ventas y construir confianza del cliente a través de calificaciones y reseñas, con asistencia IA para experiencia de usuario mejorada.

💡 Solución

Plataforma de comercio electrónico basada en microservicios con funcionalidades potenciadas por IA incluyendo procesamiento de carga de voz, búsqueda semántica con embeddings, sistema de autenticación basado en roles e integración de pagos en tiempo real a través de API MercadoPago.

📊 Impacto

Solución completa de marketplace que permite a emprendedores gestionar sus negocios eficientemente mientras proporciona a compradores capacidades avanzadas de búsqueda y experiencia de compra fluida con descubrimiento de productos mejorado por IA.

$ git log --oneline --graph sprints/

Progreso de desarrollo organizado en sprints ágiles con historias de usuario específicas y entregables

Sprint 1: Sprint 1 - Fundación y Autenticación

Completado

Sprint 2: Sprint 2 - Lógica de Negocio Central

Completado

Sprint 3: Sprint 3 - Integración IA y Funcionalidades de Voz

Completado

Sprint 4: Sprint 4 - Gestión de Productos

Completado

Sprint 5: Sprint 5 - Gestión de Catálogos y Mejoras de Voz

Completado

Sprint 6: Sprint 6 - Carrito de Compras y Experiencia del Comprador

Completado

Sprint 7: Sprint 7 - Integración de Pagos y Mejoras UX

Completado

Sprint 8: Sprint 8 - Gestión de Ventas y Geolocalización

ACTUAL

En Progreso

📋 User Stories:

•Registro automático de ventas cuando compradores completan compras
•SPIKE: Implementación personalizada Google Maps para geolocalización de negocios
•Funcionalidad de búsqueda de negocios para compradores con conciencia de ubicación
•Vista completa de tienda emprendedora usando especificaciones de diseño de Fede
•Vista de consulta de ventas para emprendedores con analíticas
•Vista de consulta de ventas para compradores con historial de pedidos

🔧 Logros Técnicos:

Implementación de sistema de registro automático de ventas

Integración personalizada Google Maps para servicios de ubicación de negocios

Funcionalidad de búsqueda de negocios con filtrado basado en ubicación

Vistas completas de consulta de ventas para todos los roles de usuario

🎯 Foco Actual:

⚡Integración API Google Maps y componentes de mapa personalizados
⚡Automatización de flujo de trabajo de ventas y procesamiento de pedidos
⚡Algoritmos de descubrimiento de negocios basados en ubicación
⚡UI/UX mejorado para gestión de tiendas y ventas

Sprint 8/∞En desarrollo...

📊 Estadísticas de Desarrollo

Sprints Completados

En Progreso

User Stories Total

Semanas de Desarrollo

$ docker-compose ps --services

Arquitectura distribuida de microservicios con API Gateway centralizado, servicios especializados y bases de datos dedicadas. Implementa patrones de Diseño Dirigido por Dominio y arquitectura hexagonal para mantenibilidad y escalabilidad.

🏗️ Arquitectura de Microservicios

Gateway Layer

API Gateway

:8080

• Enrutamiento

• Autenticación JWT

• Rate Limiting

Services Layer

Core Service

:8081

• Emprendimientos

• Productos

• Arquitectura Hexagonal

AI Service

:8082

• Audio-to-Text

• Embeddings

• Búsqueda Semántica

Data Layer

PostgreSQL

:5432

• Datos principales

• Triggers

OpenSearch

:9200

• Búsquedas vectoriales

• Embeddings

Keycloak

:8083

• OAuth2/JWT

• Gestión usuarios

Backend

Java 24

Spring Boot 3.4+

Spring Cloud Gateway

Spring Security

Spring Data JPA

Database

PostgreSQL

OpenSearch

Security

Keycloak

JWT

Frontend

React 19

Vite

Material-UI v7

Redux Toolkit

AI/ML

Python

FastAPI

OpenAI API

Whisper

Embeddings

DevOps

Docker

Docker Compose

Nginx

Maven

Swagger/OpenAPI

Other

MercadoPago API

Google Maps API

🔌 Integraciones Externas

Keycloak para gestión de identidad y acceso con tokens JWT

PostgreSQL como base de datos primaria para servicio Core

OpenSearch para búsqueda de productos y almacenamiento de embeddings

API OpenAI para funcionalidades IA y procesamiento de voz

API MercadoPago para procesamiento de pagos con manejo de webhooks

API Google Maps para geolocalización y descubrimiento de negocios

Docker y Docker Compose para contenerización

Nginx para servir activos estáticos en producción