Higher Education Troubleshooting & Academic FAQ

1. Overview & Business Value#

This comprehensive operational guide details the architecture, business workflows, configuration parameters, and execution steps for Higher Education Troubleshooting & Academic FAQ within SmartERP.

Troubleshooting solutions for registration blocks, timetable collisions, grade calculation anomalies, and portal access issues.

{screenshot:troubleshooting-and-academic-faq-overview-dashboard}

2. Prerequisites & Security Access Groups#

• Required Modules: smarterp_higher_education, smarterp_student_records
• Security Groups:
  • Admissions Officer (Technical ID: smarterp_higher_ed.group_admissions_user)
  • Registrar / Academic Dean (Technical ID: smarterp_higher_ed.group_registrar_manager)
  • Faculty Member / Instructor (Technical ID: smarterp_higher_ed.group_faculty_user)
• Master Data Dependencies: Faculties, departments, ECTS modular curricula, academic semesters (Ethiopian/Gregorian calendar), tuition fee schedules, and student master files.

3. Step-by-Step Configuration & Execution#

Step 1: Navigating to the Module Interface#

1. Log into your SmartERP instance at https://smarterp.et/odoo.
2. Open the main App Switcher (grid icon in the top-left corner).
3. Select the Higher Education app icon.
4. From the top navigation bar, open Higher Education → Academic Registry → Students / Admissions / Courses / Grading.

{screenshot:troubleshooting-and-academic-faq-app-switcher-navigation}

Step 2: Creating and Parameterizing Records#

1. Click the New button in the top-left control panel.
2. Complete the mandatory fields in the record form:
   • Student ID Number (Mandatory): Unique institutional student registration identifier
   • Full Name & National ID (Mandatory): Legal name matching Ministry of Education (MoE) enrollment records
   • Academic Program & Faculty (Mandatory): Approved undergraduate or postgraduate modular program
   • Semester Term (Mandatory): Active academic term adhering to ETA curriculum guidelines
3. Configure optional operational parameters and localized tags as required:
   • Course Prerequisite Override (Optional): Authorized waiver for advanced module enrollment
   • Tuition Sponsorship (Optional): Cost-sharing agreement or private employer corporate sponsorship
   • Dormitory & Campus Facility (Optional): Assigned residential block and meal plan access
4. Click the Save icon in the control bar to commit the record.

{screenshot:troubleshooting-and-academic-faq-record-creation-form}

Step 3: Validating and Processing Transactions#

• State Transitions: Execute operational state progression (Applied → Admitted → Registered / Enrolled → Active Study → Grades Finalized → Graduated).
• Ledger & System Impact: Semester registration automatically generates student tuition invoices in Accounts Receivable; fee settlement via Telebirr/CBE Birr marks student financially cleared.
• Audit Verification: Automated recording of author ID, timestamp, and immutable revision history.

{screenshot:troubleshooting-and-academic-faq-transaction-processing-state}

Frequently Encountered Academic Issues#

1. Student Blocked from Registering for Advanced Course#

• Symptoms: Portal displays error: "Registration Denied: Missing Prerequisite COSC-1012".
• Root Cause: The student did not earn a passing grade in the prerequisite course, or the transfer credit from another institution was not formally mapped in the student master file.
• Resolution:
  1. Open the student's academic history tab.
  2. If the student completed the prerequisite at an accredited transfer university, record a formal Credit Transfer Exemption in Higher Education > Registration > Credit Transfer.
  3. If the course was failed, the student must re-register for the prerequisite course before advancing.

2. CGPA Displays Incorrect Value After Course Repeat#

• Symptoms: A student repeated a failed course (F replaced with A), but the CGPA still reflects the previous failing score.
• Root Cause: The repeat flag was not toggled on the new registration line, causing the GPA engine to calculate both attempts in the denominator.
• Resolution:
  1. Navigate to Higher Education > Assessment > Grade Corrections.
  2. Select the repeated registration record and verify the Is Course Repeat checkbox is active.
  3. Click Recalculate Cumulative CGPA. The system purges the previous grade points from the cumulative denominator and updates the official transcript.

3. Student Admit Card Blocked Due to "Tuition Hold" Despite Payment#

• Symptoms: The student settled fees via bank transfer, but the portal still displays "Admit Card Barred: Outstanding Balance".
• Root Cause: The digital bank webhook was delayed, or the payment was posted to general ledger without being reconciled against the specific student tuition invoice.
• Resolution:
  1. In Higher Education > Finance > Invoices, locate the student's pending invoice.
  2. Open the payments tab and match the bank transaction reference number.
  3. Click Reconcile Payment.
  4. Once the invoice transitions to Paid, the admit card download unlocks immediately on the student portal.

4. Advanced Configuration Points#

• Automated Actions & Scheduled Tasks (Crons):
  • Education: Compute semester GPA and cumulative CGPA (smarterp_higher_ed.ir_cron_cgpa_calc): Runs at the end of each examination period to compute student academic standing
  • Finance: Generate semester tuition fee invoices (smarterp_higher_ed.ir_cron_tuition_invoices): Runs prior to semester registration deadline
• Custom Print Templates & Reports:
  • Official Student Academic Transcript (MoE & ETA Standards)
  • Semester Course Registration & Clearance Slip
  • Student ID Card with Cryptographic QR Verification
  • Examination Results & Faculty Grade Distribution 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#