# mayursinhdjadeja/mcq_based_examination_system architecture

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

- Interactive diagram: https://gitdiagram.com/mayursinhdjadeja/mcq_based_examination_system
- Repository: https://github.com/mayursinhdjadeja/mcq_based_examination_system

## Overview

This is a browser-based MCQ examination system. A student enters enrollment and exam details, waits through a countdown, answers timed questions, and submits for scoring; results are sent to Google Sheets and an attempt flag is saved in local storage. The sampled JavaScript shows form validation, question rendering, navigation, timer submission, and result persistence. Some orchestration inside the omitted portions of script.js is not verified, so those links are dashed.

Main entry points: [`index.html`](https://github.com/mayursinhdjadeja/mcq_based_examination_system/blob/main/index.html) (Start Form), [`script.js`](https://github.com/mayursinhdjadeja/mcq_based_examination_system/blob/main/script.js) (Result Persistence)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Exam Entry"]
  node_start["Start Form<br/>[index.html]"]
  node_validation["Enrollment Check<br/>[script.js]"]
  node_countdown["Start Countdown<br/>[script.js]"]
end

subgraph group_runtime["Exam Runtime"]
  node_questionbank["MCQ Bank<br/>[script.js]"]
  node_questionview["Question Display<br/>[script.js]"]
  node_navigation["Question Navigation<br/>[script.js]"]
  node_timer["Exam Timer<br/>[script.js]"]
end

subgraph group_results["Results and Storage"]
  node_submission["Exam Submission<br/>[script.js]"]
  node_resultstore["Result Persistence<br/>[script.js]"]
  node_localstorage[("Browser Local Storage")]
  node_sheets[("Google Sheets")]
end

node_student(("Student"))

node_student -.->|"enters details"| node_start
node_start -->|"checks enrollment"| node_validation
node_start -->|"starts countdown"| node_countdown
node_countdown -.->|"starts exam"| node_questionview
node_questionbank -.->|"supplies questions"| node_questionview
node_navigation -->|"renders question"| node_questionview
node_timer -->|"submits on timeout"| node_submission
node_student -.->|"answers questions"| node_navigation
node_student -.->|"requests submission"| node_submission
node_submission -->|"stores result"| node_resultstore
node_resultstore -->|"posts result"| node_sheets
node_resultstore -->|"saves attempt flag"| node_localstorage

click node_start "https://github.com/mayursinhdjadeja/mcq_based_examination_system/blob/main/index.html"
click node_validation "https://github.com/mayursinhdjadeja/mcq_based_examination_system/blob/main/script.js"
click node_countdown "https://github.com/mayursinhdjadeja/mcq_based_examination_system/blob/main/script.js"
click node_questionbank "https://github.com/mayursinhdjadeja/mcq_based_examination_system/blob/main/script.js"
click node_questionview "https://github.com/mayursinhdjadeja/mcq_based_examination_system/blob/main/script.js"
click node_navigation "https://github.com/mayursinhdjadeja/mcq_based_examination_system/blob/main/script.js"
click node_timer "https://github.com/mayursinhdjadeja/mcq_based_examination_system/blob/main/script.js"
click node_submission "https://github.com/mayursinhdjadeja/mcq_based_examination_system/blob/main/script.js"
click node_resultstore "https://github.com/mayursinhdjadeja/mcq_based_examination_system/blob/main/script.js"

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_start,node_validation,node_countdown toneBlue
class node_questionbank,node_questionview,node_navigation,node_timer toneAmber
class node_submission,node_resultstore,node_localstorage,node_sheets toneMint
class node_student toneIndigo
```

## Components

### Exam Entry

- [Start Form](https://github.com/mayursinhdjadeja/mcq_based_examination_system/blob/main/index.html): `index.html`
- [Enrollment Check](https://github.com/mayursinhdjadeja/mcq_based_examination_system/blob/main/script.js): `script.js`
- [Start Countdown](https://github.com/mayursinhdjadeja/mcq_based_examination_system/blob/main/script.js): `script.js`

### Exam Runtime

- [MCQ Bank](https://github.com/mayursinhdjadeja/mcq_based_examination_system/blob/main/script.js): `script.js`
- [Question Display](https://github.com/mayursinhdjadeja/mcq_based_examination_system/blob/main/script.js): `script.js`
- [Question Navigation](https://github.com/mayursinhdjadeja/mcq_based_examination_system/blob/main/script.js): `script.js`
- [Exam Timer](https://github.com/mayursinhdjadeja/mcq_based_examination_system/blob/main/script.js): `script.js`

### Results and Storage

- [Exam Submission](https://github.com/mayursinhdjadeja/mcq_based_examination_system/blob/main/script.js): `script.js`
- [Result Persistence](https://github.com/mayursinhdjadeja/mcq_based_examination_system/blob/main/script.js): `script.js`
- **Browser Local Storage**
- **Google Sheets**

### Other components

- **Student**

## Connections

- Student → Start Form: enters details
- Start Form → Enrollment Check: checks enrollment (evidence: `script.js`)
- Start Form → Start Countdown: starts countdown (evidence: `script.js`)
- Start Countdown → Question Display: starts exam (evidence: `script.js`)
- MCQ Bank → Question Display: supplies questions (evidence: `script.js`)
- Question Navigation → Question Display: renders question (evidence: `script.js`)
- Exam Timer → Exam Submission: submits on timeout (evidence: `script.js`)
- Student → Question Navigation: answers questions
- Student → Exam Submission: requests submission
- Exam Submission → Result Persistence: stores result (evidence: `script.js`)
- Result Persistence → Google Sheets: posts result (evidence: `script.js`)
- Result Persistence → Browser Local Storage: saves attempt flag (evidence: `script.js`)
