Hubee - Dropshipping Platform

Project Description

Hubee is a dropshipping SaaS platform that connects suppliers with resellers in Colombia. It eliminates the need for personal inventory: sellers list products from Hubee’s catalog, take orders, and the platform coordinates direct shipment from the supplier to the end customer. Three-repository architecture: Go backend, Next.js frontend, and an infrastructure-as-code repo.

Key Features

• Multi-tenant with hierarchical roles: SuperAdmin, Organization Admin, and Operator with granular permissions per role and per organization membership
• Catalog management: Products with color × size variants, base price + suggested retail price, real stock per combination
• Bulk import: Catalog loading from CSV or Excel with per-row validation and error feedback
• Organizations and Factories: Supplier CRUD with internal factories, created in a single operation with an initial admin user
• Robust authentication: JWT + refresh token with authorization middleware on the backend and route guards on the frontend
• Automated deploy: CI/CD pipeline via GitHub Actions + AWS SSM that deploys on push to main

Technologies Used

Backend (Go)

• Go + Gin: High-performance REST API with role-based authorization middleware
• GORM + PostgreSQL: ORM with relational schema and versioned migrations via Goose
• Redis: Cache and session management
• JWT (golang-jwt): Stateless authentication with access + refresh tokens
• AWS SES: Transactional email delivery
• Cloudinary: Product image storage and optimization
• ULID: Chronologically sortable IDs instead of UUID

Frontend (Next.js)

• Next.js 16 + React 19: SSR dashboard with App Router
• TailwindCSS 4 + Radix UI: Accessible UI and reusable components
• TanStack React Query: Data fetching with cache and server state synchronization
• Zustand: Global client state management
• React Hook Form + Zod 4: Type-safe forms with robust validation
• i18next: ES/EN internationalization
• Recharts: Dashboard charts and analytics

Infrastructure

• Terraform: Infrastructure as code — VPC, EC2, EIP, SES, IAM, GitHub OIDC
• Docker Compose + Caddy: Service orchestration with automatic HTTPS
• AWS EC2: Production backend and database
• GitHub Actions: CI with lint, tests and typecheck for both Go and TypeScript

Architecture

Three coordinated repositories:

1. hubee-backend (Go + Gin): REST API with layered architecture — handlers, services, repositories, domain models. Multi-tenant from the middleware: every request validates role and organization membership before reaching the handler
2. hubee-frontend (Next.js): Admin dashboard with role-based route guards, React Query data fetching, and forms with client-side + server-side validation
3. hubee-infra (Terraform + Docker): Reproducible infrastructure — a single terraform apply stands up the entire platform on AWS from scratch