Hubee - Plataforma de Dropshipping

Descripcion del Proyecto

Hubee es una plataforma SaaS de dropshipping que conecta proveedores con revendedores en Colombia. Elimina la necesidad de stock propio: los vendedores listan productos del catalogo de Hubee, toman pedidos y la plataforma coordina el despacho directo desde el proveedor al cliente final. Arquitectura de tres repositorios coordinados: backend en Go, frontend en Next.js y un repo de infraestructura como codigo.

Caracteristicas Principales

• Multi-tenant con roles jerarquicos: SuperAdmin, Admin de Organizacion y Operador con permisos granulares por rol y por pertenencia a organizacion
• Gestion de catalogo: Productos con variantes por color y talle, precio base + precio sugerido al publico, stock real por combinacion
• Importacion masiva: Carga de catalogo desde CSV o Excel con validacion y feedback de errores por fila
• Organizaciones y Fabricas: CRUD de proveedores (Organizations) con sus fabricas internas, alta en una sola operacion con usuario admin inicial
• Autenticacion robusta: JWT + refresh token con middleware de autorizacion en backend y guards de rutas en frontend
• Deploy automatizado: Pipeline CI/CD via GitHub Actions + AWS SSM que deploya al hacer push a main

Tecnologias Utilizadas

Backend (Go)

• Go + Gin: API REST de alto rendimiento con middleware de autorizacion por rol
• GORM + PostgreSQL: ORM con esquema relacional y migraciones versionadas con Goose
• Redis: Cache y manejo de sesiones
• JWT (golang-jwt): Autenticacion stateless con access + refresh tokens
• AWS SES: Envio de emails transaccionales
• Cloudinary: Almacenamiento y optimizacion de imagenes de productos
• ULID: IDs ordenables cronologicamente en lugar de UUID

Frontend (Next.js)

• Next.js 16 + React 19: Dashboard con SSR y App Router
• TailwindCSS 4 + Radix UI: UI accesible y componentes reutilizables
• TanStack React Query: Data fetching con cache y sincronizacion de estado servidor
• Zustand: Estado global del cliente
• React Hook Form + Zod 4: Formularios type-safe con validacion robusta
• i18next: Internacionalizacion ES/EN
• Recharts: Graficos y analiticas del dashboard

Infraestructura

• Terraform: Infraestructura como codigo — VPC, EC2, EIP, SES, IAM, GitHub OIDC
• Docker Compose + Caddy: Orquestacion de servicios con HTTPS automatico
• AWS EC2: Backend y base de datos productivos
• GitHub Actions: CI con lint, tests y typecheck en Go y TypeScript

Arquitectura

Monorepo de tres repositorios coordinados:

1. hubee-backend (Go + Gin): API REST con arquitectura en capas — handlers, services, repositories, domain models. Multi-tenant desde el middleware: cada request valida rol y pertenencia a organizacion antes de llegar al handler
2. hubee-frontend (Next.js): Dashboard administrativo con guards de ruta por rol, data fetching con React Query y formularios con validacion client-side + server-side
3. hubee-infra (Terraform + Docker): Infraestructura reproducible — un solo terraform apply levanta toda la plataforma en AWS desde cero