HerHaven – Girls Hostel Management System

HerHaven is a web-based girls hostel management system that helps students report complaints and enables wardens, supervisors, and maintenance staff to track, assign, and resolve issues efficiently.

Comment

Inspiration

Hostel issues such as plumbing problems, electrical faults, cleaning requests, and room maintenance are often communicated through calls, messages, or verbally. This can make it difficult to know whether a complaint has been assigned, is being worked on, or has actually been resolved.

This inspired us to build HerHaven – Girls Hostel Management System, a web-based platform that brings students, supervisors, maintenance staff, and administration into one organized system. Our goal was to make hostel complaint handling more transparent, trackable, and convenient for everyone.

What it does

HerHaven provides role-based access for four types of users:

  • Student – register complaints, track their status, view room information, and review completed complaints.
  • Supervisor / Warden – review complaints, assign maintenance staff, and monitor hostel operations.
  • Maintenance Staff – view assigned repair jobs, start work, and mark complaints as completed.
  • Administration – manage students, staff, rooms, hostel blocks, and complaint workflows.

The complaint lifecycle follows:

Pending → Assigned → In Progress → Completed → Closed

Each complaint remains in its current status section so that its progress can be tracked clearly.

The system also manages hostel blocks, rooms, student-room assignments, occupancy information, and real complaint records without relying on fake demo statistics.

How we built it

We built HerHaven as a responsive browser-based application using:

  • HTML for the application structure
  • CSS for the user interface, layout, and responsive design
  • JavaScript for application logic, role-based access, complaint management, room management, and state handling
  • Local Storage for the prototype data layer

The application was designed with a cloud-ready architecture in mind. The current prototype stores data locally, while a production version can use secure authentication, backend APIs, a cloud database, and cloud storage.

We also used Git and GitHub for version control and project publishing.

Challenges we ran into

One of the main challenges was designing a complaint workflow where each complaint appears only in its current status. We solved this by maintaining a single status for every complaint and updating that status as the work progresses.

Another challenge was connecting information across different roles. A complaint created by a student must become visible to the supervisor, then to the assigned maintenance staff, and finally return to the student's complaint history after completion.

Managing room occupancy was another important challenge. We wanted to avoid creating misleading statistics, so occupancy is based on actual student-room assignments and missing data is displayed as 0 or an empty state.

We also faced practical challenges while publishing the project to GitHub, including authentication, branch synchronization, and resolving a README merge conflict.

Accomplishments that we're proud of

We are proud of creating a complete role-based hostel management prototype rather than only a complaint form.

Some of our key accomplishments are:

  • Built separate interfaces for students, supervisors, maintenance staff, and administration.
  • Implemented a complete complaint lifecycle from Pending to Closed.
  • Connected complaints with students, rooms, locations, priorities, and assigned staff.
  • Added hostel block and room management.
  • Created a responsive and consistent interface across different roles.
  • Designed the application so it can be extended into a cloud-based production system.
  • Successfully published the project using GitHub and documented the architecture.

What we learned

This project taught us that building a real-world application involves much more than designing screens.

We learned how to:

  • Design role-based interfaces and workflows.
  • Manage application state using JavaScript.
  • Store and retrieve structured data using Local Storage.
  • Connect related entities such as students, rooms, complaints, supervisors, and maintenance staff.
  • Design a complete complaint lifecycle.
  • Create responsive and user-friendly interfaces.
  • Think about cloud-ready architecture for future deployment.
  • Use Git and GitHub for version control and collaboration.

Most importantly, we learned how to translate a real-world hostel problem into a structured software solution.

What's next for HerHaven – Girls Hostel Management System

HerHaven is currently a browser-based prototype, but it can be expanded into a complete production system.

Our future plans include:

  • Secure login and authentication
  • Cloud database integration
  • Backend API and server-side authorization
  • Real-time complaint notifications
  • Email and SMS alerts
  • Image attachments for complaints
  • Advanced analytics and reports
  • Mobile application support
  • Maintenance performance tracking
  • Cloud storage for documents and images
  • Automated complaint prioritization

Our long-term vision is to make HerHaven a reliable digital platform that improves hostel operations, reduces communication gaps, and ensures that every complaint receives proper attention.

HerHaven — Report. Track. Resolve. Stay Safe.

Built With

Share this project:

Updates

Submission history