---
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](https://huggingface.co/spaces/Hamzavelous/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

```bash
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.

```bash
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`)