# sikderishan61-art/mcqbook architecture

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

- Interactive diagram: https://gitdiagram.com/sikderishan61-art/mcqbook
- Repository: https://github.com/sikderishan61-art/mcqbook

## Overview

MCQBook is a Bangla SSC study and practice site. Learners use the site to select curriculum questions, answer quizzes, and review saved attempts; the large data files supply question content, while the main app code manages practice and learner state. The repository also includes formula references, study-support features, subject/chapter pages, and an Android package. The README describes the intended asset split, but the supplied tree is flat; edges are limited to relationships visible in excerpts or documented in the README, so some runtime wiring is not shown.

Main entry points: [`02-data-app-part1.js`](https://github.com/sikderishan61-art/mcqbook/blob/main/02-data-app-part1.js) (Quiz and account logic), [`07-data-app-part6.js`](https://github.com/sikderishan61-art/mcqbook/blob/main/07-data-app-part6.js) (Study state), [`03-data-app-part2.js`](https://github.com/sikderishan61-art/mcqbook/blob/main/03-data-app-part2.js) (Question bank 2), [`04-data-app-part3.js`](https://github.com/sikderishan61-art/mcqbook/blob/main/04-data-app-part3.js) (Question bank 3)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Question content"]
  node_q1["Question bank 1"]
  node_q2["Question bank 2"]
  node_q3["Question bank 3"]
  node_q4["Question bank 4"]
  node_q5["Question bank 5"]
  node_q6["Question bank 6"]
  node_q7["Practice sets"]
  node_q8["Practice sets"]
end

subgraph group_practice["Practice app"]
  node_appcore["Quiz and account logic"]
  node_appstate[("Study state")]
  node_appfeatures["Practice features"]
end

subgraph group_learning["Study tools"]
  node_explanations["Answer explanations<br/>[01-scripts.js]"]
  node_chemexplanations["Chemistry explanations<br/>[10-scripts.js]"]
  node_physicsformulas["Physics formulas<br/>[22-fm-js.js]"]
  node_mathformulas["Math formulas<br/>[23-mf-js.js]"]
  node_assistant["Study assistant<br/>[17-ishan-asst.js]"]
  node_premium["Premium access<br/>[13-pm-js.js]"]
  node_education["Education tools<br/>[18-edu-js.js]"]
end

subgraph group_site["Site content"]
  node_home["Site shell<br/>[index.html]"]
  node_articles["Study articles"]
  node_subjectpages["Subject and chapter pages<br/>[ssc-mcq.html]"]
  node_android["Android app package<br/>[mcqbook.apk]"]
end

node_learner(("Learner"))
node_formsubmit{{"FormSubmit service"}}

node_learner -->|"opens"| node_home
node_learner -.->|"reads"| node_articles
node_learner -.->|"browses"| node_subjectpages
node_learner -.->|"uses"| node_android
node_q1 -->|"question data"| node_appcore
node_q2 -->|"question data"| node_appcore
node_q3 -->|"question data"| node_appcore
node_q4 -->|"question data"| node_appcore
node_q5 -->|"question data"| node_appcore
node_q6 -->|"question data"| node_appcore
node_q7 -->|"question data"| node_appcore
node_q8 -->|"question data"| node_appcore
node_appcore -->|"reads and saves"| node_appstate
node_appcore -->|"sends account notice"| node_formsubmit
node_appfeatures -->|"updates attempts"| node_appstate
node_mathformulas -.->|"integrates into views"| node_physicsformulas

click node_home "https://github.com/sikderishan61-art/mcqbook/blob/main/index.html"
click node_q1 "https://github.com/sikderishan61-art/mcqbook/blob/main/02-data-app-part1.js"
click node_q2 "https://github.com/sikderishan61-art/mcqbook/blob/main/03-data-app-part2.js"
click node_q3 "https://github.com/sikderishan61-art/mcqbook/blob/main/04-data-app-part3.js"
click node_q4 "https://github.com/sikderishan61-art/mcqbook/blob/main/05-data-app-part4.js"
click node_q5 "https://github.com/sikderishan61-art/mcqbook/blob/main/06-data-app-part5.js"
click node_q6 "https://github.com/sikderishan61-art/mcqbook/blob/main/07-data-app-part6.js"
click node_q7 "https://github.com/sikderishan61-art/mcqbook/blob/main/08-data-app-part7.js"
click node_q8 "https://github.com/sikderishan61-art/mcqbook/blob/main/09-data-app-part8.js"
click node_appcore "https://github.com/sikderishan61-art/mcqbook/blob/main/02-data-app-part1.js"
click node_appstate "https://github.com/sikderishan61-art/mcqbook/blob/main/07-data-app-part6.js"
click node_appfeatures "https://github.com/sikderishan61-art/mcqbook/blob/main/08-data-app-part7.js"
click node_explanations "https://github.com/sikderishan61-art/mcqbook/blob/main/01-scripts.js"
click node_chemexplanations "https://github.com/sikderishan61-art/mcqbook/blob/main/10-scripts.js"
click node_physicsformulas "https://github.com/sikderishan61-art/mcqbook/blob/main/22-fm-js.js"
click node_mathformulas "https://github.com/sikderishan61-art/mcqbook/blob/main/23-mf-js.js"
click node_assistant "https://github.com/sikderishan61-art/mcqbook/blob/main/17-ishan-asst.js"
click node_premium "https://github.com/sikderishan61-art/mcqbook/blob/main/13-pm-js.js"
click node_education "https://github.com/sikderishan61-art/mcqbook/blob/main/18-edu-js.js"
click node_articles "https://github.com/sikderishan61-art/mcqbook/blob/main/board-question-practice-guide.html"
click node_subjectpages "https://github.com/sikderishan61-art/mcqbook/blob/main/ssc-mcq.html"
click node_android "https://github.com/sikderishan61-art/mcqbook/blob/main/app/mcqbook.apk"

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_q1,node_q2,node_q3,node_q4,node_q5,node_q6,node_q7,node_q8 toneBlue
class node_appcore,node_appstate,node_appfeatures toneAmber
class node_explanations,node_chemexplanations,node_physicsformulas,node_mathformulas,node_assistant,node_premium,node_education toneMint
class node_home,node_articles,node_subjectpages,node_android toneRose
class node_learner,node_formsubmit toneIndigo
```

## Components

### Question content

- [Question bank 1](https://github.com/sikderishan61-art/mcqbook/blob/main/02-data-app-part1.js): `02-data-app-part1.js`
- [Question bank 2](https://github.com/sikderishan61-art/mcqbook/blob/main/03-data-app-part2.js): `03-data-app-part2.js`
- [Question bank 3](https://github.com/sikderishan61-art/mcqbook/blob/main/04-data-app-part3.js): `04-data-app-part3.js`
- [Question bank 4](https://github.com/sikderishan61-art/mcqbook/blob/main/05-data-app-part4.js): `05-data-app-part4.js`
- [Question bank 5](https://github.com/sikderishan61-art/mcqbook/blob/main/06-data-app-part5.js): `06-data-app-part5.js`
- [Question bank 6](https://github.com/sikderishan61-art/mcqbook/blob/main/07-data-app-part6.js): `07-data-app-part6.js`
- [Practice sets](https://github.com/sikderishan61-art/mcqbook/blob/main/08-data-app-part7.js): `08-data-app-part7.js`
- [Practice sets](https://github.com/sikderishan61-art/mcqbook/blob/main/09-data-app-part8.js): `09-data-app-part8.js`

### Practice app

- [Quiz and account logic](https://github.com/sikderishan61-art/mcqbook/blob/main/02-data-app-part1.js): `02-data-app-part1.js`
- [Study state](https://github.com/sikderishan61-art/mcqbook/blob/main/07-data-app-part6.js): `07-data-app-part6.js`
- [Practice features](https://github.com/sikderishan61-art/mcqbook/blob/main/08-data-app-part7.js): `08-data-app-part7.js`

### Study tools

- [Answer explanations](https://github.com/sikderishan61-art/mcqbook/blob/main/01-scripts.js): `01-scripts.js`
- [Chemistry explanations](https://github.com/sikderishan61-art/mcqbook/blob/main/10-scripts.js): `10-scripts.js`
- [Physics formulas](https://github.com/sikderishan61-art/mcqbook/blob/main/22-fm-js.js): `22-fm-js.js`
- [Math formulas](https://github.com/sikderishan61-art/mcqbook/blob/main/23-mf-js.js): `23-mf-js.js`
- [Study assistant](https://github.com/sikderishan61-art/mcqbook/blob/main/17-ishan-asst.js): `17-ishan-asst.js`
- [Premium access](https://github.com/sikderishan61-art/mcqbook/blob/main/13-pm-js.js): `13-pm-js.js`
- [Education tools](https://github.com/sikderishan61-art/mcqbook/blob/main/18-edu-js.js): `18-edu-js.js`

### Site content

- [Site shell](https://github.com/sikderishan61-art/mcqbook/blob/main/index.html): `index.html`
- [Study articles](https://github.com/sikderishan61-art/mcqbook/blob/main/board-question-practice-guide.html): `board-question-practice-guide.html`
- [Subject and chapter pages](https://github.com/sikderishan61-art/mcqbook/blob/main/ssc-mcq.html): `ssc-mcq.html`
- [Android app package](https://github.com/sikderishan61-art/mcqbook/blob/main/app/mcqbook.apk): `app/mcqbook.apk`

### Other components

- **Learner**
- **FormSubmit service**

## Connections

- Learner → Site shell: opens (evidence: `README.txt`)
- Learner → Study articles: reads
- Learner → Subject and chapter pages: browses
- Learner → Android app package: uses
- Question bank 1 → Quiz and account logic: question data (evidence: `README.txt`)
- Question bank 2 → Quiz and account logic: question data (evidence: `README.txt`)
- Question bank 3 → Quiz and account logic: question data (evidence: `README.txt`)
- Question bank 4 → Quiz and account logic: question data (evidence: `README.txt`)
- Question bank 5 → Quiz and account logic: question data (evidence: `README.txt`)
- Question bank 6 → Quiz and account logic: question data (evidence: `README.txt`)
- Practice sets → Quiz and account logic: question data (evidence: `README.txt`)
- Practice sets → Quiz and account logic: question data (evidence: `README.txt`)
- Quiz and account logic → Study state: reads and saves (evidence: `07-data-app-part6.js`)
- Quiz and account logic → FormSubmit service: sends account notice (evidence: `02-data-app-part1.js`)
- Practice features → Study state: updates attempts (evidence: `08-data-app-part7.js`)
- Math formulas → Physics formulas: integrates into views
