# wajih1234/quiz-app architecture

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

- Interactive diagram: https://gitdiagram.com/wajih1234/quiz-app
- Repository: https://github.com/wajih1234/quiz-app

## Overview

QuizApp takes users from registration and login through answering coding questions, accumulating scores, and viewing a paginated leaderboard. The React app routes users among those screens; the Express API handles authentication, question and score requests, and MongoDB-backed records. The graph includes the documented leaderboard and protected-route capabilities. Some backend routes and client request implementations were not excerpted, so those connections are shown as unverified rather than asserted as observed calls.

Main entry points: [`front/src/App.js`](https://github.com/wajih1234/quiz-app/blob/main/front/src/App.js) (Page router), [`back/routes/scoreRoutes.js`](https://github.com/wajih1234/quiz-app/blob/main/back/routes/scoreRoutes.js) (Score routes), [`back/routes/index.js`](https://github.com/wajih1234/quiz-app/blob/main/back/routes/index.js) (API router), [`back/routes/questionRoutes.js`](https://github.com/wajih1234/quiz-app/blob/main/back/routes/questionRoutes.js) (Question routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React client"]
  node_bootstrap["Client bootstrap<br/>[index.js]"]
  node_app["Page router<br/>[App.js]"]
  node_signup_page["Registration<br/>[Sign.js]"]
  node_login_page["Login<br/>[Login.js]"]
  node_quiz_page["Quiz play<br/>[Quiz.js]"]
  node_score_page["Score view<br/>[Scorepage.js]"]
  node_leaderboard_page["Leaderboard<br/>[LeaderBoard.js]"]
  node_vitals["Web vitals<br/>[reportWebVitals.js]"]
end

subgraph group_api["Express API"]
  node_server["HTTP server<br/>[server.js]"]
  node_api_router["API router<br/>[index.js]"]
  node_auth_routes["Auth routes<br/>[auth.js]"]
  node_question_routes["Question routes<br/>[questionRoutes.js]"]
  node_score_routes["Score routes<br/>[scoreRoutes.js]"]
  node_auth_middleware["JWT guard<br/>[auth.js]"]
end

subgraph group_domain["Quiz domain"]
  node_auth_controller["Account service<br/>[authController.js]"]
  node_question_controller["Question and answers"]
  node_score_controller["Score queries<br/>[score.js]"]
end

subgraph group_data["Persistence"]
  node_user_model[("User records<br/>[User.js]")]
  node_question_model[("Question records<br/>[Question.js]")]
  node_score_model[("Score records<br/>[Score.js]")]
  node_db_connector["Mongo connector<br/>[db.js]"]
end

node_user(("Quiz user"))
node_mongodb[("MongoDB")]

node_user -->|"uses"| node_app
node_bootstrap -->|"renders"| node_app
node_bootstrap -->|"reports"| node_vitals
node_app -->|"routes to"| node_signup_page
node_app -->|"routes to"| node_login_page
node_app -->|"routes to"| node_quiz_page
node_app -->|"routes to"| node_score_page
node_app -->|"routes to"| node_leaderboard_page
node_server -->|"connects"| node_db_connector
node_server -->|"mounts"| node_api_router
node_api_router -->|"dispatches"| node_auth_routes
node_api_router -->|"dispatches"| node_question_routes
node_api_router -->|"dispatches"| node_score_routes
node_auth_routes -->|"dispatches"| node_auth_controller
node_question_routes -->|"dispatches"| node_question_controller
node_score_routes -->|"dispatches"| node_score_controller
node_question_routes -->|"protects"| node_auth_middleware
node_score_routes -->|"protects"| node_auth_middleware
node_auth_controller -->|"reads and writes"| node_user_model
node_question_controller -->|"reads"| node_question_model
node_question_controller -->|"updates"| node_score_model
node_score_controller -->|"queries"| node_score_model
node_score_controller -->|"references"| node_user_model
node_db_connector -->|"connects"| node_mongodb
node_signup_page -.->|"registers via"| node_auth_routes
node_login_page -.->|"logs in via"| node_auth_routes
node_quiz_page -.->|"plays via"| node_question_routes
node_score_page -.->|"retrieves via"| node_score_routes
node_leaderboard_page -.->|"retrieves via"| node_score_routes

click node_bootstrap "https://github.com/wajih1234/quiz-app/blob/main/front/src/index.js"
click node_app "https://github.com/wajih1234/quiz-app/blob/main/front/src/App.js"
click node_signup_page "https://github.com/wajih1234/quiz-app/blob/main/front/src/pages/Sign.js"
click node_login_page "https://github.com/wajih1234/quiz-app/blob/main/front/src/pages/Login.js"
click node_quiz_page "https://github.com/wajih1234/quiz-app/blob/main/front/src/pages/Quiz.js"
click node_score_page "https://github.com/wajih1234/quiz-app/blob/main/front/src/pages/Scorepage.js"
click node_leaderboard_page "https://github.com/wajih1234/quiz-app/blob/main/front/src/pages/LeaderBoard.js"
click node_vitals "https://github.com/wajih1234/quiz-app/blob/main/front/src/reportWebVitals.js"
click node_server "https://github.com/wajih1234/quiz-app/blob/main/back/server.js"
click node_api_router "https://github.com/wajih1234/quiz-app/blob/main/back/routes/index.js"
click node_auth_routes "https://github.com/wajih1234/quiz-app/blob/main/back/routes/auth.js"
click node_question_routes "https://github.com/wajih1234/quiz-app/blob/main/back/routes/questionRoutes.js"
click node_score_routes "https://github.com/wajih1234/quiz-app/blob/main/back/routes/scoreRoutes.js"
click node_auth_middleware "https://github.com/wajih1234/quiz-app/blob/main/back/middleware/auth.js"
click node_auth_controller "https://github.com/wajih1234/quiz-app/blob/main/back/controllers/authController.js"
click node_question_controller "https://github.com/wajih1234/quiz-app/blob/main/back/controllers/questionController.js"
click node_score_controller "https://github.com/wajih1234/quiz-app/blob/main/back/controllers/score.js"
click node_user_model "https://github.com/wajih1234/quiz-app/blob/main/back/models/User.js"
click node_question_model "https://github.com/wajih1234/quiz-app/blob/main/back/models/Question.js"
click node_score_model "https://github.com/wajih1234/quiz-app/blob/main/back/models/Score.js"
click node_db_connector "https://github.com/wajih1234/quiz-app/blob/main/back/config/db.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_bootstrap,node_app,node_signup_page,node_login_page,node_quiz_page,node_score_page,node_leaderboard_page,node_vitals,node_user toneBlue
class node_server,node_api_router,node_auth_routes,node_question_routes,node_score_routes,node_auth_middleware,node_mongodb toneAmber
class node_auth_controller,node_question_controller,node_score_controller toneMint
class node_user_model,node_question_model,node_score_model,node_db_connector toneRose
```

## Components

### React client

- [Client bootstrap](https://github.com/wajih1234/quiz-app/blob/main/front/src/index.js): `front/src/index.js`
- [Page router](https://github.com/wajih1234/quiz-app/blob/main/front/src/App.js): `front/src/App.js`
- [Registration](https://github.com/wajih1234/quiz-app/blob/main/front/src/pages/Sign.js): `front/src/pages/Sign.js`
- [Login](https://github.com/wajih1234/quiz-app/blob/main/front/src/pages/Login.js): `front/src/pages/Login.js`
- [Quiz play](https://github.com/wajih1234/quiz-app/blob/main/front/src/pages/Quiz.js): `front/src/pages/Quiz.js`
- [Score view](https://github.com/wajih1234/quiz-app/blob/main/front/src/pages/Scorepage.js): `front/src/pages/Scorepage.js`
- [Leaderboard](https://github.com/wajih1234/quiz-app/blob/main/front/src/pages/LeaderBoard.js): `front/src/pages/LeaderBoard.js`
- [Web vitals](https://github.com/wajih1234/quiz-app/blob/main/front/src/reportWebVitals.js): `front/src/reportWebVitals.js`

### Express API

- [HTTP server](https://github.com/wajih1234/quiz-app/blob/main/back/server.js): `back/server.js`
- [API router](https://github.com/wajih1234/quiz-app/blob/main/back/routes/index.js): `back/routes/index.js`
- [Auth routes](https://github.com/wajih1234/quiz-app/blob/main/back/routes/auth.js): `back/routes/auth.js`
- [Question routes](https://github.com/wajih1234/quiz-app/blob/main/back/routes/questionRoutes.js): `back/routes/questionRoutes.js`
- [Score routes](https://github.com/wajih1234/quiz-app/blob/main/back/routes/scoreRoutes.js): `back/routes/scoreRoutes.js`
- [JWT guard](https://github.com/wajih1234/quiz-app/blob/main/back/middleware/auth.js): `back/middleware/auth.js`

### Quiz domain

- [Account service](https://github.com/wajih1234/quiz-app/blob/main/back/controllers/authController.js): `back/controllers/authController.js`
- [Question and answers](https://github.com/wajih1234/quiz-app/blob/main/back/controllers/questionController.js): `back/controllers/questionController.js`
- [Score queries](https://github.com/wajih1234/quiz-app/blob/main/back/controllers/score.js): `back/controllers/score.js`

### Persistence

- [User records](https://github.com/wajih1234/quiz-app/blob/main/back/models/User.js): `back/models/User.js`
- [Question records](https://github.com/wajih1234/quiz-app/blob/main/back/models/Question.js): `back/models/Question.js`
- [Score records](https://github.com/wajih1234/quiz-app/blob/main/back/models/Score.js): `back/models/Score.js`
- [Mongo connector](https://github.com/wajih1234/quiz-app/blob/main/back/config/db.js): `back/config/db.js`

### Other components

- **Quiz user**
- **MongoDB**

## Connections

- Quiz user → Page router: uses (evidence: `README.md`)
- Client bootstrap → Page router: renders (evidence: `front/src/index.js`)
- Client bootstrap → Web vitals: reports (evidence: `front/src/index.js`)
- Page router → Registration: routes to (evidence: `front/src/App.js`)
- Page router → Login: routes to (evidence: `front/src/App.js`)
- Page router → Quiz play: routes to (evidence: `front/src/App.js`)
- Page router → Score view: routes to (evidence: `front/src/App.js`)
- Page router → Leaderboard: routes to (evidence: `front/src/App.js`)
- HTTP server → Mongo connector: connects (evidence: `back/server.js`)
- HTTP server → API router: mounts (evidence: `back/server.js`)
- API router → Auth routes: dispatches (evidence: `back/routes/index.js`)
- API router → Question routes: dispatches (evidence: `back/routes/index.js`)
- API router → Score routes: dispatches (evidence: `back/routes/index.js`)
- Auth routes → Account service: dispatches (evidence: `back/routes/auth.js`)
- Question routes → Question and answers: dispatches (evidence: `back/routes/questionRoutes.js`)
- Score routes → Score queries: dispatches (evidence: `back/routes/scoreRoutes.js`)
- Question routes → JWT guard: protects (evidence: `back/routes/questionRoutes.js`)
- Score routes → JWT guard: protects (evidence: `back/routes/scoreRoutes.js`)
- Account service → User records: reads and writes (evidence: `back/controllers/authController.js`)
- Question and answers → Question records: reads (evidence: `back/controllers/questionController.js`)
- Question and answers → Score records: updates (evidence: `back/controllers/questionController.js`)
- Score queries → Score records: queries (evidence: `back/controllers/score.js`)
- Score queries → User records: references (evidence: `back/controllers/score.js`)
- Mongo connector → MongoDB: connects (evidence: `back/config/db.js`)
- Registration → Auth routes: registers via
- Login → Auth routes: logs in via
- Quiz play → Question routes: plays via
- Score view → Score routes: retrieves via
- Leaderboard → Score routes: retrieves via
