# suranjanverma/voice-translator architecture

> Architecture diagram of the GitHub repository suranjanverma/voice-translator, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/suranjanverma/voice-translator
- Repository: https://github.com/suranjanverma/voice-translator

## Overview

Gray United Voice Translator is a Spring Boot web application for speech transcription, multilingual translation, account management, and per-user translation history. The documented main workflow captures browser audio and returns translated text for display and optional browser speech synthesis; sampled WebSocket code confirms one real-time route through Vosk and translation services. The graph also preserves documented authentication and history capabilities. Some README-described REST translation wiring is not present in the sampled controller excerpt, so that route is shown only as documented; other unsampled implementation details are omitted.

Main entry points: [`src/main/resources/static/index.html`](https://github.com/suranjanverma/voice-translator/blob/main/src/main/resources/static/index.html) (Translation interface), [`src/main/java/com/translator/language_translator/config/SpeechWebSocketHandler.java`](https://github.com/suranjanverma/voice-translator/blob/main/src/main/java/com/translator/language_translator/config/SpeechWebSocketHandler.java) (Live speech handler), [`src/main/java/com/translator/language_translator/repository/UserRepository.java`](https://github.com/suranjanverma/voice-translator/blob/main/src/main/java/com/translator/language_translator/repository/UserRepository.java) (User repository), [`src/main/java/com/translator/language_translator/repository/TranslationRepository.java`](https://github.com/suranjanverma/voice-translator/blob/main/src/main/java/com/translator/language_translator/repository/TranslationRepository.java) (Translation repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Browser experience"]
  node_browser["Translation interface<br/>[index.html]"]
  node_loginui["Login interface<br/>[login.html]"]
  node_browser_tts["Browser speech output<br/>[index.html]"]
end

subgraph group_speech["Speech and translation"]
  node_ws_config["WebSocket route"]
  node_ws_handler["Live speech handler"]
  node_vosk_manager["Vosk model manager"]
  node_speech_service["Speech transcription<br/>[SpeechService.java]"]
  node_translation["Translation service"]
  node_translator_controller["Translation API"]
end

subgraph group_identity["Identity and security"]
  node_auth_controller["Registration and recovery"]
  node_user_details["Login user lookup"]
  node_security["Session security"]
end

subgraph group_history["History and persistence"]
  node_user_repo["User repository"]
  node_user_model["User account<br/>[AppUser.java]"]
  node_history_repo["Translation repository"]
  node_record_model["Translation record"]
end

subgraph group_integrations["External services"]
  node_postgres[("PostgreSQL")]
  node_vosk["Vosk ASR engine"]
  node_translation_apis["Translation APIs"]
end

node_user(("Translator user"))

node_user -->|"records audio"| node_browser
node_browser -.->|"streams audio"| node_ws_config
node_ws_config -->|"routes speech"| node_ws_handler
node_ws_handler -->|"gets model"| node_vosk_manager
node_vosk_manager -->|"loads model"| node_vosk
node_ws_handler -->|"translates text"| node_translation
node_translation -->|"requests translation"| node_translation_apis
node_translation_apis -.->|"returns translation"| node_translation
node_ws_handler -->|"sends results"| node_browser
node_browser -->|"speaks translation"| node_browser_tts
node_browser -.->|"posts translation"| node_translator_controller
node_user -->|"signs in"| node_loginui
node_loginui -->|"starts session"| node_security
node_security -.->|"loads login user"| node_user_details
node_user_details -->|"finds account"| node_user_repo
node_auth_controller -->|"saves account"| node_user_repo
node_user_repo -->|"maps accounts"| node_user_model
node_user_repo -.->|"persists accounts"| node_postgres
node_translator_controller -->|"saves and reads"| node_history_repo
node_history_repo -->|"maps records"| node_record_model
node_history_repo -.->|"persists history"| node_postgres
node_browser -.->|"requests history"| node_translator_controller
node_speech_service -->|"transcribes audio"| node_vosk

click node_browser "https://github.com/suranjanverma/voice-translator/blob/main/src/main/resources/static/index.html"
click node_loginui "https://github.com/suranjanverma/voice-translator/blob/main/src/main/resources/static/login.html"
click node_browser_tts "https://github.com/suranjanverma/voice-translator/blob/main/src/main/resources/static/index.html"
click node_ws_config "https://github.com/suranjanverma/voice-translator/blob/main/src/main/java/com/translator/language_translator/config/WebSocketConfig.java"
click node_ws_handler "https://github.com/suranjanverma/voice-translator/blob/main/src/main/java/com/translator/language_translator/config/SpeechWebSocketHandler.java"
click node_vosk_manager "https://github.com/suranjanverma/voice-translator/blob/main/src/main/java/com/translator/language_translator/services/VoskModelManager.java"
click node_speech_service "https://github.com/suranjanverma/voice-translator/blob/main/src/main/java/com/translator/language_translator/services/SpeechService.java"
click node_translation "https://github.com/suranjanverma/voice-translator/blob/main/src/main/java/com/translator/language_translator/services/TranslationService.java"
click node_translator_controller "https://github.com/suranjanverma/voice-translator/blob/main/src/main/java/com/translator/language_translator/controller/TranslatorController.java"
click node_auth_controller "https://github.com/suranjanverma/voice-translator/blob/main/src/main/java/com/translator/language_translator/controller/AuthController.java"
click node_user_details "https://github.com/suranjanverma/voice-translator/blob/main/src/main/java/com/translator/language_translator/services/CustomUserDetailsService.java"
click node_security "https://github.com/suranjanverma/voice-translator/blob/main/src/main/java/com/translator/language_translator/config/SecurityConfig.java"
click node_user_repo "https://github.com/suranjanverma/voice-translator/blob/main/src/main/java/com/translator/language_translator/repository/UserRepository.java"
click node_user_model "https://github.com/suranjanverma/voice-translator/blob/main/src/main/java/com/translator/language_translator/model/AppUser.java"
click node_history_repo "https://github.com/suranjanverma/voice-translator/blob/main/src/main/java/com/translator/language_translator/repository/TranslationRepository.java"
click node_record_model "https://github.com/suranjanverma/voice-translator/blob/main/src/main/java/com/translator/language_translator/model/TranslationRecord.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_browser,node_loginui,node_browser_tts,node_user toneBlue
class node_ws_config,node_ws_handler,node_vosk_manager,node_speech_service,node_translation,node_translator_controller toneAmber
class node_auth_controller,node_user_details,node_security toneMint
class node_user_repo,node_user_model,node_history_repo,node_record_model toneRose
class node_postgres,node_vosk,node_translation_apis toneIndigo
```

## Components

### Browser experience

- [Translation interface](https://github.com/suranjanverma/voice-translator/blob/main/src/main/resources/static/index.html): `src/main/resources/static/index.html`
- [Login interface](https://github.com/suranjanverma/voice-translator/blob/main/src/main/resources/static/login.html): `src/main/resources/static/login.html`
- [Browser speech output](https://github.com/suranjanverma/voice-translator/blob/main/src/main/resources/static/index.html): `src/main/resources/static/index.html`

### Speech and translation

- [WebSocket route](https://github.com/suranjanverma/voice-translator/blob/main/src/main/java/com/translator/language_translator/config/WebSocketConfig.java): `src/main/java/com/translator/language_translator/config/WebSocketConfig.java`
- [Live speech handler](https://github.com/suranjanverma/voice-translator/blob/main/src/main/java/com/translator/language_translator/config/SpeechWebSocketHandler.java): `src/main/java/com/translator/language_translator/config/SpeechWebSocketHandler.java`
- [Vosk model manager](https://github.com/suranjanverma/voice-translator/blob/main/src/main/java/com/translator/language_translator/services/VoskModelManager.java): `src/main/java/com/translator/language_translator/services/VoskModelManager.java`
- [Speech transcription](https://github.com/suranjanverma/voice-translator/blob/main/src/main/java/com/translator/language_translator/services/SpeechService.java): `src/main/java/com/translator/language_translator/services/SpeechService.java`
- [Translation service](https://github.com/suranjanverma/voice-translator/blob/main/src/main/java/com/translator/language_translator/services/TranslationService.java): `src/main/java/com/translator/language_translator/services/TranslationService.java`
- [Translation API](https://github.com/suranjanverma/voice-translator/blob/main/src/main/java/com/translator/language_translator/controller/TranslatorController.java): `src/main/java/com/translator/language_translator/controller/TranslatorController.java`

### Identity and security

- [Registration and recovery](https://github.com/suranjanverma/voice-translator/blob/main/src/main/java/com/translator/language_translator/controller/AuthController.java): `src/main/java/com/translator/language_translator/controller/AuthController.java`
- [Login user lookup](https://github.com/suranjanverma/voice-translator/blob/main/src/main/java/com/translator/language_translator/services/CustomUserDetailsService.java): `src/main/java/com/translator/language_translator/services/CustomUserDetailsService.java`
- [Session security](https://github.com/suranjanverma/voice-translator/blob/main/src/main/java/com/translator/language_translator/config/SecurityConfig.java): `src/main/java/com/translator/language_translator/config/SecurityConfig.java`

### History and persistence

- [User repository](https://github.com/suranjanverma/voice-translator/blob/main/src/main/java/com/translator/language_translator/repository/UserRepository.java): `src/main/java/com/translator/language_translator/repository/UserRepository.java`
- [User account](https://github.com/suranjanverma/voice-translator/blob/main/src/main/java/com/translator/language_translator/model/AppUser.java): `src/main/java/com/translator/language_translator/model/AppUser.java`
- [Translation repository](https://github.com/suranjanverma/voice-translator/blob/main/src/main/java/com/translator/language_translator/repository/TranslationRepository.java): `src/main/java/com/translator/language_translator/repository/TranslationRepository.java`
- [Translation record](https://github.com/suranjanverma/voice-translator/blob/main/src/main/java/com/translator/language_translator/model/TranslationRecord.java): `src/main/java/com/translator/language_translator/model/TranslationRecord.java`

### External services

- **PostgreSQL**
- **Vosk ASR engine**
- **Translation APIs**

### Other components

- **Translator user**

## Connections

- Translator user → Translation interface: records audio (evidence: `README.md`)
- Translation interface → WebSocket route: streams audio
- WebSocket route → Live speech handler: routes speech (evidence: `src/main/java/com/translator/language_translator/config/WebSocketConfig.java`)
- Live speech handler → Vosk model manager: gets model (evidence: `src/main/java/com/translator/language_translator/config/SpeechWebSocketHandler.java`)
- Vosk model manager → Vosk ASR engine: loads model (evidence: `src/main/java/com/translator/language_translator/services/VoskModelManager.java`)
- Live speech handler → Translation service: translates text (evidence: `src/main/java/com/translator/language_translator/config/SpeechWebSocketHandler.java`)
- Translation service → Translation APIs: requests translation (evidence: `src/main/java/com/translator/language_translator/services/TranslationService.java`)
- Translation APIs → Translation service: returns translation
- Live speech handler → Translation interface: sends results (evidence: `src/main/java/com/translator/language_translator/config/SpeechWebSocketHandler.java`)
- Translation interface → Browser speech output: speaks translation (evidence: `README.md`)
- Translation interface → Translation API: posts translation
- Translator user → Login interface: signs in (evidence: `README.md`)
- Login interface → Session security: starts session (evidence: `README.md`)
- Session security → Login user lookup: loads login user
- Login user lookup → User repository: finds account (evidence: `src/main/java/com/translator/language_translator/services/CustomUserDetailsService.java`)
- Registration and recovery → User repository: saves account (evidence: `src/main/java/com/translator/language_translator/controller/AuthController.java`)
- User repository → User account: maps accounts (evidence: `src/main/java/com/translator/language_translator/repository/UserRepository.java`)
- User repository → PostgreSQL: persists accounts
- Translation API → Translation repository: saves and reads (evidence: `src/main/java/com/translator/language_translator/controller/TranslatorController.java`)
- Translation repository → Translation record: maps records (evidence: `src/main/java/com/translator/language_translator/repository/TranslationRepository.java`)
- Translation repository → PostgreSQL: persists history
- Translation interface → Translation API: requests history
- Speech transcription → Vosk ASR engine: transcribes audio (evidence: `src/main/java/com/translator/language_translator/services/SpeechService.java`)
