End-to-end reference

Every module. Every screen. One procedure each.

This is the complete operating manual: how to log in, and how to run every module and component in MS LearnSpace ERP — Home, Student Administration, Fees, Academics, Attendance, Setup, Documents, System, HR & Staff, and SMS. Click any screen below to open its step-by-step procedure or you can Search to open selected components.

10 modules 65+ individual screens 4 access levels per screen 100% sourced from the application documentation
START

Getting Started — Login & Session

4 procedures

Everyone starts here, regardless of role. This covers signing in, resetting a forgotten password, switching between branches, and changing your own password.

Log inLogin screen (unauthenticated)
+

Authenticate and land on your role-appropriate home screen.

  1. Enter your username and password.
  2. Click Sign In.
  3. You're taken to your Dashboard with menu items matching your role's permissions.
Fields
Username *Password *
✓  A session lasts 24 hours before you're asked to log in again.
⚠  "invalid credentials" — check spelling; "Account is deactivated" — contact your administrator.
Reset a forgotten passwordLogin screen → Forgot Password
+

Regain access without an administrator, using a one-time code sent to your email.

  1. Click Forgot Password and enter your account email.
  2. Check your inbox for a 6-digit code — it's valid for 10 minutes.
  3. Enter the code, then set a new password (minimum 8 characters).
⚠  Code not arriving? Check spam, and request a new one — each code expires after 10 minutes.
Switch branch / schoolHeader → branch selector
+

Move between the branches or schools you've been granted access to, without logging out.

  1. Open the branch selector in the header.
  2. Choose the school/branch you want to work in.
  3. The page refreshes and every screen now shows that branch's data only.
✓  You'll only ever see branches you've explicitly been granted.
Change your own passwordProfile → Change Password
+
  1. Open Profile from the Dashboard.
  2. Enter your current password, then your new one (minimum 8 characters).
  3. Click Save.
01

Home / Dashboard

4 screens
Root: Sidebar → DashboardAccess: home.dashboard.*

The screen everyone lands on after login — an operational summary, your own profile, and report cards.

DashboardSidebar → Dashboard
+

An at-a-glance view of your active branch: student counts, fee collection, outstanding dues, staff attendance.

  1. Open the Dashboard — it loads automatically after login.
  2. Use the branch selector in the header to change which branch's numbers you're viewing.
  3. Click any KPI card (e.g. "Outstanding dues") to jump straight to the underlying report.
✓  Numbers refresh on load and whenever you switch branch or academic year.
ProfileSidebar → Dashboard → Profile
+
  1. Open Profile to view your account details.
  2. Click Edit to update editable fields, or use Change Password for your login.
  3. Click Save.
Report CardSidebar → Dashboard → Report Card
+

Quick access to your own linked report card view (for student-facing logins).

  1. Open Report Card.
  2. Select the test/term to view.
  3. Click Print or export to PDF.
Student Report CardSidebar → Dashboard → Student Report Card
+

Look up and print the report card for any student you have access to (staff-facing).

  1. Search for the student by name or admission number.
  2. Select the academic year and test.
  3. Click Generate, then Print.
✓  Marks and grades shown are pulled directly from Marks Entry — nothing to re-enter here.
02

Student Administration

10 screens
Root: Sidebar → AdministrationAccess: administration.student.*Front office

Everything to do with a student's record: from admission through to promotion, section changes, and inactivation.

Search StudentAdministration → Search Student
+
  1. Open Search Student.
  2. Filter by academic year, branch, class, or section, or type a name / admission number.
  3. Click a result to open the full student record.
Create StudentAdministration → Create Student
+

Admit a new student and generate their admission number.

  1. Open Create Student.
  2. Fill in the mandatory fields, then whatever else is on hand.
  3. Click Save — the admission number is generated automatically.
Fields
First name *Gender *Class *Section *Admission date *DOBParent phone
✓  "Student created successfully" — the class fee structure applies automatically.
⚠  "Duplicate admission no" / "Mandatory field missing".
Update Student DetailsAdministration → Update Student Details
+
  1. Search for and open the student.
  2. Click Edit, change the relevant fields.
  3. Click Update to save.
Change SectionAdministration → Change Section
+
  1. Select the class and current section to load its student list.
  2. Select the students to move (one or many).
  3. Choose the target section and click Change Section.
