Read this once — it applies everywhere in the app.

Accessing the app

• Open your institution's web address (e.g. yourschool.kush-edu.com). Each institution sees only its own data.
• Click Sign in and enter the email/username and password your administrator gave you.
• To leave, click your profile avatar (top corner) and choose Sign out.

The top bar

• Back — returns to the previous page.
• EN / عربي — switches the whole app between English and Arabic.
• Home — returns to your Dashboard.
• Avatar — your account menu and Sign out.

The universal save pattern

• Fill the fields, then click the main button (Create / Save / Add).
• A green ✓ confirmation appears on success.
• Fields marked required must be filled or the form won't submit.

Your home screen — the modules your role can open.

1. After sign-in you land here automatically (or click Home anytime).
2. Each module appears as a card. Click Access [module] (or the card) to open it.
3. You only see modules your role is allowed to use.

Receive applications, review them, accept or reject, and email acceptance letters.

2.1 · Applications list

1. Open Admissions from the dashboard.
2. You see a table of applicants: Applicant, Program, Source, Status.
3. New applications arrive automatically from your public website.
4. Click any row to open that application.

2.2 · Application detail

The page shows the applicant's submitted details (read-only): Email, Phone, Country, Destination, Institute applied to, Program, Education level, Source, Message. To set the status, click one of:

• Accept & create student — approves the applicant and creates a student record with a QR identity.
• Mark under review — flags it as being evaluated.
• Waitlist — places them on the waiting list.
• Reject — declines the application.

2.3 · Evaluations (screening)

1. From Admissions, open Evaluations.
2. Click Evaluate all to score every application, or Run on a single row.
3. Read the Score, Band (Strong / Consider / Weak / Incomplete) and Notes.

2.4 · Acceptance letters

1. Open Acceptance letters (only accepted applicants appear).
2. Click Preview & send on an applicant.
3. Edit the Subject if needed.
4. Edit the letter body (your edits are saved to this applicant).
5. Click Send by email. A ✓ Sent marker confirms it.

Manage enrolled students, register them into courses, handle documents, and print transcripts.

3.1 · Students list

1. Open Students. The table shows Student #, Name, GPA, and a QR code.
2. Students appear here after you accept their application.
3. Click a row to open the student.

3.2 · Registering into courses

Choose the program

1. Under Program & study plan, pick the Program.
2. Set the Current semester, then Save.

Register courses

• Flexible program: tick the courses for this term, then Register selected.
• Fixed program: click Auto-register Semester [n] to register the whole block at once.

3.3 · Documents

Under Documents, each row offers Verify, Reject, or Delete. Students upload their own documents from the portal; you review them here.

3.4 · Transcript & certificate

1. Open the Transcript — it lists coursework, credits, and GPA. Click Print / Save as PDF.
2. For graduation, click Print certificate.

Define programs, their curriculum (courses by semester), and how students register.

4.1 · Create a program

1. Open Programs.
2. Under New program, fill Name, Code, Number of semesters.
3. Choose Registration: Flexible (student picks each term) or Fixed (admin assigns a block).
4. Click Create program.

4.2 · Build the curriculum

1. Open a program; adjust Name, Code, Semesters, Status and click Save changes.
2. Under Add a course to the curriculum, choose the Course, Semester, and Type (Required / Elective).
3. Click Add. Repeat for each course.

A section is one offering of a course in a term — its roster, schedule, grades, attendance, and assignments.

5.1 · Create a section

1. Under New section choose Term, Section code, optional Teacher, Capacity, and Status.
2. Click Create section.

5.2 · Section workspace

Register a student

1. Under Register a student, pick from Select a student… and click Register. (Use Drop to remove.)

Meeting times

1. Choose Day, Start, End, Room, then Add. Repeat per weekly slot.

5.3 · Gradebook

1. Add a component: Name, Weight, Max score.
2. Type each student's score in the cell and click save.
3. When done, click Post final to compute the letter grade and update GPA.

5.4 · Attendance

1. Create a session: Date, optional Topic, then Create.
2. Mark via QR check-in (scan/paste a code → Check in) or manually: Present / Absent / Late / Excused.

5.5 · Assignments

1. New assignment: Title, optional Instructions, then Create assignment.
2. Record a submission: pick the Student, add a note/link, click Add submission.
3. Grade: enter points and feedback, click Grade.

Teachers manage their own sections and grade work, with optional AI help.

6.1 · My Teaching

1. Open Teaching & Grading — you see the sections you teach.
2. If empty, ask an admin to set you as the section's teacher.

6.2 · Create an assignment

1. Fill Title, Instructions, Max points, optional Due.
2. Optionally attach a Required reading chapter, then click Create.

6.3 · Grade a submission

1. Open an assignment, then Open to grade on a student.
2. Read the submission. Optionally click ✨ AI draft feedback for a suggested score & comment.
3. Enter the final Score and Feedback, then Save grade.

