How waziri123/final-school-management-system works
Final School Management System is a multi-school administration application for school staff, with role-specific access for super admins, admins, teachers, students and parents. The main workflow is to select a school and its active academic period, manage school people and learning structures, then schedule classes and record exams and results. Student promotion and graduation are separate lifecycle operations; result printing is also supported. The README documents these capabilities, while most Livewire implementations were not sampled, so their model interactions are represented at subsystem level rather than as detailed call sequences.
Main entry points: Student.php Domain models · Result/Index.php Exam results · School/Index.php School administration · AcademicYear/Index.php Academic periods
Components 20
Access and Schools
- Authentication
app/Http/Controllers/Auth/RegisteredUserController.php - School administration
app/Http/Livewire/Dashboard/School/Index.php - School settings
app/Http/Livewire/Dashboard/School/SettingSchool.php - School data
app/Models/School.php
Academic Setup
- Academic periods
app/Http/Livewire/Dashboard/AcademicYear/Index.php - Semester management
app/Http/Livewire/Dashboard/Semester/Index.php - Classes and sections
app/Http/Livewire/Dashboard/Classes/Index.php - Subjects and syllabii
app/Http/Livewire/Dashboard/Subject/Index.php
People Lifecycle
- Student administration
app/Http/Livewire/Dashboard/Student/Index.php - Teacher administration
app/Http/Livewire/Dashboard/Teacher/Index.php - Parent administration
app/Http/Livewire/Dashboard/Parent/Index.php - Promotion and graduation
app/Http/Livewire/Dashboard/PromoteStudent/Index.php
Teaching and Assessment
- Timetable management
app/Http/Livewire/Dashboard/TimeTable/Index.php - Exam management
app/Http/Livewire/Dashboard/Exam/Index.php - Exam marking
app/Http/Livewire/Dashboard/Exam/Marking/MarkExam.php - Exam results
app/Http/Livewire/Dashboard/Exam/Result/Index.php
Application Services
- Print service
app/Services/Print/PrintService.php - Domain models
app/Models/Student.php - Application database
Other components
- School users
Connections 27
- School users → Authentication: signs in
- School users → School administration: manages schools
- School users → Academic periods: sets periods
- School users → Student administration: manages students
- School users → Teacher administration: manages teachers
- School users → Parent administration: manages parents
- School users → Timetable management: manages schedules
- School users → Exam management: manages exams
- School users → Exam marking: records marks
- School users → Promotion and graduation: manages lifecycle
- School administration → School data: manages
- School settings → School data: updates
- Academic periods → Domain models: manages periods
- Semester management → Domain models: manages semesters
- Classes and sections → Domain models: manages classes
- Subjects and syllabii → Domain models: manages subjects
- Student administration → Domain models: manages students
- Teacher administration → Domain models: manages teachers
- Parent administration → Domain models: manages parents
- Promotion and graduation → Domain models: updates enrollment
- Timetable management → Domain models: manages schedules
- Exam management → Domain models: manages exams
- Exam marking → Domain models: records marks
- Exam results → Domain models: reads results
- Exam results → Print service: requests PDF
- Print service → Application database: loads result data
- Domain models → Application database: reads and writes