Assessments, exams and report cards
From planning the term's tests to a released report card in the family's portal. Plan your term's assessments below: the guide checks dates and clashes before you create anything in the app. How a result is calculated is explained in the Academic Setup guide.
The big picture
Plan this term's assessments
Assessments ()
1. Result rules Admin
- In Edit institution › Operations › Result rules: the pass mark ( %), the mastery threshold for outcomes, and the weight of each grading term in the final result.
- Same page › Teacher permissions: who may create assessments — administrators only (default), teachers may add items, or teachers may create full assessments for their own classes and subjects.
- GPA scale and policy: GPA Configuration (details in the Academic guide).
- Teachers read the same rules, with a “what does a student need” calculator, in How results are calculated.
2. Create the assessments
- Assessments (Tests) › Create assessment: type, class, subject, date and time.
- A test of one class in one subject has a Scores button: its sheet holds the chapters it covers (only chapters already taught), what the scores are out of, and whether it counts toward the final result. The full flow is in the Teaching guide.
- Two assessments for the same class at the same time are refused. If a lesson is timetabled at that time you are warned and can choose Create anyway.
- Pick the outcomes the test covers. If an outcome has not been taught yet in that class, the app says so; you can still go ahead with “Assess anyway” and a reason, which is recorded and visible to staff.
- Scheduled tests appear on the School Calendar and on each student's timetable, and students get a reminder the day before.
3. Enter marks Teacher
- Test of one class and subject: Assessments (Tests) › Scores. Scores can be typed from the day of the test, saved as a draft that only staff see, then published to students, parents and the report. A change after publishing needs a reason and is logged (details).
- Grade-wide exam with several subjects: in Assessments select the assessment and class; the mark sheet lists the teacher's own students.
- Per-assessment report (average, pass rate, distribution, per-subject table): open the assessment.
- Students see their marks in Evaluations & notes, parents in Ratings & grades, each with which outcomes the test covered and when they were taught.
4. Formal examinations (optional)
For external or centrally run exams with centres, candidates and invigilators.
- New Examination Wizard, then centres in Exam Centres and timetabled papers in Exam Sittings.
- Invigilators accept or decline their duties in My Invigilation.
- Results are entered on Examinations.
5. Generate report cards
- Once: templates and grading scales in Report Cards › Config.
- Generate: school year, term (), grade or class, template. Each term has its own card, so Term 2 never overwrites Term 1.
- Generating again refreshes draft cards only; approved and released cards are never touched.
6. Comments and review
- Homeroom teachers write their comment per student in My Class Report Cards until the card is released.
- The principal reads each card, adds the principal's comment and approves (or sends back) in Review & Approval, filtered by year, term, class and status.
- Check the class average and the students below the pass mark before approving; a released card cannot be changed.
- Releasing locks the marks. From the moment a card is released, a teacher of that class can no longer change
that term's scores (
REPORT_CARD_RELEASED); an administrator or principal can, with a reason, and the change is written to the audit log and notified. Make sure the scores are final before you release.
7. Release
- Release the approved cards of a class or grade; the confirmation shows how many will be published.
- Students see them in My report cards, parents in Newsletters (report cards), each with a PDF to download.
- All terms and years together: Transcripts.
- Next: year-end promotion (Lifecycle guide).
8. Final exam rules and promotion (results policy)
Administrator or principal, once per year and grade, before the final exams. Teachers only read it.
- Open Promotion Rules, choose the university, school year and grade. On Pass mark and combining set the pass mark and how many subjects may be failed. Choose Every published mark of the year to calculate exactly like the report card.
- On Subject marks, tick Weight by kind of work for a subject to decide how much each kind counts, e.g. Quiz 10 %, Unit test 30 % and the final exam 60 % (each line totals 100 %). Add your own kinds there (Oral, Project …). A kind with no mark yet has its share spread over the others until one is marked.
- On Final exam, choose for each subject who sits the final exam: Every student, Exempt when conditions are met (minimum year average, every year test marked), No final exam, or Same as the university default. Set the exam weight. Each line is written back as a sentence — read it.
- Exemption can also ask for attendance at least __ % (from the class register) and the teacher's recommendation. Teachers then record "Recommend exemption / Recommend the exam" per student on How results are calculated; the recommendation is binding. A principal or administrator can still exempt a student or require the exam by hand on the same page, with a reason kept in the audit log (not for subjects every student must sit).
- On Promotion, tick the subjects that must be passed (never covered by the failed-subject allowance), give a subject its own passing mark if needed, and choose what happens with one failed subject too many: supplementary exam (default), repeat the grade, or the committee decides. Two or more too many, or an overall average below the pass mark, always means repeating the grade.
- A supplementary exam is an assessment of the kind Supplementary: its mark replaces the subject mark, at most up to the passing mark. Failing it means repeating the grade.
- Switch This rule is for to All grades to set the university default once; a grade only needs its own rule where it differs.
- Press Save draft. Nothing changes for students yet.
- Open Preview and publish: compare the outcome counts with today, check the students whose result changes, and press Explain on a few of them. Under the explanation, Try it lets you type another year-work, exam or supplementary mark and see what the rule would decide (nothing is saved). When it reads right, add a note and Publish this rule.
- Once the year-result report cards are released (or students promoted), the rule is locked for that school year: you can still save and preview a draft, but publish the change in next year's rule.
- On the same tab choose the Report card that shows the year result (e.g. Term 2). That card prints the year work and final exams combined, with a Final exam column (Exam taken / Exempted / Not required / Pending), and it cannot be released while a required exam is still unmarked. The other terms' cards keep their term marks.
- Create the final exams with the kind Exam — only marks of that kind count as the final exam. On an exam's score sheet, exempt students are greyed out and need no score.
- Students and parents see their own final-exam status (who sits which exam, conditions met, must-pass subjects) on their results page, and the year-end decision once the principal has confirmed it (with its conditions).
- The year-result report card marks must-pass subjects with *, shows a subject's own pass mark, and prints the outcome and
the confirmed decision. A UAT script for the whole policy is in
docs/results-promotion-policy-uat.md. - For the final year of a programme (e.g. ALIMGY5 of Moulana), Promotion proposes Completes the programme instead of a next class and offers Print level results: one page per student with every year in the programme, the final-year subjects and signature lines.
- Teachers see the rule and who sits each exam in How results are calculated; the promotion screen (Promotion) shows Waiting for exams until every required exam is marked.
- On Promotion, each student is pre-set to the rule's proposal: Promote, Promote with conditions, Supplementary exam, Repeat the grade or Committee decides. Choosing something else asks for a reason (kept in the audit log); Promote with conditions asks for the conditions. Supplementary exam and Committee decides are recorded without moving the student — come back after the exam or the committee and take the final decision.
Fixed rules: “Every student” beats any exemption; a student absent from a required exam is pending, never
exempt; an exempt student keeps the year-work mark. Full guide: docs/results-promotion-policy-plan.md.
Report card statuses
Only administrators and principals change a card's status. Students, parents and teachers can never approve or release.
Troubleshooting
| Problem | Why / fix |
|---|---|
| A teacher cannot create an assessment | The institution allows administrators only: change Teacher permissions, or create it for them. |
| A new assessment is refused because of a clash | Same class, same date, overlapping times: move one. |
| The mark sheet is empty | The teacher does not teach that class and subject, or no student is placed in the class. |
| A report card shows no average | No marks for that term yet, or the marks belong to another term. |
| A released card has an error | Released cards are final; correct the marks and issue the next term's card, or ask the platform administrator. |