Skip to content

terryekoe/qolabb

Repository files navigation

🌐 Qolabb — Encouraging Fair and Engaging Teamwork in Student Projects

📖 Overview

Qolabb is a web application designed to promote equitable participation and collaboration among students working on group assignments or projects.
It helps teams stay transparent, accountable, and motivated through data-driven participation insights.

By combining simple data analytics with an intuitive user experience, Qolabb allows both students and instructors to track contributions, visualize engagement, and encourage fair teamwork — ensuring every member plays their part.


🎯 Project Objective

Teamwork is a core part of learning, but in most student projects, participation is uneven.
Some members take on most of the work while others contribute very little.
Qolabb aims to solve this by:

  • Monitoring participation across group projects.
  • Providing transparent analytics for teams and supervisors.
  • Encouraging healthy collaboration and accountability.
  • Reducing frustration and improving project outcomes.

🧩 Features (Planned and Completed)

Feature Description Status
👥 Team Management Create, join, and manage project teams. ⏳ In Progress
📝 Task Logging Record member activities and project updates. ⏳ Planned
📊 Participation Dashboard Visualize each member’s contributions and engagement levels. ⏳ Planned
⚖️ Collaboration Analytics Compute fairness metrics and engagement ratios. ⏳ Planned
🔔 Feedback & Motivation Provide insights to help improve group dynamics. ⏳ Planned

🧠 Why Data Science?

Qolabb uses data science to transform raw participation logs into actionable insights.
With basic data analysis and visualization, the system can:

  • Quantify individual participation.
  • Detect imbalances in teamwork.
  • Highlight engagement trends over time.
  • Support data-informed feedback for fairer grading and teamwork improvement.

This connects human behavior with data-driven learning, helping educators and students make better collaboration decisions.


🧱 Project Structure

Qolabb/
│
├── 0_domain_study/          # Research on teamwork, collaboration, and participation
│   └── README.md
│
├── 1_data_collection/       # Scripts or tools for capturing participation data
│
├── 2_data_analysis/         # Notebooks or scripts for cleaning and analyzing data
│
├── 3_app_development/       # Frontend and backend code for the web application
│
├── assets/                  # Images, logos, screenshots
│
└── README.md                # (This file)

⚙️ Tech Stack

  • Frontend: React (Next.js)
  • Backend / Database: Supabase
  • Data Analysis: Python (Pandas, Matplotlib)
  • Version Control: Git + GitHub
  • Deployment (optional): Vercel

🚀 Getting Started

1️⃣ Clone the Repository

git clone https://github.com/<your-username>/qolabb.git
cd qolabb

2️⃣ Install Dependencies If using Node.js:

Copy code

npm install

3️⃣ Run the App Copy code

npm run dev

4️⃣ View Locally

Open your browser at http://localhost:5173 (or as shown in your terminal).

📊 Example Use Case

Imagine a 4-member student project team:

Each member logs their completed tasks.

Qolabb tracks participation and visualizes contributions.

The dashboard highlights any imbalance, helping the team self-correct.

Educators can use the summary view for fairer assessment.

🔍 Research Background

For detailed context and literature supporting this project’s design, see 👉 /0_domain_study/README.md

🧠 Future Improvements

  • Automatic participation tracking from GitHub or Google Docs.

  • Machine learning models to predict under-contributing teams.

  • Integration with LMS systems (Moodle, Google Classroom).

  • Peer evaluation tools integrated with analytics dashboards.

👥 Contributors

Terry Ekoe Aziaba — Project Lead / Developer / Researcher

📜 License

This project is open source under the MIT License. You’re free to use, adapt, and share it with attribution.

“Collaboration is the engine of learning and data is its fuel.” —--

About

Encourage and measure participation in group projects/assignment

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors