eTeamups Platform

The eTeamups Platform (also known as the Zeswa Platform) is a backend microservices monorepo that powers team matching, organisation management, and user profile services. It provides the API layer consumed by the Zeswa Hub (zeswa.com) and the Admin Portal (admin.zeswa.com), both of which live in separate repositories.

What the Platform Does

The platform enables organisations to:

• Register and authenticate users via a passwordless, PKCE-secured OTP flow.
• Manage organisations, teams, and teammates.
• Maintain master data catalogues (countries, industries, functions, education levels, study majors, locations, skills, and assessment questions).
• Deliver transactional emails asynchronously through a Redis-backed message queue.
• Serve media assets to frontend clients.

Technology Stack

Repository Layout

eteamups-platform/
  services/
    auth/           # Authentication service (port 9000)
    profile/        # Profile service (port 9100)
    organisation/   # Organisation service (port 9107)
    media/          # Media service (port 9102)
    messaging/      # Email and SMS client implementations
    store/          # Mongoose models, schemas, and DTOs
    common/         # Shared Express middleware base class
  libs/
    server/         # Generic Express server bootstrap
    auth/           # PKCE challenge/verify helpers
    token/          # JWT sign, verify, validate middleware
    mongo/          # MongooseClient singleton
    message-queue/  # BullMQ MessageQueue singleton and worker
    email/          # Email template utilities
    seeder/         # Database seed scripts
    utility/        # Logger, SchemaValidation, EmailUtility, time helpers
  nginx/            # Nginx config (main + conf.d)
  docker/           # Dockerfiles per service
  emails/           # React Email templates
  public/           # Static assets
  scripts/          # Build and utility scripts
  swagger/          # API documentation generation
  types/            # Global TypeScript type declarations

Services at a Glance

Infrastructure Overview

All services run inside Docker containers on a shared bridge network (eteamups-network). Nginx acts as the single entry point, terminating TLS and routing requests by path or hostname to the appropriate upstream service. MongoDB and Redis provide persistence and queue storage respectively. Container images are published to the GitHub Container Registry (GHCR) under ghcr.io/creativeaura/eteamups-platform-*.

Documentation Sections

• Architecture Overview – High-level system diagram and data flow.
• Services – Detailed per-service documentation.
• Database – MongoDB collections, schemas, and the BaseModel pattern.
• Authentication – PKCE OAuth2 flow, JWT tokens, and OTP system.
• Message Queue – BullMQ async processing and email delivery.
• Observability – OpenTelemetry, Winston logging, and Nginx log formats.