← All administrator guides

Academic Setup — Demo & Onboarding Guide

From curriculum to report card: what an institution administrator sets up, what a teacher does with it, and how every result is calculated. All numbers below are sample data for a walkthrough.

Blue menu chips open that page in the app at this address.

1. The big picture

Six stages. Blue = administrator, green = teacher, dashed = the system calculates, violet = student/guardian sees it.

1CurriculumTemplate, terms, outcomes per grade
→
2AssignmentsSubjects to classes, teachers to subjects
→
3Teach & assessLessons, quizzes, tests, graded homework
→
4Subject averageWeighted by grading term
→
5GPAAverage → band → points
→
6Report cardGenerate, approve, release

Three kinds of “term” — do not mix them up

Name in the appWhat it is forWhere it is set
Academic periodThe school year. Everything hangs off it.Settings › Academic Periods (platform administrator)
Timetable termsCalendar blocks for the timetable (Semester 1, Semester 2).Timetable Terms
Grading termsThe terms marks are recorded against. Each has a weight. These drive results.Assessment › Assessments
Curriculum termsChapters of the curriculum: which outcomes are taught when.Curriculum › Curriculum Setup

2. The sample school used in this guide

School

InstitutionHidayatUnNisa
School year2026–2027
Grade / classALIM Year 1 / class ALIMGY1C1
Student followedZainab Idris
Pass mark50%

Subjects and grading terms

SubjectLessons / weekTeacher
Arabic5Ustadh Bilal
Urdu3Ustadha Amina
Health2Ms Clara

Grading terms: Term 1 weight 40, Term 2 weight 60.

3. Curriculum template and outcomes Administrator

In this app a curriculum template and an outcome template are the same record: one template per grade and school year, holding the terms and the learning outcomes a student must reach.

Template ALIMY1-2026 "ALIM Year 1 curriculum" (grade ALIM Year 1, year 2026-2027) | +-- Curriculum term 1 "Foundations" Sep - Dec | +-- Arabic AR-1.1 Reads short voweled sentences | +-- Arabic AR-1.2 Writes the 28 letters in all positions | +-- Urdu UR-1.1 Introduces self in five sentences | +-- Curriculum term 2 "Application" Jan - Jun +-- Arabic AR-2.1 Translates a 50-word passage +-- Health HE-2.1 Explains three hygiene routines
  1. Open Curriculum › Curriculum Onboarding. Pick the institution and school year, then press Start.
  2. Foundation step: enter code ALIMY1-2026, a name, the grade, and at least one outcome. Press Save Template. Repeat per grade.
  3. To add terms or more outcomes later, open Curriculum › Curriculum Setup and select the template.
  4. The wizard then walks you through Offerings, Staffing and Delivery — the assignments in section 4. Section 5 then turns them into a timetable and calendar.
Templates are shared reference data per grade and year. What makes them yours is the next step: offering the subjects in your institution.

4. Assignments Administrator

“Assignment” means four different things in the menus. This is how they connect:

SubjectArabic ClassALIMGY1C1 TeacherUstadh Bilal Timetable lessonMon 08:30 Arabic Cover / homeworkper lesson or task A offered to B teaches C placed in timetable D
What you assignMenuSample
ASubjects to a grade and its classes, with lessons per weekClasses › Subject OfferingsArabic → ALIMGY1C1, 5 per week
BTeachers to subjectsClasses › Curriculum Setup · TeachersUstadh Bilal → Arabic
CLessons into the weekly timetableCalendar › Timetable BuilderMon–Fri 08:30 Arabic
D1Cover for an absent teacher, with a deadlineCurriculum › Cover AssignmentsUstadha Amina covers Mon 08:30
D2Homework and graded home assignments for studentsCurriculum › Homework“Letter practice”, marked out of 20

One-stop alternative for A and B: University Setup walks grades → classes → subjects → teachers in one wizard.

5. Lesson planning: from curriculum to the calendar Administrator Teacher

New since November 2026: chapters with weights, a week-by-week plan, a lesson log per objective, weighted chapter progress and test scores with draft and published are described, with demo data, in the Teaching guide. The pages below (Lesson Planning, Teacher Coverage) are the older way and are now labelled “Lesson slots (Old planning)” and “Teacher Coverage (Old lesson log)” in the menu.

A lesson only reaches a student's calendar when four things exist: what is taught (the curriculum), who teaches it to which class and how often, when the school day runs, and a published timetable that places it. Lesson planning then says which outcome each lesson covers.