Promote StudentsAdministration → Promote Students
+
  1. Select the current class/section and academic year.
  2. Select students to promote and the target class for the new academic year.
  3. Click Promote to move them in bulk.
Demote StudentsAdministration → Demote Students
+
  1. Select the class/section and the students to demote.
  2. Choose the class to move them back to.
  3. Click Demote to confirm in bulk.
Make Student InactiveAdministration → Make Student Inactive
+

Used for students who leave — deactivates rather than deletes, keeping their history intact.

  1. Open the student's record.
  2. Click Make Inactive and confirm.
✓  The student's record and history are preserved, just hidden from active lists.
Import Student DataAdministration → Import Student Data
+

Admit many students at once from a spreadsheet — for new-batch onboarding.

  1. Click Download Template to get the required column format.
  2. Fill it in and save as .xlsx.
  3. Click Upload and select the file.
  4. Review the validation results — fix and re-upload any flagged rows.
⚠  Import fails on a bad template or duplicate admission numbers — use the latest template and fix duplicates before re-uploading.
Student ConcessionAdministration → Student Concession
+

Grant a fee discount to a specific student, drawing on the concessions configured in Concession Master.

  1. Search for the student.
  2. Select the concession type to apply and enter the amount or percentage.
  3. Click Save — it will be available next time fees are collected for this student.
Student Document ManagementAdministration → Document Management
+
  1. Open the student's record → Documents.
  2. Click Upload, select the document type, and choose the file (up to 16 MB).
  3. Click Save — download or view it anytime from the same screen.
⚠  "File too large" — files over 16 MB won't upload; compress and retry.
03

Fees

18 screens
Root: Sidebar → FinancialAccess: fees.fee.*Finance / Cashier

Billing setup, day-to-day collection, concessions, reversals, reporting, and branch petty cash — all in one place.

Fee DashboardFinancial → Fee Dashboard
+
  1. Open the Fee Dashboard for a snapshot of today's collection, dues, and concessions granted for your branch.
Take Fee (collect payment)Financial → Take Fee
+
  1. Search for the student — their outstanding fee types and installments load automatically.
  2. Tick what's being paid; click Apply Concession first if one applies.
  3. Enter the amount and payment mode (cheque details if applicable).
  4. Click Collect, then Print for the receipt — optionally send it by SMS.
Fields
Amount paid *Payment mode *Cheque no / bank / date
✓  "Payment recorded" — dues update immediately.
⚠  "Amount exceeds due" / "No fee assigned".
Fee ReceiptFinancial → Fee Receipt
+
  1. Search by receipt number or student.
  2. Open the receipt to view the full payment breakdown.
  3. Click Print to reprint, or Cancel/Delete to reverse (requires delete permission — moves to Deleted Receipts with a reason).
Fee TypeFinancial → Fee Type
+

Master list of fee heads (tuition, transport, exam fee, etc.) used to build fee structures.

  1. Click Create, name the fee type, and Save.
  2. Fee types must be unique per branch, year and school.
Class Fee StructureFinancial → Class Fee Structure
+

Attach fee types and amounts to a class — this is what auto-applies when a student is admitted.

  1. Select the class and academic year.
  2. Add each fee type with its amount.
  3. Click Save — every student in that class picks this up automatically.
Assign Special FeeFinancial → Special Fee
+

Add a one-off fee to a single student, outside the standard class structure.

  1. Search for the student.
  2. Add the fee item and amount.
  3. Click Save — it appears at their next Take Fee visit.
Update Student Fee Structure / Rebate DateFinancial → Fee Structure / Rebate Updates
+
  1. Open the student's fee record.
  2. Adjust the assigned structure or rebate date as needed.
  3. Click Update to save.
Fee InstallmentsFinancial → Fee Installments
+
  1. Select the fee type and class.
  2. Define the installment schedule (how the total is split and due dates).
  3. Click Save.
Concession MasterFinancial → Concession Master
+
  1. Click Create and define the concession (percentage or flat amount, which fee type it applies to).
  2. Click Save — it's now available in Student Concession and at collection time.
Fee ReportsFinancial → Fee Reports
+

Today's, daily, monthly, class-wise, installment-wise, due and late-due collection reports.

  1. Choose the report type and set your filters (branch, date range, class).
  2. Click Export for Excel or PDF.
