{"id":20454995,"url":"https://github.com/rudrajiii/college-management-protocol","last_synced_at":"2025-04-13T03:36:00.283Z","repository":{"id":234761484,"uuid":"789448070","full_name":"Rudrajiii/College-Management-Protocol","owner":"Rudrajiii","description":"We are building a full functional COLLEGE MANAGEMENT PROTOCOL SYSTEM For the College Authority along with all the staff's , students !!.This system can able to handle the whole process of a college starting from a student admission to students placements , college events , staff selection , exams , updates each and everything...","archived":false,"fork":false,"pushed_at":"2025-03-25T11:47:32.000Z","size":37915,"stargazers_count":8,"open_issues_count":0,"forks_count":4,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-25T12:36:55.620Z","etag":null,"topics":["chartjs","firebase","flask-application","groq-ai","javascript","mailgen","mongodb","python3","razorpay-payment-gateway","scss-styles"],"latest_commit_sha":null,"homepage":"","language":"Python","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/Rudrajiii.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":"support_funcs.py","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-04-20T15:22:14.000Z","updated_at":"2025-03-25T11:47:37.000Z","dependencies_parsed_at":"2024-04-29T17:53:00.522Z","dependency_job_id":"12e8646e-d8a3-4e91-bb03-f4a7d7249524","html_url":"https://github.com/Rudrajiii/College-Management-Protocol","commit_stats":null,"previous_names":["rudrajiii/student_management_app","rudrajiii/college-management-protocol"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rudrajiii%2FCollege-Management-Protocol","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rudrajiii%2FCollege-Management-Protocol/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rudrajiii%2FCollege-Management-Protocol/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rudrajiii%2FCollege-Management-Protocol/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Rudrajiii","download_url":"https://codeload.github.com/Rudrajiii/College-Management-Protocol/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248660033,"owners_count":21141228,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["chartjs","firebase","flask-application","groq-ai","javascript","mailgen","mongodb","python3","razorpay-payment-gateway","scss-styles"],"created_at":"2024-11-15T11:17:41.325Z","updated_at":"2025-04-13T03:36:00.278Z","avatar_url":"https://github.com/Rudrajiii.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# College Management Eco-system\n-----------------------------------\n\n## Why This Software ?\n\u003e [!NOTE]  \n\u003e This is for managing the whole eco-system of a college starting from managing the\n\u003e students / teachers through a admin in a single place within a centralized system\n\u003e also benefitial for handling serveral kind of stats of students / teachers /etc\n\n## About This Project \nThis project is a web-based student management system designed to streamline various administrative tasks for a college. It leverages a combination of modern day web frameworks \nlike **\"Flask\"**\n\n## Technologies Used 💻\n\n### **Backend**\n- \u003cimg src=\"https://raw.githubusercontent.com/devicons/devicon/master/icons/flask/flask-original.svg\" alt=\"Flask\" width=\"20\"/\u003e **Python (Flask)**: Main Backend Framework of this project.\n\n### **Database**\n- \u003cimg src=\"https://raw.githubusercontent.com/devicons/devicon/master/icons/mongodb/mongodb-original.svg\" alt=\"MongoDB\" width=\"20\"/\u003e **MongoDB**: Free instance of MongoDB Cluster (512MB).\n\n### **Frontend**\n- \u003cimg src=\"https://raw.githubusercontent.com/devicons/devicon/master/icons/javascript/javascript-original.svg\" alt=\"JavaScript\" width=\"20\"/\u003e **JavaScript**: For client-side scripting and interactivity.\n- \u003cimg src=\"https://raw.githubusercontent.com/devicons/devicon/master/icons/sass/sass-original.svg\" alt=\"SCSS\" width=\"20\"/\u003e **SCSS \u0026 CSS**: For styling the HTML pages.\n- \u003cimg src=\"https://raw.githubusercontent.com/devicons/devicon/master/icons/html5/html5-original.svg\" alt=\"HTML\" width=\"20\"/\u003e **HTML \u0026 Jinja Templating**: For dynamic data rendering / rendering page content.\n\n### Prerequisites 📚\n\u003e [!IMPORTANT] \n\u003e - Python 3.10.* \u003c= 3.11.* \u003c= 3.12.*\n\u003e - Flask\n\u003e - MongoDB\n\u003e - JavaScript , Scss , Bootstrap For Frontend\n\n## Setup \u0026 Installation ⚙️\n\n\u003e [!TIP]\n\u003e First Fork this repo to make a local copy of this software.\n### [1] clone the repo to get the source code:\n```bash\ngit clone https://github.com/Rudrajiii/College-Management-Protocol.git\n``` \n### [2] navigate to the directory:\n```bash\ncd College-Management-Protocol\n```\n### [3] create a virtual environment:\n```bash\npython -m venv sysProj\n```\n### [4] navigate to the newly created virtual environment directory:\n```bash\ncd sysProj\n```\n### [5] activate the environment:\n```bash\n.\\Scripts\\activate\n```\n### [6] install all the dependencies:\n```bash\npip install -r requirements.txt\n```\n### [7] run the server:\n```bash\npython app.py\n```\n\n## Project Structure\n**Features**\n- Admin Dashboard\nThe admin dashboard manages all staff information, processes data from MongoDB collections, and displays it through a card interface. The dashboard provides an overview of the entire system, ensuring that administrators can efficiently handle student and teacher data.\n\n\n**MongoDB Database Structure**\nOur MongoDB database structure is designed to store and organize data efficiently, supporting the seamless flow of information between different components of the system.\n![DB Structure](https://github.com/Rudrajiii/College-Management-Protocol/blob/main/assets/data_models.png?raw=true)\n\n**Data Flow**\nThe data flow diagram illustrates how student data is managed within the system, showing the routes from admin to students and vice versa. The backend server processes and formats data in JSON for seamless communication.\n![DataFlow On Student Dashboard](https://github.com/Rudrajiii/College-Management-Protocol/blob/main/assets/dataflow_on_student_db.png?raw=true)\n\n**Real-Time Notifications**\nNotifications are handled using WebSockets for real-time updates. This feature is crucial for applications like teacher leave requests, ensuring that administrators and teachers are promptly informed of any changes.\n![Events On Teacher Dashboard](https://github.com/Rudrajiii/College-Management-Protocol/blob/main/assets/events_on_teacher_dsb.png?raw=true)\n\n**Teacher Applications**\nThe system processes teacher applications in real-time, with features to accept, reject, and send emails using Flask-Mail. Administrators can also clear notifications once actions are taken.\n![Teachers Applications Event](https://github.com/Rudrajiii/College-Management-Protocol/blob/main/assets/application_history_strc.png?raw=true)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frudrajiii%2Fcollege-management-protocol","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frudrajiii%2Fcollege-management-protocol","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frudrajiii%2Fcollege-management-protocol/lists"}