# quannh-netalik/elsa-coding-challenge architecture

> Architecture diagram of the GitHub repository quannh-netalik/elsa-coding-challenge, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-10). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/quannh-netalik/elsa-coding-challenge
- Repository: https://github.com/quannh-netalik/elsa-coding-challenge

## Overview

##### Main Components Identification

The system consists of three primary domains:
- Customer Domain (Auth & User Services)
- Quiz Domain (Content, Session, and Socket Services)
- Infrastructure Domain (Logger Service)

##### Detailed Component Representation

a) Customer Domain:
**[Auth Service (8060)]**
- Authentication logic
- Session management
- Token verification

**[User Service]**
- User management
- Profile handling

b) Quiz Domain:
**[Quiz Content Service]**
- Question management
- Quiz data storage

**[Quiz Session Service]**
- Session management
- Game state handling

**[Quiz Session Socket]**
- Real-time communication
- Player synchronization

c) Infrastructure:
**[Logger Service]**
- Centralized logging
- Correlation ID tracking

##### Integration Points

- SDK integration between services (packages folder)
- Authentication flow
- Session creation/joining flow
- Real-time communication paths

##### Additional Elements

Include:
- API Gateway (entry point)
- Load Balancers
- Redis Clusters
- MongoDB Replicas
- Correlation ID flow

##### Specific Implementation Details

Show:
- Port numbers for each service
- Environment configurations
- Security layers (API keys)
- Monitoring points

##### Logging flow

- High-level architecture visibility
- Detailed implementation specifics
- Clear service boundaries
- Communication patterns

Remember to emphasize:
- Scalability points
- Security checkpoints
- Monitoring points
- Failure recovery paths

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Gateway
        API[API Gateway]:::gateway
    end

    subgraph CustomerDomain
        AuthService["Auth Service (8060)"]:::customer
        UserService["User Service"]:::customer
        
        AuthDB[(Auth MongoDB)]:::database
        UserDB[(User MongoDB)]:::database
        
        AuthCache{{"Auth Redis<br/>Cache"}}:::cache
        
        AuthService --> AuthDB
        AuthService --> AuthCache
        UserService --> UserDB
    end
    
    subgraph QuizDomain
        ContentService["Quiz Content<br/>Service"]:::quiz
        SessionService["Quiz Session<br/>Service"]:::quiz
        SocketService["Quiz Session<br/>Socket"]:::quiz
        
        ContentDB[(Content MongoDB)]:::database
        SessionDB[(Session MongoDB)]:::database
        
        SessionCache{{"Session Redis<br/>Cache"}}:::cache
        
        ContentService --> ContentDB
        SessionService --> SessionDB
        SessionService --> SessionCache
        SocketService --> SessionCache
    end
    
    subgraph InfraDomain
        LoggerService["Logger Service"]:::infra
        LogDB[(Log MongoDB)]:::database
        LoggerService --> LogDB
    end
    
    %% SDK Integration Layer
    subgraph SDKLayer
        AuthSDK["Auth SDK"]:::sdk
        UserSDK["User SDK"]:::sdk
        ContentSDK["Quiz Content SDK"]:::sdk
        SessionSDK["Quiz Session SDK"]:::sdk
        LoggerSDK["Logger SDK"]:::sdk
    end
    
    %% Service Connections
    API --> AuthService
    API --> UserService
    API --> ContentService
    API --> SessionService
    API --> SocketService
    
    %% SDK Usage
    AuthService -.-> LoggerSDK
    UserService -.-> LoggerSDK
    ContentService -.-> LoggerSDK
    SessionService -.-> LoggerSDK
    SocketService -.-> LoggerSDK
    
    SessionService -.-> AuthSDK
    ContentService -.-> AuthSDK
    SocketService -.-> SessionSDK
    
    %% WebSocket Connection
    Client[Client]:::client
    Client --- API
    Client -.-|WebSocket| SocketService
    
    %% Click Events
    click AuthService "https://github.com/quannh-netalik/elsa-coding-challenge/tree/master/apps/auth-service"
    click UserService "https://github.com/quannh-netalik/elsa-coding-challenge/tree/master/apps/user-service"
    click ContentService "https://github.com/quannh-netalik/elsa-coding-challenge/tree/master/apps/quiz-content-service"
    click SessionService "https://github.com/quannh-netalik/elsa-coding-challenge/tree/master/apps/quiz-session-service"
    click SocketService "https://github.com/quannh-netalik/elsa-coding-challenge/tree/master/apps/quiz-session-socket"
    click LoggerService "https://github.com/quannh-netalik/elsa-coding-challenge/tree/master/apps/logger-service"
    click AuthSDK "https://github.com/quannh-netalik/elsa-coding-challenge/tree/master/packages/auth-sdk"
    click UserSDK "https://github.com/quannh-netalik/elsa-coding-challenge/tree/master/packages/user-sdk"
    click ContentSDK "https://github.com/quannh-netalik/elsa-coding-challenge/tree/master/packages/quiz-content-sdk"
    click SessionSDK "https://github.com/quannh-netalik/elsa-coding-challenge/tree/master/packages/quiz-session-sdk"
    click LoggerSDK "https://github.com/quannh-netalik/elsa-coding-challenge/tree/master/packages/logger-sdk"
    
    %% Styles
    classDef customer fill:#2374ab
    classDef quiz fill:#2a9d8f
    classDef infra fill:#6c757d
    classDef database fill:#ddd,stroke:#666
    classDef cache fill:#fff,stroke:#666
    classDef sdk fill:#f4a261
    classDef client fill:#e9ecef
    classDef gateway fill:#264653

    %% Legend
    subgraph Legend
        L1[Customer Domain Service]:::customer
        L2[Quiz Domain Service]:::quiz
        L3[Infrastructure Service]:::infra
        L4[(Database)]:::database
        L5{{"Cache"}}:::cache
        L6[SDK]:::sdk
    end
```
