App Introduction

Mham School & LMS — Full System Overview (English)

Overview

A complete bilingual (Arabic/English) school management and LMS (Learning Management System) built on a custom PHP MVC framework. It serves two purposes in one codebase:

1. School Management — classes, teachers, students, attendance, grades, behavior, fees, library, timetable, events, announcements, health records
2. LMS — online courses, video lessons, assignments, enrollments, student progress tracking

Works as a multi-tenant system — multiple schools/nurseries on a single installation.

Role System (8 roles)

Admin Panel — Full Feature List

The admin panel (under /admin) provides complete school control:

Dashboard

• Key metrics: total students, teachers, classes, subjects, courses, enrollments
• Recent registrations, quick action buttons

School Settings

• School name, address, phone, email, website, logo
• Academic year management

Class Management

• Create/edit classes (Grade 1-6, sections A-C)
• Assign homeroom teachers
• Student roster per class
• Grade levels configuration

Subject Management

• Create/edit subjects per school
• Assign to grade levels

Timetable

• Visual weekly schedule per class
• Drag subject/time slots
• Teacher timetable view

Teacher Management

• Register teachers with full profile
• Assign to classes/subjects
• View teacher schedules

Student Management

• Register students with complete profiles (name, email, phone, address, birth date, gender)
• Student detail page with parent info, attendance history, grades, behavior records
• Search/filter students

Attendance

• Daily attendance sheet per class
• Mark present/absent/late/excused
• Monthly attendance reports
• Calendar-based date picker

Gradebook

• Grade categories (tests, homework, participation, exams)
• Grade items per class/subject
• Per-student grade entry with automatic averages
• Grade reports

Behavior Records

• Positive/negative behavior entries
• Per-student behavior history
• Per-class behavior overview

Announcements

• Create/edit/delete school-wide announcements
• Target by audience (students, teachers, parents)

Events

• School event calendar
• Event title, date, description

Fee Management

• Fee categories (tuition, transportation, lunch, materials)
• Per-student fee payments tracking
• Outstanding balance view

Library Management

• Book catalog with author/ISBN
• Book lending/return tracking
• Overdue book alerts

Reports

• Student reports (attendance, grades, behavior)
• Class reports
• School-wide statistics

User Management

• All users list with roles
• Add/edit/delete users
• Role assignment

LMS Features

Course Management

• Course creation with title, description, thumbnail, category, price
• Course listing with lesson counts, category filters
• Search/filter courses

Category Management

• Course categories with course counts
• Full CRUD

Lesson Management

• Video lessons (Plyr player integration)
• Lesson ordering
• Content with HTML/text
• Course-filtered lesson list

Assignment Management

• Create assignments per lesson
• Due dates, points, instructions
• Student file submissions
• Grading with feedback
• Submission list with status

Enrollment System

• Student course enrollment
• Enrollment count tracking
• Course access control

Technical Architecture

• Language: PHP 8.x
• Database: MySQL/MariaDB
• Frontend: HTML/CSS/JS (responsive, no framework)
• Video: Plyr.js
• Auth: Session-based, bcrypt passwords
• Security: CSRF tokens, prepared statements, XSS escaping
• i18n: Custom lang() helper, EN/JP files

Database (28 tables)

Key Advantages

• No framework license fees — completely custom PHP
• Dual system — LMS + school management in one
• Multi-school ready — nursery chains and school groups
• Bilingual — Arabic/English out of the box, easy to add more
• Simple hosting — any shared hosting with PHP 8 + MySQL
• No Composer needed — upload and run
• Demo data included — functional on install