Skip to main content

Architecture

This document describes the architecture of the User Profile service.

Goals​

  • Robust, consistent user profile management
  • Scalable reads and writes
  • Clear separation of concerns

High-Level Diagram​

Components​

  • API Layer: Express/Fastify REST endpoints for profile CRUD and search
  • Auth: JWT validation middleware and role-based access controls
  • Database: PostgreSQL with normalized tables and indexes
  • Cache: Redis for hot data (profile lookups, search filters)
  • Storage: Image uploads and transformations
  • Observability: Structured logs, metrics, health checks

Data Model​

  • profiles: core profile attributes
  • preferences: user settings and toggles
  • images: avatar and gallery metadata

Non-Functional​

  • Idempotent APIs, retries with backoff
  • Rate limiting and input validation
  • Rolling deployments and health checks