Home Modules Academic Reporting Administrator Guide
RPT-800

Academic Reporting — Administrator Configuration Guide

This guide walks your system administrator through the complete configuration of the Edupro SMS Academic Reporting module — from initial server setup to generating and emailing report cards at the end of every term.

Administrator Guide ZIMSEC O-Level ZIMSEC A-Level Cambridge Bulk Report Cards

1. System Overview

The Edupro SMS Academic Reporting module (RPT-800) provides end-to-end management of student academic records — from defining the academic year and grading scales through mark capture to bulk generation of professional PDF report cards.

The system is built into your school's local Edupro SMS server and works fully offline. Report cards can be printed on-site or emailed to parents once an internet connection is available.

ℹ About Edupro SMS Edupro SMS is Zimbabwe's school management platform combining student information, attendance, fees, communications, and academic reporting in one offline-capable system. The Academic Reporting module supports both ZIMSEC (O-Level and A-Level) and Cambridge International grading frameworks.

What This Guide Covers

  • Configuring your school's academic structure (year, terms, grading)
  • Setting up programs, courses, and ZIMSEC/Cambridge subject codes
  • Enrolling students into academic programmes
  • Capturing assessment marks (manual and bulk Excel import)
  • Generating, printing, and distributing report cards
  • User roles and who should do what
  • End-of-term checklist for zero-error report runs
⚠ Sample School Notice — Throughout this guide, the school name "Hillside Secondary School" is used for all examples and screenshots. This is a dummy/sample school name for illustration only. Replace it with your actual school name during setup.

2. Server Requirements

Edupro SMS runs on a local school server. The following minimum specifications are required for the Academic Reporting module to perform well:

ComponentMinimumRecommended
ProcessorIntel Core i3 / equivalentIntel Core i5 or better
RAM4 GB8 GB
Storage100 GB HDD256 GB SSD
Operating SystemUbuntu 20.04 LTSUbuntu 22.04 LTS
Network100 Mbps LAN switchGigabit LAN + Wi-Fi AP
ClientsAny modern browserChrome / Firefox latest
✓ Works Offline Once installed, the system does not require internet. Mark entry, report generation, and PDF printing all work on your local network. Internet is only needed for cloud backup (ZimHPC) and emailing reports to parents.

Supported Browsers

  • Google Chrome 90+
  • Mozilla Firefox 88+
  • Microsoft Edge 90+
  • Safari 14+ (Mac/iPad)

Internet Explorer is not supported. Staff computers should have Chrome or Firefox installed.

3. First Login & Education Settings

After your Edupro SMS server is installed and running, open a browser on any school computer and navigate to your server's local IP address (e.g., http://192.168.1.100 or the hostname your IT staff configured).

Logging In

  1. Open your browser and go to your Edupro SMS server address.
  2. Log in with the Administrator credentials provided by your Edupro SMS technician.
  3. You will see the main Edupro SMS desk with module icons.
📷

Screenshot: Edupro SMS login screen

Shows the login form with username and password fields on the Hillside Secondary School server.

Opening Education Settings

The first configuration step is to fill in your school's details in Education Settings.

📷

Screenshot: Education Settings form

The Education Settings page showing school name, address, logo, and contact fields filled in for the sample school.

FieldExample ValueRequired?
School NameHillside Secondary School sampleRequired
School AbbreviationHSSRequired
Address14 Hillside Drive, BulawayoOptional
Phone+263 29 2123456Optional
School LogoUpload .PNG file (transparent background recommended)Optional
Current Academic Year2025 (set after creating the year — see Section 4)Required
Current TermTerm 1Required
⚠ Important Set the Current Academic Year and Current Term correctly before any other configuration. Many downstream functions (mark entry, report generation) rely on these values being accurate.

4. Academic Year & Terms

Every set of report cards in Edupro SMS is tied to an Academic Year and a Term. You must create these before capturing any marks.

Creating an Academic Year

📷

Screenshot: New Academic Year form

