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.
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
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:
| Component | Minimum | Recommended |
|---|---|---|
| Processor | Intel Core i3 / equivalent | Intel Core i5 or better |
| RAM | 4 GB | 8 GB |
| Storage | 100 GB HDD | 256 GB SSD |
| Operating System | Ubuntu 20.04 LTS | Ubuntu 22.04 LTS |
| Network | 100 Mbps LAN switch | Gigabit LAN + Wi-Fi AP |
| Clients | Any modern browser | Chrome / Firefox latest |
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
- Open your browser and go to your Edupro SMS server address.
- Log in with the Administrator credentials provided by your Edupro SMS technician.
- 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.
| Field | Example Value | Required? |
|---|---|---|
| School Name | Hillside Secondary School sample | Required |
| School Abbreviation | HSS | Required |
| Address | 14 Hillside Drive, Bulawayo | Optional |
| Phone | +263 29 2123456 | Optional |
| School Logo | Upload .PNG file (transparent background recommended) | Optional |
| Current Academic Year | 2025 (set after creating the year — see Section 4) | Required |
| Current Term | Term 1 | Required |
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.
| Field | Example | Notes |
|---|---|---|
| Academic Year Name | 2025 | Used as a label everywhere in the system |
| Year Start Date | 01-01-2025 | First school day of the year |
| Year End Date | 30-11-2025 | Last 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).
| Term | Typical Start | Typical End |
|---|---|---|
| Term 1 — 2025 | 14 January 2025 | 11 April 2025 |
| Term 2 — 2025 | 06 May 2025 | 01 August 2025 |
| Term 3 — 2025 | 26 August 2025 | 28 November 2025 |
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
| Grade | Minimum % | Maximum % | Description |
|---|---|---|---|
| 1 | 80 | 100 | Distinction |
| 2 | 70 | 79 | Merit |
| 3 | 60 | 69 | Credit |
| 4 | 50 | 59 | Credit |
| 5 | 40 | 49 | Pass |
| 6 | 30 | 39 | Pass |
| 7 | 20 | 29 | Fail |
| 8 | 10 | 19 | Fail |
| 9 | 0 | 9 | Ungraded |
ZIMSEC A-Level Standard Grading
| Grade | Minimum % | Maximum % | Description |
|---|---|---|---|
| A | 80 | 100 | Excellent |
| B | 70 | 79 | Very Good |
| C | 60 | 69 | Good |
| D | 50 | 59 | Satisfactory |
| E | 40 | 49 | Pass |
| U | 0 | 39 | Ungraded |
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 Name | Forms | Grading Scale |
|---|---|---|
| Form 1 — ZIMSEC | Form 1 | ZIMSEC O-Level |
| Form 2 — ZIMSEC | Form 2 | ZIMSEC O-Level |
| Form 3 — ZIMSEC | Form 3 | ZIMSEC O-Level |
| Form 4 — ZIMSEC | Form 4 | ZIMSEC O-Level |
| Lower Sixth — A-Level | Form 5 | ZIMSEC A-Level |
| Upper Sixth — A-Level | Form 6 | ZIMSEC 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
| Subject | ZIMSEC Code |
|---|---|
| English Language | 2010 |
| English Literature | 2011 |
| Mathematics | 4004 |
| Additional Mathematics | 4005 |
| Combined Science | 5006 |
| Physics | 5009 |
| Chemistry | 5010 |
| Biology | 5008 |
| Geography | 2214 |
| History | 2166 |
| Commerce | 7103 |
| Accounts | 7110 |
| Business Studies | 7115 |
| Agriculture | 5021 |
| Food and Nutrition | 6028 |
| Fashion and Fabrics | 6029 |
| Shona | 3026 |
| Ndebele | 3028 |
| French | 3016 |
| Religious and Moral Education | 2063 |
| Computer Science | 4201 |
| Physical Education | 6033 |
Common A-Level Subject Codes
| Subject | ZIMSEC Code |
|---|---|
| Mathematics | 9164 |
| Further Mathematics | 9172 |
| Physics | 9188 |
| Chemistry | 9189 |
| Biology | 9190 |
| Geography | 9226 |
| History | 9389 |
| Accounts | 9706 |
| Business Studies | 9707 |
| Economics | 9708 |
| English Literature | 9695 |
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.
| Field | Value |
|---|---|
| Student | Select from the student list (type to search) |
| Program | e.g., Form 3 — ZIMSEC |
| Academic Year | 2025 |
| Academic Term | Term 1 — 2025 |
| Enrollment Date | First 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.
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.
| Field | Example | Notes |
|---|---|---|
| Assessment Name | Form 3A Maths — T1 Exam | Use a clear, consistent naming convention |
| Course | Mathematics (4004) | Linked to course record |
| Student Group | Form 3A — 2025 | Determines which students appear |
| Academic Year | 2025 | |
| Academic Term | Term 1 — 2025 | |
| Maximum Marks | 100 | Total marks available for this assessment |
| Weightage (%) | 100 | Contribution to overall subject grade |
| Grading Scale | ZIMSEC O-Level | Auto-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
0or 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.
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.
| Field | Value |
|---|---|
| Academic Year | 2025 |
| Academic Term | Term 1 — 2025 |
| Program | Form 3 — ZIMSEC |
| Student Group | Form 3A — 2025 (leave blank for all groups) |
| Report Card Template | Select 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.
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)
- Select the Academic Year, Term, and Student Group.
- Click "Bulk Download PDF".
- The system generates a ZIP file containing one PDF per student.
- 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.
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.
- Select the Student Group to email.
- Review and edit the default email subject and body if needed.
- Click "Preview" to see a sample email for one student.
- Click "Send Report Cards" to start the batch send.
- A progress log shows each email as it is sent.
- Students whose parents have no email on file are flagged — their reports can be printed separately.
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
| Job | Frequency | What It Does |
|---|---|---|
| Database Backup | Daily (midnight) | Creates a compressed backup of the entire Edupro SMS database and saves to the local backup folder and/or ZimHPC cloud. |
| Attendance Summary | Weekly | Calculates attendance percentages per student and updates the summary field used on report cards. |
| Marks Reminder | Weekly (during term) | Emails teachers who have open Assessments with no marks entered, reminding them to submit. |
| Report Card Email Queue | On demand | Processes the email sending queue for report cards — useful if a previous batch send was interrupted. |
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
| Error | Cause | Fix |
|---|---|---|
| Missing marks for student | Student was absent or teacher forgot to enter marks | Open the Assessment and enter 0 or actual marks |
| Student not on report | Student not enrolled in the Programme | Create a Programme Enrolment record for the student |
| Marks exceed maximum | Data entry error | Correct the mark in the Assessment mark entry grid |
| Wrong class position | Duplicate marks or a subject with no marks | Ensure all subjects have marks; regenerate report cards |
| Missing subject on report | Course not linked to the Programme | Add the course to the Programme under Setup |
Correcting Marks After Report Generation
If you discover a mark error after report cards have been generated:
- Correct the mark in the Assessment record.
- Delete the affected Report Card record.
- Re-run Report Card generation for the affected student or student group.
- Re-download and reprint / re-email only the corrected report cards.
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 Member | Edupro SMS Role | What They Can Do |
|---|---|---|
| School IT Administrator | System Manager | Full system access — settings, users, backups, all modules |
| Deputy Head / Examinations Officer | Education Manager | Create assessments, generate report cards, manage academic structure |
| Head of Department | Instructor | Create and manage assessments for their department, enter marks |
| Class Teacher / Subject Teacher | Instructor | Enter marks for their assigned assessments only |
| Secretary / Admin Clerk | Academics User | View reports, print and email report cards, view student lists |
| Parent | Guardian | View 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.
Restricting Teachers to Their Own Classes
To prevent a teacher from viewing or editing marks for classes they do not teach:
- Assign the teacher the Instructor role.
- In the Assessment record, set the Instructor field to that teacher's name.
- 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 correctlyGo 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 dateCheck 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 createdEvery 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 savedChase 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 AuditGo 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 remarksClass 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 CardsRun 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 printDownload 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 backupTrigger 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 termIn 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.
support@edupro.co.zw
Response within 1 business day. Include your school name, school code, and a description of the issue.
WhatsApp: +263 772 837 385
Phone: +263 788 111 611
Office hours: Mon–Fri, 8:00 AM – 5:00 PM CAT