Deleted ReceiptsFinancial → Deleted Receipts
+
  1. Open Deleted Receipts and filter by date range.
  2. Review the reason recorded for each reversal, and who performed it.
Fee Concession ReportFinancial → Concession Report
+
  1. Filter by class and academic year.
  2. Export to review every concession granted, by student.
Adjust Fee ReportFinancial → Adjust Fee Report
+
  1. Open the report to review any manual fee adjustments made outside standard collection.
Petty Cash — VouchersFinancial → Petty Cash → Vouchers
+
  1. Click Create Voucher, choose Payment or Received, and enter the ledger head and amount.
  2. Click Save — the voucher status is set to Pending.
  3. Once approved, it rolls into the petty-cash reports and ledger balance automatically.
Petty Cash — Fund AllocationFinancial → Petty Cash → Fund Allocation
+
  1. Click Create Allocation, enter the branch and amount being allocated, with justification.
  2. Click Save — it routes for approval before funds are available.
Petty Cash — Monthly Expenses / ReportFinancial → Petty Cash → Report
+
  1. Filter by branch, ledger head, and month.
  2. Export for expense review and reconciliation.
Petty Cash — ApprovalFinancial → Petty Cash → Approval
+

Where a Finance Manager or Admin reviews pending vouchers and allocations.

  1. Open the Approval queue — pending vouchers and allocations are listed.
  2. Open one to review the amount, ledger, and creator.
  3. Click Approve or Reject — rejections require the creator to revise and resubmit.
✓  Approving records who approved it and when — fully audit-logged.
04

Academics

11 screens
Root: Sidebar → AcademicAccess: academics.academic.*Academic Coordinator / Teacher

Set up subjects and tests once per year, then enter marks — grades and report cards are calculated for you.

Subject MasterAcademic → Subject Master
+
  1. Click Create, enter the subject name and type (Academic or Deeniyath).
  2. Click Save.
Class Subject AssignmentAcademic → Class Subject Assignment
+
  1. Select the class.
  2. Tick which subjects apply to it.
  3. Click Save.
Assign Student SubjectsAcademic → Assign Student Subjects
+
  1. Select the class — its students load with the class's assigned subjects.
  2. Adjust for individual students if needed (e.g. elective choices).
  3. Click Save.
Test Type ManagerAcademic → Test Type Manager
+
  1. Click Create, name the test type (e.g. Unit Test, Term Exam), and set its display order.
  2. Click Save.
Class Test AssignmentAcademic → Class Test Assignment
+
  1. Select the class and test type, and create the specific test (name, max marks).
  2. Assign the relevant subjects to that test.
  3. Click Save.
Assign Subject Tests / Assign Student TestsAcademic → Assign Student Tests
+

Link the class test to the actual students who'll sit it — required before marks can be entered.

  1. Select the class test.
  2. Select which students are assigned to it (defaults to the full class).
  3. Click Save.
Grade Scale ManagerAcademic → Grade Scale Manager
+

Defines how marks convert to grades — required before any marks can be graded.

  1. Click Create and define each grade with its mark range (min–max) and label.
  2. Ranges must be continuous and non-overlapping.
  3. Click Save.
⚠  Overlapping or gapped ranges are rejected — check min < max across all grades.
Marks EntryAcademic → Marks Entry
+
  1. Select academic year, branch, class & section, test, and subject.
  2. Enter marks for each student in the loaded list.
  3. Click Save — grades are computed automatically from the grade scale.
⚠  "Grade scale not configured" / "Test not assigned to student".
Marks Entry — All SubjectsAcademic → Marks Entry All Subjects
+
  1. Select the class, section and test.
  2. Enter marks across every subject for each student on one screen.
  3. Click Save.
Marks UploadAcademic → Marks Upload
+
  1. Download the marks template for the selected test.
  2. Fill it in offline and save.
  3. Click Upload and review the validation results.
Report CardAcademic → Report Card / Dashboard → Student Report Card
+
  1. Search for the student and select the test/term.
  2. Click Generate to preview the consolidated result.
  3. Click Print or export to PDF.
05

Attendance

2 screens
Root: Sidebar → Academic → AttendanceAccess: attendance.attendance.*Class Teacher

Student attendance — daily and exam-specific. (Staff attendance is captured automatically via biometric devices — see HR & Staff.)