Shows the Academic Year creation form with Year Name "2025", Start Date "01-01-2025", End Date "30-11-2025" filled in.

FieldExampleNotes
Academic Year Name2025Used as a label everywhere in the system
Year Start Date01-01-2025First school day of the year
Year End Date30-11-2025Last school day before year-end

Creating Terms

Zimbabwe schools run three terms per year. Create a Term record for each one.

📷

Screenshot: Academic Term list showing Term 1, Term 2, Term 3 for year 2025

The Academic Term list view with three rows: Term 1 (Jan–Apr), Term 2 (May–Aug), Term 3 (Sep–Nov).

TermTypical StartTypical End
Term 1 — 202514 January 202511 April 2025
Term 2 — 202506 May 202501 August 2025
Term 3 — 202526 August 202528 November 2025
✓ Tip After creating all three terms, go back to Education Settings and set the Current Academic Year and Current Term to the live term.

5. Grading Scale Configuration

Edupro SMS supports multiple grading scales. You must configure at least one grading scale matching your curriculum before entering marks.

Creating a Grading Scale

📷

Screenshot: ZIMSEC O-Level Grading Scale configuration

Shows the grading scale form with Grade Name "ZIMSEC O-Level", and rows for grades 1–9 with percentage thresholds.

ZIMSEC O-Level Standard Grading

GradeMinimum %Maximum %Description
180100Distinction
27079Merit
36069Credit
45059Credit
54049Pass
63039Pass
72029Fail
81019Fail
909Ungraded

ZIMSEC A-Level Standard Grading

GradeMinimum %Maximum %Description
A80100Excellent
B7079Very Good
C6069Good
D5059Satisfactory
E4049Pass
U039Ungraded
ℹ Cambridge Grading For Cambridge International schools, create a separate grading scale using the Cambridge A–G scale for IGCSE or A–E for AS/A2. You can create as many grading scales as needed and assign different ones to different programmes.
📷

Screenshot: Grading Scale list view

Shows the list of configured grading scales: "ZIMSEC O-Level", "ZIMSEC A-Level", "Primary (ECD–Grade 7)".

6. Programs & Courses

In Edupro SMS, a Program represents a study track (e.g., Form 1–4 ZIMSEC, Lower Sixth ZIMSEC A-Level). Courses are the individual subjects within that programme.

Creating a Program

📷

Screenshot: New Program form for "Form 3 – ZIMSEC O-Level"

Shows program name, department, and the courses table with subjects listed below.

Recommended Programs for a Typical Zimbabwe Secondary School

Program NameFormsGrading Scale
Form 1 — ZIMSECForm 1ZIMSEC O-Level
Form 2 — ZIMSECForm 2ZIMSEC O-Level
Form 3 — ZIMSECForm 3ZIMSEC O-Level
Form 4 — ZIMSECForm 4ZIMSEC O-Level
Lower Sixth — A-LevelForm 5ZIMSEC A-Level
Upper Sixth — A-LevelForm 6ZIMSEC A-Level

Creating Courses (Subjects)

Create one Course record per subject. Use the ZIMSEC or Cambridge subject code as the Course Code to maintain accuracy for external examination entries.

📷

Screenshot: New Course form for "Mathematics"

Shows Course Name "Mathematics", Course Code "4004", Department "Science and Mathematics", linked to the ZIMSEC O-Level grading scale.

7. ZIMSEC Subject Codes Reference

Use the official ZIMSEC syllabus codes when creating Course records. This ensures mark sheets and reports align with external examination records.

Common O-Level Subject Codes

SubjectZIMSEC Code
English Language2010
English Literature2011
Mathematics4004
Additional Mathematics4005
Combined Science5006
Physics5009
Chemistry5010
Biology5008
Geography2214
History2166
Commerce7103
Accounts7110
Business Studies7115
Agriculture5021
Food and Nutrition6028
Fashion and Fabrics6029
Shona3026
Ndebele3028
French3016
Religious and Moral Education2063
Computer Science4201
Physical Education6033