1CurriculumTemplate + outcomes per grade
→
2Class subjectsSubject per class, lessons per week
→
3TeachersOne teacher per class + subject
→
4School dayTerm, periods, breaks
5TimetableGenerate, check, publish
→
6Lesson planningOutcome per lesson: I → R → M
→
7CalendarEvery dated lesson, per person
→
8DeliveryTaught / partly / skipped

How the records hang together

OutcomeAR-1.1 Reads sentences Class subjectALIMGY1C1 · Arabic · 5/wk School daySemester 1 · 10 periods Timetable slotMon P1 · Ustadh Bilal · Rm 101 Outcome linkAR-1.1 · Introduced Calendar lessonMon 7 Sep 08:30 Delivery recordTaught, 7 Sep placed by chosen in repeats every school day of the term

The timetable is a weekly pattern. The calendar turns each slot into a dated lesson for every school day of the term, skipping weekends, holidays and closures. The outcome link sits on the slot, so it applies to every week that slot repeats.

Start here: the Academic Setup Checklist

One page tells you, for an institution and school year, which of the steps below are ready, which need a check and which are not started. Each step lists what is missing by name (for example “ALIMGY4C · Math — no teacher”) and has a button that opens the page that fixes it. The banner at the top always names the next step to do.

Academic Setup Checklist (School Calendar group; administrators and principals)

Steps checked: school-year dates · terms · grades offered · classes · curriculum · subjects and lessons per week · teachers · school day · holidays · timetables · published · lesson planning · data integrity.

Step by step, with the sample class

#Do thisMenuSample
1Create the curriculum template and outcomes (section 3).Curriculum OnboardingALIMY1-2026, AR-1.1, AR-1.2, UR-1.1
2Link each subject to the class and enter lessons per week. The timetable generator places exactly this many.Curriculum Setup › ClassesArabic 5, Urdu 3, Health 2
3Give each class-subject its teacher. The teacher is set per class, so a teacher only sees the classes they actually teach.University Setup step 5Arabic → Ustadh Bilal
4aMake sure the term exists for this school year (Semester 1, Semester 2). Institution administrators and principals manage the terms of their own institution; a term must sit inside the academic period, and a term a timetable uses cannot be deleted.Timetable TermsSemester 1: 1 Sep – 21 Dec
4bBuild the school day: periods with start and end times, plus breaks and lunch. Check school days (e.g. Mon–Fri) and apply the country's public holidays.Calendar Setup10 periods from 08:30, lunch 12:00–12:45
5aCreate one timetable for the class and term, then Auto-generate. The dialog opens on a preview and lists every subject with its lessons per week; change a number there and it is saved for the class and the preview updates. To do all classes of a grade at once, use Generate whole grade (shared teachers are never double-booked; published timetables are skipped). Or place lessons by hand and drag them; only free cells accept a drop.Timetable Builder10 of 10 lessons placed, spread over 5 days
5bFix blocking conflicts (teacher or room booked twice, lesson on a break), then Publish.Timetable Precheck0 blocking
6Teacher opens the class and subject, picks the semester, and ticks which outcome each weekly slot covers. Click a cell to cycle Introduced → Reinforced → Mastered.Lesson PlanningMon P1 AR-1.1 I · Wed P1 AR-1.1 R · Fri P1 AR-1.2 I
7Lessons appear on the calendar with subject, teacher and room. Lessons of a draft timetable are shown dashed and labelled Draft, and only administrators and principals see them.School Calendar My Schedule My timetableMon 7 Sep 08:30 Arabic · Ustadh Bilal · Room 101
8After each lesson the teacher records what happened. This is the evidence used when a test is created.Teacher Coverage7 Sep: Taught

When does a slot become a calendar lesson?

  • The date is inside the timetable's term.
  • The weekday is a school day and the period runs that day.
  • The date is not a public holiday or school closure.
  • The period is a teaching period, not a break.
  • Students, guardians and teachers only see published timetables.
  • Only administrators and principals create, generate, copy or restore timetables and terms.

What the planner shows the teacher

  • One row per weekly slot of the chosen semester, with its first date.
  • Outcomes of the grade's template, grouped by curriculum term.
  • Planned versus covered counts per outcome.
  • “Mastered” is only allowed once the outcome is linked to an assessment.
