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