{"id":26056093,"url":"https://github.com/khaledkamr/muster","last_synced_at":"2026-04-21T06:33:51.458Z","repository":{"id":280422687,"uuid":"941696435","full_name":"khaledkamr/Muster","owner":"khaledkamr","description":"A web-based platform designed to centralize and visualize academic data (attendance, grades, assignments) with dashboards for professors, students, and parents. with AI-driven insights including predictive analytics, clustering, and course recommendations.","archived":false,"fork":false,"pushed_at":"2025-08-09T14:57:19.000Z","size":13491,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-09T16:32:16.041Z","etag":null,"topics":["blade","bootstrap","css","javascript","laravel11","mysql","php"],"latest_commit_sha":null,"homepage":"","language":"Blade","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/khaledkamr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-03-02T22:00:43.000Z","updated_at":"2025-08-09T14:57:23.000Z","dependencies_parsed_at":"2025-03-03T11:23:06.751Z","dependency_job_id":"bcf672af-f5bf-4ad3-bc09-168eba505856","html_url":"https://github.com/khaledkamr/Muster","commit_stats":null,"previous_names":["khaledkamr/muster"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/khaledkamr/Muster","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khaledkamr%2FMuster","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khaledkamr%2FMuster/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khaledkamr%2FMuster/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khaledkamr%2FMuster/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/khaledkamr","download_url":"https://codeload.github.com/khaledkamr/Muster/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khaledkamr%2FMuster/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32080429,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-21T06:27:27.065Z","status":"ssl_error","status_checked_at":"2026-04-21T06:27:21.250Z","response_time":128,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blade","bootstrap","css","javascript","laravel11","mysql","php"],"created_at":"2025-03-08T10:29:04.760Z","updated_at":"2026-04-21T06:33:51.453Z","avatar_url":"https://github.com/khaledkamr.png","language":"Blade","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Muster: University Dashboard System with AI-Driven Analytics\n\n## Overview\n\n**Muster** is a web-based university dashboard developed as a graduation project at **Misr University for Science and Technology**. It enhances educational decision-making by integrating academic data with AI-powered insights through customized interfaces for **professors**, **admins**, **students**, and **parents**.\n\nThe system provides visualizations and predictive analytics on grades, attendance, assignments, and course data, leveraging cutting-edge AI techniques such as:\n\n-  **Logistic Regression**: Predicts student dropout risk  \n-  **LSTM-based RNN**: Forecasts future GPA  \n-  **K-Means Clustering**: Categorizes student performance  \n-  **Content-Based Filtering**: Recommends personalized courses\n\n---\n\n## Database Schema\n\n\u003cimg width=\"1615\" height=\"900\" alt=\"Screenshot 2025-07-31 152757\" src=\"https://github.com/user-attachments/assets/4e7a3317-6a72-4332-99b7-db25490c4bd7\" /\u003e\n\n---\n\n##  Professor Interface\n\nProfessors can manage courses, track students performance, and act on predictive insights with dashboards tailored to academic engagement:\n\n- **Students Dashboard**: view all students and cluster them as groups based on their performance.\n- **Exams Dashboard**: view all assessments with detailed statistics.\n- **Grades Dashboard**: \n  - Searchable tables for all the students with all types of assessments.\n  - Classify students (***on track*** or ***at risk***) and send feedbacks.\n- **Attendance Dashboard**: \n  - view all the attendances over the weeks with the session type.\n  - charts to visualize the weekly attendance trend and attendance distribution.\n- **Assignments Dashboard**: Track student submissions and scores.\n- **Student \u0026 Course Metrics**: view all the academic statistics for one student in specific course.\n  \n\u003cimg width=\"1917\" height=\"907\" alt=\"prof\" src=\"https://github.com/user-attachments/assets/77f3f9f6-097d-4274-a5dc-4cad4af24d01\" /\u003e \n\n---\n\n## Admin Interface\n\nAdmins can manage courses and users with full CRUD operations. They can also view analytics on courses, users, and professor feedbacks.\n\n- **Courses Dashboards**: \n  - manage CRUD operations on courses.\n  - charts to visualize courses analytics.\n- **Users Dashboard**: \n  - manage CRUD operations on users\n  - charts to visualize users analytics (professors, students).\n- **Feedbacks Dashboard**: \n  - track professors feedback about students.\n  - track students feedback about professors.\n  - track students feedback about courses content.\n \n\u003cimg width=\"1918\" height=\"1078\" alt=\"Screenshot 2025-07-31 151801\" src=\"https://github.com/user-attachments/assets/c2e0fd20-afcb-4e2d-8c94-1eff727e40d2\" /\u003e\n\n---\n\n##  Student Interface\n\nStudents receive a personalized dashboard to monitor academic progress and receive AI-backed recommendations:\n\n- **Courses Dashboard**: \n  - view all current semester courses with overview and progress.\n  - courses total grades chart to visualize difference performance between courses.\n  - GPA and CGPA prediction for the current semester based on performance.\n- **Course Recommendations**: AI-based elective courses suggestions tailored to strengths and progress.\n- **Grade Summary**: \n  - show grades statistics for selected semester.\n  - charts to visualize grades distribution and GPA trend over semesters.\n- **Assignment Tracker**: \n  - view assignments status and upcoming assignments.\n  - Completion charts and score trends.\n- **Attendance Record**: \n  - Weekly and overall attendance visualizations with attendance rate.\n  - show attendance details and rate for each course.\n- **Course Details**: view all the academic statistics for each course.\n \n\u003cdiv style=\"display: flex;\"\u003e\n  \u003cimg width=\"410\" alt=\"Screenshot 2025-07-15 191823\" src=\"https://github.com/user-attachments/assets/add85ddc-4237-4fdc-9ff2-c7da331380c3\" /\u003e \n  \u003cimg width=\"410\" alt=\"Screenshot2 2025-07-15 191933\" src=\"https://github.com/user-attachments/assets/51ceb545-d4f4-44a0-945c-b5ea88202b09\" /\u003e \n\u003c/div\u003e\n\n---\n\n##  Parent Interface\n\nParents are offered an intuitive dashboard to stay engaged with their child’s academic journey:\n\n- **Child Dashboards**: Dashboard for each child if having more than one.\n- **Courses Dashboard**: current semester courses with overview and progress.\n- **Grade Summary**: show grades statistics for selected semester.\n- **Assignment Completion**: See pending/submitted assignments and deadlines.\n- **Class Attendance Rate**: Charts showing attendance performance and rate.\n- **Professors Feedbacks**: Review professors feedbacks about student.\n\n\u003cimg width=\"1918\" height=\"1078\" alt=\"par\" src=\"https://github.com/user-attachments/assets/8d7fabfb-a0e7-4e61-bcd8-acc0d7fb5765\" /\u003e \n\n---\n\n##  Technical Details\n\n###  Technologies\n\n  - PHP Laravel (core logic)  \n  - Flask API (AI model integration)  \n  - MySQL (data storage)\n\n  - JavaScript + Bootstrap (responsive UI)  \n  - Chart.js (interactive charts)\n\n  - Python with `scikit-learn` and `TensorFlow`  \n    - Logistic Regression (Dropout prediction)  \n    - K-means Clustering (Performance segmentation)  \n    - Content-Based Filtering (Course suggestions)  \n    - LSTM RNN (GPA forecasting)\n\n---\n\n## How to use\n\n### Prerequisites\n- PHP 8.2.12\n- Composer\n- MySQL\n- web server (Apache/Nginx)\n  \nor you can just install XAMPP and Compoaer \n\n### Instal Laravel\n```bash\ncomposer global require laravel/installer\n```\n\n### Install project\n```bash\ngit clone https://github.com/khaledkamr/Muster.git\n```\n\n### configurations\n- Copy the `.env.example` file to create a `.env` file:\n  ```bash\n  cp .env.example .env\n  ```\n\n- Edit the `.env` file to configure your environment settings, such as:\n    - Database connection.\n    - App URL (`APP_URL`) and other settings as required.\n\n- Generate an application key:\n  ```bash\n  php artisan key:generate\n  ```\n\n### Set Up the Database\n\n- Create a database in your database management system.\n- Update the `.env` file with your database credentials.\n- Run migrations to set up the database schema:\n  ```bash\n  php artisan migrate\n  ```\n- Run database seeders:\n  ```bash\n  php artisan db:seed\n  ```\n\n### Run the Application\n- Run laravel server\n  ```bash\n  php artisan serve\n  ```\n  This will start the server, typically at `http://localhost:8000`.\n\n- Run flask APIs\n  ```bash\n  python python_scripts/APIs/model_endpoints.py\n  ```\n  This will start the server, typically at `http://127.0.0.1:5000`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkhaledkamr%2Fmuster","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkhaledkamr%2Fmuster","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkhaledkamr%2Fmuster/lists"}