Dormitory & Hostel Accommodation Management

1. Overview & Business Value#

This comprehensive operational guide details the architecture, business workflows, configuration parameters, and execution steps for Dormitory & Hostel Accommodation Management within SmartERP.

Manage campus student housing, room allocations, bed inventories, resident warden checks, and disciplinary clearance.

{screenshot:dormitory-and-hostel-accommodation-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:dormitory-and-hostel-accommodation-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:dormitory-and-hostel-accommodation-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:dormitory-and-hostel-accommodation-transaction-processing-state}

Campus Housing Facility Hierarchy#

SmartERP structures campus residential facilities systematically:

$$\text{Campus Housing} \longrightarrow \text{Hostel Blocks} \longrightarrow \text{Floors} \longrightarrow \text{Dorm Rooms} \longrightarrow \text{Bed Units}$$

Housing policies enforce segregation by gender, academic cohort (freshman vs graduating seniors), and specialized medical needs.

Allocating Rooms to Incoming Freshmen#

1. Open Higher Education > Campus Life > Dormitory Allocation.
2. Select Academic Year and Cohort (e.g., Freshman Batch 2026/2027).
3. Click Auto-Allocate Dormitory Beds:
   • The allocation algorithm groups students by department and regional diversity while honoring disability accommodation requests on ground floors.
4. Review generated bed distribution; resolve manual exceptions.
5. Click Publish Housing Roster.

Student Check-In & Room Inventory Handover#

1. When the student arrives at the assigned hostel block:
   • The resident warden verifies the student ID and housing permit.
2. Complete digital Room Property Checklist:
   • Condition of bed frame, mattress, study desk, chair, wardrobe, and window glass.
   • Student digitally signs the property condition form on the warden's tablet.
3. The warden issues room keys and locks the bed status to Occupied.

Resident Disciplinary Records & Exit Clearance#

At the end of the academic year or upon graduation:

1. The warden inspects the room against the initial inventory checklist.
2. Any damaged institutional property is billed to the student's financial account.
3. The warden clicks Approve Dormitory Clearance, releasing the student's hold on graduation transcripts.

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#