# shan-infodelix/swiftlln architecture

> Architecture diagram of the GitHub repository shan-infodelix/swiftlln, 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/shan-infodelix/swiftlln
- Repository: https://github.com/shan-infodelix/swiftlln

## Overview

Vorx Forms is a multi-tenant quiz and assessment platform. Educators and administrators manage accounts, author questions and quizzes, and publish assessments; learners take interactive quizzes and submit responses, which become results for reporting and analytics. The graph combines README-documented product capabilities with relationships visible in the supplied source index and excerpts. Some feature branches are documented but their implementation was not sampled, so those links cite the README rather than implying source inspection.

Main entry points: [`app/Http/Controllers/LaunchQuizController.php`](https://github.com/shan-infodelix/swiftlln/blob/main/app/Http/Controllers/LaunchQuizController.php) (Quiz launch), [`app/Models/Account.php`](https://github.com/shan-infodelix/swiftlln/blob/main/app/Models/Account.php) (Accounts and subscriptions), [`app/Models/Quiz.php`](https://github.com/shan-infodelix/swiftlln/blob/main/app/Models/Quiz.php) (Quiz and types), [`app/Http/Controllers/Admin/ResultController.php`](https://github.com/shan-infodelix/swiftlln/blob/main/app/Http/Controllers/Admin/ResultController.php) (Result reporting)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Authoring and Admin"]
  node_admin["Admin management"]
  node_quiz_authoring["Quiz authoring"]
  node_question_bank["Question bank<br/>[Question.php]"]
  node_quiz_controller["Quiz management API<br/>[QuizController.php]"]
  node_quiz_domain["Quiz and types<br/>[Quiz.php]"]
end

subgraph group_delivery["Quiz Delivery"]
  node_launch["Quiz launch"]
  node_quiz_runner["Interactive quiz runner"]
  node_question_rendering["Question formats"]
end

subgraph group_results["Results and Analytics"]
  node_results[("Result records<br/>[Result.php]")]
  node_result_questions[("Saved answers<br/>[ResultQuestion.php]")]
  node_result_admin["Result reporting"]
  node_analytics["Analytics and exports"]
end

subgraph group_platform["Tenant Platform"]
  node_accounts[("Accounts and subscriptions<br/>[Account.php]")]
  node_users[("Users and roles<br/>[User.php]")]
  node_tenant_scope["Tenant access scope<br/>[AccountScope.php]"]
  node_access_rules["Feature access"]
  node_media["Media storage"]
  node_notification["Notifications"]
end

node_educators(("Educators and admins"))
node_learners(("Learners"))
node_external_service["External notification service"]
node_database[("Application database")]

node_educators -->|"manage platform"| node_admin
node_educators -->|"author quizzes"| node_quiz_authoring
node_quiz_authoring -->|"assign questions"| node_question_bank
node_quiz_controller -->|"uses quiz service"| node_quiz_domain
node_quiz_domain -->|"relates questions"| node_question_bank
node_learners -->|"start assessment"| node_launch
node_launch -->|"serves quiz"| node_quiz_runner
node_quiz_runner -->|"renders formats"| node_question_rendering
node_launch -->|"records completion"| node_results
node_launch -.->|"saves answers"| node_result_questions
node_launch -->|"dispatches notifications"| node_notification
node_notification -.->|"sends externally"| node_external_service
node_admin -->|"review results"| node_result_admin
node_result_admin -->|"queries results"| node_results
node_result_admin -->|"loads saved answers"| node_result_questions
node_result_admin -->|"reports performance"| node_analytics
node_accounts -->|"organizes users"| node_users
node_accounts -->|"controls features"| node_access_rules
node_quiz_domain -->|"checks availability"| node_access_rules
node_quiz_domain -->|"applies account scope"| node_tenant_scope
node_question_bank -->|"applies account scope"| node_tenant_scope
node_accounts -->|"resolves file storage"| node_media
node_question_bank -->|"resolves file storage"| node_media
node_accounts -.->|"persists account data"| node_database
node_results -.->|"persists results"| node_database

click node_admin "https://github.com/shan-infodelix/swiftlln/tree/main/app/Http/Controllers/Admin"
click node_quiz_authoring "https://github.com/shan-infodelix/swiftlln/tree/main/resources/js/Components/Admin/QuizBuilder"
click node_question_bank "https://github.com/shan-infodelix/swiftlln/blob/main/app/Models/Question.php"
click node_quiz_controller "https://github.com/shan-infodelix/swiftlln/blob/main/app/Http/Controllers/Api/V1/QuizController.php"
click node_quiz_domain "https://github.com/shan-infodelix/swiftlln/blob/main/app/Models/Quiz.php"
click node_launch "https://github.com/shan-infodelix/swiftlln/blob/main/app/Http/Controllers/LaunchQuizController.php"
click node_quiz_runner "https://github.com/shan-infodelix/swiftlln/blob/main/resources/js/Components/QuizWizard/QuizQuestionRenderer.vue"
click node_question_rendering "https://github.com/shan-infodelix/swiftlln/tree/main/resources/js/Components/QuizWizard/Cards"
click node_results "https://github.com/shan-infodelix/swiftlln/blob/main/app/Models/Result.php"
click node_result_questions "https://github.com/shan-infodelix/swiftlln/blob/main/app/Models/ResultQuestion.php"
click node_result_admin "https://github.com/shan-infodelix/swiftlln/blob/main/app/Http/Controllers/Admin/ResultController.php"
click node_analytics "https://github.com/shan-infodelix/swiftlln/blob/main/app/Services/SurveyAnalyticsService.php"
click node_accounts "https://github.com/shan-infodelix/swiftlln/blob/main/app/Models/Account.php"
click node_users "https://github.com/shan-infodelix/swiftlln/blob/main/app/Models/User.php"
click node_tenant_scope "https://github.com/shan-infodelix/swiftlln/blob/main/app/Scopes/AccountScope.php"
click node_access_rules "https://github.com/shan-infodelix/swiftlln/blob/main/app/Services/AccountProcessAccessService.php"
click node_media "https://github.com/shan-infodelix/swiftlln/blob/main/app/Models/Services/Factories/FileServiceFactory.php"
click node_notification "https://github.com/shan-infodelix/swiftlln/blob/main/app/Services/Notifications/NotificationManager.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_admin,node_quiz_authoring,node_question_bank,node_quiz_controller,node_quiz_domain toneBlue
class node_launch,node_quiz_runner,node_question_rendering,node_database toneAmber
class node_results,node_result_questions,node_result_admin,node_analytics toneMint
class node_accounts,node_users,node_tenant_scope,node_access_rules,node_media,node_notification toneRose
class node_educators,node_learners,node_external_service toneIndigo
```

## Components

### Authoring and Admin

- [Admin management](https://github.com/shan-infodelix/swiftlln/tree/main/app/Http/Controllers/Admin): `app/Http/Controllers/Admin`
- [Quiz authoring](https://github.com/shan-infodelix/swiftlln/tree/main/resources/js/Components/Admin/QuizBuilder): `resources/js/Components/Admin/QuizBuilder`
- [Question bank](https://github.com/shan-infodelix/swiftlln/blob/main/app/Models/Question.php): `app/Models/Question.php`
- [Quiz management API](https://github.com/shan-infodelix/swiftlln/blob/main/app/Http/Controllers/Api/V1/QuizController.php): `app/Http/Controllers/Api/V1/QuizController.php`
- [Quiz and types](https://github.com/shan-infodelix/swiftlln/blob/main/app/Models/Quiz.php): `app/Models/Quiz.php`

### Quiz Delivery

- [Quiz launch](https://github.com/shan-infodelix/swiftlln/blob/main/app/Http/Controllers/LaunchQuizController.php): `app/Http/Controllers/LaunchQuizController.php`
- [Interactive quiz runner](https://github.com/shan-infodelix/swiftlln/blob/main/resources/js/Components/QuizWizard/QuizQuestionRenderer.vue): `resources/js/Components/QuizWizard/QuizQuestionRenderer.vue`
- [Question formats](https://github.com/shan-infodelix/swiftlln/tree/main/resources/js/Components/QuizWizard/Cards): `resources/js/Components/QuizWizard/Cards`

### Results and Analytics

- [Result records](https://github.com/shan-infodelix/swiftlln/blob/main/app/Models/Result.php): `app/Models/Result.php`
- [Saved answers](https://github.com/shan-infodelix/swiftlln/blob/main/app/Models/ResultQuestion.php): `app/Models/ResultQuestion.php`
- [Result reporting](https://github.com/shan-infodelix/swiftlln/blob/main/app/Http/Controllers/Admin/ResultController.php): `app/Http/Controllers/Admin/ResultController.php`
- [Analytics and exports](https://github.com/shan-infodelix/swiftlln/blob/main/app/Services/SurveyAnalyticsService.php): `app/Services/SurveyAnalyticsService.php`

### Tenant Platform

- [Accounts and subscriptions](https://github.com/shan-infodelix/swiftlln/blob/main/app/Models/Account.php): `app/Models/Account.php`
- [Users and roles](https://github.com/shan-infodelix/swiftlln/blob/main/app/Models/User.php): `app/Models/User.php`
- [Tenant access scope](https://github.com/shan-infodelix/swiftlln/blob/main/app/Scopes/AccountScope.php): `app/Scopes/AccountScope.php`
- [Feature access](https://github.com/shan-infodelix/swiftlln/blob/main/app/Services/AccountProcessAccessService.php): `app/Services/AccountProcessAccessService.php`
- [Media storage](https://github.com/shan-infodelix/swiftlln/blob/main/app/Models/Services/Factories/FileServiceFactory.php): `app/Models/Services/Factories/FileServiceFactory.php`
- [Notifications](https://github.com/shan-infodelix/swiftlln/blob/main/app/Services/Notifications/NotificationManager.php): `app/Services/Notifications/NotificationManager.php`

### Other components

- **Educators and admins**
- **Learners**
- **External notification service**
- **Application database**

## Connections

- Educators and admins → Admin management: manage platform (evidence: `README.md`)
- Educators and admins → Quiz authoring: author quizzes (evidence: `README.md`)
- Quiz authoring → Question bank: assign questions (evidence: `README.md`)
- Quiz management API → Quiz and types: uses quiz service (evidence: `app/Http/Controllers/Api/V1/QuizController.php`)
- Quiz and types → Question bank: relates questions (evidence: `app/Models/Quiz.php`)
- Learners → Quiz launch: start assessment (evidence: `README.md`)
- Quiz launch → Interactive quiz runner: serves quiz (evidence: `README.md`)
- Interactive quiz runner → Question formats: renders formats (evidence: `README.md`)
- Quiz launch → Result records: records completion (evidence: `app/Http/Controllers/LaunchQuizController.php`)
- Quiz launch → Saved answers: saves answers
- Quiz launch → Notifications: dispatches notifications (evidence: `app/Http/Controllers/LaunchQuizController.php`)
- Notifications → External notification service: sends externally (evidence: `app/Services/Notifications/NotificationManager.php`)
- Admin management → Result reporting: review results (evidence: `README.md`)
- Result reporting → Result records: queries results (evidence: `app/Http/Controllers/Admin/ResultController.php`)
- Result reporting → Saved answers: loads saved answers (evidence: `app/Http/Controllers/Admin/ResultController.php`)
- Result reporting → Analytics and exports: reports performance (evidence: `README.md`)
- Accounts and subscriptions → Users and roles: organizes users (evidence: `README.md`)
- Accounts and subscriptions → Feature access: controls features (evidence: `README.md`)
- Quiz and types → Feature access: checks availability (evidence: `app/Models/Quiz.php`)
- Quiz and types → Tenant access scope: applies account scope (evidence: `app/Models/Quiz.php`)
- Question bank → Tenant access scope: applies account scope (evidence: `app/Models/Question.php`)
- Accounts and subscriptions → Media storage: resolves file storage (evidence: `app/Models/Account.php`)
- Question bank → Media storage: resolves file storage (evidence: `app/Models/Question.php`)
- Accounts and subscriptions → Application database: persists account data
- Result records → Application database: persists results
