# an-k4/myquizapp architecture

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

- Interactive diagram: https://gitdiagram.com/an-k4/myquizapp
- Repository: https://github.com/an-k4/myquizapp

## Overview

MyQuizzApp is an Android quiz-authoring and multiplayer-play app. Users enter through the app navigation, then can authenticate, discover/search quizzes, create or manage quizzes, set up or join a room, play as a host or player, and view results. The architecture separates feature presentation/domain code from shared repository contracts and network implementations, with local Room storage for cookies and cached data. The supplied README is empty; several feature connections are therefore shown as unverified rather than asserted as inspected calls.

Main entry points: [`app/src/main/java/android/kma/myquizzapp/navigation/AppNavGraph.kt`](https://github.com/an-k4/myquizapp/blob/main/app/src/main/java/android/kma/myquizzapp/navigation/AppNavGraph.kt) (App navigation), [`feature/quiz-manage/src/main/java/android/kma/myquizzapp/feature/quiz_manage/presentation`](https://github.com/an-k4/myquizapp/tree/main/feature/quiz-manage/src/main/java/android/kma/myquizzapp/feature/quiz_manage/presentation) (Quiz management), [`core/network/src/main/java/android/kma/myquizzapp/core/network/repository/AuthRepositoryImpl.kt`](https://github.com/an-k4/myquizapp/blob/main/core/network/src/main/java/android/kma/myquizzapp/core/network/repository/AuthRepositoryImpl.kt) (Auth repository), [`core/network/src/main/java/android/kma/myquizzapp/core/network/repository/StorageRepositoryImpl.kt`](https://github.com/an-k4/myquizapp/blob/main/core/network/src/main/java/android/kma/myquizzapp/core/network/repository/StorageRepositoryImpl.kt) (Image upload)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App shell"]
  node_activity["Main activity<br/>[MainActivity.kt]"]
  node_navigation["App navigation<br/>[AppNavGraph.kt]"]
end

subgraph group_identity["Identity"]
  node_auth_ui["Auth screens"]
  node_auth_usecases["Auth use cases<br/>[AuthUseCases.kt]"]
  node_auth_impl["Auth repository"]
  node_auth_api["Auth API<br/>[AuthApiService.kt]"]
  node_session["Session state"]
end

subgraph group_quizzes["Quiz catalog"]
  node_home_search["Quiz search<br/>[SearchScreen.kt]"]
  node_search_vm["Search view model<br/>[SearchViewModel.kt]"]
  node_quiz_manage["Quiz management"]
  node_quiz_api["Quiz API<br/>[QuizApiService.kt]"]
  node_storage_flow["Image upload"]
  node_storage_api["Presign API"]
end

subgraph group_multiplayer["Multiplayer"]
  node_lobby["Room lobby"]
  node_session_usecase["Game session creation"]
  node_host_game["Host gameplay"]
  node_player_game["Player gameplay"]
  node_results["Final results"]
end

subgraph group_platform["Shared platform"]
  node_game_session_contract["Game session contract"]
  node_socket_contract["Game socket contracts"]
  node_database[("Room database<br/>[MyQuizzDatabase.kt]")]
  node_cookies["Persistent cookies<br/>[RoomCookieStore.kt]"]
  node_quiz_cache["Quiz cache"]
end

node_person(("App user"))
node_object_store[("Object storage")]

node_person -.->|"opens"| node_activity
node_activity -->|"renders"| node_navigation
node_navigation -.->|"routes to"| node_auth_ui
node_navigation -.->|"routes to"| node_home_search
node_navigation -.->|"routes to"| node_quiz_manage
node_navigation -.->|"routes to"| node_lobby
node_navigation -.->|"routes to"| node_host_game
node_navigation -.->|"routes to"| node_player_game
node_navigation -.->|"routes to"| node_results
node_auth_ui -.->|"invokes"| node_auth_usecases
node_auth_usecases -->|"uses contract"| node_auth_impl
node_auth_impl -->|"calls"| node_auth_api
node_auth_impl -->|"clears"| node_cookies
node_home_search -->|"sends intents"| node_search_vm
node_search_vm -.->|"searches quizzes"| node_quiz_api
node_quiz_manage -.->|"manages quizzes"| node_quiz_api
node_quiz_manage -.->|"uploads images"| node_storage_flow
node_storage_flow -->|"requests presign"| node_storage_api
node_storage_flow -.->|"uploads bytes"| node_object_store
node_quiz_manage -.->|"starts room setup"| node_session_usecase
node_session_usecase -->|"creates session"| node_game_session_contract
node_lobby -.->|"joins room"| node_game_session_contract
node_host_game -.->|"uses host socket"| node_socket_contract
node_player_game -->|"uses player socket"| node_socket_contract
node_player_game -.->|"records results"| node_results
node_database -->|"provides DAO"| node_cookies
node_database -->|"provides DAO"| node_quiz_cache

click node_activity "https://github.com/an-k4/myquizapp/blob/main/app/src/main/java/android/kma/myquizzapp/MainActivity.kt"
click node_navigation "https://github.com/an-k4/myquizapp/blob/main/app/src/main/java/android/kma/myquizzapp/navigation/AppNavGraph.kt"
click node_auth_ui "https://github.com/an-k4/myquizapp/tree/main/feature/auth/src/main/java/android/kma/myquizzapp/feature/auth/presentation"
click node_auth_usecases "https://github.com/an-k4/myquizapp/blob/main/feature/auth/src/main/java/android/kma/myquizzapp/feature/auth/domain/usecase/AuthUseCases.kt"
click node_auth_impl "https://github.com/an-k4/myquizapp/blob/main/core/network/src/main/java/android/kma/myquizzapp/core/network/repository/AuthRepositoryImpl.kt"
click node_auth_api "https://github.com/an-k4/myquizapp/blob/main/core/network/src/main/java/android/kma/myquizzapp/core/network/api/AuthApiService.kt"
click node_session "https://github.com/an-k4/myquizapp/blob/main/core/common/src/main/java/android/kma/myquizzapp/core/common/repository/SessionRepository.kt"
click node_home_search "https://github.com/an-k4/myquizapp/blob/main/feature/home/src/main/java/android/kma/myquizzapp/feature/home/presentation/search/SearchScreen.kt"
click node_search_vm "https://github.com/an-k4/myquizapp/blob/main/feature/home/src/main/java/android/kma/myquizzapp/feature/home/presentation/search/SearchViewModel.kt"
click node_quiz_manage "https://github.com/an-k4/myquizapp/tree/main/feature/quiz-manage/src/main/java/android/kma/myquizzapp/feature/quiz_manage/presentation"
click node_quiz_api "https://github.com/an-k4/myquizapp/blob/main/core/network/src/main/java/android/kma/myquizzapp/core/network/api/QuizApiService.kt"
click node_storage_flow "https://github.com/an-k4/myquizapp/blob/main/core/network/src/main/java/android/kma/myquizzapp/core/network/repository/StorageRepositoryImpl.kt"
click node_storage_api "https://github.com/an-k4/myquizapp/blob/main/core/network/src/main/java/android/kma/myquizzapp/core/network/api/StorageApiService.kt"
click node_lobby "https://github.com/an-k4/myquizapp/tree/main/feature/lobby/src/main/java/android/kma/myquizzapp/feature/lobby/presentation"
click node_session_usecase "https://github.com/an-k4/myquizapp/blob/main/feature/quiz-manage/src/main/java/android/kma/myquizzapp/feature/quiz_manage/domain/usecase/CreateGameSessionUseCase.kt"
click node_game_session_contract "https://github.com/an-k4/myquizapp/blob/main/core/common/src/main/java/android/kma/myquizzapp/core/common/repository/GameSessionRepository.kt"
click node_host_game "https://github.com/an-k4/myquizapp/blob/main/feature/game-host/src/main/java/android/kma/myquizzapp/feature/game_host/presentation/hostgame/HostGameViewModel.kt"
click node_player_game "https://github.com/an-k4/myquizapp/blob/main/feature/game-player/src/main/java/android/kma/myquizzapp/feature/game_player/domain/PlayerGameSessionUseCase.kt"
click node_socket_contract "https://github.com/an-k4/myquizapp/blob/main/core/common/src/main/java/android/kma/myquizzapp/core/common/repository/PlayerGameSocketRepository.kt"
click node_results "https://github.com/an-k4/myquizapp/blob/main/feature/leaderboard/src/main/java/android/kma/myquizzapp/feature/leaderboard/presentation/FinalResultScreen.kt"
click node_database "https://github.com/an-k4/myquizapp/blob/main/core/database/src/main/java/android/kma/myquizzapp/core/database/MyQuizzDatabase.kt"
click node_cookies "https://github.com/an-k4/myquizapp/blob/main/core/database/src/main/java/android/kma/myquizzapp/core/database/cookie/RoomCookieStore.kt"
click node_quiz_cache "https://github.com/an-k4/myquizapp/blob/main/core/database/src/main/java/android/kma/myquizzapp/core/database/cache/RoomQuizCacheStore.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_person toneBlue
class node_auth_ui,node_auth_usecases,node_auth_impl,node_auth_api,node_session,node_object_store toneAmber
class node_home_search,node_search_vm,node_quiz_manage,node_quiz_api,node_storage_flow,node_storage_api toneMint
class node_lobby,node_session_usecase,node_host_game,node_player_game,node_results toneRose
class node_game_session_contract,node_socket_contract,node_database,node_cookies,node_quiz_cache toneIndigo
```

## Components

### App shell

- [Main activity](https://github.com/an-k4/myquizapp/blob/main/app/src/main/java/android/kma/myquizzapp/MainActivity.kt): `app/src/main/java/android/kma/myquizzapp/MainActivity.kt`
- [App navigation](https://github.com/an-k4/myquizapp/blob/main/app/src/main/java/android/kma/myquizzapp/navigation/AppNavGraph.kt): `app/src/main/java/android/kma/myquizzapp/navigation/AppNavGraph.kt`

### Identity

- [Auth screens](https://github.com/an-k4/myquizapp/tree/main/feature/auth/src/main/java/android/kma/myquizzapp/feature/auth/presentation): `feature/auth/src/main/java/android/kma/myquizzapp/feature/auth/presentation`
- [Auth use cases](https://github.com/an-k4/myquizapp/blob/main/feature/auth/src/main/java/android/kma/myquizzapp/feature/auth/domain/usecase/AuthUseCases.kt): `feature/auth/src/main/java/android/kma/myquizzapp/feature/auth/domain/usecase/AuthUseCases.kt`
- [Auth repository](https://github.com/an-k4/myquizapp/blob/main/core/network/src/main/java/android/kma/myquizzapp/core/network/repository/AuthRepositoryImpl.kt): `core/network/src/main/java/android/kma/myquizzapp/core/network/repository/AuthRepositoryImpl.kt`
- [Auth API](https://github.com/an-k4/myquizapp/blob/main/core/network/src/main/java/android/kma/myquizzapp/core/network/api/AuthApiService.kt): `core/network/src/main/java/android/kma/myquizzapp/core/network/api/AuthApiService.kt`
- [Session state](https://github.com/an-k4/myquizapp/blob/main/core/common/src/main/java/android/kma/myquizzapp/core/common/repository/SessionRepository.kt): `core/common/src/main/java/android/kma/myquizzapp/core/common/repository/SessionRepository.kt`

### Quiz catalog

- [Quiz search](https://github.com/an-k4/myquizapp/blob/main/feature/home/src/main/java/android/kma/myquizzapp/feature/home/presentation/search/SearchScreen.kt): `feature/home/src/main/java/android/kma/myquizzapp/feature/home/presentation/search/SearchScreen.kt`
- [Search view model](https://github.com/an-k4/myquizapp/blob/main/feature/home/src/main/java/android/kma/myquizzapp/feature/home/presentation/search/SearchViewModel.kt): `feature/home/src/main/java/android/kma/myquizzapp/feature/home/presentation/search/SearchViewModel.kt`
- [Quiz management](https://github.com/an-k4/myquizapp/tree/main/feature/quiz-manage/src/main/java/android/kma/myquizzapp/feature/quiz_manage/presentation): `feature/quiz-manage/src/main/java/android/kma/myquizzapp/feature/quiz_manage/presentation`
- [Quiz API](https://github.com/an-k4/myquizapp/blob/main/core/network/src/main/java/android/kma/myquizzapp/core/network/api/QuizApiService.kt): `core/network/src/main/java/android/kma/myquizzapp/core/network/api/QuizApiService.kt`
- [Image upload](https://github.com/an-k4/myquizapp/blob/main/core/network/src/main/java/android/kma/myquizzapp/core/network/repository/StorageRepositoryImpl.kt): `core/network/src/main/java/android/kma/myquizzapp/core/network/repository/StorageRepositoryImpl.kt`
- [Presign API](https://github.com/an-k4/myquizapp/blob/main/core/network/src/main/java/android/kma/myquizzapp/core/network/api/StorageApiService.kt): `core/network/src/main/java/android/kma/myquizzapp/core/network/api/StorageApiService.kt`

### Multiplayer

- [Room lobby](https://github.com/an-k4/myquizapp/tree/main/feature/lobby/src/main/java/android/kma/myquizzapp/feature/lobby/presentation): `feature/lobby/src/main/java/android/kma/myquizzapp/feature/lobby/presentation`
- [Game session creation](https://github.com/an-k4/myquizapp/blob/main/feature/quiz-manage/src/main/java/android/kma/myquizzapp/feature/quiz_manage/domain/usecase/CreateGameSessionUseCase.kt): `feature/quiz-manage/src/main/java/android/kma/myquizzapp/feature/quiz_manage/domain/usecase/CreateGameSessionUseCase.kt`
- [Host gameplay](https://github.com/an-k4/myquizapp/blob/main/feature/game-host/src/main/java/android/kma/myquizzapp/feature/game_host/presentation/hostgame/HostGameViewModel.kt): `feature/game-host/src/main/java/android/kma/myquizzapp/feature/game_host/presentation/hostgame/HostGameViewModel.kt`
- [Player gameplay](https://github.com/an-k4/myquizapp/blob/main/feature/game-player/src/main/java/android/kma/myquizzapp/feature/game_player/domain/PlayerGameSessionUseCase.kt): `feature/game-player/src/main/java/android/kma/myquizzapp/feature/game_player/domain/PlayerGameSessionUseCase.kt`
- [Final results](https://github.com/an-k4/myquizapp/blob/main/feature/leaderboard/src/main/java/android/kma/myquizzapp/feature/leaderboard/presentation/FinalResultScreen.kt): `feature/leaderboard/src/main/java/android/kma/myquizzapp/feature/leaderboard/presentation/FinalResultScreen.kt`

### Shared platform

- [Game session contract](https://github.com/an-k4/myquizapp/blob/main/core/common/src/main/java/android/kma/myquizzapp/core/common/repository/GameSessionRepository.kt): `core/common/src/main/java/android/kma/myquizzapp/core/common/repository/GameSessionRepository.kt`
- [Game socket contracts](https://github.com/an-k4/myquizapp/blob/main/core/common/src/main/java/android/kma/myquizzapp/core/common/repository/PlayerGameSocketRepository.kt): `core/common/src/main/java/android/kma/myquizzapp/core/common/repository/PlayerGameSocketRepository.kt`
- [Room database](https://github.com/an-k4/myquizapp/blob/main/core/database/src/main/java/android/kma/myquizzapp/core/database/MyQuizzDatabase.kt): `core/database/src/main/java/android/kma/myquizzapp/core/database/MyQuizzDatabase.kt`
- [Persistent cookies](https://github.com/an-k4/myquizapp/blob/main/core/database/src/main/java/android/kma/myquizzapp/core/database/cookie/RoomCookieStore.kt): `core/database/src/main/java/android/kma/myquizzapp/core/database/cookie/RoomCookieStore.kt`
- [Quiz cache](https://github.com/an-k4/myquizapp/blob/main/core/database/src/main/java/android/kma/myquizzapp/core/database/cache/RoomQuizCacheStore.kt): `core/database/src/main/java/android/kma/myquizzapp/core/database/cache/RoomQuizCacheStore.kt`

### Other components

- **App user**
- **Object storage**

## Connections

- App user → Main activity: opens
- Main activity → App navigation: renders (evidence: `app/src/main/java/android/kma/myquizzapp/MainActivity.kt`)
- App navigation → Auth screens: routes to
- App navigation → Quiz search: routes to
- App navigation → Quiz management: routes to
- App navigation → Room lobby: routes to
- App navigation → Host gameplay: routes to
- App navigation → Player gameplay: routes to
- App navigation → Final results: routes to
- Auth screens → Auth use cases: invokes
- Auth use cases → Auth repository: uses contract (evidence: `feature/auth/src/main/java/android/kma/myquizzapp/feature/auth/domain/usecase/AuthUseCases.kt`)
- Auth repository → Auth API: calls (evidence: `core/network/src/main/java/android/kma/myquizzapp/core/network/repository/AuthRepositoryImpl.kt`)
- Auth repository → Persistent cookies: clears (evidence: `core/network/src/main/java/android/kma/myquizzapp/core/network/repository/AuthRepositoryImpl.kt`)
- Quiz search → Search view model: sends intents (evidence: `feature/home/src/main/java/android/kma/myquizzapp/feature/home/presentation/search/SearchScreen.kt`)
- Search view model → Quiz API: searches quizzes
- Quiz management → Quiz API: manages quizzes
- Quiz management → Image upload: uploads images
- Image upload → Presign API: requests presign (evidence: `core/network/src/main/java/android/kma/myquizzapp/core/network/repository/StorageRepositoryImpl.kt`)
- Image upload → Object storage: uploads bytes
- Quiz management → Game session creation: starts room setup
- Game session creation → Game session contract: creates session (evidence: `feature/quiz-manage/src/main/java/android/kma/myquizzapp/feature/quiz_manage/domain/usecase/CreateGameSessionUseCase.kt`)
- Room lobby → Game session contract: joins room
- Host gameplay → Game socket contracts: uses host socket
- Player gameplay → Game socket contracts: uses player socket (evidence: `feature/game-player/src/main/java/android/kma/myquizzapp/feature/game_player/domain/PlayerGameSessionUseCase.kt`)
- Player gameplay → Final results: records results
- Room database → Persistent cookies: provides DAO (evidence: `core/database/src/main/java/android/kma/myquizzapp/core/database/MyQuizzDatabase.kt`)
- Room database → Quiz cache: provides DAO (evidence: `core/database/src/main/java/android/kma/myquizzapp/core/database/MyQuizzDatabase.kt`)
