# murtaza1904/learning-management-system architecture

> Architecture diagram of the GitHub repository murtaza1904/learning-management-system, 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/murtaza1904/learning-management-system
- Repository: https://github.com/murtaza1904/learning-management-system

## Overview

This is a role-based academic and student-management application built with Laravel and Inertia/React. A candidate completes a staged enrollment form; the server retains step data in the session, then creates an account, student profile, enrollment, and education records before logging the user in. Other major product areas include academic-structure administration, student and teacher academic workflows, and fee management. The enrollment flow is shown from excerpts; other branches reflect the source index and repository tree, so their internal links are limited to documented references.

Main entry points: [`app/Models/Student.php`](https://github.com/murtaza1904/learning-management-system/blob/main/app/Models/Student.php) (Student Records), [`app/Services/StudentEnrollmentService.php`](https://github.com/murtaza1904/learning-management-system/blob/main/app/Services/StudentEnrollmentService.php) (Enrollment Service), [`app/Http/Controllers/Student/EnrollmentController.php`](https://github.com/murtaza1904/learning-management-system/blob/main/app/Http/Controllers/Student/EnrollmentController.php) (Enrollment Controller), [`app/Models/Course.php`](https://github.com/murtaza1904/learning-management-system/blob/main/app/Models/Course.php) (Courses)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_enrollment["Admissions"]
  node_enrollment_form["Enrollment Form<br/>[Index.tsx]"]
  node_enrollment_controller["Enrollment Controller"]
  node_enrollment_service["Enrollment Service"]
  node_accounts[("User Accounts<br/>[User.php]")]
  node_student_records[("Student Records<br/>[Student.php]")]
  node_enrollment_records[("Enrollment Records<br/>[Enrollment.php]")]
  node_education_records[("Education Records")]
end

subgraph group_academics["Academic Operations"]
  node_academic_catalog[("Academic Catalog<br/>[Degree.php]")]
  node_courses[("Courses<br/>[Course.php]")]
  node_teacher_assessment["Assessment Management"]
  node_attendance["Attendance Management"]
  node_results[("Academic Results<br/>[Result.php]")]
  node_student_portal["Student Portal"]
end

subgraph group_admin["Administration"]
  node_admin_catalog["Catalog Administration"]
  node_user_admin["User Administration<br/>[UserController.php]"]
end

subgraph group_finance["Finance"]
  node_fee_management["Fee Management"]
  node_fee_records[("Fee Records<br/>[Fee.php]")]
  node_accountant_fees["Accountant Fees<br/>[FeeController.php]"]
end

node_candidate(("Candidate"))

node_candidate -.->|"completes"| node_enrollment_form
node_enrollment_form -.->|"submits steps"| node_enrollment_controller
node_enrollment_controller -->|"creates enrollment"| node_enrollment_service
node_enrollment_service -->|"creates account"| node_accounts
node_enrollment_service -->|"creates profile"| node_student_records
node_enrollment_service -->|"creates enrollment"| node_enrollment_records
node_enrollment_service -->|"creates records"| node_education_records
node_enrollment_controller -->|"loads choices"| node_academic_catalog
node_student_records -->|"has enrollment"| node_enrollment_records
node_student_records -->|"has records"| node_education_records
node_student_records -->|"has results"| node_results
node_academic_catalog -->|"has courses"| node_courses
node_teacher_assessment -->|"uses courses"| node_courses
node_teacher_assessment -.->|"records assessment"| node_results
node_attendance -.->|"records attendance"| node_student_records
node_student_portal -.->|"loads student"| node_student_records
node_admin_catalog -.->|"manages courses"| node_courses
node_user_admin -->|"manages users"| node_accounts
node_accountant_fees -->|"updates fees"| node_fee_management
node_fee_management -->|"manages fees"| node_fee_records
node_student_records -->|"has fees"| node_fee_records

click node_enrollment_form "https://github.com/murtaza1904/learning-management-system/blob/main/resources/js/pages/Student/Enrollment/Index.tsx"
click node_enrollment_controller "https://github.com/murtaza1904/learning-management-system/blob/main/app/Http/Controllers/Student/EnrollmentController.php"
click node_enrollment_service "https://github.com/murtaza1904/learning-management-system/blob/main/app/Services/StudentEnrollmentService.php"
click node_accounts "https://github.com/murtaza1904/learning-management-system/blob/main/app/Models/User.php"
click node_student_records "https://github.com/murtaza1904/learning-management-system/blob/main/app/Models/Student.php"
click node_enrollment_records "https://github.com/murtaza1904/learning-management-system/blob/main/app/Models/Enrollment.php"
click node_education_records "https://github.com/murtaza1904/learning-management-system/blob/main/app/Models/EducationRecord.php"
click node_academic_catalog "https://github.com/murtaza1904/learning-management-system/blob/main/app/Models/Degree.php"
click node_courses "https://github.com/murtaza1904/learning-management-system/blob/main/app/Models/Course.php"
click node_teacher_assessment "https://github.com/murtaza1904/learning-management-system/blob/main/app/Http/Controllers/Teacher/AssessmentController.php"
click node_attendance "https://github.com/murtaza1904/learning-management-system/blob/main/app/Http/Controllers/Teacher/AttendanceController.php"
click node_results "https://github.com/murtaza1904/learning-management-system/blob/main/app/Models/Result.php"
click node_student_portal "https://github.com/murtaza1904/learning-management-system/blob/main/app/Http/Controllers/Student/DashboardController.php"
click node_admin_catalog "https://github.com/murtaza1904/learning-management-system/blob/main/app/Http/Controllers/Admin/CourseController.php"
click node_user_admin "https://github.com/murtaza1904/learning-management-system/blob/main/app/Http/Controllers/Admin/UserController.php"
click node_fee_management "https://github.com/murtaza1904/learning-management-system/blob/main/app/Services/FeeManagementService.php"
click node_fee_records "https://github.com/murtaza1904/learning-management-system/blob/main/app/Models/Fee.php"
click node_accountant_fees "https://github.com/murtaza1904/learning-management-system/blob/main/app/Http/Controllers/Accountant/FeeController.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_enrollment_form,node_enrollment_controller,node_enrollment_service,node_accounts,node_student_records,node_enrollment_records,node_education_records toneBlue
class node_academic_catalog,node_courses,node_teacher_assessment,node_attendance,node_results,node_student_portal toneAmber
class node_admin_catalog,node_user_admin toneMint
class node_fee_management,node_fee_records,node_accountant_fees toneRose
class node_candidate toneIndigo
```

## Components

### Admissions

- [Enrollment Form](https://github.com/murtaza1904/learning-management-system/blob/main/resources/js/pages/Student/Enrollment/Index.tsx): `resources/js/pages/Student/Enrollment/Index.tsx`
- [Enrollment Controller](https://github.com/murtaza1904/learning-management-system/blob/main/app/Http/Controllers/Student/EnrollmentController.php): `app/Http/Controllers/Student/EnrollmentController.php`
- [Enrollment Service](https://github.com/murtaza1904/learning-management-system/blob/main/app/Services/StudentEnrollmentService.php): `app/Services/StudentEnrollmentService.php`
- [User Accounts](https://github.com/murtaza1904/learning-management-system/blob/main/app/Models/User.php): `app/Models/User.php`
- [Student Records](https://github.com/murtaza1904/learning-management-system/blob/main/app/Models/Student.php): `app/Models/Student.php`
- [Enrollment Records](https://github.com/murtaza1904/learning-management-system/blob/main/app/Models/Enrollment.php): `app/Models/Enrollment.php`
- [Education Records](https://github.com/murtaza1904/learning-management-system/blob/main/app/Models/EducationRecord.php): `app/Models/EducationRecord.php`

### Academic Operations

- [Academic Catalog](https://github.com/murtaza1904/learning-management-system/blob/main/app/Models/Degree.php): `app/Models/Degree.php`
- [Courses](https://github.com/murtaza1904/learning-management-system/blob/main/app/Models/Course.php): `app/Models/Course.php`
- [Assessment Management](https://github.com/murtaza1904/learning-management-system/blob/main/app/Http/Controllers/Teacher/AssessmentController.php): `app/Http/Controllers/Teacher/AssessmentController.php`
- [Attendance Management](https://github.com/murtaza1904/learning-management-system/blob/main/app/Http/Controllers/Teacher/AttendanceController.php): `app/Http/Controllers/Teacher/AttendanceController.php`
- [Academic Results](https://github.com/murtaza1904/learning-management-system/blob/main/app/Models/Result.php): `app/Models/Result.php`
- [Student Portal](https://github.com/murtaza1904/learning-management-system/blob/main/app/Http/Controllers/Student/DashboardController.php): `app/Http/Controllers/Student/DashboardController.php`

### Administration

- [Catalog Administration](https://github.com/murtaza1904/learning-management-system/blob/main/app/Http/Controllers/Admin/CourseController.php): `app/Http/Controllers/Admin/CourseController.php`
- [User Administration](https://github.com/murtaza1904/learning-management-system/blob/main/app/Http/Controllers/Admin/UserController.php): `app/Http/Controllers/Admin/UserController.php`

### Finance

- [Fee Management](https://github.com/murtaza1904/learning-management-system/blob/main/app/Services/FeeManagementService.php): `app/Services/FeeManagementService.php`
- [Fee Records](https://github.com/murtaza1904/learning-management-system/blob/main/app/Models/Fee.php): `app/Models/Fee.php`
- [Accountant Fees](https://github.com/murtaza1904/learning-management-system/blob/main/app/Http/Controllers/Accountant/FeeController.php): `app/Http/Controllers/Accountant/FeeController.php`

### Other components

- **Candidate**

## Connections

- Candidate → Enrollment Form: completes
- Enrollment Form → Enrollment Controller: submits steps
- Enrollment Controller → Enrollment Service: creates enrollment (evidence: `app/Http/Controllers/Student/EnrollmentController.php`)
- Enrollment Service → User Accounts: creates account (evidence: `app/Services/StudentEnrollmentService.php`)
- Enrollment Service → Student Records: creates profile (evidence: `app/Services/StudentEnrollmentService.php`)
- Enrollment Service → Enrollment Records: creates enrollment (evidence: `app/Services/StudentEnrollmentService.php`)
- Enrollment Service → Education Records: creates records (evidence: `app/Services/StudentEnrollmentService.php`)
- Enrollment Controller → Academic Catalog: loads choices (evidence: `app/Http/Controllers/Student/EnrollmentController.php`)
- Student Records → Enrollment Records: has enrollment (evidence: `app/Models/Student.php`)
- Student Records → Education Records: has records (evidence: `app/Models/Student.php`)
- Student Records → Academic Results: has results (evidence: `app/Models/Student.php`)
- Academic Catalog → Courses: has courses (evidence: `app/Models/Degree.php`)
- Assessment Management → Courses: uses courses (evidence: `app/Http/Controllers/Teacher/AssessmentController.php`)
- Assessment Management → Academic Results: records assessment
- Attendance Management → Student Records: records attendance
- Student Portal → Student Records: loads student
- Catalog Administration → Courses: manages courses
- User Administration → User Accounts: manages users (evidence: `app/Http/Controllers/Admin/UserController.php`)
- Accountant Fees → Fee Management: updates fees (evidence: `app/Http/Controllers/Accountant/FeeController.php`)
- Fee Management → Fee Records: manages fees (evidence: `app/Services/FeeManagementService.php`)
- Student Records → Fee Records: has fees (evidence: `app/Models/Student.php`)
