metadata
title: Hostel Management System
emoji: 🏠
colorFrom: indigo
colorTo: purple
sdk: docker
app_port: 7860
pinned: false
license: mit
short_description: Hostel MS with admin/student portals & C PDC benchmarks
🏠 Hostel Management System
Parallel & Distributed Computing Lab Project
University of Central Punjab (UCP) · BSAI
Authors: Ch Hamza Younas (L1F23BAI0089) · Muhammad Abdullah (L1F23BSAI0063)
Instructor: Ma'am Khadija
A modern Streamlit web application for complete hostel operations — with real OpenMP and POSIX Threads performance benchmarks compiled in C.
🔗 Live App: Hostel-Management_System
🔐 Demo Logins
| Role | Credentials |
|---|---|
| Admin / Warden | admin / admin123 |
| Student | UCP-BSAI-1001 / student123 |
✨ Features
Admin Portal
- 📊 Live Dashboard — KPIs, charts, activity feed & room grid
- 🛏️ Room Management — add, view, delete, CSV export
- 🎓 Student Management — enroll, search, assign rooms
- 💰 Fee & Finance — challans, payments, defaulters, history
- 🍽️ Mess & Complaints — weekly menu, ticket tracking, announcements
- 🚪 Gate & Attendance — IN/OUT logs, bulk roll call
- 📊 Analytics Hub — rent collection, floor occupancy
- 📁 Reports — JSON/CSV export, reset demo data
- ⚡ PDC Benchmark — Sequential, OpenMP, POSIX Threads (C)
Student Portal
- Profile, fees, complaints, mess menu, announcements
- 🕐 My Activity — personal gate logs & attendance history
- ⚡ PDC performance test access
⚡ PDC Performance Test
| Method | Workers | Engine |
|---|---|---|
| Sequential | 1 | Single-threaded C loop |
| OpenMP | 2 / 4 | #pragma omp parallel for |
| POSIX Threads | 4 | pthread_create() workers |
True parallel speedup — not Python GIL-limited threads.
🚀 Run Locally
pip install -r requirements.txt
cd c_backend
gcc -O2 -fopenmp -pthread search_bench.c hostel_mock_data.c -o search_bench -lm
cd ..
streamlit run app.py
🐳 Docker (Hugging Face Spaces)
This Space uses the Docker SDK on port 7860. The Dockerfile compiles the C benchmark automatically.
docker build -t hostel-ms .
docker run -p 7860:7860 hostel-ms
🛠️ Tech Stack
- Frontend: Streamlit, Plotly, custom dark indigo theme
- Backend logic: Python session state + C benchmark binary
- Parallel C: OpenMP (
-fopenmp) + POSIX Threads (-pthread)