# terry1921/nenek_trivia architecture

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

- Interactive diagram: https://gitdiagram.com/terry1921/nenek_trivia
- Repository: https://github.com/terry1921/nenek_trivia

## Overview

Nenek Trivia is an Android Compose trivia app. The main journey is player sign-in, question retrieval and timed answering, then local session/score persistence and Honor synchronization; leaderboard, profile, preferences, and app review are additional documented capabilities. The README describes the MVVM/use-case/repository layering. Several implementation files were not sampled, so edges for those flows rely on that documentation rather than inspection of unsampled code.

Main entry points: [`ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/questions/QuestionsViewModel.kt`](https://github.com/terry1921/nenek_trivia/blob/main/ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/questions/QuestionsViewModel.kt) (Trivia play), [`domain/src/main/kotlin/dev/terry1921/nenektrivia/domain/auth/SignInWithGoogleUseCase.kt`](https://github.com/terry1921/nenek_trivia/blob/main/domain/src/main/kotlin/dev/terry1921/nenektrivia/domain/auth/SignInWithGoogleUseCase.kt) (Social sign-in), [`database/src/main/kotlin/dev/terry1921/nenektrivia/database/session/RoomSessionRepository.kt`](https://github.com/terry1921/nenek_trivia/blob/main/database/src/main/kotlin/dev/terry1921/nenektrivia/database/session/RoomSessionRepository.kt) (Game session store), [`ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/main/MainActivity.kt`](https://github.com/terry1921/nenek_trivia/blob/main/ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/main/MainActivity.kt) (App entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["App experience"]
  node_activity["App entry<br/>[MainActivity.kt]"]
  node_navigation["App navigation<br/>[AppNavHost.kt]"]
  node_profile["Player profile"]
end

subgraph group_game["Trivia and progress"]
  node_questionui["Trivia play"]
  node_questionusecase["Question retrieval"]
  node_questionmodel["Question data<br/>[QuestionModel.kt]"]
  node_honorusecase["Honor synchronization"]
  node_leaderboardui["Leaderboard view"]
  node_leaderboardusecase["Leaderboard query"]
end

subgraph group_identity["Identity and settings"]
  node_authscreen["Sign-in screen<br/>[AuthScreen.kt]"]
  node_authvm["Sign-in logic<br/>[AuthViewModel.kt]"]
  node_authusecases["Social sign-in"]
  node_sessionusecase["Save user session"]
  node_preferencesui["Player preferences"]
  node_preferencesusecase["Settings use cases"]
end

subgraph group_storage["Local persistence"]
  node_localuser["Local user repository"]
  node_sessionstore["Game session store"]
  node_schema[("Room database")]
  node_sessionentity["Session records<br/>[GameSession.kt]"]
  node_datastore[("Preferences store")]
end

subgraph group_services["Remote services"]
  node_remoteauth["Firebase auth"]
  node_questionremote["Firebase questions"]
  node_honorremote["Firebase Honor"]
  node_leaderboardremote["Firebase leaderboard"]
end

node_player(("Player"))

node_player -->|"opens"| node_activity
node_activity -->|"hosts"| node_navigation
node_navigation -.->|"routes to"| node_authscreen
node_authscreen -->|"renders"| node_authvm
node_authvm -.->|"invokes"| node_authusecases
node_authusecases -.->|"authenticates"| node_remoteauth
node_authusecases -.->|"saves identity"| node_sessionusecase
node_sessionusecase -->|"persists session"| node_localuser
node_player -.->|"plays"| node_questionui
node_questionui -.->|"requests questions"| node_questionusecase
node_questionusecase -.->|"loads questions"| node_questionremote
node_questionremote -->|"maps data"| node_questionmodel
node_questionui -.->|"records session"| node_sessionstore
node_sessionstore -.->|"uses Room"| node_schema
node_sessionstore -->|"stores"| node_sessionentity
node_questionui -.->|"syncs result"| node_honorusecase
node_honorusecase -.->|"syncs Honor"| node_honorremote
node_player -.->|"views"| node_leaderboardui
node_leaderboardui -.->|"requests scores"| node_leaderboardusecase
node_leaderboardusecase -.->|"loads scores"| node_leaderboardremote
node_player -.->|"configures"| node_preferencesui
node_preferencesui -.->|"updates settings"| node_preferencesusecase
node_preferencesusecase -.->|"reads and saves"| node_datastore
node_player -.->|"views profile"| node_profile

click node_activity "https://github.com/terry1921/nenek_trivia/blob/main/ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/main/MainActivity.kt"
click node_navigation "https://github.com/terry1921/nenek_trivia/blob/main/ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/navigation/AppNavHost.kt"
click node_authscreen "https://github.com/terry1921/nenek_trivia/blob/main/ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/auth/AuthScreen.kt"
click node_authvm "https://github.com/terry1921/nenek_trivia/blob/main/ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/auth/AuthViewModel.kt"
click node_authusecases "https://github.com/terry1921/nenek_trivia/blob/main/domain/src/main/kotlin/dev/terry1921/nenektrivia/domain/auth/SignInWithGoogleUseCase.kt"
click node_remoteauth "https://github.com/terry1921/nenek_trivia/blob/main/network/src/main/kotlin/dev/terry1921/nenektrivia/network/auth/FirebaseRemoteAuthRepository.kt"
click node_sessionusecase "https://github.com/terry1921/nenek_trivia/blob/main/domain/src/main/kotlin/dev/terry1921/nenektrivia/domain/session/SaveUserSessionUseCase.kt"
click node_localuser "https://github.com/terry1921/nenek_trivia/blob/main/database/src/main/kotlin/dev/terry1921/nenektrivia/database/auth/RoomAuthRepository.kt"
click node_questionui "https://github.com/terry1921/nenek_trivia/blob/main/ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/questions/QuestionsViewModel.kt"
click node_questionusecase "https://github.com/terry1921/nenek_trivia/blob/main/domain/src/main/kotlin/dev/terry1921/nenektrivia/domain/questions/GetQuestionsUseCase.kt"
click node_questionremote "https://github.com/terry1921/nenek_trivia/blob/main/network/src/main/kotlin/dev/terry1921/nenektrivia/network/questions/FirebaseQuestionsRepository.kt"
click node_questionmodel "https://github.com/terry1921/nenek_trivia/blob/main/model/src/main/kotlin/dev/terry1921/nenektrivia/model/question/QuestionModel.kt"
click node_sessionstore "https://github.com/terry1921/nenek_trivia/blob/main/database/src/main/kotlin/dev/terry1921/nenektrivia/database/session/RoomSessionRepository.kt"
click node_schema "https://github.com/terry1921/nenek_trivia/blob/main/database/src/main/kotlin/dev/terry1921/nenektrivia/database/NenekTriviaDatabase.kt"
click node_sessionentity "https://github.com/terry1921/nenek_trivia/blob/main/database/src/main/kotlin/dev/terry1921/nenektrivia/database/entity/GameSession.kt"
click node_honorusecase "https://github.com/terry1921/nenek_trivia/blob/main/domain/src/main/kotlin/dev/terry1921/nenektrivia/domain/honor/SyncHonorForGameResultUseCase.kt"
click node_honorremote "https://github.com/terry1921/nenek_trivia/blob/main/network/src/main/kotlin/dev/terry1921/nenektrivia/network/honor/FirebaseHonorRepository.kt"
click node_leaderboardui "https://github.com/terry1921/nenek_trivia/blob/main/ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/leaderboard/LeaderboardViewModel.kt"
click node_leaderboardusecase "https://github.com/terry1921/nenek_trivia/blob/main/domain/src/main/kotlin/dev/terry1921/nenektrivia/domain/leaderboard/GetLeaderboardUseCase.kt"
click node_leaderboardremote "https://github.com/terry1921/nenek_trivia/blob/main/network/src/main/kotlin/dev/terry1921/nenektrivia/network/leaderboard/FirebaseLeaderboardRepository.kt"
click node_preferencesui "https://github.com/terry1921/nenek_trivia/blob/main/ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/preferences/PreferencesViewModel.kt"
click node_preferencesusecase "https://github.com/terry1921/nenek_trivia/blob/main/domain/src/main/kotlin/dev/terry1921/nenektrivia/domain/preferences/GetUserSettingsUseCase.kt"
click node_datastore "https://github.com/terry1921/nenek_trivia/blob/main/database/src/main/kotlin/dev/terry1921/nenektrivia/database/preferences/DataStorePreferencesRepository.kt"
click node_profile "https://github.com/terry1921/nenek_trivia/blob/main/ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/profile/ProfileViewModel.kt"

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_activity,node_navigation,node_profile toneBlue
class node_questionui,node_questionusecase,node_questionmodel,node_honorusecase,node_leaderboardui,node_leaderboardusecase toneAmber
class node_authscreen,node_authvm,node_authusecases,node_sessionusecase,node_preferencesui,node_preferencesusecase toneMint
class node_localuser,node_sessionstore,node_schema,node_sessionentity,node_datastore toneRose
class node_remoteauth,node_questionremote,node_honorremote,node_leaderboardremote,node_player toneIndigo
```

## Components

### App experience

- [App entry](https://github.com/terry1921/nenek_trivia/blob/main/ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/main/MainActivity.kt): `ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/main/MainActivity.kt`
- [App navigation](https://github.com/terry1921/nenek_trivia/blob/main/ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/navigation/AppNavHost.kt): `ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/navigation/AppNavHost.kt`
- [Player profile](https://github.com/terry1921/nenek_trivia/blob/main/ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/profile/ProfileViewModel.kt): `ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/profile/ProfileViewModel.kt`

### Trivia and progress

- [Trivia play](https://github.com/terry1921/nenek_trivia/blob/main/ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/questions/QuestionsViewModel.kt): `ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/questions/QuestionsViewModel.kt`
- [Question retrieval](https://github.com/terry1921/nenek_trivia/blob/main/domain/src/main/kotlin/dev/terry1921/nenektrivia/domain/questions/GetQuestionsUseCase.kt): `domain/src/main/kotlin/dev/terry1921/nenektrivia/domain/questions/GetQuestionsUseCase.kt`
- [Question data](https://github.com/terry1921/nenek_trivia/blob/main/model/src/main/kotlin/dev/terry1921/nenektrivia/model/question/QuestionModel.kt): `model/src/main/kotlin/dev/terry1921/nenektrivia/model/question/QuestionModel.kt`
- [Honor synchronization](https://github.com/terry1921/nenek_trivia/blob/main/domain/src/main/kotlin/dev/terry1921/nenektrivia/domain/honor/SyncHonorForGameResultUseCase.kt): `domain/src/main/kotlin/dev/terry1921/nenektrivia/domain/honor/SyncHonorForGameResultUseCase.kt`
- [Leaderboard view](https://github.com/terry1921/nenek_trivia/blob/main/ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/leaderboard/LeaderboardViewModel.kt): `ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/leaderboard/LeaderboardViewModel.kt`
- [Leaderboard query](https://github.com/terry1921/nenek_trivia/blob/main/domain/src/main/kotlin/dev/terry1921/nenektrivia/domain/leaderboard/GetLeaderboardUseCase.kt): `domain/src/main/kotlin/dev/terry1921/nenektrivia/domain/leaderboard/GetLeaderboardUseCase.kt`

### Identity and settings

- [Sign-in screen](https://github.com/terry1921/nenek_trivia/blob/main/ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/auth/AuthScreen.kt): `ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/auth/AuthScreen.kt`
- [Sign-in logic](https://github.com/terry1921/nenek_trivia/blob/main/ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/auth/AuthViewModel.kt): `ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/auth/AuthViewModel.kt`
- [Social sign-in](https://github.com/terry1921/nenek_trivia/blob/main/domain/src/main/kotlin/dev/terry1921/nenektrivia/domain/auth/SignInWithGoogleUseCase.kt): `domain/src/main/kotlin/dev/terry1921/nenektrivia/domain/auth/SignInWithGoogleUseCase.kt`
- [Save user session](https://github.com/terry1921/nenek_trivia/blob/main/domain/src/main/kotlin/dev/terry1921/nenektrivia/domain/session/SaveUserSessionUseCase.kt): `domain/src/main/kotlin/dev/terry1921/nenektrivia/domain/session/SaveUserSessionUseCase.kt`
- [Player preferences](https://github.com/terry1921/nenek_trivia/blob/main/ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/preferences/PreferencesViewModel.kt): `ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/preferences/PreferencesViewModel.kt`
- [Settings use cases](https://github.com/terry1921/nenek_trivia/blob/main/domain/src/main/kotlin/dev/terry1921/nenektrivia/domain/preferences/GetUserSettingsUseCase.kt): `domain/src/main/kotlin/dev/terry1921/nenektrivia/domain/preferences/GetUserSettingsUseCase.kt`

### Local persistence

- [Local user repository](https://github.com/terry1921/nenek_trivia/blob/main/database/src/main/kotlin/dev/terry1921/nenektrivia/database/auth/RoomAuthRepository.kt): `database/src/main/kotlin/dev/terry1921/nenektrivia/database/auth/RoomAuthRepository.kt`
- [Game session store](https://github.com/terry1921/nenek_trivia/blob/main/database/src/main/kotlin/dev/terry1921/nenektrivia/database/session/RoomSessionRepository.kt): `database/src/main/kotlin/dev/terry1921/nenektrivia/database/session/RoomSessionRepository.kt`
- [Room database](https://github.com/terry1921/nenek_trivia/blob/main/database/src/main/kotlin/dev/terry1921/nenektrivia/database/NenekTriviaDatabase.kt): `database/src/main/kotlin/dev/terry1921/nenektrivia/database/NenekTriviaDatabase.kt`
- [Session records](https://github.com/terry1921/nenek_trivia/blob/main/database/src/main/kotlin/dev/terry1921/nenektrivia/database/entity/GameSession.kt): `database/src/main/kotlin/dev/terry1921/nenektrivia/database/entity/GameSession.kt`
- [Preferences store](https://github.com/terry1921/nenek_trivia/blob/main/database/src/main/kotlin/dev/terry1921/nenektrivia/database/preferences/DataStorePreferencesRepository.kt): `database/src/main/kotlin/dev/terry1921/nenektrivia/database/preferences/DataStorePreferencesRepository.kt`

### Remote services

- [Firebase auth](https://github.com/terry1921/nenek_trivia/blob/main/network/src/main/kotlin/dev/terry1921/nenektrivia/network/auth/FirebaseRemoteAuthRepository.kt): `network/src/main/kotlin/dev/terry1921/nenektrivia/network/auth/FirebaseRemoteAuthRepository.kt`
- [Firebase questions](https://github.com/terry1921/nenek_trivia/blob/main/network/src/main/kotlin/dev/terry1921/nenektrivia/network/questions/FirebaseQuestionsRepository.kt): `network/src/main/kotlin/dev/terry1921/nenektrivia/network/questions/FirebaseQuestionsRepository.kt`
- [Firebase Honor](https://github.com/terry1921/nenek_trivia/blob/main/network/src/main/kotlin/dev/terry1921/nenektrivia/network/honor/FirebaseHonorRepository.kt): `network/src/main/kotlin/dev/terry1921/nenektrivia/network/honor/FirebaseHonorRepository.kt`
- [Firebase leaderboard](https://github.com/terry1921/nenek_trivia/blob/main/network/src/main/kotlin/dev/terry1921/nenektrivia/network/leaderboard/FirebaseLeaderboardRepository.kt): `network/src/main/kotlin/dev/terry1921/nenektrivia/network/leaderboard/FirebaseLeaderboardRepository.kt`

### Other components

- **Player**

## Connections

- Player → App entry: opens (evidence: `ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/main/MainActivity.kt`)
- App entry → App navigation: hosts (evidence: `ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/main/MainActivity.kt`)
- App navigation → Sign-in screen: routes to
- Sign-in screen → Sign-in logic: renders (evidence: `ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/auth/AuthScreen.kt`)
- Sign-in logic → Social sign-in: invokes (evidence: `ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/auth/AuthViewModel.kt`)
- Social sign-in → Firebase auth: authenticates
- Social sign-in → Save user session: saves identity
- Save user session → Local user repository: persists session (evidence: `domain/src/main/kotlin/dev/terry1921/nenektrivia/domain/session/SaveUserSessionUseCase.kt`)
- Player → Trivia play: plays
- Trivia play → Question retrieval: requests questions
- Question retrieval → Firebase questions: loads questions
- Firebase questions → Question data: maps data (evidence: `network/src/main/kotlin/dev/terry1921/nenektrivia/network/questions/FirebaseQuestionsRepository.kt`)
- Trivia play → Game session store: records session
- Game session store → Room database: uses Room
- Game session store → Session records: stores (evidence: `database/src/main/kotlin/dev/terry1921/nenektrivia/database/session/RoomSessionRepository.kt`)
- Trivia play → Honor synchronization: syncs result
- Honor synchronization → Firebase Honor: syncs Honor
- Player → Leaderboard view: views
- Leaderboard view → Leaderboard query: requests scores
- Leaderboard query → Firebase leaderboard: loads scores
- Player → Player preferences: configures
- Player preferences → Settings use cases: updates settings
- Settings use cases → Preferences store: reads and saves
- Player → Player profile: views profile
