# mayank2kumar/quiz_master_23f1003160_ architecture

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

- Interactive diagram: https://gitdiagram.com/mayank2kumar/quiz_master_23f1003160_
- Repository: https://github.com/mayank2kumar/quiz_master_23f1003160_

## Overview

Quiz Master is a Flask quiz-management and examination system for administrators and students. Students register and log in, browse subjects, chapters, and quizzes, submit answers, and review scores; administrators manage educational content and users. Routes.py contains the application logic, SQLAlchemy models represent persistent data, and Jinja templates provide the UI. The README documents capabilities beyond the sampled route excerpts; those are represented as route subsystems, with links omitted where implementation details were not shown.

Main entry points: [`models.py`](https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/models.py) (Domain models), [`app.py`](https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/app.py) (Flask application), [`templates`](https://github.com/mayank2kumar/quiz_master_23f1003160_/tree/master/templates) (Jinja templates), [`routes.py`](https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/routes.py) (Registration and auth)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Web runtime"]
  node_app["Flask application<br/>[app.py]"]
  node_configuration["App configuration<br/>[config.py]"]
  node_templates["Jinja templates"]
  node_models["Domain models<br/>[models.py]"]
  node_database[("SQLite database<br/>[models.py]")]
end

subgraph group_identity["Identity and administration"]
  node_auth["Registration and auth<br/>[routes.py]"]
  node_admin_dashboard["Admin dashboard<br/>[routes.py]"]
  node_user_management["User management<br/>[routes.py]"]
  node_admin_summary["Admin summary<br/>[routes.py]"]
end

subgraph group_content["Educational content"]
  node_subject_management["Subject management<br/>[routes.py]"]
  node_chapter_management["Chapter management<br/>[routes.py]"]
  node_quiz_management["Quiz management<br/>[routes.py]"]
  node_question_management["Question management<br/>[routes.py]"]
end

subgraph group_assessment["Quizzes and results"]
  node_subject_browsing["Browse subjects<br/>[routes.py]"]
  node_quiz_attempt["Quiz attempt<br/>[routes.py]"]
  node_score_calculation["Score calculation<br/>[routes.py]"]
  node_score_history["Score history<br/>[routes.py]"]
end

node_student(("Student"))
node_administrator(("Administrator"))

node_student -->|"uses"| node_app
node_administrator -->|"uses"| node_app
node_app -->|"loads"| node_configuration
node_app -->|"loads"| node_models
node_app -->|"loads routes"| node_auth
node_app -->|"renders"| node_templates
node_auth -->|"queries"| node_models
node_auth -->|"renders"| node_templates
node_admin_dashboard -->|"queries"| node_models
node_admin_dashboard -->|"renders"| node_templates
node_user_management -->|"updates"| node_models
node_admin_summary -->|"queries"| node_models
node_subject_management -->|"manages"| node_models
node_chapter_management -->|"manages"| node_models
node_quiz_management -->|"manages"| node_models
node_question_management -->|"manages"| node_models
node_subject_browsing -->|"queries"| node_models
node_subject_browsing -->|"renders"| node_templates
node_quiz_attempt -->|"loads questions"| node_models
node_quiz_attempt -->|"submits answers"| node_score_calculation
node_score_calculation -->|"evaluates quiz"| node_models
node_score_calculation -.->|"stores scores"| node_database
node_score_history -->|"queries scores"| node_models
node_score_history -->|"renders"| node_templates
node_models -->|"persists data"| node_database

click node_app "https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/app.py"
click node_configuration "https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/config.py"
click node_templates "https://github.com/mayank2kumar/quiz_master_23f1003160_/tree/master/templates"
click node_auth "https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/routes.py"
click node_admin_dashboard "https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/routes.py"
click node_user_management "https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/routes.py"
click node_admin_summary "https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/routes.py"
click node_subject_management "https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/routes.py"
click node_chapter_management "https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/routes.py"
click node_quiz_management "https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/routes.py"
click node_question_management "https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/routes.py"
click node_subject_browsing "https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/routes.py"
click node_quiz_attempt "https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/routes.py"
click node_score_calculation "https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/routes.py"
click node_score_history "https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/routes.py"
click node_models "https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/models.py"
click node_database "https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/models.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_configuration,node_templates,node_models,node_database toneBlue
class node_auth,node_admin_dashboard,node_user_management,node_admin_summary toneAmber
class node_subject_management,node_chapter_management,node_quiz_management,node_question_management toneMint
class node_subject_browsing,node_quiz_attempt,node_score_calculation,node_score_history toneRose
class node_student,node_administrator toneIndigo
```

## Components

### Web runtime

- [Flask application](https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/app.py): `app.py`
- [App configuration](https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/config.py): `config.py`
- [Jinja templates](https://github.com/mayank2kumar/quiz_master_23f1003160_/tree/master/templates): `templates`
- [Domain models](https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/models.py): `models.py`
- [SQLite database](https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/models.py): `models.py`

### Identity and administration

- [Registration and auth](https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/routes.py): `routes.py`
- [Admin dashboard](https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/routes.py): `routes.py`
- [User management](https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/routes.py): `routes.py`
- [Admin summary](https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/routes.py): `routes.py`

### Educational content

- [Subject management](https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/routes.py): `routes.py`
- [Chapter management](https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/routes.py): `routes.py`
- [Quiz management](https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/routes.py): `routes.py`
- [Question management](https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/routes.py): `routes.py`

### Quizzes and results

- [Browse subjects](https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/routes.py): `routes.py`
- [Quiz attempt](https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/routes.py): `routes.py`
- [Score calculation](https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/routes.py): `routes.py`
- [Score history](https://github.com/mayank2kumar/quiz_master_23f1003160_/blob/master/routes.py): `routes.py`

### Other components

- **Student**
- **Administrator**

## Connections

- Student → Flask application: uses (evidence: `README.md`)
- Administrator → Flask application: uses (evidence: `README.md`)
- Flask application → App configuration: loads (evidence: `app.py`)
- Flask application → Domain models: loads (evidence: `app.py`)
- Flask application → Registration and auth: loads routes (evidence: `app.py`)
- Flask application → Jinja templates: renders (evidence: `README.md`)
- Registration and auth → Domain models: queries (evidence: `routes.py`)
- Registration and auth → Jinja templates: renders (evidence: `routes.py`)
- Admin dashboard → Domain models: queries (evidence: `routes.py`)
- Admin dashboard → Jinja templates: renders (evidence: `README.md`)
- User management → Domain models: updates (evidence: `routes.py`)
- Admin summary → Domain models: queries (evidence: `routes.py`)
- Subject management → Domain models: manages (evidence: `routes.py`)
- Chapter management → Domain models: manages (evidence: `routes.py`)
- Quiz management → Domain models: manages (evidence: `routes.py`)
- Question management → Domain models: manages (evidence: `routes.py`)
- Browse subjects → Domain models: queries (evidence: `routes.py`)
- Browse subjects → Jinja templates: renders (evidence: `routes.py`)
- Quiz attempt → Domain models: loads questions (evidence: `routes.py`)
- Quiz attempt → Score calculation: submits answers (evidence: `README.md`)
- Score calculation → Domain models: evaluates quiz (evidence: `routes.py`)
- Score calculation → SQLite database: stores scores (evidence: `routes.py`)
- Score history → Domain models: queries scores (evidence: `routes.py`)
- Score history → Jinja templates: renders (evidence: `routes.py`)
- Domain models → SQLite database: persists data (evidence: `README.md`)
