How terry1921/nenek_trivia works
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: QuestionsViewModel.kt Trivia play · SignInWithGoogleUseCase.kt Social sign-in · RoomSessionRepository.kt Game session store · MainActivity.kt App entry
Components 25
App experience
- App entry
ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/main/MainActivity.kt - App navigation
ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/navigation/AppNavHost.kt - Player profile
ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/profile/ProfileViewModel.kt
Trivia and progress
- Trivia play
ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/questions/QuestionsViewModel.kt - Question retrieval
domain/src/main/kotlin/dev/terry1921/nenektrivia/domain/questions/GetQuestionsUseCase.kt - Question data
model/src/main/kotlin/dev/terry1921/nenektrivia/model/question/QuestionModel.kt - Honor synchronization
domain/src/main/kotlin/dev/terry1921/nenektrivia/domain/honor/SyncHonorForGameResultUseCase.kt - Leaderboard view
ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/leaderboard/LeaderboardViewModel.kt - Leaderboard query
domain/src/main/kotlin/dev/terry1921/nenektrivia/domain/leaderboard/GetLeaderboardUseCase.kt
Identity and settings
- Sign-in screen
ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/auth/AuthScreen.kt - Sign-in logic
ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/auth/AuthViewModel.kt - Social sign-in
domain/src/main/kotlin/dev/terry1921/nenektrivia/domain/auth/SignInWithGoogleUseCase.kt - Save user session
domain/src/main/kotlin/dev/terry1921/nenektrivia/domain/session/SaveUserSessionUseCase.kt - Player preferences
ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/preferences/PreferencesViewModel.kt - Settings use cases
domain/src/main/kotlin/dev/terry1921/nenektrivia/domain/preferences/GetUserSettingsUseCase.kt
Local persistence
- Local user repository
database/src/main/kotlin/dev/terry1921/nenektrivia/database/auth/RoomAuthRepository.kt - Game session store
database/src/main/kotlin/dev/terry1921/nenektrivia/database/session/RoomSessionRepository.kt - Room database
database/src/main/kotlin/dev/terry1921/nenektrivia/database/NenekTriviaDatabase.kt - Session records
database/src/main/kotlin/dev/terry1921/nenektrivia/database/entity/GameSession.kt - Preferences store
database/src/main/kotlin/dev/terry1921/nenektrivia/database/preferences/DataStorePreferencesRepository.kt
Remote services
- Firebase auth
network/src/main/kotlin/dev/terry1921/nenektrivia/network/auth/FirebaseRemoteAuthRepository.kt - Firebase questions
network/src/main/kotlin/dev/terry1921/nenektrivia/network/questions/FirebaseQuestionsRepository.kt - Firebase Honor
network/src/main/kotlin/dev/terry1921/nenektrivia/network/honor/FirebaseHonorRepository.kt - Firebase leaderboard
network/src/main/kotlin/dev/terry1921/nenektrivia/network/leaderboard/FirebaseLeaderboardRepository.kt
Other components
- Player
Connections 24
- Player → App entry: opens
ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/main/MainActivity.kt - App entry → App navigation: hosts
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
ui/src/main/kotlin/dev/terry1921/nenektrivia/ui/auth/AuthScreen.kt - Sign-in logic → Social sign-in: invokes
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
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
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
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