Common A-Level Subject Codes

SubjectZIMSEC Code
Mathematics9164
Further Mathematics9172
Physics9188
Chemistry9189
Biology9190
Geography9226
History9389
Accounts9706
Business Studies9707
Economics9708
English Literature9695
✓ Tip Always verify subject codes against the current ZIMSEC syllabus booklet for your examination year, as codes are occasionally updated.

8. Student Enrolment into Programmes

Before marks can be entered, students must be enrolled in their Programme for the current academic year. If you use the SIM-100 Student Information module, student records already exist — you only need to create the programme enrolment records.

Enrolling a Single Student

📷

Screenshot: Program Enrollment form

Shows a single student enrollment with student name, program "Form 3 – ZIMSEC", academic year "2025", term "Term 1", and enrollment date.

FieldValue
StudentSelect from the student list (type to search)
Programe.g., Form 3 — ZIMSEC
Academic Year2025
Academic TermTerm 1 — 2025
Enrollment DateFirst day of term

Bulk Enrolment (Recommended for New Year)

At the start of a new academic year, use the Student Group tool to enrol entire classes at once.

Create one Student Group per class (e.g., "Form 3A", "Form 3B"). Add all students in that class to the group, then link the group to the Programme. Edupro SMS will create individual enrolment records for every student in the group automatically.

📷

Screenshot: Student Group form for "Form 3A" showing student list

Shows the Student Group "Form 3A – 2025" with the Programme "Form 3 – ZIMSEC" linked, and the students table populated with 35 student names.

⚠ Check Before Mark Entry Run the Programme Enrolment report before opening mark sheets to confirm every student appears. Students not enrolled in a programme will not appear in mark entry forms.

9. Assessments & Mark Entry

Assessments are the building blocks of report cards. Each assessment (e.g., "Term 1 Continuous Assessment", "End of Term Examination") collects marks for one subject in one term.

Creating an Assessment

📷

Screenshot: New Assessment form for "Form 3A Mathematics — Term 1 Exam"

Shows assessment name, course (Mathematics), student group (Form 3A), academic year, term, maximum marks (100), and weightage fields filled in.

FieldExampleNotes
Assessment NameForm 3A Maths — T1 ExamUse a clear, consistent naming convention
CourseMathematics (4004)Linked to course record
Student GroupForm 3A — 2025Determines which students appear
Academic Year2025
Academic TermTerm 1 — 2025
Maximum Marks100Total marks available for this assessment
Weightage (%)100Contribution to overall subject grade
Grading ScaleZIMSEC O-LevelAuto-populates from course

Entering Marks

Once an Assessment is saved, open it and click "Enter Marks". A spreadsheet-style grid appears with all enrolled students.

📷

Screenshot: Mark entry grid for Form 3A Mathematics

Shows a table with student names in the left column and a "Marks Obtained" input column on the right. Several marks have been entered. The status bar at the bottom shows "28/35 marks entered".

  • Click any cell and type the mark. Press Tab or Enter to move to the next student.
  • Marks outside the valid range (0 – maximum marks) will be highlighted in red.
  • Absent students should be marked 0 or use the Absent checkbox if available.
  • Click Save frequently while entering marks.

Bulk Mark Import via Excel

For schools where teachers prefer to work in Excel before uploading, use the Import Marks button.

1Download the Template
From the Assessment record, click Download Template. A pre-formatted Excel file will download with student names and roll numbers pre-filled.
2Fill in Marks in Excel
Enter marks in the "Marks Obtained" column only. Do not change student names, IDs, or column headers.
3Upload the Completed File
Return to the Assessment record and click Import Marks → Upload File. Select the saved Excel file. The system will validate and load all marks.
4Review and Confirm
A preview shows all imported marks. Any rows with errors are highlighted. Correct errors and re-upload if needed, then click Confirm Import.
📷

