FusionIIIT

FusionIIIT is the automation of various functionalities, modules and tasks of/for PDPM Indian Institute of Information Technology, Design and Manufacturing, Jabalpur being developed in python3.8 and using Django Webframework.

System Configuration

• Ubuntu 20.04 (Recommended)
• OR WSL for Windows 10 (Follow the guide below) :
  Windows Subsystem for Linux Installation Guide for Windows 10
• OR Windows 7/8/8.1/10

Software Requirements

• Python 3.8
• Git

How to get started

• on Ubuntu:

  // Install the required packages using the following command:
  
  sudo apt install python3-pip python3-dev libpq-dev python-virtualenv build-essential git
  sudo -H pip3 install --upgrade pip
  sudo -H pip3 install virtualenv

• on Windows:

  • Get Python 3.8 from here for AMD64/x64 or here for x86
  • Git from here
  • Install both using the downloaded exe files

  Important: Make sure to check the box that says Add Python 3.x to PATH to ensure that the interpreter will be placed in your execution path

Downloading the Code

• Go to (https://github.com/FusionIIIT/Fusion) and click on Fork
• You will be redirected to your fork, https://github.com/<your_user_name>/Fusion
• Open the terminal, change to the directory where you want to clone the Fusion repository
• Clone your repository using git clone https://github.com/<your_user_name>/Fusion
• Enter the cloned directory using cd Fusion/

Setting up environment

• Create a virtual environment
  • on Ubuntu: virtualenv env -p python3
  • on Windows Powershell: virtualenv env
• Activate the env
  • on Ubuntu: source env/bin/activate
  • on Windows Powershell: . .\env\scripts\activate
• Install the requirements: pip install -r requirements.txt

Running server

• Change directory to FusionIIIT cd FusionIIIT
• Run the server python manage.py runserver

Working with Code (Method 1)

Setting upstream

• git remote add upstream https://github.com/FusionIIIT/Fusion
  • Adds the remote repository (the repository you forked from) so that changes can be pulled from/pushed to it

Switching branch

• git checkout -b <module-name>
  • Creates a new branch <module-name> in your repository
• git checkout <module-name>
  • Switches to the branch you just created

Migrating Changes (Database)

• Make migrations $ python manage.py makemigrations
• Migrate the changes to the database $ python manage.py migrate

Committing

• git add .
  • Adds the changes to the staging area
• git commit
  • Commits the staged changes

Syncing

Pulling

• git pull upstream master
  • Pulls the changes from the upstream master branch

Pushing

• git push -u origin <module-name>
  • Pushes the changes to your repository (First time only); using git push is sufficient later on
• Go to https://github.com/<your_user_name>/Fusion/tree/<module-name> and create pull request

Working with Code (Alternative)

• (Recommended) Use Visual Studio Code as a text editor. Go through the Tutorial for getting started with Visual Studio Code for Python.
  Note : Use the following guide if using WSL for Development
  (https://code.visualstudio.com/docs/remote/wsl)
• Use the inbuilt Source Control feature for checking out, committing, pushing, pulling changes. You can also use Github Desktop (Windows/Mac only).
• Refer to below link for best practices regarding commit messages :
  (https://gist.github.com/robertpainsi/b632364184e70900af4ab688decf6f53)

Different modules included

• Academic database management
• Academic workflows
• Finance and Accounting
• Placement Cell
• Mess management
• Gymkhana Activities
• Scholarship and Awards Portal
• Employee Management
• Course Management
• Complaint System
• File Tracking System
• Health Centre Mangement
• Visitor's Hostel Management
• Leave Module