# web-dev-ruchi/quiz_spark architecture

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

- Interactive diagram: https://gitdiagram.com/web-dev-ruchi/quiz_spark
- Repository: https://github.com/web-dev-ruchi/quiz_spark

## Overview

Quiz Spark is a Laravel quiz platform with public category and quiz browsing, verified user accounts, authenticated quiz attempts and results, plus an admin area for managing categories, quizzes and questions. The main flow routes a participant through category selection and quiz start, then records answers and displays a result; user history is also available. Admins create the content that users take. Relationships below follow the sampled controllers, route declarations and README; unsampled view and model behavior is not inferred beyond those references.

Main entry points: [`app/Http/Controllers/UserController.php`](https://github.com/web-dev-ruchi/quiz_spark/blob/master/app/Http/Controllers/UserController.php) (User workflows), [`app/Http/Controllers/AdminController.php`](https://github.com/web-dev-ruchi/quiz_spark/blob/master/app/Http/Controllers/AdminController.php) (Admin workflows), [`routes/web.php`](https://github.com/web-dev-ruchi/quiz_spark/blob/master/routes/web.php) (Web routes), [`app/Mail/VerifyUser.php`](https://github.com/web-dev-ruchi/quiz_spark/blob/master/app/Mail/VerifyUser.php) (Verification email)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Web entry"]
  node_routes["Web routes<br/>[web.php]"]
  node_userauth["User auth guard<br/>[CheckUserAuth.php]"]
  node_adminauth["Admin auth guard<br/>[CheckAdminAuth.php]"]
end

subgraph group_participant["Participant experience"]
  node_userctrl["User workflows<br/>[UserController.php]"]
  node_userpages["User pages"]
  node_accounts[("User accounts<br/>[User.php]")]
  node_verification["Verification email<br/>[VerifyUser.php]"]
  node_mailview["Verification template"]
  node_history[("Attempt history<br/>[Record.php]")]
  node_answers[("Answer records<br/>[McqRecord.php]")]
end

subgraph group_content["Quiz content"]
  node_categories[("Categories<br/>[category.php]")]
  node_quizzes[("Quizzes<br/>[quiz.php]")]
  node_questions[("MCQ questions<br/>[mcq.php]")]
end

subgraph group_admin["Administration"]
  node_adminctrl["Admin workflows"]
  node_adminpages["Admin pages"]
  node_adminrecords[("Admin accounts<br/>[admin.php]")]
end

node_visitor(("Visitor / user"))
node_mailservice["Mail delivery"]

node_visitor -->|"requests pages"| node_routes
node_routes -->|"routes user requests"| node_userctrl
node_routes -->|"routes admin requests"| node_adminctrl
node_routes -->|"guards user routes"| node_userauth
node_routes -->|"guards admin routes"| node_adminauth
node_userctrl -->|"renders pages"| node_userpages
node_userctrl -->|"reads and updates"| node_accounts
node_userctrl -->|"queries categories"| node_categories
node_userctrl -->|"queries quizzes"| node_quizzes
node_userctrl -->|"loads questions"| node_questions
node_userctrl -->|"creates attempts"| node_history
node_userctrl -->|"stores answers"| node_answers
node_userctrl -->|"sends verification"| node_verification
node_verification -->|"renders template"| node_mailview
node_userctrl -->|"dispatches email"| node_mailservice
node_adminctrl -->|"renders pages"| node_adminpages
node_adminctrl -->|"checks admin"| node_adminrecords
node_adminctrl -->|"manages categories"| node_categories
node_adminctrl -->|"creates quizzes"| node_quizzes
node_adminctrl -->|"creates questions"| node_questions

click node_routes "https://github.com/web-dev-ruchi/quiz_spark/blob/master/routes/web.php"
click node_userauth "https://github.com/web-dev-ruchi/quiz_spark/blob/master/app/Http/Middleware/CheckUserAuth.php"
click node_adminauth "https://github.com/web-dev-ruchi/quiz_spark/blob/master/app/Http/Middleware/CheckAdminAuth.php"
click node_userctrl "https://github.com/web-dev-ruchi/quiz_spark/blob/master/app/Http/Controllers/UserController.php"
click node_userpages "https://github.com/web-dev-ruchi/quiz_spark/tree/master/resources/views"
click node_accounts "https://github.com/web-dev-ruchi/quiz_spark/blob/master/app/Models/User.php"
click node_verification "https://github.com/web-dev-ruchi/quiz_spark/blob/master/app/Mail/VerifyUser.php"
click node_mailview "https://github.com/web-dev-ruchi/quiz_spark/blob/master/resources/views/mail/VerifyUser.blade.php"
click node_history "https://github.com/web-dev-ruchi/quiz_spark/blob/master/app/Models/Record.php"
click node_answers "https://github.com/web-dev-ruchi/quiz_spark/blob/master/app/Models/McqRecord.php"
click node_categories "https://github.com/web-dev-ruchi/quiz_spark/blob/master/app/Models/category.php"
click node_quizzes "https://github.com/web-dev-ruchi/quiz_spark/blob/master/app/Models/quiz.php"
click node_questions "https://github.com/web-dev-ruchi/quiz_spark/blob/master/app/Models/mcq.php"
click node_adminctrl "https://github.com/web-dev-ruchi/quiz_spark/blob/master/app/Http/Controllers/AdminController.php"
click node_adminpages "https://github.com/web-dev-ruchi/quiz_spark/tree/master/resources/views"
click node_adminrecords "https://github.com/web-dev-ruchi/quiz_spark/blob/master/app/Models/admin.php"

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_routes,node_userauth,node_adminauth,node_visitor toneBlue
class node_userctrl,node_userpages,node_accounts,node_verification,node_mailview,node_history,node_answers toneAmber
class node_categories,node_quizzes,node_questions toneMint
class node_adminctrl,node_adminpages,node_adminrecords toneRose
class node_mailservice toneIndigo
```

## Components

### Web entry

- [Web routes](https://github.com/web-dev-ruchi/quiz_spark/blob/master/routes/web.php): `routes/web.php`
- [User auth guard](https://github.com/web-dev-ruchi/quiz_spark/blob/master/app/Http/Middleware/CheckUserAuth.php): `app/Http/Middleware/CheckUserAuth.php`
- [Admin auth guard](https://github.com/web-dev-ruchi/quiz_spark/blob/master/app/Http/Middleware/CheckAdminAuth.php): `app/Http/Middleware/CheckAdminAuth.php`

### Participant experience

- [User workflows](https://github.com/web-dev-ruchi/quiz_spark/blob/master/app/Http/Controllers/UserController.php): `app/Http/Controllers/UserController.php`
- [User pages](https://github.com/web-dev-ruchi/quiz_spark/tree/master/resources/views): `resources/views`
- [User accounts](https://github.com/web-dev-ruchi/quiz_spark/blob/master/app/Models/User.php): `app/Models/User.php`
- [Verification email](https://github.com/web-dev-ruchi/quiz_spark/blob/master/app/Mail/VerifyUser.php): `app/Mail/VerifyUser.php`
- [Verification template](https://github.com/web-dev-ruchi/quiz_spark/blob/master/resources/views/mail/VerifyUser.blade.php): `resources/views/mail/VerifyUser.blade.php`
- [Attempt history](https://github.com/web-dev-ruchi/quiz_spark/blob/master/app/Models/Record.php): `app/Models/Record.php`
- [Answer records](https://github.com/web-dev-ruchi/quiz_spark/blob/master/app/Models/McqRecord.php): `app/Models/McqRecord.php`

### Quiz content

- [Categories](https://github.com/web-dev-ruchi/quiz_spark/blob/master/app/Models/category.php): `app/Models/category.php`
- [Quizzes](https://github.com/web-dev-ruchi/quiz_spark/blob/master/app/Models/quiz.php): `app/Models/quiz.php`
- [MCQ questions](https://github.com/web-dev-ruchi/quiz_spark/blob/master/app/Models/mcq.php): `app/Models/mcq.php`

### Administration

- [Admin workflows](https://github.com/web-dev-ruchi/quiz_spark/blob/master/app/Http/Controllers/AdminController.php): `app/Http/Controllers/AdminController.php`
- [Admin pages](https://github.com/web-dev-ruchi/quiz_spark/tree/master/resources/views): `resources/views`
- [Admin accounts](https://github.com/web-dev-ruchi/quiz_spark/blob/master/app/Models/admin.php): `app/Models/admin.php`

### Other components

- **Visitor / user**
- **Mail delivery**

## Connections

- Visitor / user → Web routes: requests pages (evidence: `routes/web.php`)
- Web routes → User workflows: routes user requests (evidence: `routes/web.php`)
- Web routes → Admin workflows: routes admin requests (evidence: `routes/web.php`)
- Web routes → User auth guard: guards user routes (evidence: `routes/web.php`)
- Web routes → Admin auth guard: guards admin routes (evidence: `routes/web.php`)
- User workflows → User pages: renders pages (evidence: `app/Http/Controllers/UserController.php`)
- User workflows → User accounts: reads and updates (evidence: `app/Http/Controllers/UserController.php`)
- User workflows → Categories: queries categories (evidence: `app/Http/Controllers/UserController.php`)
- User workflows → Quizzes: queries quizzes (evidence: `app/Http/Controllers/UserController.php`)
- User workflows → MCQ questions: loads questions (evidence: `app/Http/Controllers/UserController.php`)
- User workflows → Attempt history: creates attempts (evidence: `app/Http/Controllers/UserController.php`)
- User workflows → Answer records: stores answers (evidence: `app/Http/Controllers/UserController.php`)
- User workflows → Verification email: sends verification (evidence: `app/Http/Controllers/UserController.php`)
- Verification email → Verification template: renders template (evidence: `app/Mail/VerifyUser.php`)
- User workflows → Mail delivery: dispatches email (evidence: `app/Http/Controllers/UserController.php`)
- Admin workflows → Admin pages: renders pages (evidence: `app/Http/Controllers/AdminController.php`)
- Admin workflows → Admin accounts: checks admin (evidence: `app/Http/Controllers/AdminController.php`)
- Admin workflows → Categories: manages categories (evidence: `app/Http/Controllers/AdminController.php`)
- Admin workflows → Quizzes: creates quizzes (evidence: `app/Http/Controllers/AdminController.php`)
- Admin workflows → MCQ questions: creates questions (evidence: `app/Http/Controllers/AdminController.php`)