6.4 · Assign teachers (admin)

1. Open Assign Teachers to Sections.
2. For each section, pick the staff member and Save. They then see it under "My Teaching".

Invoices and payments, payroll, expenses, vouchers, fee structures, and reports.

7.1 · Finance hub

Shows KPIs (Total billed, Collected, Outstanding) and cards for each area. To create an invoice: pick a Fee structure, optional Term, click Issue.

7.2 · Fee structures

1. New structure: Name + currency, then create.
2. Open it and add items: Charge label + amount, click Add item.

7.3 · Invoice detail

1. Set a Due date + note, click Save details.
2. Add a charge: label + amount → Add charge.
3. Record a payment: amount, method (Cash / Card / Bank transfer / Scholarship / Other), reference → Record.

7.4 · Staff & payroll

1. Set a salary: pick the Staff member, Job title, Base monthly → Save salary.
2. Run payroll: Label + optional month → Create run (generates payslips).
3. Review payslips (Gross / Deductions / Net), then Email payslips to staff.

7.5 · Expenses

Choose a Category, enter Payee, amount, optional note, then record it.

7.6 · Payment vouchers

New voucher: Voucher no., Payee (required), amount, Purpose, Approved by, then Save.

7.7 · Financial reports

Set From and To dates, click Apply, and review Income, Surplus/Deficit, Outstanding, and Expenses by category.

Users, roles, announcements, your public page, branding, and the e-library.

8.1 · Users

1. Under Add a user: Full name, Email, optional username/phone, Temporary password (min 8).
2. Tick the Roles, then Create user. Give them the temporary password.

8.2 · Roles & permissions

1. Add a role: Role name + description, click Add role.
2. For each role, tick its permissions, then Save permissions.

8.3 · Announcements

1. New announcement: Title + Body.
2. Choose Audience (Everyone / Students / Staff) and status (Draft / Published); optionally Pin.
3. Click Create announcement. Published ones show in the student portal.

8.4 · Institution page (public site)

1. Fill the English fields and matching Arabic fields: Tagline, About, Student life, Faculty.
2. Add a Hero image URL and Gallery URLs (one per line).
3. Enter Contact email, phone, address. Tick Show the Apply form if desired.
4. Click Save; use View public page to preview.

8.5 · Branding

Paste a public logo URL (transparent PNG/SVG works best) and click Save logo. Empty = the institution name shows instead.

8.6 · E-Library

1. Add a book: Title, author, cover URL, language, description → Add book.
2. Open it and add chapters: Chapter title + text → Add chapter.

Validate a student's QR identity.

1. Open Scan ID and point the camera at the QR code — it validates automatically.
2. No camera? Paste the scanned code and click Validate.
3. The result confirms a valid student, or explains why not (expired, revoked, invalid).

Create and manage the institutions (tenants) on the platform.

1. Open Platform Admin.
2. New institution: Institution name, slug (subdomain), default language → Create institution.
3. The table lists every institution with its subdomain, mode, and status.

Where students see their own information and act on it.

• My Profile & QR ID — view details; Generate my QR ID if none; "Show full screen" to present it.
• Grades & GPA — grades per course and cumulative GPA.
• Attendance — overall rate and recent sessions.
• Timetable — the weekly class schedule.
• Course Registration — when open, tick available courses and register (Full sections can't be taken).
• Fees & Payments — invoices and balance.
• Documents & Visa — upload a file with number, country, issue/expiry dates → Upload. The registrar reviews it.
• Announcements — institution news.
• Assignments & Results — read required reading, type a submission, Submit; later see Result and Feedback.
• Library — open a book and read chapter by chapter.

What visitors see before signing in.

• Programs — browse programs; open a curriculum to see courses by semester.
• Grading Structure — the standard letter-grade scale.
• Application Status — enter the application email and click Check status to see Submitted, Under review, or a Decision.

Parents sign in with their own account to follow their children — attendance, fees, and the school bus.

13.1 · Set up a parent account (admin)

1. In Settings → Users, create the parent's account (name, email, temporary password). No roles are needed.
2. Open Settings → Parents.
3. Under Link a parent to a student, choose the Parent (user), the Student, and an optional Relationship, then click Link.
4. Repeat for each child. Use Remove to unlink.

13.2 · What the parent sees

1. The parent signs in normally — they land on the Parent Portal automatically.
2. Each linked child appears as a card. Open a child to see:

• Attendance — overall rate, by-course table, and recent sessions.
• Fees — invoices, payments, and the balance (read-only).
• Transport — the child's bus route, driver name and phone, and pickup point.

13.3 · Transport (admin)

1. Open Transport from the dashboard.
2. Under Add a route: Route name, optional Vehicle, Driver name, Driver phone, Capacity → Add route.
3. Open a route. Under Assign a student, pick the Student and a Pickup point, then Assign.
4. The route page shows riders vs capacity. Use Remove to take a student off the route.