Planning is kept when the timetable changes. Regenerating a timetable, copying it to another term or class (“Copy lesson planning too” is on by default), or restoring an older version keeps each lesson's outcome links and its delivery history. A lesson that stays in its slot keeps them; a lesson that moves takes them with it. Before you regenerate, the preview tells you how many links stay, move, or cannot be placed.
Drafts are labelled. The School Calendar shows lessons of draft timetables only to administrators and principals, dashed and marked Draft, with a “Hide drafts” switch. Students, guardians and teachers only see published timetables, so publish before telling families to check.

6. Assessments Administrator Teacher

Grading termsTerm 1 (40), Term 2 (60) with open/close dates
→
AssessmentType, class, subject, date, time
→
Enter marks0–100 per student and subject
→
Student sees itCalendar, then My results
TypeTypical useSample in Term 1
QuizShort check, in classArabic letters quiz, 12 Oct
Unit testEnd of a chapterArabic unit test, 5 Nov 09:30
AssignmentGraded homework that countsLetter practice, out of 20
ExamEnd of termTerm 1 exam, 15 Dec
  1. Open Assessment › Assessments and press Create assessment.
  2. Choose the type, grade, class, subject, date and time. The app warns if the class already has a lesson or another test at that time.
  3. Marks are entered on the same page. A mark is always stored on a 0–100 scale.
  4. Who may create assessments is a per-institution choice: administrators only, teachers may add items, or teachers may create everything. Set it on the institution's edit page under Teacher permissions.

Graded home assignment

In Homework › Create Homework, tick Graded assignment and enter Marked out of. Tick Count the mark toward results and give it a weight (default 10) if it should affect the subject average. Students see “Graded · out of 20” before handing in. A mark of 17 out of 20 enters results as 85.

7. How results are calculated

subject average = sum of (mark x weight of its grading term) ---------------------------------------- sum of (weight of its grading term)

Every mark counts with the weight of the term it belongs to. A graded home assignment counts with its own weight.

Worked example: Zainab, Arabic

MarkBelongs toMark (0–100)WeightMark × weight
Term 1 examTerm 170402,800
Term 2 examTerm 285605,100
Letter practice 17/20Graded assignment8510850
Total1108,750

Arabic average = 8,750 ÷ 110 = 79.55%

Term 1 · 36%Term 2 · 55%HW · 9%

All three subjects

SubjectTerm 1 (40)Term 2 (60)Homework (10)AverageResult
Arabic70858579.55Pass
Urdu6050—54.00Pass
Health4565—57.00Pass

Urdu: (60×40 + 50×60) ÷ 100 = 54. Health: (45×40 + 65×60) ÷ 100 = 57.

Two things to tell every new administrator. (1) If two tests are recorded in the same term, both count with that term's full weight, so that term's share of the average grows. (2) A subject with no marks is left out of the average unless the GPA policy says to count it as zero.

8. Setting up GPA Administrator

1GPA scaleBands with a range and points
→
2PolicyYear, grade, scale, weighting, decimals
→
3PreviewCheck numbers, nothing saved
→
4ComputeStores GPA per term and per year

Menu: Assessment › GPA Configuration

Step 1 — sample GPA scale

BandAverage from–toPoints
A80 – 1004.00
B70 – 79.993.00
C60 – 69.992.00
D50 – 59.991.00
F0 – 49.990.00

Bands must not overlap and must cover 0 to 100. A subject whose average falls in no band is reported as unmapped.

Step 2 — policy choices

ScopeOne year and grade, or “All”. The most specific policy wins.
WeightingEqual: every subject counts once. Credit: a subject counts by its lessons per week.
Decimals0 to 2
Unmarked subjectsLeave out (default) or count as 0 points
CumulativeNone, previous grading terms, or previous grades

No policy for a grade means no GPA is computed for it; the page says so.

GPA = sum of (subject points x subject weight) / sum of (subject weight)

Worked example: Zainab's GPA

SubjectAverageBandPointsLessons / weekPoints × lessons
Arabic79.55B3.00515.00
Urdu54.00D1.0033.00
Health57.00D1.0022.00
Total5.001020.00

Equal weighting: 5.00 ÷ 3 subjects = GPA 1.67  ·  Credit weighting: 20.00 ÷ 10 lessons = GPA 2.00

Same marks, different GPA. Decide the weighting once per grade and tell teachers which one applies.

9. Report cards

