Hostel & Mess Management

Manage hostel infrastructure, student allocations, attendance, mess plans, visitor logs, and maintenance complaints.

Tab 1: Setup — Hostel Infrastructure

Create the physical hostel hierarchy before allocating students:

1. Navigate to Hostel in the sidebar.
2. Click "Add Hostel" to create a hostel (e.g., "Boys Hostel").
3. Inside a hostel, create Blocks (e.g., "Block A", "Block B").
4. Inside a block, create Rooms with a room number and capacity.
5. Inside a room, create Beds with a bed number.

The full hierarchy is: Hostel → Block → Room → Bed

Tab 2: Allocations

Assign students to available hostel beds:

1. Switch to the "Allocations" tab.
2. Click "Allocate Student".
3. Search for a student by typing their name — results load dynamically (search-as-you-type with debounce).
4. Select the Hostel → Block → Room → Bed from cascading dropdowns.
5. Click Allocate.

You can also Vacate a student (frees the bed) or Transfer them to a different bed.

Tab 3: Attendance

Hostel attendance is separate from academic attendance and supports two sessions:

• Morning Roll Call — Verify students are present before the school day
• Night Roll Call — Verify students are in their rooms at curfew

1. Select the Hostel and Date.
2. Choose the Session (Morning / Night).
3. Mark each student as Present, Absent, or Leave.
4. Click "Save Attendance".

Tab 4: Visitors

Log external visitors coming to meet hostel residents:

1. Click "Register Visitor".
2. Search for the hostel student being visited.
3. Enter the visitor's Name, Relation, Phone, and Purpose.
4. Click Register. A printable Gate Pass is generated automatically.
5. When the visitor leaves, click "Checkout" to log the exit time.

Tab 5: Complaints

Students can raise maintenance and hostel-related complaints:

• Students submit complaints from their Hostel portal page with a title and description.
• Complaints appear in the admin's Complaints tab with a status workflow:

Status	Meaning
Open	Newly submitted by student
In Progress	Admin has acknowledged and is working on it
Resolved	Issue has been fixed
Closed	Complaint closed after resolution

Tab 6: Mess

Manage the hostel dining facility:

• Meal Plans — Define daily plans with meal type (Breakfast / Lunch / Dinner), items, and dietary tags (Vegetarian, Non-Vegetarian, Vegan, etc.).
• Mess Enrollments — Enroll hostel students into the mess program.
• Menu Visibility — Plans are displayed on the Student/Parent hostel portal for easy reference.

Dashboard KPIs

The School Admin Dashboard shows three hostel-specific stat cards:

• Hostel Occupancy — Total beds and occupancy percentage
• Open Complaints — Number of unresolved hostel complaints
• Today's Visitors — Number of visitors registered today

Student/Parent Hostel Portal

Students and Parents have a dedicated Hostel tab in their portal showing:

• Room allocation details (hostel, block, room, bed)
• Mess menu for the current week
• Hostel attendance history
• Complaint submission and tracking
• Visitor log (who visited and when)