School management platform overview
Comprehensive 10-module academic suite for educational institutions: student records, admissions, attendance, grading, fee collections, parent portal, and AI Copilot.
1. Overview & Business Value#
This comprehensive operational guide details the architecture, business workflows, configuration parameters, and execution steps for School management platform overview within SmartERP.
SmartERP School Management is a comprehensive, multi-campus academic operating system designed for Ethiopian primary schools, secondary academies, and higher educational colleges. Built natively on Odoo 19 Community Edition with zero enterprise dependencies, it delivers 10 interconnected modules managing the entire student journey from initial enrollment application to graduation.
{screenshot:overview-overview-dashboard}
2. Prerequisites & Security Access Groups#
- Required Modules:
smarterp_school, smarterp_academic - Security Groups:
Teacher / Instructor(Technical ID:smarterp_school.group_school_teacher)Academic Registrar(Technical ID:smarterp_school.group_school_registrar)Principal / Headmaster(Technical ID:smarterp_school.group_school_manager)
- Master Data Dependencies: Academic grade levels (Primary, Middle, Secondary), curriculum syllabus, examination schedules, fee structures, and guardian records.
3. Step-by-Step Configuration & Execution#
Step 1: Navigating to the Module Interface#
- Log into your SmartERP instance at
https://smarterp.et/odoo. - Open the main App Switcher (grid icon in the top-left corner).
- Select the School Management app icon.
- From the top navigation bar, open School Management → Students / Classes / Attendance / Gradebook.
{screenshot:overview-app-switcher-navigation}
Step 2: Creating and Parameterizing Records#
- Click the New button in the top-left control panel.
- Complete the mandatory fields in the record form:
- Student Full Name (Mandatory): Legal name matching Ministry of Education student census
- Grade & Section (Mandatory): Assigned academic level and classroom division
- Guardian Emergency Contact (Mandatory): Primary parent/guardian phone number and address
- Academic Term / Year (Mandatory): Current academic operational calendar year
- Configure optional operational parameters and localized tags as required:
- Transportation Route (Optional): Designated school bus route and stop
- Extracurricular Activities (Optional): Student sports, clubs, and academic societies
- Medical Notes & Allergies (Optional): School nurse emergency health details
- Click the Save icon in the control bar to commit the record.
{screenshot:overview-record-creation-form}
Step 3: Validating and Processing Transactions#
- State Transitions: Execute operational state progression (Application → Enrolled → Active Student → Continuous Assessment → Final Assessment → Promoted / Graduated).
- Ledger & System Impact: Tuition fees create customer invoices in Accounts Receivable; fee receipts post to bank and cash clearing journals.
- Audit Verification: Automated recording of author ID, timestamp, and immutable revision history.
{screenshot:overview-transaction-processing-state}
Architectural modules#
| Module Technical Name | Display Name | Core Functionality |
|---|---|---|
smarterp_school_core | School Core | Multi-campus hierarchy, academic year/term lifecycles, configuration wizard, and RBAC. |
smarterp_school_student | Student Master | Authoritative student master, Fayda/Kebele national ID detection, multi-guardian authorization, and status history. |
smarterp_school_academic | Academics & Syllabi | Academic programs, grade levels, sections, subjects, classrooms, and teacher workload scheduling. |
smarterp_school_admission | Admissions & Intake | Online application portal, document verification, entrance examination rubrics, and automatic enrollment. |
smarterp_school_attendance | Attendance Tracking | Daily and subject-period attendance, biometric device integration, and automated parent SMS notifications. |
smarterp_school_assessment | Examinations & Grading | Continuous assessments, mid-terms, final exams, GPA computation, and ministerial report cards. |
smarterp_school_finance | Tuition & Fee Invoicing | Fee schedules, installment payment plans, CBE and Telebirr SuperApp integration, and scholarship waivers. |
smarterp_school_portal | Student & Parent Portal | Responsive self-service portal: timetable schedules, live grade books, attendance records, and online fee payments. |
smarterp_school_dashboard | Executive Cockpit | Campus-level enrollment trends, retention rates, pass/fail analytics, and revenue collection metrics. |
smarterp_school_ai | AI School Copilot | Gemini-powered academic assistant: student performance intervention flags, automated narrative progress reports, and 7 MCP tools. |
Key capabilities#
- Multi-Campus Hierarchy: Run multiple branches (e.g., Bole Campus, CMC Branch, Hawassa Campus) under a unified administrative umbrella with company and branch record isolation.
- Bilingual Amharic/English Transcripts: Issue official student transcripts and report cards in both English and Ge'ez Fidel script conforming to Ethiopian Ministry of Education requirements.
- Multi-Guardian Governance: Granularly designate guardians as Legal Custodian, Financial Sponsor, Emergency Contact, or Authorized Pickup Person, strictly isolating portal records.
- Automated Financial Reconciliation: Settle student tuition and laboratory fees via Telebirr or CBE direct bank transfer, automatically updating student ledger cards.
4. Advanced Configuration Points#
- Automated Actions & Scheduled Tasks (Crons):
School: Generate term grade report cards(smarterp_school.ir_cron_gradecards): Runs at the end of each term to compile student transcriptsSchool: Daily parent attendance notification via SMS(smarterp_school.ir_cron_attendance_sms): Runs daily at 09:30 to notify guardians of student absences
- Custom Print Templates & Reports:
- Official Student Report Card & Academic Transcript
- Classroom Daily Attendance Register
- Term Tuition Billing & Fee Collection Ledger
- Multi-Company Rules: Record-level security isolation under Company 1 (
Ashewa Technology Solutions S.C.), preventing cross-company ledger leakage across parent and subsidiary legal entities.
5. Comprehensive Troubleshooting Matrix#
| Error Symptom / Exception | Probable Root Cause | Corrective Action / Resolution |
|---|---|---|
Grading Error: Assessment marks exceed maximum possible score | Entered score is higher than configured assessment component maximum. | Correct score to fall within valid range (e.g. 0 to 20 for mid-term test). |
Section Assignment Error: Class capacity exceeded | Target section has reached maximum allowable classroom pupil ratio. | Allocate student to an alternative section or obtain Principal waiver. |
Financial Hold: Outstanding fee balance | Student examination entry card or portal view blocked by unpaid tuition. | Settle balance via Telebirr or cash cashier receipt. |