HOIISP

Habib Open Innovation & Independent Study Platform

Repository: https://github.com/BasilSaeedBari/HOIISP
Approved: 2026-05-11 07:48:28
Last Push: 2026-05-11T09:13:37Z

The Habib Open Innovation & Independent Study Platform (HOIISP) is a centralized discovery engine designed to showcase, track, and manage student-led engineering and computer science projects at Habib University. Inspired by the need to bridge the gap between academic research, independent studies, and collaborative innovation, HOIISP provides a unified directory where students, faculty, and administrators can discover active projects and monitor milestones. Version 3 of HOIISP represents a paradigm shift from the platform's original monolithic file-hosting architecture to a read-only, GitHub-centric discovery engine. Previous iterations of the platform (V1 and V2) suffered from excessive storage costs, complex user authentication systems, and high maintenance overhead due to built-in file editing and uploads. HOIISP V3 addresses these issues by treating student-owned GitHub repositories as the single source of truth. By utilizing a zero-storage policy, automated repository parsing via AST markdown extraction, and real-time Server-Sent Events (SSE) for leaderboards, this project delivers a highly scalable, frictionless experience. The successful outcome of this project is a fully deployed FastAPI-based backend capable of validating Habib University affiliations via commit history, parsing structured project.md files, and automatically provisioning project directory pages without requiring students to manage separate accounts on the platform.

Historically, student projects at Habib University existed in silos. There was no centralized platform to showcase independent studies, track hardware resource allocations, or allow faculty to discover innovative work being done across departments. This lack of visibility hindered cross-disciplinary collaboration and made it difficult for administrators to manage lab equipment efficiently. HOIISP was originally created to solve this by providing a unified, transparent project directory for the university. However, as the platform evolved, the existing HOIISP V2 architecture became structurally flawed, burdened by its dependency on local file uploads, custom user authentication, and in-platform markdown editors. These features not only duplicate existing capabilities provided by industry-standard tools like GitHub but also create a maintenance nightmare and unnecessary liability regarding data retention. Consequently, the platform became difficult to deploy, costly to host, and created friction for engineering and computer science students who already utilize Git for their projects. There is a critical need to decouple the platform from data hosting and reimplement it as a purely read-only discovery layer that aggregates, parses, and beautifully presents project data directly from student-managed GitHub repositories.