# kerem-ali/quizautomation architecture

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

- Interactive diagram: https://gitdiagram.com/kerem-ali/quizautomation
- Repository: https://github.com/kerem-ali/quizautomation

## Overview

QuizAutomation is a PyQt desktop quiz application. Users register or log in, then enter a main workspace for quiz creation, solving, result review, profile/settings, and leaderboard views. Quiz and question records, accounts, and submission results are managed through SQLite-backed managers. The graph preserves those major UI branches and the question/result stages; unsampled UI-to-manager details are omitted where the excerpts and index do not establish the call.

Main entry points: [`main.py`](https://github.com/kerem-ali/quizautomation/blob/main/main.py) (Application), [`UI/base/baseUI/baseUI.py`](https://github.com/kerem-ali/quizautomation/blob/main/UI/base/baseUI/baseUI.py) (Workspace navigation), [`DBManagers/QuestionDatabaseManager.py`](https://github.com/kerem-ali/quizautomation/blob/main/DBManagers/QuestionDatabaseManager.py) (Question manager), [`DBManagers/TestDatabaseManager.py`](https://github.com/kerem-ali/quizautomation/blob/main/DBManagers/TestDatabaseManager.py) (Quiz manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and accounts"]
  node_app["Application<br/>[main.py]"]
  node_login["Login screen<br/>[login.py]"]
  node_register["Registration screen<br/>[register.py]"]
  node_validator["Account validation<br/>[account_checker.py]"]
end

subgraph group_workspace["Quiz workspace"]
  node_mainui["Main window<br/>[mainUI.py]"]
  node_baseui["Workspace navigation<br/>[baseUI.py]"]
  node_create["Quiz creation<br/>[CreateQuizUI.py]"]
  node_questioninput["Question editor<br/>[inputQuestion.py]"]
  node_viewquizzes["Quiz browsing<br/>[viewQuestions.py]"]
  node_solve["Quiz solving<br/>[QuizUI.py]"]
  node_questionui["Question display<br/>[QuestionUISolve.py]"]
  node_quizreview["Quiz review<br/>[QuizReview.py]"]
  node_reviewquestion["Answer review"]
  node_resultsview["Results view<br/>[results.py]"]
  node_quizresult["Quiz result<br/>[quizresult.py]"]
  node_leaderboard["Leaderboard<br/>[leaderboard.py]"]
  node_about["About and charts<br/>[about.py]"]
  node_settings["Settings<br/>[settings.py]"]
end

subgraph group_content["Quiz content"]
  node_questionmodel["Question models<br/>[Question.py]"]
end

subgraph group_persistence["Persistence"]
  node_accounts["Account manager"]
  node_questionmanager["Question manager"]
  node_testmanager["Quiz manager"]
  node_resultsmanager["Results manager"]
  node_sqlite[("SQLite database")]
end

node_user(("User"))

node_user -->|"starts"| node_app
node_app -->|"shows"| node_login
node_app -->|"shows"| node_register
node_app -->|"validates"| node_validator
node_app -->|"authenticates"| node_accounts
node_app -->|"creates account"| node_accounts
node_app -->|"opens"| node_mainui
node_mainui -.->|"hosts"| node_baseui
node_baseui -->|"shows home"| node_resultsview
node_baseui -->|"shows"| node_about
node_baseui -->|"shows"| node_leaderboard
node_baseui -->|"shows"| node_viewquizzes
node_baseui -->|"opens"| node_create
node_baseui -->|"shows"| node_settings
node_create -->|"uses editor"| node_questioninput
node_viewquizzes -.->|"launches"| node_solve
node_solve -->|"renders"| node_questionui
node_quizreview -->|"renders"| node_reviewquestion
node_resultsview -->|"uses"| node_quizresult
node_quizresult -->|"opens review"| node_quizreview
node_questionmanager -->|"creates models"| node_questionmodel
node_testmanager -->|"loads questions"| node_questionmanager
node_resultsmanager -->|"updates quiz"| node_testmanager
node_app -->|"constructs"| node_questionmanager
node_app -->|"constructs"| node_testmanager
node_app -->|"constructs"| node_resultsmanager
node_accounts -->|"reads and writes"| node_sqlite
node_questionmanager -->|"reads and writes"| node_sqlite
node_testmanager -->|"reads and writes"| node_sqlite
node_resultsmanager -->|"reads and writes"| node_sqlite

click node_app "https://github.com/kerem-ali/quizautomation/blob/main/main.py"
click node_login "https://github.com/kerem-ali/quizautomation/blob/main/UI/login/login.py"
click node_register "https://github.com/kerem-ali/quizautomation/blob/main/UI/register/register.py"
click node_validator "https://github.com/kerem-ali/quizautomation/blob/main/Validators/account_checker.py"
click node_accounts "https://github.com/kerem-ali/quizautomation/blob/main/DBManagers/AccountsDatabaseManager.py"
click node_mainui "https://github.com/kerem-ali/quizautomation/blob/main/UI/base/mainUI.py"
click node_baseui "https://github.com/kerem-ali/quizautomation/blob/main/UI/base/baseUI/baseUI.py"
click node_create "https://github.com/kerem-ali/quizautomation/blob/main/UI/base/createTest/CreateQuizUI.py"
click node_questioninput "https://github.com/kerem-ali/quizautomation/blob/main/UI/base/createTest/inputQuestion.py"
click node_viewquizzes "https://github.com/kerem-ali/quizautomation/blob/main/UI/base/ViewQuestions/viewQuestions.py"
click node_solve "https://github.com/kerem-ali/quizautomation/blob/main/UI/base/ViewQuestions/QuizUI.py"
click node_questionui "https://github.com/kerem-ali/quizautomation/blob/main/UI/base/ViewQuestions/QuestionUISolve.py"
click node_quizreview "https://github.com/kerem-ali/quizautomation/blob/main/UI/base/ViewQuestions/QuizReview.py"
click node_reviewquestion "https://github.com/kerem-ali/quizautomation/blob/main/UI/base/ViewQuestions/QuestionUIReview.py"
click node_resultsview "https://github.com/kerem-ali/quizautomation/blob/main/UI/base/ViewQuestions/results.py"
click node_quizresult "https://github.com/kerem-ali/quizautomation/blob/main/UI/base/ViewQuestions/quizresult.py"
click node_leaderboard "https://github.com/kerem-ali/quizautomation/blob/main/UI/base/leaderboard/leaderboard.py"
click node_about "https://github.com/kerem-ali/quizautomation/blob/main/UI/base/about/about.py"
click node_settings "https://github.com/kerem-ali/quizautomation/blob/main/UI/base/settings/settings.py"
click node_questionmodel "https://github.com/kerem-ali/quizautomation/blob/main/CustomDataTypes/Question.py"
click node_questionmanager "https://github.com/kerem-ali/quizautomation/blob/main/DBManagers/QuestionDatabaseManager.py"
click node_testmanager "https://github.com/kerem-ali/quizautomation/blob/main/DBManagers/TestDatabaseManager.py"
click node_resultsmanager "https://github.com/kerem-ali/quizautomation/blob/main/DBManagers/ResultsDatabaseManager.py"

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_login,node_register,node_validator,node_user toneBlue
class node_mainui,node_baseui,node_create,node_questioninput,node_viewquizzes,node_solve,node_questionui,node_quizreview,node_reviewquestion,node_resultsview,node_quizresult,node_leaderboard,node_about,node_settings toneAmber
class node_questionmodel toneMint
class node_accounts,node_questionmanager,node_testmanager,node_resultsmanager,node_sqlite toneRose
```

## Components

### Entry and accounts

- [Application](https://github.com/kerem-ali/quizautomation/blob/main/main.py): `main.py`
- [Login screen](https://github.com/kerem-ali/quizautomation/blob/main/UI/login/login.py): `UI/login/login.py`
- [Registration screen](https://github.com/kerem-ali/quizautomation/blob/main/UI/register/register.py): `UI/register/register.py`
- [Account validation](https://github.com/kerem-ali/quizautomation/blob/main/Validators/account_checker.py): `Validators/account_checker.py`

### Quiz workspace

- [Main window](https://github.com/kerem-ali/quizautomation/blob/main/UI/base/mainUI.py): `UI/base/mainUI.py`
- [Workspace navigation](https://github.com/kerem-ali/quizautomation/blob/main/UI/base/baseUI/baseUI.py): `UI/base/baseUI/baseUI.py`
- [Quiz creation](https://github.com/kerem-ali/quizautomation/blob/main/UI/base/createTest/CreateQuizUI.py): `UI/base/createTest/CreateQuizUI.py`
- [Question editor](https://github.com/kerem-ali/quizautomation/blob/main/UI/base/createTest/inputQuestion.py): `UI/base/createTest/inputQuestion.py`
- [Quiz browsing](https://github.com/kerem-ali/quizautomation/blob/main/UI/base/ViewQuestions/viewQuestions.py): `UI/base/ViewQuestions/viewQuestions.py`
- [Quiz solving](https://github.com/kerem-ali/quizautomation/blob/main/UI/base/ViewQuestions/QuizUI.py): `UI/base/ViewQuestions/QuizUI.py`
- [Question display](https://github.com/kerem-ali/quizautomation/blob/main/UI/base/ViewQuestions/QuestionUISolve.py): `UI/base/ViewQuestions/QuestionUISolve.py`
- [Quiz review](https://github.com/kerem-ali/quizautomation/blob/main/UI/base/ViewQuestions/QuizReview.py): `UI/base/ViewQuestions/QuizReview.py`
- [Answer review](https://github.com/kerem-ali/quizautomation/blob/main/UI/base/ViewQuestions/QuestionUIReview.py): `UI/base/ViewQuestions/QuestionUIReview.py`
- [Results view](https://github.com/kerem-ali/quizautomation/blob/main/UI/base/ViewQuestions/results.py): `UI/base/ViewQuestions/results.py`
- [Quiz result](https://github.com/kerem-ali/quizautomation/blob/main/UI/base/ViewQuestions/quizresult.py): `UI/base/ViewQuestions/quizresult.py`
- [Leaderboard](https://github.com/kerem-ali/quizautomation/blob/main/UI/base/leaderboard/leaderboard.py): `UI/base/leaderboard/leaderboard.py`
- [About and charts](https://github.com/kerem-ali/quizautomation/blob/main/UI/base/about/about.py): `UI/base/about/about.py`
- [Settings](https://github.com/kerem-ali/quizautomation/blob/main/UI/base/settings/settings.py): `UI/base/settings/settings.py`

### Quiz content

- [Question models](https://github.com/kerem-ali/quizautomation/blob/main/CustomDataTypes/Question.py): `CustomDataTypes/Question.py`

### Persistence

- [Account manager](https://github.com/kerem-ali/quizautomation/blob/main/DBManagers/AccountsDatabaseManager.py): `DBManagers/AccountsDatabaseManager.py`
- [Question manager](https://github.com/kerem-ali/quizautomation/blob/main/DBManagers/QuestionDatabaseManager.py): `DBManagers/QuestionDatabaseManager.py`
- [Quiz manager](https://github.com/kerem-ali/quizautomation/blob/main/DBManagers/TestDatabaseManager.py): `DBManagers/TestDatabaseManager.py`
- [Results manager](https://github.com/kerem-ali/quizautomation/blob/main/DBManagers/ResultsDatabaseManager.py): `DBManagers/ResultsDatabaseManager.py`
- **SQLite database**

### Other components

- **User**

## Connections

- User → Application: starts
- Application → Login screen: shows (evidence: `main.py`)
- Application → Registration screen: shows (evidence: `main.py`)
- Application → Account validation: validates (evidence: `main.py`)
- Application → Account manager: authenticates (evidence: `main.py`)
- Application → Account manager: creates account (evidence: `main.py`)
- Application → Main window: opens (evidence: `main.py`)
- Main window → Workspace navigation: hosts (evidence: `UI/base/mainUI.py`)
- Workspace navigation → Results view: shows home (evidence: `UI/base/baseUI/baseUI.py`)
- Workspace navigation → About and charts: shows (evidence: `UI/base/baseUI/baseUI.py`)
- Workspace navigation → Leaderboard: shows (evidence: `UI/base/baseUI/baseUI.py`)
- Workspace navigation → Quiz browsing: shows (evidence: `UI/base/baseUI/baseUI.py`)
- Workspace navigation → Quiz creation: opens (evidence: `UI/base/baseUI/baseUI.py`)
- Workspace navigation → Settings: shows (evidence: `UI/base/baseUI/baseUI.py`)
- Quiz creation → Question editor: uses editor (evidence: `UI/base/createTest/CreateQuizUI.py`)
- Quiz browsing → Quiz solving: launches
- Quiz solving → Question display: renders (evidence: `UI/base/ViewQuestions/QuizUI.py`)
- Quiz review → Answer review: renders (evidence: `UI/base/ViewQuestions/QuizReview.py`)
- Results view → Quiz result: uses (evidence: `UI/base/ViewQuestions/results.py`)
- Quiz result → Quiz review: opens review (evidence: `UI/base/ViewQuestions/quizresult.py`)
- Question manager → Question models: creates models (evidence: `DBManagers/QuestionDatabaseManager.py`)
- Quiz manager → Question manager: loads questions (evidence: `DBManagers/TestDatabaseManager.py`)
- Results manager → Quiz manager: updates quiz (evidence: `DBManagers/ResultsDatabaseManager.py`)
- Application → Question manager: constructs (evidence: `main.py`)
- Application → Quiz manager: constructs (evidence: `main.py`)
- Application → Results manager: constructs (evidence: `main.py`)
- Account manager → SQLite database: reads and writes (evidence: `DBManagers/AccountsDatabaseManager.py`)
- Question manager → SQLite database: reads and writes (evidence: `DBManagers/QuestionDatabaseManager.py`)
- Quiz manager → SQLite database: reads and writes (evidence: `DBManagers/TestDatabaseManager.py`)
- Results manager → SQLite database: reads and writes (evidence: `DBManagers/ResultsDatabaseManager.py`)