GeneratePer class, template and term
→
Homeroom commentTeacher adds remarks
→
Review & approvePrincipal checks, sends back or approves
→
ReleaseFinal; cannot be changed after
→
Student & guardianMy report cards

Menus: Report Cards › Generate Report Cards › Review & Approval Report Cards Dashboard

Students and guardians only ever see released cards. Regenerating never resets an approved or released card.

10. Teacher guide Teacher

Teachers do not change the setup, but they can see everything that affects their classes. Start here after signing in.

I want to see…Teacher menuWhat it shows
The curriculum and outcomes for my subjectTeaching › ProgramsOutcomes by curriculum term, with planned and covered counts
Which outcomes each lesson coversTeaching › Lesson PlanningLink outcomes to lessons: Introduced, Reinforced, Mastered
Tests scheduled for my classes, and mark entryTeaching › AssessmentsList, mark sheet, and a per-assessment report (averages, pass rate)
Homework and graded assignmentsTeaching › HomeworkCreate, see submissions, grade with a capped numeric mark
Each student's average and rankTeaching › My StudentsWeighted average per student and per subject
Report cards for my classTeaching › My Class Report CardsStatus, average, homeroom comment box
The GPA scale and policy page is for administrators only. Ask your administrator for three facts and keep them with this guide: the grading-term weights, the GPA bands, and whether weighting is equal or credit.

Calculating a student's result by hand — four steps

  1. Convert every mark to a percentage. 17 out of 20 is 85.
  2. Multiply each percentage by the weight of its grading term (or the assignment's own weight) and add them up.
  3. Divide by the sum of the weights you used. That is the subject average. 50 or more is a pass.
  4. For GPA: look up each subject average in the band table to get points, then average the points (equal) or weight them by lessons per week (credit).

Your hand result should match My Students. If it does not, check that a mark was not entered under the wrong grading term.

11. Coaching a student to pass Teacher Student

The most useful thing to tell a student is a number: what they need in what is left.

needed average in remaining work = (pass mark x total weight - sum of mark x weight so far) / remaining weight

Example: Health after Term 1

Term 1 mark 45 (weight 40). Term 2 (weight 60) still to come. Pass mark 50.

(50 × 100 − 45 × 40) ÷ 60 = 3,200 ÷ 60 = 53.3% needed in Term 2.

Zainab scored 65, so she finished on 57 and passed.

“What do I need?” calculator

Enter each mark as a percentage with its weight. Leave the mark empty for work not yet done.

ItemMark % (empty = not yet)Weight

What to say, by situation

Needed in remaining workMessage to the studentAction
Below 50%“You are on track. Keep your routine.”Aim for the next band; show the band table
50–70%“Passing is realistic with steady work.”Pick the two weakest outcomes in Programs and practise them weekly
70–100%“You need a strong finish.”Hand in every graded assignment (easy weight), agree a revision plan with the guardian
Above 100%“A pass is not reachable by marks alone.”Speak to the administrator early about a resit or extra graded work

Where the biggest gain is: the term with the highest weight. In the sample, one extra point in Term 2 is worth 1.5 times a point in Term 1. Graded assignments are small but certain: they reward effort, not exam nerves.

Students check progress under My results and My learning; guardians under Results in the parent portal. Use Messages to send the target number to the family.

12. Demo checklist (about 35 minutes)

#Sign in asShowSay
1AdministratorCurriculum OnboardingOne template per grade holds terms and outcomes
2AdministratorSubject Offerings, then TeachersSubjects to classes, teachers to subjects
3AdministratorAssessmentsGrading terms carry the weights; create one unit test
3aAdministratorAcademic Setup ChecklistWhat is ready, what is missing, and the next step
3bAdministratorTimetable BuilderAuto-generate from lessons per week (edit them in the dialog), check conflicts, publish
3cTeacherLesson PlanningLink an outcome to Monday's slot: Introduced
3dStudentMy timetableThe same lesson, dated, with teacher and room
4TeacherHomeworkGraded assignment, out of 20, counts toward results
5TeacherAssessments › mark sheetEnter two marks, open the report
6AdministratorGPA ConfigurationScale, policy, Preview, then Compute
7AdministratorGenerate → Review & ApprovalNothing reaches families until release
8StudentMy results, My report cardsSame numbers the teacher saw

Demo accounts for the sample institution are listed in docs/uat-seed-hidayatunnisa.md.