# mdarkhan/islamic-lms architecture

> Architecture diagram of the GitHub repository mdarkhan/islamic-lms, 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/mdarkhan/islamic-lms
- Repository: https://github.com/mdarkhan/islamic-lms

## Overview

Masud Alimi is a Laravel Islamic learning and examination platform. Students sign in, browse courses and lessons, take scheduled official exams or untimed practice, and view released results, points, and rankings; administrators manage learning content, students, quizzes, results, and site settings. The graph also captures public knowledge features and legacy-data migration. Edges use README claims or the supplied source index and excerpts; unsampled subsystems are included at tree-supported paths, with uncertain runtime links omitted.

Main entry points: [`routes/web.php`](https://github.com/mdarkhan/islamic-lms/blob/main/routes/web.php) (Web routes), [`app/Services/Quiz/QuizAttemptService.php`](https://github.com/mdarkhan/islamic-lms/blob/main/app/Services/Quiz/QuizAttemptService.php) (Attempt lifecycle), [`app/Http/Controllers/Student/ExamAttemptController.php`](https://github.com/mdarkhan/islamic-lms/blob/main/app/Http/Controllers/Student/ExamAttemptController.php) (Exam & practice), [`app/Http/Controllers/Student/DashboardController.php`](https://github.com/mdarkhan/islamic-lms/blob/main/app/Http/Controllers/Student/DashboardController.php) (Student learning area)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public knowledge"]
  node_publicsite["Public site &amp; CMS"]
  node_ask["Ask Ustaz &amp; contact"]
  node_zakat["Zakat calculator"]
  node_calendar["Calendar service"]
end

subgraph group_learning["Learning &amp; exams"]
  node_auth["Authentication"]
  node_studentarea["Student learning area"]
  node_exam["Exam &amp; practice"]
  node_results["Results &amp; rankings"]
end

subgraph group_admin["Administration"]
  node_admincontent["Content management"]
  node_adminquiz["Quiz administration<br/>[QuizController.php]"]
  node_adminstudents["Student administration"]
  node_adminresults["Results &amp; regrading"]
  node_settings["Settings<br/>[SettingService.php]"]
end

subgraph group_domain["Domain services"]
  node_attemptsvc["Attempt lifecycle"]
  node_scoring["Scoring &amp; adjustments"]
  node_points["Points ledger<br/>[PointService.php]"]
  node_notifications["Notifications"]
  node_audit["Audit logging<br/>[AuditLogger.php]"]
end

subgraph group_migration["Data migration"]
  node_importui["Import tools"]
  node_importservices["Legacy import services"]
end

node_visitor(("Visitor"))
node_student(("Student"))
node_staff(("Administrator"))
node_web["Web routes<br/>[web.php]"]
node_database[("Application database")]
node_legacy["Legacy exports"]

node_visitor -->|"browses"| node_web
node_student -->|"uses"| node_web
node_staff -->|"administers"| node_web
node_web -.->|"routes requests"| node_publicsite
node_web -.->|"routes sign-in"| node_auth
node_web -.->|"routes student area"| node_studentarea
node_web -.->|"routes exams"| node_exam
node_web -.->|"routes admin"| node_admincontent
node_web -.->|"routes quizzes"| node_adminquiz
node_web -.->|"routes students"| node_adminstudents
node_visitor -->|"sends inquiry"| node_ask
node_visitor -->|"calculates zakat"| node_zakat
node_publicsite -->|"uses calendar"| node_calendar
node_studentarea -->|"shows rankings"| node_results
node_student -->|"starts attempts"| node_exam
node_exam -->|"submits answers"| node_attemptsvc
node_attemptsvc -->|"scores attempt"| node_scoring
node_attemptsvc -->|"debits points"| node_points
node_exam -->|"displays released results"| node_results
node_adminquiz -->|"records changes"| node_audit
node_adminstudents -->|"records changes"| node_audit
node_adminresults -.->|"records adjustments"| node_audit
node_adminresults -.->|"regrades scores"| node_scoring
node_studentarea -->|"reads learning data"| node_database
node_attemptsvc -->|"stores attempts"| node_database
node_settings -->|"reads settings"| node_database
node_importui -.->|"imports records"| node_importservices
node_legacy -->|"provides source data"| node_importservices
node_importservices -.->|"writes migrated data"| node_database
node_ask -->|"reads recipients"| node_settings
node_notifications -->|"stores notifications"| node_database

click node_web "https://github.com/mdarkhan/islamic-lms/blob/main/routes/web.php"
click node_publicsite "https://github.com/mdarkhan/islamic-lms/blob/main/app/Http/Controllers/PublicController.php"
click node_ask "https://github.com/mdarkhan/islamic-lms/blob/main/app/Http/Controllers/AskUstazController.php"
click node_zakat "https://github.com/mdarkhan/islamic-lms/blob/main/app/Services/Zakat/ZakatCalculatorService.php"
click node_calendar "https://github.com/mdarkhan/islamic-lms/blob/main/app/Services/Calendar/CalendarService.php"
click node_auth "https://github.com/mdarkhan/islamic-lms/blob/main/app/Http/Controllers/Auth/LoginController.php"
click node_studentarea "https://github.com/mdarkhan/islamic-lms/blob/main/app/Http/Controllers/Student/DashboardController.php"
click node_exam "https://github.com/mdarkhan/islamic-lms/blob/main/app/Http/Controllers/Student/ExamAttemptController.php"
click node_results "https://github.com/mdarkhan/islamic-lms/blob/main/app/Services/Quiz/LeaderboardService.php"
click node_admincontent "https://github.com/mdarkhan/islamic-lms/blob/main/app/Http/Controllers/Admin/CourseController.php"
click node_adminquiz "https://github.com/mdarkhan/islamic-lms/blob/main/app/Http/Controllers/Admin/QuizController.php"
click node_adminstudents "https://github.com/mdarkhan/islamic-lms/blob/main/app/Http/Controllers/Admin/StudentController.php"
click node_adminresults "https://github.com/mdarkhan/islamic-lms/blob/main/app/Http/Controllers/Admin/RegradeController.php"
click node_settings "https://github.com/mdarkhan/islamic-lms/blob/main/app/Services/Settings/SettingService.php"
click node_attemptsvc "https://github.com/mdarkhan/islamic-lms/blob/main/app/Services/Quiz/QuizAttemptService.php"
click node_scoring "https://github.com/mdarkhan/islamic-lms/blob/main/app/Services/Quiz/QuizScoringService.php"
click node_points "https://github.com/mdarkhan/islamic-lms/blob/main/app/Services/Points/PointService.php"
click node_notifications "https://github.com/mdarkhan/islamic-lms/blob/main/app/Services/Notifications/NotificationService.php"
click node_audit "https://github.com/mdarkhan/islamic-lms/blob/main/app/Services/Audit/AuditLogger.php"
click node_importui "https://github.com/mdarkhan/islamic-lms/blob/main/app/Http/Controllers/Admin/StudentImportController.php"
click node_importservices "https://github.com/mdarkhan/islamic-lms/blob/main/app/Services/Import/LegacyResultImporter.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_publicsite,node_ask,node_zakat,node_calendar toneBlue
class node_auth,node_studentarea,node_exam,node_results,node_database toneAmber
class node_admincontent,node_adminquiz,node_adminstudents,node_adminresults,node_settings,node_web toneMint
class node_attemptsvc,node_scoring,node_points,node_notifications,node_audit toneRose
class node_importui,node_importservices,node_visitor,node_student,node_staff,node_legacy toneIndigo
```

## Components

### Public knowledge

- [Public site & CMS](https://github.com/mdarkhan/islamic-lms/blob/main/app/Http/Controllers/PublicController.php): `app/Http/Controllers/PublicController.php`
- [Ask Ustaz & contact](https://github.com/mdarkhan/islamic-lms/blob/main/app/Http/Controllers/AskUstazController.php): `app/Http/Controllers/AskUstazController.php`
- [Zakat calculator](https://github.com/mdarkhan/islamic-lms/blob/main/app/Services/Zakat/ZakatCalculatorService.php): `app/Services/Zakat/ZakatCalculatorService.php`
- [Calendar service](https://github.com/mdarkhan/islamic-lms/blob/main/app/Services/Calendar/CalendarService.php): `app/Services/Calendar/CalendarService.php`

### Learning & exams

- [Authentication](https://github.com/mdarkhan/islamic-lms/blob/main/app/Http/Controllers/Auth/LoginController.php): `app/Http/Controllers/Auth/LoginController.php`
- [Student learning area](https://github.com/mdarkhan/islamic-lms/blob/main/app/Http/Controllers/Student/DashboardController.php): `app/Http/Controllers/Student/DashboardController.php`
- [Exam & practice](https://github.com/mdarkhan/islamic-lms/blob/main/app/Http/Controllers/Student/ExamAttemptController.php): `app/Http/Controllers/Student/ExamAttemptController.php`
- [Results & rankings](https://github.com/mdarkhan/islamic-lms/blob/main/app/Services/Quiz/LeaderboardService.php): `app/Services/Quiz/LeaderboardService.php`

### Administration

- [Content management](https://github.com/mdarkhan/islamic-lms/blob/main/app/Http/Controllers/Admin/CourseController.php): `app/Http/Controllers/Admin/CourseController.php`
- [Quiz administration](https://github.com/mdarkhan/islamic-lms/blob/main/app/Http/Controllers/Admin/QuizController.php): `app/Http/Controllers/Admin/QuizController.php`
- [Student administration](https://github.com/mdarkhan/islamic-lms/blob/main/app/Http/Controllers/Admin/StudentController.php): `app/Http/Controllers/Admin/StudentController.php`
- [Results & regrading](https://github.com/mdarkhan/islamic-lms/blob/main/app/Http/Controllers/Admin/RegradeController.php): `app/Http/Controllers/Admin/RegradeController.php`
- [Settings](https://github.com/mdarkhan/islamic-lms/blob/main/app/Services/Settings/SettingService.php): `app/Services/Settings/SettingService.php`

### Domain services

- [Attempt lifecycle](https://github.com/mdarkhan/islamic-lms/blob/main/app/Services/Quiz/QuizAttemptService.php): `app/Services/Quiz/QuizAttemptService.php`
- [Scoring & adjustments](https://github.com/mdarkhan/islamic-lms/blob/main/app/Services/Quiz/QuizScoringService.php): `app/Services/Quiz/QuizScoringService.php`
- [Points ledger](https://github.com/mdarkhan/islamic-lms/blob/main/app/Services/Points/PointService.php): `app/Services/Points/PointService.php`
- [Notifications](https://github.com/mdarkhan/islamic-lms/blob/main/app/Services/Notifications/NotificationService.php): `app/Services/Notifications/NotificationService.php`
- [Audit logging](https://github.com/mdarkhan/islamic-lms/blob/main/app/Services/Audit/AuditLogger.php): `app/Services/Audit/AuditLogger.php`

### Data migration

- [Import tools](https://github.com/mdarkhan/islamic-lms/blob/main/app/Http/Controllers/Admin/StudentImportController.php): `app/Http/Controllers/Admin/StudentImportController.php`
- [Legacy import services](https://github.com/mdarkhan/islamic-lms/blob/main/app/Services/Import/LegacyResultImporter.php): `app/Services/Import/LegacyResultImporter.php`

### Other components

- **Visitor**
- **Student**
- **Administrator**
- [Web routes](https://github.com/mdarkhan/islamic-lms/blob/main/routes/web.php): `routes/web.php`
- **Application database**
- **Legacy exports**

## Connections

- Visitor → Web routes: browses (evidence: `README.md`)
- Student → Web routes: uses (evidence: `README.md`)
- Administrator → Web routes: administers (evidence: `README.md`)
- Web routes → Public site & CMS: routes requests
- Web routes → Authentication: routes sign-in
- Web routes → Student learning area: routes student area
- Web routes → Exam & practice: routes exams
- Web routes → Content management: routes admin
- Web routes → Quiz administration: routes quizzes
- Web routes → Student administration: routes students
- Visitor → Ask Ustaz & contact: sends inquiry (evidence: `README.md`)
- Visitor → Zakat calculator: calculates zakat (evidence: `README.md`)
- Public site & CMS → Calendar service: uses calendar (evidence: `README.md`)
- Student learning area → Results & rankings: shows rankings (evidence: `app/Http/Controllers/Student/DashboardController.php`)
- Student → Exam & practice: starts attempts (evidence: `README.md`)
- Exam & practice → Attempt lifecycle: submits answers (evidence: `app/Services/Quiz/QuizAttemptService.php`)
- Attempt lifecycle → Scoring & adjustments: scores attempt (evidence: `app/Services/Quiz/QuizAttemptService.php`)
- Attempt lifecycle → Points ledger: debits points (evidence: `app/Services/Quiz/QuizAttemptService.php`)
- Exam & practice → Results & rankings: displays released results (evidence: `README.md`)
- Quiz administration → Audit logging: records changes (evidence: `app/Http/Controllers/Admin/QuizController.php`)
- Student administration → Audit logging: records changes (evidence: `app/Http/Controllers/Admin/StudentController.php`)
- Results & regrading → Audit logging: records adjustments
- Results & regrading → Scoring & adjustments: regrades scores
- Student learning area → Application database: reads learning data (evidence: `app/Http/Controllers/Student/DashboardController.php`)
- Attempt lifecycle → Application database: stores attempts (evidence: `app/Services/Quiz/QuizAttemptService.php`)
- Settings → Application database: reads settings (evidence: `app/Services/Settings/SettingService.php`)
- Import tools → Legacy import services: imports records
- Legacy exports → Legacy import services: provides source data (evidence: `README.md`)
- Legacy import services → Application database: writes migrated data
- Ask Ustaz & contact → Settings: reads recipients (evidence: `app/Http/Controllers/AskUstazController.php`)
- Notifications → Application database: stores notifications (evidence: `app/Services/Notifications/NotificationService.php`)
