Assessor HMS
A hostel management system that replaces manual register-keeping with structured resident records, room occupancy tracking, and payment workflows.
The Problem
Hostel managers were running operations on paper registers and WhatsApp messages β no single place to answer who is in which room, what they owe, or which beds are actually free. Partial payments, refunds, and room transfers were tracked manually and frequently inconsistent.
What We Built
A full-stack platform built around two core concepts: the Resident (a person who may stay multiple times) and the Stay (a single occupancy tied to a room, dates, and payment state). Administrators manage allocations, payments, and refunds through a Django admin portal. Room status transitions automatically on check-in and checkout. Residents receive email notifications at key points via Brevo.
Key Features
- Resident & Stay separation β Returning residents keep their profile and history across multiple stays β no duplicate records.
- Room state machine β Rooms move through Available, Occupied, Maintenance, and Reserved automatically β no manual updates.
- Partial payment tracking β Running balance against total due per stay, so outstanding amounts are always clear.
- Refund workflow β Admin-approved refund requests with a full audit trail before any funds are marked returned.
- Email notifications β Automated booking, payment, and checkout emails via Brevo HTTP API.
Status
Deployed and in active use. Backend on Render, frontend on Vercel. Replaced manual register-keeping for the property it was built for.
