# nt101-lc/silentvoixapp architecture

> Architecture diagram of the GitHub repository nt101-lc/silentvoixapp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nt101-lc/silentvoixapp
- Repository: https://github.com/nt101-lc/silentvoixapp

## Overview

SilentVoix is a native Android app backed by a Java REST service; only the backend accesses PostgreSQL. The main user journey is navigating the app, signing in or using its speech and gesture features, and viewing locally stored recognition history and settings. The backend also provides health checks, authentication, feedback, and administration. The graph reflects explicit README and source-index relationships; unsampled feature wiring is omitted or left unverified rather than inferred.

Main entry points: [`android/app/src/main/java/com/silentvoix/app/ui/SilentVoixApp.kt`](https://github.com/nt101-lc/silentvoixapp/blob/main/android/app/src/main/java/com/silentvoix/app/ui/SilentVoixApp.kt) (App navigation), [`backend-java/src/main/java/com/silentvoix/backend/database/Jdbc.java`](https://github.com/nt101-lc/silentvoixapp/blob/main/backend-java/src/main/java/com/silentvoix/backend/database/Jdbc.java) (JDBC transactions), [`backend-java/src/main/java/com/silentvoix/backend/health/HealthController.java`](https://github.com/nt101-lc/silentvoixapp/blob/main/backend-java/src/main/java/com/silentvoix/backend/health/HealthController.java) (Health endpoint), [`backend-java/src/main/java/com/silentvoix/backend/auth/AuthController.java`](https://github.com/nt101-lc/silentvoixapp/blob/main/backend-java/src/main/java/com/silentvoix/backend/auth/AuthController.java) (Auth endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_android["Android experience"]
  node_app["App navigation<br/>[SilentVoixApp.kt]"]
  node_home["Home dashboard<br/>[HomeScreen.kt]"]
  node_authui["Sign in<br/>[AuthScreen.kt]"]
  node_translate["Gesture translate<br/>[TranslateScreen.kt]"]
  node_speakui["Speak phrases<br/>[SpeakScreen.kt]"]
  node_historyui["Recognition history<br/>[HistoryScreen.kt]"]
  node_settingsui["App settings<br/>[SettingsScreen.kt]"]
  node_healthclient["Health client"]
end

subgraph group_device["On-device features"]
  node_camera["Camera frames<br/>[GestureCamera.kt]"]
  node_recognizer["Gesture inference"]
  node_session["Translation session"]
  node_speech["Text to speech"]
end

subgraph group_server["Backend services"]
  node_backend["REST backend"]
  node_health["Health endpoint"]
  node_dbhealth["Database readiness"]
  node_authcontroller["Auth endpoints"]
  node_authservice["Auth service<br/>[AuthService.java]"]
  node_admin["Admin endpoints"]
  node_feedback["Feedback endpoint"]
end

subgraph group_storage["Persistence"]
  node_historyrepo["History repository"]
  node_historydb[("Room history<br/>[HistoryDatabase.kt]")]
  node_settingsrepo["Settings repository"]
  node_jdbc["JDBC transactions<br/>[Jdbc.java]"]
  node_postgres[("PostgreSQL")]
end

node_user(("App user"))

node_user -->|"uses"| node_app
node_app -->|"shows"| node_home
node_app -->|"shows"| node_authui
node_app -->|"shows"| node_translate
node_app -->|"shows"| node_speakui
node_app -->|"shows"| node_historyui
node_app -->|"shows"| node_settingsui
node_translate -.->|"uses"| node_camera
node_camera -.->|"submits frames"| node_recognizer
node_recognizer -.->|"reports gestures"| node_session
node_speakui -.->|"speaks phrases"| node_speech
node_historyui -.->|"loads history"| node_historyrepo
node_historyrepo -.->|"uses"| node_historydb
node_settingsui -.->|"updates settings"| node_settingsrepo
node_app -->|"checks health"| node_healthclient
node_healthclient -->|"requests health"| node_health
node_health -->|"checks database"| node_dbhealth
node_authui -.->|"calls REST"| node_authcontroller
node_authcontroller -->|"delegates auth"| node_authservice
node_authservice -->|"runs transactions"| node_jdbc
node_admin -->|"runs queries"| node_jdbc
node_feedback -->|"stores feedback"| node_jdbc
node_dbhealth -.->|"checks database"| node_jdbc
node_jdbc -->|"reads and writes"| node_postgres
node_backend -.->|"serves endpoints"| node_authcontroller
node_backend -.->|"serves endpoints"| node_health

click node_app "https://github.com/nt101-lc/silentvoixapp/blob/main/android/app/src/main/java/com/silentvoix/app/ui/SilentVoixApp.kt"
click node_home "https://github.com/nt101-lc/silentvoixapp/blob/main/android/app/src/main/java/com/silentvoix/app/ui/home/HomeScreen.kt"
click node_authui "https://github.com/nt101-lc/silentvoixapp/blob/main/android/app/src/main/java/com/silentvoix/app/ui/auth/AuthScreen.kt"
click node_translate "https://github.com/nt101-lc/silentvoixapp/blob/main/android/app/src/main/java/com/silentvoix/app/ui/translate/TranslateScreen.kt"
click node_camera "https://github.com/nt101-lc/silentvoixapp/blob/main/android/app/src/main/java/com/silentvoix/app/ui/translate/GestureCamera.kt"
click node_recognizer "https://github.com/nt101-lc/silentvoixapp/blob/main/android/app/src/main/java/com/silentvoix/app/recognition/GestureRecognizerEngine.kt"
click node_session "https://github.com/nt101-lc/silentvoixapp/blob/main/android/app/src/main/java/com/silentvoix/app/recognition/TranslateSession.kt"
click node_speakui "https://github.com/nt101-lc/silentvoixapp/blob/main/android/app/src/main/java/com/silentvoix/app/ui/speak/SpeakScreen.kt"
click node_speech "https://github.com/nt101-lc/silentvoixapp/blob/main/android/app/src/main/java/com/silentvoix/app/speech/AndroidSpeechEngine.kt"
click node_historyui "https://github.com/nt101-lc/silentvoixapp/blob/main/android/app/src/main/java/com/silentvoix/app/ui/history/HistoryScreen.kt"
click node_historyrepo "https://github.com/nt101-lc/silentvoixapp/blob/main/android/app/src/main/java/com/silentvoix/app/data/history/HistoryRepository.kt"
click node_historydb "https://github.com/nt101-lc/silentvoixapp/blob/main/android/app/src/main/java/com/silentvoix/app/data/history/HistoryDatabase.kt"
click node_settingsui "https://github.com/nt101-lc/silentvoixapp/blob/main/android/app/src/main/java/com/silentvoix/app/ui/settings/SettingsScreen.kt"
click node_settingsrepo "https://github.com/nt101-lc/silentvoixapp/blob/main/android/app/src/main/java/com/silentvoix/app/data/settings/SettingsRepository.kt"
click node_healthclient "https://github.com/nt101-lc/silentvoixapp/blob/main/android/app/src/main/java/com/silentvoix/app/data/backend/BackendHealthClient.kt"
click node_backend "https://github.com/nt101-lc/silentvoixapp/blob/main/backend-java/src/main/java/com/silentvoix/backend/SilentVoixBackendApplication.java"
click node_health "https://github.com/nt101-lc/silentvoixapp/blob/main/backend-java/src/main/java/com/silentvoix/backend/health/HealthController.java"
click node_dbhealth "https://github.com/nt101-lc/silentvoixapp/blob/main/backend-java/src/main/java/com/silentvoix/backend/health/DatabaseHealthChecker.java"
click node_authcontroller "https://github.com/nt101-lc/silentvoixapp/blob/main/backend-java/src/main/java/com/silentvoix/backend/auth/AuthController.java"
click node_authservice "https://github.com/nt101-lc/silentvoixapp/blob/main/backend-java/src/main/java/com/silentvoix/backend/auth/AuthService.java"
click node_admin "https://github.com/nt101-lc/silentvoixapp/blob/main/backend-java/src/main/java/com/silentvoix/backend/admin/AdminController.java"
click node_feedback "https://github.com/nt101-lc/silentvoixapp/blob/main/backend-java/src/main/java/com/silentvoix/backend/feedback/FeedbackController.java"
click node_jdbc "https://github.com/nt101-lc/silentvoixapp/blob/main/backend-java/src/main/java/com/silentvoix/backend/database/Jdbc.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_app,node_home,node_authui,node_translate,node_speakui,node_historyui,node_settingsui,node_healthclient,node_user toneBlue
class node_camera,node_recognizer,node_session,node_speech toneAmber
class node_backend,node_health,node_dbhealth,node_authcontroller,node_authservice,node_admin,node_feedback toneMint
class node_historyrepo,node_historydb,node_settingsrepo,node_jdbc,node_postgres toneRose
```

## Components

### Android experience

- [App navigation](https://github.com/nt101-lc/silentvoixapp/blob/main/android/app/src/main/java/com/silentvoix/app/ui/SilentVoixApp.kt): `android/app/src/main/java/com/silentvoix/app/ui/SilentVoixApp.kt`
- [Home dashboard](https://github.com/nt101-lc/silentvoixapp/blob/main/android/app/src/main/java/com/silentvoix/app/ui/home/HomeScreen.kt): `android/app/src/main/java/com/silentvoix/app/ui/home/HomeScreen.kt`
- [Sign in](https://github.com/nt101-lc/silentvoixapp/blob/main/android/app/src/main/java/com/silentvoix/app/ui/auth/AuthScreen.kt): `android/app/src/main/java/com/silentvoix/app/ui/auth/AuthScreen.kt`
- [Gesture translate](https://github.com/nt101-lc/silentvoixapp/blob/main/android/app/src/main/java/com/silentvoix/app/ui/translate/TranslateScreen.kt): `android/app/src/main/java/com/silentvoix/app/ui/translate/TranslateScreen.kt`
- [Speak phrases](https://github.com/nt101-lc/silentvoixapp/blob/main/android/app/src/main/java/com/silentvoix/app/ui/speak/SpeakScreen.kt): `android/app/src/main/java/com/silentvoix/app/ui/speak/SpeakScreen.kt`
- [Recognition history](https://github.com/nt101-lc/silentvoixapp/blob/main/android/app/src/main/java/com/silentvoix/app/ui/history/HistoryScreen.kt): `android/app/src/main/java/com/silentvoix/app/ui/history/HistoryScreen.kt`
- [App settings](https://github.com/nt101-lc/silentvoixapp/blob/main/android/app/src/main/java/com/silentvoix/app/ui/settings/SettingsScreen.kt): `android/app/src/main/java/com/silentvoix/app/ui/settings/SettingsScreen.kt`
- [Health client](https://github.com/nt101-lc/silentvoixapp/blob/main/android/app/src/main/java/com/silentvoix/app/data/backend/BackendHealthClient.kt): `android/app/src/main/java/com/silentvoix/app/data/backend/BackendHealthClient.kt`

### On-device features

- [Camera frames](https://github.com/nt101-lc/silentvoixapp/blob/main/android/app/src/main/java/com/silentvoix/app/ui/translate/GestureCamera.kt): `android/app/src/main/java/com/silentvoix/app/ui/translate/GestureCamera.kt`
- [Gesture inference](https://github.com/nt101-lc/silentvoixapp/blob/main/android/app/src/main/java/com/silentvoix/app/recognition/GestureRecognizerEngine.kt): `android/app/src/main/java/com/silentvoix/app/recognition/GestureRecognizerEngine.kt`
- [Translation session](https://github.com/nt101-lc/silentvoixapp/blob/main/android/app/src/main/java/com/silentvoix/app/recognition/TranslateSession.kt): `android/app/src/main/java/com/silentvoix/app/recognition/TranslateSession.kt`
- [Text to speech](https://github.com/nt101-lc/silentvoixapp/blob/main/android/app/src/main/java/com/silentvoix/app/speech/AndroidSpeechEngine.kt): `android/app/src/main/java/com/silentvoix/app/speech/AndroidSpeechEngine.kt`

### Backend services

- [REST backend](https://github.com/nt101-lc/silentvoixapp/blob/main/backend-java/src/main/java/com/silentvoix/backend/SilentVoixBackendApplication.java): `backend-java/src/main/java/com/silentvoix/backend/SilentVoixBackendApplication.java`
- [Health endpoint](https://github.com/nt101-lc/silentvoixapp/blob/main/backend-java/src/main/java/com/silentvoix/backend/health/HealthController.java): `backend-java/src/main/java/com/silentvoix/backend/health/HealthController.java`
- [Database readiness](https://github.com/nt101-lc/silentvoixapp/blob/main/backend-java/src/main/java/com/silentvoix/backend/health/DatabaseHealthChecker.java): `backend-java/src/main/java/com/silentvoix/backend/health/DatabaseHealthChecker.java`
- [Auth endpoints](https://github.com/nt101-lc/silentvoixapp/blob/main/backend-java/src/main/java/com/silentvoix/backend/auth/AuthController.java): `backend-java/src/main/java/com/silentvoix/backend/auth/AuthController.java`
- [Auth service](https://github.com/nt101-lc/silentvoixapp/blob/main/backend-java/src/main/java/com/silentvoix/backend/auth/AuthService.java): `backend-java/src/main/java/com/silentvoix/backend/auth/AuthService.java`
- [Admin endpoints](https://github.com/nt101-lc/silentvoixapp/blob/main/backend-java/src/main/java/com/silentvoix/backend/admin/AdminController.java): `backend-java/src/main/java/com/silentvoix/backend/admin/AdminController.java`
- [Feedback endpoint](https://github.com/nt101-lc/silentvoixapp/blob/main/backend-java/src/main/java/com/silentvoix/backend/feedback/FeedbackController.java): `backend-java/src/main/java/com/silentvoix/backend/feedback/FeedbackController.java`

### Persistence

- [History repository](https://github.com/nt101-lc/silentvoixapp/blob/main/android/app/src/main/java/com/silentvoix/app/data/history/HistoryRepository.kt): `android/app/src/main/java/com/silentvoix/app/data/history/HistoryRepository.kt`
- [Room history](https://github.com/nt101-lc/silentvoixapp/blob/main/android/app/src/main/java/com/silentvoix/app/data/history/HistoryDatabase.kt): `android/app/src/main/java/com/silentvoix/app/data/history/HistoryDatabase.kt`
- [Settings repository](https://github.com/nt101-lc/silentvoixapp/blob/main/android/app/src/main/java/com/silentvoix/app/data/settings/SettingsRepository.kt): `android/app/src/main/java/com/silentvoix/app/data/settings/SettingsRepository.kt`
- [JDBC transactions](https://github.com/nt101-lc/silentvoixapp/blob/main/backend-java/src/main/java/com/silentvoix/backend/database/Jdbc.java): `backend-java/src/main/java/com/silentvoix/backend/database/Jdbc.java`
- **PostgreSQL**

### Other components

- **App user**

## Connections

- App user → App navigation: uses (evidence: `README.md`)
- App navigation → Home dashboard: shows (evidence: `android/app/src/main/java/com/silentvoix/app/ui/SilentVoixApp.kt`)
- App navigation → Sign in: shows (evidence: `android/app/src/main/java/com/silentvoix/app/ui/SilentVoixApp.kt`)
- App navigation → Gesture translate: shows (evidence: `android/app/src/main/java/com/silentvoix/app/ui/SilentVoixApp.kt`)
- App navigation → Speak phrases: shows (evidence: `android/app/src/main/java/com/silentvoix/app/ui/SilentVoixApp.kt`)
- App navigation → Recognition history: shows (evidence: `android/app/src/main/java/com/silentvoix/app/ui/SilentVoixApp.kt`)
- App navigation → App settings: shows (evidence: `android/app/src/main/java/com/silentvoix/app/ui/SilentVoixApp.kt`)
- Gesture translate → Camera frames: uses
- Camera frames → Gesture inference: submits frames
- Gesture inference → Translation session: reports gestures
- Speak phrases → Text to speech: speaks phrases
- Recognition history → History repository: loads history
- History repository → Room history: uses
- App settings → Settings repository: updates settings
- App navigation → Health client: checks health (evidence: `android/app/src/main/java/com/silentvoix/app/ui/SilentVoixApp.kt`)
- Health client → Health endpoint: requests health (evidence: `android/app/src/main/java/com/silentvoix/app/data/backend/BackendHealthClient.kt`)
- Health endpoint → Database readiness: checks database (evidence: `backend-java/src/main/java/com/silentvoix/backend/health/HealthController.java`)
- Sign in → Auth endpoints: calls REST
- Auth endpoints → Auth service: delegates auth (evidence: `backend-java/src/main/java/com/silentvoix/backend/auth/AuthController.java`)
- Auth service → JDBC transactions: runs transactions (evidence: `backend-java/src/main/java/com/silentvoix/backend/auth/AuthService.java`)
- Admin endpoints → JDBC transactions: runs queries (evidence: `backend-java/src/main/java/com/silentvoix/backend/admin/AdminController.java`)
- Feedback endpoint → JDBC transactions: stores feedback (evidence: `backend-java/src/main/java/com/silentvoix/backend/feedback/FeedbackController.java`)
- Database readiness → JDBC transactions: checks database
- JDBC transactions → PostgreSQL: reads and writes (evidence: `backend-java/src/main/java/com/silentvoix/backend/database/Jdbc.java`)
- REST backend → Auth endpoints: serves endpoints
- REST backend → Health endpoint: serves endpoints
