# hrshadhin/school-management-system architecture

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

- Interactive diagram: https://gitdiagram.com/hrshadhin/school-management-system
- Repository: https://github.com/hrshadhin/school-management-system

## Overview

CloudSchool is a Laravel school-management application. Staff use routed backend functions to manage academic structure and student records, enter attendance and exam marks, publish results, and review reports; administrators also manage users and permissions. A separate public-facing site presents school content, while backend tools manage that content. The map preserves README capabilities even where implementation was not sampled; those branches use exact directories where available. Edges are limited to documented capabilities and relationships visible in the excerpts or SOURCE INDEX.

Main entry points: [`routes/web.php`](https://github.com/hrshadhin/school-management-system/blob/master/routes/web.php) (Backend routes), [`app/Http/Controllers/Backend/MarkController.php`](https://github.com/hrshadhin/school-management-system/blob/master/app/Http/Controllers/Backend/MarkController.php) (Marks and results), [`app/Http/Controllers/Backend/StudentController.php`](https://github.com/hrshadhin/school-management-system/blob/master/app/Http/Controllers/Backend/StudentController.php) (Student records), [`app/Http/Controllers/Backend/ReportController.php`](https://github.com/hrshadhin/school-management-system/blob/master/app/Http/Controllers/Backend/ReportController.php) (Reports)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_academic["Academic Records"]
  node_academic_ctrl["Academic management"]
  node_academic_models["Academic structure<br/>[AcademicYear.php]"]
  node_student_ctrl["Student records"]
  node_student_models["Student registration<br/>[Registration.php]"]
  node_attendance_ctrl["Student attendance"]
end

subgraph group_assessment["Assessment"]
  node_exam_ctrl["Exam management<br/>[ExamController.php]"]
  node_marks_ctrl["Marks and results<br/>[MarkController.php]"]
  node_assessment_models["Assessment records<br/>[Mark.php]"]
  node_report_ctrl["Reports"]
  node_report_helper["Report helpers<br/>[ReportHelper.php]"]
end

subgraph group_operations["People Operations"]
  node_employee_ctrl["Employee management"]
  node_employee_models["Employee records<br/>[Employee.php]"]
  node_employee_attendance["Employee attendance"]
  node_leave_ctrl["Leave management"]
end

subgraph group_admin["Administration"]
  node_user_ctrl["Users and roles<br/>[UserController.php]"]
  node_access_models["Roles and permissions<br/>[Role.php]"]
end

subgraph group_publicsite["Public Website"]
  node_site_ctrl["Website management<br/>[SiteController.php]"]
  node_frontend["Public site<br/>[HomeController.php]"]
  node_site_content["Site content records<br/>[Event.php]"]
end

node_staff(("School staff"))
node_web_routes["Backend routes<br/>[web.php]"]
node_helper["Application helper<br/>[AppHelper.php]"]

node_staff -->|"uses"| node_web_routes
node_web_routes -->|"routes to"| node_academic_ctrl
node_web_routes -->|"routes to"| node_student_ctrl
node_web_routes -->|"routes to"| node_attendance_ctrl
node_web_routes -->|"routes to"| node_exam_ctrl
node_web_routes -->|"routes to"| node_marks_ctrl
node_web_routes -->|"routes to"| node_report_ctrl
node_web_routes -->|"routes to"| node_employee_ctrl
node_web_routes -->|"routes to"| node_employee_attendance
node_web_routes -->|"routes to"| node_leave_ctrl
node_web_routes -->|"routes to"| node_user_ctrl
node_web_routes -.->|"routes to"| node_site_ctrl
node_student_ctrl -->|"uses"| node_student_models
node_student_ctrl -->|"checks enrollment"| node_academic_models
node_marks_ctrl -->|"records marks"| node_assessment_models
node_marks_ctrl -->|"calculates marks"| node_helper
node_marks_ctrl -->|"uses registrations"| node_student_models
node_report_ctrl -->|"uses"| node_report_helper
node_report_ctrl -->|"queries"| node_assessment_models
node_employee_ctrl -.->|"manages"| node_employee_models
node_employee_attendance -->|"records attendance"| node_employee_models
node_employee_models -->|"uses constants"| node_helper
node_user_ctrl -.->|"manages access"| node_access_models
node_site_ctrl -.->|"manages content"| node_site_content
node_frontend -->|"loads content"| node_site_content

click node_web_routes "https://github.com/hrshadhin/school-management-system/blob/master/routes/web.php"
click node_academic_ctrl "https://github.com/hrshadhin/school-management-system/blob/master/app/Http/Controllers/Backend/AcademicController.php"
click node_academic_models "https://github.com/hrshadhin/school-management-system/blob/master/app/AcademicYear.php"
click node_student_ctrl "https://github.com/hrshadhin/school-management-system/blob/master/app/Http/Controllers/Backend/StudentController.php"
click node_student_models "https://github.com/hrshadhin/school-management-system/blob/master/app/Registration.php"
click node_attendance_ctrl "https://github.com/hrshadhin/school-management-system/blob/master/app/Http/Controllers/Backend/StudentAttendanceController.php"
click node_exam_ctrl "https://github.com/hrshadhin/school-management-system/blob/master/app/Http/Controllers/Backend/ExamController.php"
click node_marks_ctrl "https://github.com/hrshadhin/school-management-system/blob/master/app/Http/Controllers/Backend/MarkController.php"
click node_assessment_models "https://github.com/hrshadhin/school-management-system/blob/master/app/Mark.php"
click node_report_ctrl "https://github.com/hrshadhin/school-management-system/blob/master/app/Http/Controllers/Backend/ReportController.php"
click node_report_helper "https://github.com/hrshadhin/school-management-system/blob/master/app/Http/Helpers/ReportHelper.php"
click node_employee_ctrl "https://github.com/hrshadhin/school-management-system/blob/master/app/Http/Controllers/Backend/EmployeeController.php"
click node_employee_models "https://github.com/hrshadhin/school-management-system/blob/master/app/Employee.php"
click node_employee_attendance "https://github.com/hrshadhin/school-management-system/blob/master/app/Http/Controllers/Backend/EmployeeAttendanceController.php"
click node_leave_ctrl "https://github.com/hrshadhin/school-management-system/blob/master/app/Http/Controllers/Backend/LeaveController.php"
click node_user_ctrl "https://github.com/hrshadhin/school-management-system/blob/master/app/Http/Controllers/Backend/UserController.php"
click node_access_models "https://github.com/hrshadhin/school-management-system/blob/master/app/Role.php"
click node_site_ctrl "https://github.com/hrshadhin/school-management-system/blob/master/app/Http/Controllers/Backend/SiteController.php"
click node_frontend "https://github.com/hrshadhin/school-management-system/blob/master/app/Http/Controllers/Frontend/HomeController.php"
click node_site_content "https://github.com/hrshadhin/school-management-system/blob/master/app/Event.php"
click node_helper "https://github.com/hrshadhin/school-management-system/blob/master/app/Http/Helpers/AppHelper.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_academic_ctrl,node_academic_models,node_student_ctrl,node_student_models,node_attendance_ctrl toneBlue
class node_exam_ctrl,node_marks_ctrl,node_assessment_models,node_report_ctrl,node_report_helper toneAmber
class node_employee_ctrl,node_employee_models,node_employee_attendance,node_leave_ctrl,node_web_routes toneMint
class node_user_ctrl,node_access_models toneRose
class node_site_ctrl,node_frontend,node_site_content,node_staff toneIndigo
class node_helper toneTeal
```

## Components

### Academic Records

- [Academic management](https://github.com/hrshadhin/school-management-system/blob/master/app/Http/Controllers/Backend/AcademicController.php): `app/Http/Controllers/Backend/AcademicController.php`
- [Academic structure](https://github.com/hrshadhin/school-management-system/blob/master/app/AcademicYear.php): `app/AcademicYear.php`
- [Student records](https://github.com/hrshadhin/school-management-system/blob/master/app/Http/Controllers/Backend/StudentController.php): `app/Http/Controllers/Backend/StudentController.php`
- [Student registration](https://github.com/hrshadhin/school-management-system/blob/master/app/Registration.php): `app/Registration.php`
- [Student attendance](https://github.com/hrshadhin/school-management-system/blob/master/app/Http/Controllers/Backend/StudentAttendanceController.php): `app/Http/Controllers/Backend/StudentAttendanceController.php`

### Assessment

- [Exam management](https://github.com/hrshadhin/school-management-system/blob/master/app/Http/Controllers/Backend/ExamController.php): `app/Http/Controllers/Backend/ExamController.php`
- [Marks and results](https://github.com/hrshadhin/school-management-system/blob/master/app/Http/Controllers/Backend/MarkController.php): `app/Http/Controllers/Backend/MarkController.php`
- [Assessment records](https://github.com/hrshadhin/school-management-system/blob/master/app/Mark.php): `app/Mark.php`
- [Reports](https://github.com/hrshadhin/school-management-system/blob/master/app/Http/Controllers/Backend/ReportController.php): `app/Http/Controllers/Backend/ReportController.php`
- [Report helpers](https://github.com/hrshadhin/school-management-system/blob/master/app/Http/Helpers/ReportHelper.php): `app/Http/Helpers/ReportHelper.php`

### People Operations

- [Employee management](https://github.com/hrshadhin/school-management-system/blob/master/app/Http/Controllers/Backend/EmployeeController.php): `app/Http/Controllers/Backend/EmployeeController.php`
- [Employee records](https://github.com/hrshadhin/school-management-system/blob/master/app/Employee.php): `app/Employee.php`
- [Employee attendance](https://github.com/hrshadhin/school-management-system/blob/master/app/Http/Controllers/Backend/EmployeeAttendanceController.php): `app/Http/Controllers/Backend/EmployeeAttendanceController.php`
- [Leave management](https://github.com/hrshadhin/school-management-system/blob/master/app/Http/Controllers/Backend/LeaveController.php): `app/Http/Controllers/Backend/LeaveController.php`

### Administration

- [Users and roles](https://github.com/hrshadhin/school-management-system/blob/master/app/Http/Controllers/Backend/UserController.php): `app/Http/Controllers/Backend/UserController.php`
- [Roles and permissions](https://github.com/hrshadhin/school-management-system/blob/master/app/Role.php): `app/Role.php`

### Public Website

- [Website management](https://github.com/hrshadhin/school-management-system/blob/master/app/Http/Controllers/Backend/SiteController.php): `app/Http/Controllers/Backend/SiteController.php`
- [Public site](https://github.com/hrshadhin/school-management-system/blob/master/app/Http/Controllers/Frontend/HomeController.php): `app/Http/Controllers/Frontend/HomeController.php`
- [Site content records](https://github.com/hrshadhin/school-management-system/blob/master/app/Event.php): `app/Event.php`

### Other components

- **School staff**
- [Backend routes](https://github.com/hrshadhin/school-management-system/blob/master/routes/web.php): `routes/web.php`
- [Application helper](https://github.com/hrshadhin/school-management-system/blob/master/app/Http/Helpers/AppHelper.php): `app/Http/Helpers/AppHelper.php`

## Connections

- School staff → Backend routes: uses
- Backend routes → Academic management: routes to (evidence: `routes/web.php`)
- Backend routes → Student records: routes to (evidence: `routes/web.php`)
- Backend routes → Student attendance: routes to (evidence: `routes/web.php`)
- Backend routes → Exam management: routes to (evidence: `routes/web.php`)
- Backend routes → Marks and results: routes to (evidence: `routes/web.php`)
- Backend routes → Reports: routes to (evidence: `routes/web.php`)
- Backend routes → Employee management: routes to (evidence: `routes/web.php`)
- Backend routes → Employee attendance: routes to (evidence: `routes/web.php`)
- Backend routes → Leave management: routes to (evidence: `routes/web.php`)
- Backend routes → Users and roles: routes to (evidence: `routes/web.php`)
- Backend routes → Website management: routes to
- Student records → Student registration: uses (evidence: `app/Http/Controllers/Backend/StudentController.php`)
- Student records → Academic structure: checks enrollment (evidence: `app/Http/Controllers/Backend/StudentController.php`)
- Marks and results → Assessment records: records marks (evidence: `app/Http/Controllers/Backend/MarkController.php`)
- Marks and results → Application helper: calculates marks (evidence: `app/Http/Controllers/Backend/MarkController.php`)
- Marks and results → Student registration: uses registrations (evidence: `app/Http/Controllers/Backend/MarkController.php`)
- Reports → Report helpers: uses (evidence: `app/Http/Controllers/Backend/ReportController.php`)
- Reports → Assessment records: queries (evidence: `app/Http/Controllers/Backend/ReportController.php`)
- Employee management → Employee records: manages
- Employee attendance → Employee records: records attendance
- Employee records → Application helper: uses constants (evidence: `app/Employee.php`)
- Users and roles → Roles and permissions: manages access (evidence: `app/Http/Controllers/Backend/UserController.php`)
- Website management → Site content records: manages content
- Public site → Site content records: loads content (evidence: `app/Http/Controllers/Frontend/HomeController.php`)