Screenshot: Mark import preview showing validation results

Shows a table of imported marks with a green tick on valid rows and a red warning on one row where marks exceeded the maximum.

Assessment Plan (Multiple Assessments per Subject)

If a subject uses multiple components (e.g., Continuous Assessment 30% + End-of-Term Exam 70%), create a separate Assessment for each component and set the Weightage accordingly. Edupro SMS will automatically calculate the combined weighted mark for the report card.

📷

Screenshot: Assessment Plan showing two components for Mathematics

Shows "Continuous Assessment" (30%) and "End of Term Exam" (70%) listed under the Mathematics Assessment Plan for Form 3A, Term 1.

10. Generating Report Cards

Once all marks have been entered and saved, report cards can be generated for individual students, a whole class, or the entire school at once.

Generating by Student Group (Class)

📷

Screenshot: Report Card generation form

Shows the Report Card form with Academic Year "2025", Term "Term 1", Program "Form 3 – ZIMSEC", Student Group "Form 3A – 2025" selected, and the "Generate" button highlighted.

FieldValue
Academic Year2025
Academic TermTerm 1 — 2025
ProgramForm 3 — ZIMSEC
Student GroupForm 3A — 2025 (leave blank for all groups)
Report Card TemplateSelect the branded template for your school

Click "Generate Report Cards". The system will process all students and create individual report card records. This may take 30–60 seconds for large classes.

📷

Screenshot: Report Card list view after generation

Shows a list of 35 generated report cards for Form 3A, each with student name, total marks, class position, and status "Generated".

Class Position & Class Statistics

Edupro SMS automatically calculates:

  • Subject marks and grades — based on the grading scale attached to each course
  • Total marks / Overall percentage
  • Class position — rank within the student group
  • Aggregate / Points — for O-Level (best 8 subjects) and A-Level (best 3 subjects + General Paper)
  • Class average per subject — shown on each report card
  • Highest and lowest mark in class
📷

Screenshot: Preview of a generated report card for a student at Hillside Secondary School

Shows the formatted report card with school header, student details, subject table with marks/grades, class position "7/35", and total aggregate. School name shown as "Hillside Secondary School" — this is the sample school used for illustration only.

⚠ The school name "Hillside Secondary School" shown in the sample report card above is a dummy name for illustration. Your school's actual name and logo will appear on real report cards.

Teacher Comments

Class teachers can add a personalised comment to each report card before it is printed or emailed.

The Head of School / Principal remarks field is a separate text area that applies to all report cards for that term, or can be customised per student.

11. PDF Printing & Download

All report cards are rendered as PDF documents using your school's branded template. PDFs can be downloaded individually or in a single bulk ZIP archive.

Printing a Single Report Card

Open any Report Card record and click "Print / Download PDF". A PDF opens in a new browser tab, ready for printing or saving.

📷

Screenshot: Single report card PDF preview in browser

Shows the PDF report card in the browser print preview dialog, with the school logo at the top, student details, subject table, and signature lines at the bottom.

Bulk PDF Download (Whole Class or Year)

  1. Select the Academic Year, Term, and Student Group.
  2. Click "Bulk Download PDF".
  3. The system generates a ZIP file containing one PDF per student.
  4. Download and extract the ZIP. Each file is named with the student's name and roll number.
📷

Screenshot: Bulk PDF download progress bar

Shows a progress indicator "Generating 35 report cards… 24/35 complete" with a download button that becomes active when done.

Printing Tips

  • Use A4 paper, portrait orientation for standard ZIMSEC-style report cards.
  • Set browser print margins to None or Minimum for best results.
  • If the school logo appears blurry, re-upload a higher-resolution PNG (minimum 300 dpi, transparent background).
  • For double-sided printing, configure your printer to flip on the short edge.
✓ Tip — Save Ink The report card template has a "Black & White" mode option in Education Settings → Report Card Template. Use this for draft printing.

12. Emailing Report Cards to Parents