Student AttendanceAcademic → Attendance → Student Attendance
+
  1. Select the date and class/section — the student list loads with a present/absent toggle each.
  2. Mark each student, or use the bulk upload template for a large intake.
  3. Click Save to lock in the day's attendance.
✓  Saved attendance can trigger an SMS to absent students' parents, if configured.
Set Exam AttendanceAcademic → Attendance → Set Exam Attendance
+
  1. Select the exam period and class.
  2. Mark attendance for the exam days.
  3. Click Save.
06

School Setup

4 screens
Root: Sidebar → Setup Your SchoolAccess: setup.school-setup.*Administrator

The foundation everything else is built on — done once when a school or branch is onboarded, and revisited each academic year.

Setup SchoolSetup Your School → Setup School
+
  1. Enter the school's core details and its first branch.
  2. Set the active academic year.
  3. Click Save to make the tenant available for operations.
Classes ManagementSetup Your School → Classes Management
+
  1. Click Create, name the class, and add its sections in the same step.
  2. Click Save.
Class SummarySetup Your School → Class Summary
+
  1. Open Class Summary to review every class, its sections, and student counts at a glance.
ConfigurationSetup Your School → Configuration
+

Week-off days and the holiday calendar — used by attendance and reporting to exclude non-working days.

  1. Set which days of the week are off by default.
  2. Add specific holiday dates for the academic year.
  3. Click Save.
07

Documents

2 screens
Root: Sidebar → DocumentsAccess: documents.documents.*

Define what kinds of documents you collect, then upload and store them against each student, securely.

Document AdministrationDocuments → Document Administration
+

Admin screen — defines the list of document types available when uploading (e.g. Birth Certificate, Transfer Certificate).

  1. Click Create and name the document type.
  2. Click Save.
Document ManagementDocuments → Document Management
+
  1. Open the student's record.
  2. Click Upload, choose the document type and file (up to 16 MB).
  3. Click Save — download it anytime from the same screen.
⚠  "File too large" — keep uploads at or under 16 MB.
08

System

4 screens
Root: Sidebar → Control PanelAccess: system.*Administrator only

The control room — who can log in, what they can do, and which schools and branches exist. Visible only to administrator roles.

User ManagementControl Panel → User Management
+
  1. Click Add User, enter username, email, and temporary password.
  2. Assign a role and the school/branch they should have access to.
  3. Click Save — the new user is prompted to change their password on first login.

To remove access, prefer Deactivate over Delete — it blocks login while keeping their history intact for audit.

⚠  "Username already exists" / "Email already in use" / "Password must be at least 8 characters".
Role Permissions (RBAC)Control Panel → Role Permissions
+

Create custom roles and control exactly which screens they can view, create, add to, or delete from.

  1. Click Create Role and name it (e.g. "Finance Manager").
  2. For each screen, toggle the four action flags it needs: view, create, add, delete.
  3. Click Save — users assigned this role see exactly those screens.
⚠  "Role name already exists" / "System role names cannot be changed" — create a new custom role instead.
School ManagementControl Panel → School Management
+
  1. Click Create School and enter name, code, logo, and theme color.
  2. Click Save — the school is now available as a tenant.
Franchise ManagementControl Panel → Franchise Management
+
  1. Open Franchise Management to view or configure the schools grouped under a franchise brand.
09

HR & Staff

12 screens
Root: Sidebar → HR & StaffAccess: hr.*HR

Staff records, the org structure behind them, biometric devices, and the attendance those devices generate automatically.

Staff MasterHR & Staff → Staff Master
+
  1. Click Create and fill in personal and employment details.
  2. Click Save — staff code and employee ID are generated automatically.
Fields
First name *Gender *Joining date *Employment type *DepartmentDesignationDefault shift
⚠  "Duplicate staff code" / "Missing joining date".
Staff DirectoryHR & Staff → Staff Directory
+
  1. Search or filter by department, designation, or status.
  2. Click a staff member to open their profile.
Staff ProfileHR & Staff → Staff Profile
+
  1. Open a staff member's profile to view their full employment details and attendance history in one place.
Staff CategoriesHR & Staff → Staff Categories
+
  1. Click Create and name the category (e.g. Teaching, Non-Teaching).
  2. Click Save.
Staff StatusesHR & Staff → Staff Statuses
+
  1. Click Create and name the employment status (e.g. Active, On Leave).
  2. Click Save.
