# leo-dev-2004/team-project-context-translator-ss25 architecture

> Architecture diagram of the GitHub repository leo-dev-2004/team-project-context-translator-ss25, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/leo-dev-2004/team-project-context-translator-ss25
- Repository: https://github.com/leo-dev-2004/team-project-context-translator-ss25

## Overview

##### Project type and purpose
- This is a full-stack, real-time virtual meeting assistant built as a browser extension/plugin for Google Meet, backed by two specialized microservices (STT and LLM).
- Its purpose is to capture live audio, convert speech to text, use LLMs to generate contextual explanations, summaries, and suggestions, then render those insights back in the meeting UI.

##### File structure
- Top-level:
- .github/workflows/summary.yml – CI workflow definition (build/tests)
- .gitignore – ignores local/dev files
- README.md – full project spec and architecture overview
- No src directories present yet, but the README defines three independent modules/groups (App, STT, LLM) that will map to separate code repos or sub-folders in src/.

##### Key insights from the README
- Three core components:
1. App Group (Frontend): Google Meet extension -> capture/display
2. STT Group: real-time speech-to-text microservice
3. LLM Group: inference microservice for explanations, summaries, suggestions
- Data flow:
Audio → STT → sentence splitting → LLM → UI
- Technologies: Chrome/Firefox WebExtension APIs, Hugging Face STT models, Qwen-family LLMs, WebSocket/HTTP for comms, optional GPU workstation or cloud GPU.

##### Detail
- Every step: audio capture, streaming, segmentation, inference, display.
- Both cloud/GPU compute and on-device elements.
- Don’t omit the CI/CD workflow even if it’s peripheral.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Layer
    subgraph "Frontend" 
        BE["Browser Extension<br>(Google Meet Plugin)"]:::frontend
    end

    %% Backend Services
    subgraph "Backend Services"
        STT["STT Microservice"]:::stt
        LLM["LLM Microservice"]:::llm
        KB["Knowledge-Base / Participant Profile Store"]:::datastore
    end

    %% External Dependencies
    subgraph "External Services"
        GMAPI["Google Meet API"]:::external
        HFSTT["Hugging Face STT Endpoint"]:::external
        QHOST["Qwen Model Host"]:::external
    end

    %% CI/CD
    CI["CI/CD (GitHub Actions)"]:::external

    %% Data Flows
    BE -->|"captures audio stream"| GMAPI
    GMAPI -->|"provides audio"| BE
    BE -->|"opens WebSocket/HTTP"| STT
    STT -->|"transcribed text JSON"| LLM
    LLM -->|"LLM response JSON"| BE
    LLM -->|"reads/writes"| KB

    %% Service calls to external models
    STT -->|"calls model"| HFSTT
    LLM -->|"inference requests"| QHOST

    %% CI/CD pipeline
    CI

    %% Click Events
    click CI "https://github.com/leo-dev-2004/team-project-context-translator-ss25/blob/main/.github/workflows/summary.yml"

    %% Styling
    classDef frontend fill:#cce5ff,stroke:#2a6f99,color:#000;
    classDef stt fill:#d4edda,stroke:#2e7d32,color:#000;
    classDef llm fill:#ffe5b4,stroke:#ff8c00,color:#000;
    classDef external fill:#e2e3e5,stroke:#6c757d,color:#000;
    classDef datastore fill:#f1f1f1,stroke:#adb5bd,color:#000;
```