Edupro SMS can automatically email each student's PDF report card to their parent or guardian's email address on record in the student profile.

Prerequisites

  • SMTP email is configured in Edupro SMS (done by your technician during setup — uses your school's email account).
  • Parent/guardian email addresses are stored in student profiles under SIM-100.
  • Internet connectivity is available at the time of sending.

Sending Report Emails

📷

Screenshot: Email Report Cards dialog

Shows a dialog with subject line "Term 1 2025 Report Card — Hillside Secondary School", email body template, student group selector, and "Send to 35 parents" button.

  1. Select the Student Group to email.
  2. Review and edit the default email subject and body if needed.
  3. Click "Preview" to see a sample email for one student.
  4. Click "Send Report Cards" to start the batch send.
  5. A progress log shows each email as it is sent.
  6. Students whose parents have no email on file are flagged — their reports can be printed separately.
⚠ Email Limits If your school's email account has a daily sending limit (common on shared hosting), consider scheduling the send in batches (e.g., one class per day). Contact your IT administrator or Edupro SMS support if you need to increase limits.
📷

Screenshot: Email send log showing delivery status for each student

Shows a table with columns: Student Name, Parent Email, Status (Sent / Failed / No Email). 32 rows show "Sent", 2 show "No Email on file", 1 shows "Failed — invalid address".

13. Scheduled Automation

Edupro SMS includes a background job scheduler that can automate recurring tasks related to academic reporting.

Configuring Scheduled Jobs

📷

Screenshot: Scheduled Job Types list

Shows the list of scheduled jobs with their frequency (Daily, Weekly, Monthly) and last run time.

Useful Automated Jobs

JobFrequencyWhat It Does
Database BackupDaily (midnight)Creates a compressed backup of the entire Edupro SMS database and saves to the local backup folder and/or ZimHPC cloud.
Attendance SummaryWeeklyCalculates attendance percentages per student and updates the summary field used on report cards.
Marks ReminderWeekly (during term)Emails teachers who have open Assessments with no marks entered, reminding them to submit.
Report Card Email QueueOn demandProcesses the email sending queue for report cards — useful if a previous batch send was interrupted.
✓ ZimHPC Cloud Backup If your school subscribes to the ZimHPC cloud plan, configure the backup job to also sync to the ZimHPC servers at the University of Zimbabwe. This provides off-site disaster recovery for all student data.

14. Data Audit & Corrections

Before printing or distributing report cards, run the built-in data audit to catch common errors.

Running the Pre-Report Audit

📷

Screenshot: Report Card Audit results for Form 3A, Term 1 2025

Shows the audit results table with categories: Missing Marks (2 students), Students Not Enrolled (0), Marks Exceed Maximum (1 entry), Missing Subject Codes (0). Each row has a "Fix" action button.

Common Errors & Fixes

ErrorCauseFix
Missing marks for studentStudent was absent or teacher forgot to enter marksOpen the Assessment and enter 0 or actual marks
Student not on reportStudent not enrolled in the ProgrammeCreate a Programme Enrolment record for the student
Marks exceed maximumData entry errorCorrect the mark in the Assessment mark entry grid
Wrong class positionDuplicate marks or a subject with no marksEnsure all subjects have marks; regenerate report cards
Missing subject on reportCourse not linked to the ProgrammeAdd the course to the Programme under Setup

Correcting Marks After Report Generation

If you discover a mark error after report cards have been generated:

  1. Correct the mark in the Assessment record.
  2. Delete the affected Report Card record.
  3. Re-run Report Card generation for the affected student or student group.
  4. Re-download and reprint / re-email only the corrected report cards.
⚠ Version Control Keep a record of any corrections made after report cards were first distributed. The activity log in Edupro SMS stores all changes with timestamps.

15. User Roles & Permissions

Edupro SMS uses role-based access control. Only assign the minimum permissions each user needs to do their job.

Recommended Role Assignments

Staff MemberEdupro SMS RoleWhat They Can Do
School IT AdministratorSystem ManagerFull system access — settings, users, backups, all modules
Deputy Head / Examinations OfficerEducation ManagerCreate assessments, generate report cards, manage academic structure
Head of DepartmentInstructorCreate and manage assessments for their department, enter marks
Class Teacher / Subject TeacherInstructorEnter marks for their assigned assessments only
Secretary / Admin ClerkAcademics UserView reports, print and email report cards, view student lists
ParentGuardianView their child's report card and attendance via parent portal (if enabled)

Creating a User Account

📷

Screenshot: New User form with Role field set to "Instructor"

Shows the user creation form with fields for Full Name, Email, Role (set to Instructor), and the option to send a welcome email with login instructions.

ℹ Password Policy All Edupro SMS user passwords must be at least 8 characters and include a mix of letters and numbers. Users should change their password on first login.

Restricting Teachers to Their Own Classes

To prevent a teacher from viewing or editing marks for classes they do not teach:

  1. Assign the teacher the Instructor role.
  2. In the Assessment record, set the Instructor field to that teacher's name.
  3. The teacher will only see Assessments where they are listed as Instructor.

16. End-of-Term Checklist

Follow this checklist every term to ensure a smooth, error-free report card run.

  • Confirm Current Term is set correctly
    Go to Education Settings and verify the Academic Year and Current Term match the term you are closing. Incorrect term settings will cause marks to be attributed to the wrong period.
  • Verify all Student Groups are up to date
    Check that new students (mid-term admissions) have been added to their Student Group and enrolled in the correct Programme. Check that any students who left have been removed or marked inactive.
  • Confirm all Assessments are created
    Every subject for every class should have at least one Assessment record for this term. Run the Assessment audit report to identify any subjects with no assessment created.
  • All marks entered and saved
    Chase all outstanding marks from teachers. Run the Marks Missing report under Assessment Reports to identify gaps. No Assessment should show "0 marks entered" at this stage.
  • Run the Pre-Report Audit
    Go to Assessment → Report Card Audit. Resolve all errors before generating report cards. This step takes 5–10 minutes but prevents having to reprint cards.
  • Add teacher and principal remarks
    Class teachers enter individual student comments. The Head of School adds the term principal's remarks if using a standard message for all students.
  • Generate Report Cards
    Run report card generation for each Student Group. Spot-check 3–5 random report cards to verify marks, grades, class position, and layout are correct.
  • Bulk download and print
    Download the ZIP of PDFs for each class. Print on A4 paper. Get the Head of School to sign the master copy if required by policy.
  • Email report cards to parents (optional)
    Run the email batch for each class. Monitor the delivery log for failures. Print and hand-deliver reports for students whose parents have no email address.
  • Run database backup
    Trigger a manual backup after all reports are finalised and saved. Store a copy off-site (USB drive or ZimHPC cloud sync).
  • Archive the term and open the next term
    In Education Settings, update the Current Term to the next term. Do NOT delete the closed term — historical data must remain for future reference and Zimbabwe Schools Inspectorate audits.
📷

Screenshot: End-of-term summary dashboard showing completion status for each class

Shows a summary grid with one row per Student Group. Columns: Assessments Complete, Marks Complete, Report Cards Generated, PDFs Downloaded, Emails Sent — each with a green tick or red warning icon.

Support & Contacts

If you encounter any issues not covered in this guide, the Edupro SMS support team is available to help.

📧 Email Support

support@edupro.co.zw
Response within 1 business day. Include your school name, school code, and a description of the issue.

📱 WhatsApp & Phone

WhatsApp: +263 772 837 385
Phone: +263 788 111 611
Office hours: Mon–Fri, 8:00 AM – 5:00 PM CAT

✓ On-Site Training Available Edupro SMS offers on-site staff training through the TRN-1000 Capacity Building module. Training sessions cover mark entry workflows, report card generation, and system administration. Contact sales@edupro.co.zw to schedule a session.

Useful Links