DepartmentsHR & Staff → Departments
+
  1. Click Create, name the department.
  2. Click Save — this also feeds the staff code sequence.
DesignationsHR & Staff → Designations
+
  1. Click Create, name the designation and link it to a department.
  2. Click Save.
ShiftsHR & Staff → Shifts
+
  1. Click Create, set the shift name and start/end times.
  2. Click Save.
Biometric DevicesHR & Staff → Biometric Devices
+
  1. Click Create, register the device's name and branch location.
  2. Click Save — it can now sync punches once configured on-site.
Staff Biometric MappingHR & Staff → Staff Biometric Mapping
+

Links a staff member to their fingerprint/ID on the device, so punches are attributed correctly.

  1. Select the staff member.
  2. Enter their biometric ID from the device.
  3. Click Save.
Attendance SummaryHR & Staff → Attendance Summary
+
  1. Filter by branch and month.
  2. Review present/late/overtime days per staff member — generated automatically from punches.
  3. Export for payroll input.
Punch LogHR & Staff → Punch Log
+

The raw, unprocessed device punches — useful when a staff member's attendance looks wrong.

  1. Filter by staff member and date.
  2. Compare raw punch times against the Attendance Summary if something looks off.
⚠  Missing punches usually mean the device or its sync connection is down — check with your administrator.
10

SMS

2 screens
Root: Sidebar → Administration → SMS CenterAccess: administration.sms.*

Keep parents informed — attendance alerts, fee receipts, due reminders, and general announcements, sent straight from the record that triggered them.

SMS Center — send a messageAdministration → SMS Center
+
  1. Choose the message type: Attendance, Fee Receipt, Fee Due, or Announcement.
  2. Select the recipients — a class, a filtered list, or individual students.
  3. For Announcements, type your message; other types use their pre-set template.
  4. Click Send.
✓  Fee-receipt and due reminders can also be triggered with one click directly from Take Fee / Fee Reports.
SMS ReportsAdministration → SMS Center → Reports
+
  1. Filter by message type and date.
  2. Review delivery status per message for a full send log.
⚠  "Not delivered" usually means the gateway isn't configured — flag it to your administrator.
REF

Reports Catalog

Where to find every export

Every exportable report in the system, and which module it lives in.

ReportFound inExports as
Today's / Daily / Monthly FeesFinancial → Fee ReportsExcel / PDF
Class-wise FeesFinancial → Fee ReportsExcel
Installment-wiseFinancial → Fee ReportsExcel
Due / Late DueFinancial → Fee ReportsExcel
Deleted ReceiptsFinancial → Deleted ReceiptsExcel
Concession ReportFinancial → Fee Concession ReportExcel
Petty Cash (branch / ledger / monthly)Financial → Petty Cash → ReportExcel
SMS ReportsAdministration → SMS Center → Reports
Student Report CardDashboard → Student Report CardPDF / Print
Staff Attendance SummaryHR & Staff → Attendance SummaryExcel
REF

Notifications — What Triggers What

ChannelTypeSent whenGoes to
SMSAttendanceAttendance marked / student absentParent
SMSFee ReceiptFee collectedParent
SMSFee DueSent on demand from Fee ReportsParent
SMSAnnouncementSent manually from SMS CenterSelected students/parents
EmailPassword OTPForgot Password requestedUser's registered email
REF

Error Glossary — Quick Fixes

MessageWhat to do
Mandatory field missingA required (starred) field was left blank — check every starred field on the form.
Duplicate admission no / staff codeThese are auto-generated — leave the field blank and let the system assign it.
Unauthorized branchYou don't have access to this branch — ask an administrator to grant it.
Amount exceeds dueThe entered payment is more than what's owed — recheck the outstanding balance shown.
No fee structure assignedThe class doesn't have a fee structure yet — ask Finance to configure Class Fee Structure.
Grade scale not configuredSet up a grade scale for the class before entering marks.
Test not assigned to studentAssign the test to the student first, under Assign Student Tests.
File too largeUploads are capped at 16 MB — compress the file and try again.
Session expiredLog back in — nothing was lost; sessions last 24 hours.
Account is deactivatedContact your administrator to reactivate your account.
↑ Back to top

Complete end-user procedure reference · Prepared for client presentation