A club management system build for IITI community.

aim • Local Installation • Links • Tesing • Tech Stack • Team Members

A project under the course CS-258, we created this application under the guidance of Puneet Gupta Sir and Anup Gupta Sir.

AIM

”IITI Club Management WEBSITE” creates a space for Teachers, IITI students,nonIITI students and Office Staffs for making an effort to resume the activities of the clubs which have stopped due to the pandemic for
example:-Dance, Music, etc... After logging into the website by IIT-I Mail id, a student has been given a unique id, by using which he/she can reach out to form-fill-up page.
It will take his/her personal information,info about clubs which he/she have joined and info about the clubs for which he has applied.He will be added as a student of that particular club only after being approved by the club head.
Also the student can see the recent activities of any club and they can also see who all are already a part of the club.Student profile will contain all his personal information, past positions, recent positions etc...
Office staff, admins and club Heads can control the website according to the club which they have been assigned . But of course, with the permission of Director. Directors’ main work is to assign permission to the admins,
club heads and office staff when they want to create a new club or dissolve any existing club or merging two clubs.He also has all the authorities that are with the admins and the staff. He can also directly post
notice to the website, admins or club heads.

Local Installation

• Clone this repo using git clone https://github.com/gg-dev-05/clubs-iiti.git
• After cloning create a .env file to store all the environment variables
• Fill in the .env file with the content as follows

env = dev
CLEARDB_DATABASE_URL = RETRACTED (Put your mysql database url here)
client_id = RETRACTED (Put Your client id given by google developer console)
client_secret =  RETRACTED (Put Your client secret given by google developer console)
mail_id = RETRACTED (Enter the email using which all clubs related emails will be sent)
mail_password =  RETRACTED (Password for the above entered email-id)
secret_key =  RETRACTED (Any secret key of your choice)

Here RETRACTED refers we must not share this variable, and thus should not be present in public repos

• After setting .env file install all the required python packages using pip install -r requirements.txt
• Before running the server create all the required mysql tables and populate them by running clubs-iiti.ddl and populate.sql in your sql editor.
• Start the server using python app.py

USAGE STEPS:-

• New student has to fill a form to give his/her details in order to continue to explore the website with different clubs.
  
• Then He can choose to join club he is interested in by clicking on Join button.
  
• email will be sent to the student regarding details of the meeting.
  
• Meeting will be set by clubhead with the aspirants.
  
• If selected, he can continue

Testing

In Order to run the automated testing in flask download chromewebdriver according to your version(for refernce see this tutorial click here) and then create a secret.py file and write the content as follows

email = RETRACTED (Enter the email for which you want to run the tests)
password =  RETRACTED (Password for the above entered email-id)
secret_key =  RETRACTED (Any secret key of your choice)
rasta=RETRACTED (path for chromewebdriver)

Register Page

New Student can register by Filling out the details in this registration form

Home

Home Page displays the different clubs and the current events of different clubs
with a dashboard on the top with options menu of login,testinomials,apply etc. as Shown in FIG

Club Home Page

Home page of club containing description, events, members of the club as shown in FIG

WORK FLOW

User Interface

The User Interface of the Website is crystal clean, sleek and simple with all the utilities and functionalities to compliment the user with the best services.
Diving into the color schema of the website , its a combination of sapphire blue and cream white colors with a formal and sober look .
The different clubs are being assembled in a GRID fashion along with their Official Club Logo

Links

We have hosted the website on heroku: Visit Us!!
Demo Video : LINK

Tech Stack

FRONTEND
• HTML
• CSS (Bootstrap 4)
• JS(JQuery)
BACKEND
• FLASK (Python)
• Flask-MySQL

Team Members

Divyansh Maheshwari • Eish Malvi • Garvit Galgat • Somya Mehta • Tanishq Jain