Skip to main content

Microservices Architecture Overview

To maintain high responsiveness and prevent heavy computational or external API workloads from degrading core backend performance, LearnWay decouples specialized subsystems into standalone microservices.

Standalone Microservices Directory

  • AI Microservice (learnway-ai-service/):
    • Generative AI tutoring, dynamic onboarding skill assessments, and automated Capstone Project code evaluations.
    • Injects course lesson slides and student history into Google Gemini prompt pipelines with Redis caching.
  • Notification Microservice (learnway-notification-service/):
    • Multi-channel delivery engine coordinating mobile push notifications (FCM), transactional emails (Resend), and in-app alert synchronization.
    • Dedicated token lifecycle management and BullMQ background queue workers.

Key Benefits of Decomposition

  1. Independent Scalability: High-frequency LLM tutoring requests or mass push broadcast batches scale in dedicated container instances without consuming thread pool resources on the core REST/WebSocket server.
  2. Failure Isolation: Upstream rate limits or temporary third-party API latency (Gemini, FCM, Resend) never impact user login, lesson navigation, or PvP quiz battles.
  3. Optimized Resource Profiles: The AI service can be allocated memory and compute tuned for prompt streaming and payload transformations, while the core backend remains lightweight.