Skip to content

Commit

Permalink
Update README
Browse files Browse the repository at this point in the history
  • Loading branch information
chirag-jn committed Dec 25, 2020
1 parent 90a782b commit 1db2608
Showing 1 changed file with 75 additions and 10 deletions.
85 changes: 75 additions & 10 deletions README.MD
Original file line number Diff line number Diff line change
@@ -1,10 +1,75 @@
This is the web portal for managing the mandatory Self Growth & Community Work done by the students of IIIT-Delhi, India

# Setup
1. sudo apt-get install python-dev \
build-essential libssl-dev libffi-dev \
libxml2-dev libxslt1-dev zlib1g-dev \
python-pip
2. sudo apt-get install libmysqlclient-dev
3. sudo apt-get install python-mysqldb
4. pip install mysql-python
# SG/CW Portal - IIITD
Web Portal for managing Self Growth and Community Work projects for the students of IIIT Delhi, India.

## Installation Setup

### Prerequisites
Here's a list of things you'll need to have prior to setting up the software.
1. Python3
2. MySQL
3. Memcached

### Setup
1. Create a new `SQL` database with the name `cw_portal` and create a new SQL user `cw` with all privileges on `cw_portal` database.

2. Install the required packages
```shell
sudo apt-get install python-dev \
build-essential libssl-dev libffi-dev \
libxml2-dev libxslt1-dev zlib1g-dev \
python-pip
sudo apt-get install libmysqlclient-dev
sudo apt-get install python-mysqldb
pip3 install mysql-python
```

3. Install the required libraries.
```shell
pip3 install requirements.txt
```

4. Setup Migrations
```shell
python3 manage.py migrate
```

5. Setup SQL database variables as follows
```sql
USE cw_portal

INSERT INTO `cw_portal`.`supervisor_flags`
(`name`, `value`)
VALUES
("add_project", 1);

INSERT INTO `cw_portal`.`studentportal_category`
(`name`, `description`)
VALUES
("SG", "Self Growth");

INSERT INTO `cw_portal`.`studentportal_category`
(`name`, `description`)
VALUES
("CW", "Community Work");
```

6. Create a new superuser
```shell
python3 manage.py createsuperuser
```

7. Run your portal
```shell
python3 manage.py runserver
```

8. You can alternatively set up WSGI and NGINX to serve the website.

## Contributors

### Current maintainers
1. [Chirag Jain](https://github.com/chirag-jn)
2. [Reeshabh Ranjan](https://github.com/reeshabhranjan)

### Old maintainers
1. [Sambhav Satija](https://github.com/darkryder)

0 comments on commit 1db2608

Please sign in to comment.