{"id":29544539,"url":"https://github.com/ajgthb2002/allot-easy","last_synced_at":"2026-05-03T22:33:38.111Z","repository":{"id":74547879,"uuid":"347862955","full_name":"AJgthb2002/Allot-Easy","owner":"AJgthb2002","description":"Branch-wise seat allotment system for a college based on the entrance exam score of students. Web Application made using python libraries","archived":false,"fork":false,"pushed_at":"2021-06-07T10:55:39.000Z","size":2134,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-03T17:51:37.129Z","etag":null,"topics":["csv","dsa-project","flask","pandas","python","pywebio","web-application"],"latest_commit_sha":null,"homepage":"https://allot-easy.herokuapp.com/","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/AJgthb2002.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":"2021-03-15T06:36:03.000Z","updated_at":"2025-08-21T07:11:42.000Z","dependencies_parsed_at":"2023-03-14T20:30:52.231Z","dependency_job_id":null,"html_url":"https://github.com/AJgthb2002/Allot-Easy","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/AJgthb2002/Allot-Easy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AJgthb2002%2FAllot-Easy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AJgthb2002%2FAllot-Easy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AJgthb2002%2FAllot-Easy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AJgthb2002%2FAllot-Easy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AJgthb2002","download_url":"https://codeload.github.com/AJgthb2002/Allot-Easy/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AJgthb2002%2FAllot-Easy/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32587819,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-03T22:12:39.696Z","status":"ssl_error","status_checked_at":"2026-05-03T22:09:10.534Z","response_time":103,"last_error":"SSL_read: 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":["csv","dsa-project","flask","pandas","python","pywebio","web-application"],"created_at":"2025-07-17T15:02:22.043Z","updated_at":"2026-05-03T22:33:38.095Z","avatar_url":"https://github.com/AJgthb2002.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Allot Easy\n\nThis is an *application based* group project as a part of the Buffer 2.0 project series organised by Team Loop of Cummins College of Engineering, Pune. \nVisit our [website] to view the project or view the [Demo video]\n\n---\n### What is the project objective?\nThis project aims to **simulate the admission process** for Engineering Colleges at the State level. Students can apply for a degree program at an engineering college using this system. Allot Easy is a completely merit based allotment system. Students are admitted taking in consideration their Common Entrance Test (CET) marks and course preferences.\n\n----\n#### Allot Easy Web App Screenshots\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd\u003eLogin page\u003c/td\u003e\n     \u003ctd\u003eSign up page\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cimg src=\"screenshots/Login_page.png\" width=auto height=auto\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"screenshots/Sign_up_page.png\" width=auto height=auto\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n     \u003ctd\u003eStudent Menu page\u003c/td\u003e\n     \u003ctd\u003eAdmin Menu page\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cimg src=\"screenshots/Student_menu_page.png\" width=auto height=auto\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"screenshots/Admin_menu_page.png\" width=auto height=auto\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n \u003c/table\u003e\n\n### Features:\nThe code is divided into different classes: menu, database, allotment_mechanism. \nEach file contains a class which has the related data members and functions defined in it. \nThe functionality is divided mainly into 2 parts: For **Admin** and **Student**. \nThere are different functionalities available to the user depending upon whether he/she is an Admin or a Student. Validations are added for all inputs to ensure an error free experience.\nThe system carries out seat allocation efficiently for 500+ student records currently present in the database.\n**Passwords are encrypted** with a simple caesar-cipher algorithm before saving in the datasheet.\n\n**Functions available for Students:**\n- **Sign Up** :  \nA new Student has to register and set his username and password before he can log into the application and access more features. \nThe password can be changed later by logging into the account.\n- **Login for Students** : \nStudent has to log into the application with his username and password.\n- **Fill Application details** : \nStudents can update their application with their perosnal details (gender, email-id), marks, and course preferences. Students can reset their course preferences any number of times before the allotment process is done. \n(This functionality is available only till the allotment process is executed by Admin)\n- **View seat matrix** : \nStudents can view the number of available seats of all courses offered by the college.\n- **Check application status** : \nStudents can view their saved application details and check the allotment status: application incomplete / allotment pending / allotment result.\n- **Withdraw application** : \nStudent can choose to withdraw his/her application which will delete all the saved details and the student gets logged out of his account automatically.\n(This functionality is available only till the allotment process is executed by Admin)\n- **View cutoff marks** : \nStudents can view the cut off marks of various Engineering Courses that the college offers. (This functionality is available only *after* the Admin has run the allotment process)\n- **Get vacancy data** : \nStudents can view the vacancies left after allotment is done, for each course offered by the college. \n\n**Functions available for Admin:**\n- Admin can **Run the allotment** process after which the students are admitted to a course of their preference. Admin can also **reset** the allotments if needed.\n- Admin can **view the details** of any Student who has applied to the college.\n- Admin can **view the full allotment result**, where all the applicants are listed with their alloted course name.\n- Admin can **get course wise allotment list** of students.\n- Admin can **get the count and list** of students who **haven't been alloted** any seat.\n- Admin can **view the data of vacancies** left after allotment process.\n\n---\n**Programming Language:**  Python \u003c/br\u003e\n**Data Structures used:**  Dictionary, List, List of dictionaries, List of lists (2D Array) \u003c/br\u003e\n**Libraries used:** \u003c/br\u003e\n- pandas (for handling of csv data)\n- csv  (for reading and writing to csv file)\n- pywebio (for GUI)\n- flask (for deployment of the web app)\n\n---\n### What's next?\nWe will continue updating the project with additional features such as\n- Forgot Password- A new temporary password will be emailed to the user.\n- Password encryption by using a stronger algorithm.\n- Validation of score entered by applicant by extracting the score from the uploaded scorecard in pdf form.\n- Feature for students that allow them to download their allotment result as a pdf file and Admin feature to download the full allotment result list in the form of pdf.\n- Course seat prediction, based on score by using ML algorithms.\n- Show statistics such as acceptance rate per course, gender wise allocation chart, etc.\n- Executing multiple allotment rounds - students will have the option to accept and freeze the alloted seat or try again for betterment in the next round.\n\n\n[//]: # (These are reference links used in the body of this note and get stripped out when the markdown processor does its job. There is no need to format nicely because it shouldn't be seen. Thanks SO - http://stackoverflow.com/questions/4823468/store-comments-in-markdown-syntax)\n\n   [website]: \u003chttps://allot-easy.herokuapp.com/\u003e\n   [Demo video]: \u003chttps://youtu.be/Kn9ufMtAcJc\u003e\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fajgthb2002%2Fallot-easy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fajgthb2002%2Fallot-easy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fajgthb2002%2Fallot-easy/lists"}