wewakesharma/bcevote

Brooklyn College Blockchain eVoting System.

Brooklyn College eVote

(Fig.) Default index page.

(Fig.) Create petition page.

(Fig.) View more details page.

Dev Environment Specifications:

-Tested on Mac OS X 10.14

-Tested on Ubuntu 18.04.03 with VirtualBox v5.50.20

-Written in Python3.6.8.

Local Setup/Installation Process:

Part One - Install Algorand Node:

1. Click on this link and follow instructions for your specific operating system: https://developer.algorand.org/docs/introduction-installing-node

Part Two - Install Python Virtual Environment and BCeV:

1. Create empty parent directory.
2. Create Python virtual environment within new parent directory python3 -m venv venv
3. Activate virtual environmentsource venv/bin/activate then cd venv
4. git clone https://github.com/AlexanderHart/BCeVote.git
5. cd BCeVote
6. pip3 install -r requirements.txt
7. pip3 install py-algorand-sdk
8. Set environment variables, APP_MAIL_USERNAME and APP_MAIL_PASSWORD to your email and password, respectfully. Also, these values can be hardcoded in /project/config.py, if desired in line 24 and 25.
9. Create bash executable Within project directory: chmod u+x autoDispense.sh

Part Three - Create and run Private Network/Algod Processes & Update Files:

1. Create a private network with ./goal network create -r ~/algodNet -n private -t <path_to_template.json> NOTICE: We supply the template JSON file (from the Algorand developer page) that can be used in the above step. Locate the file at the following path: /venv/BCeVote/project/privateNetwork.json
2. ./goal network start -r ~/algodNet
3. ./goal kmd start -d ~/algodNet/Primary
4. Update data_dir_path in line 17 at BCeVote/project/params.py

Part Four - Run setup processes for BCeV

1. python3 manage.py create_db
2. python3 manage.py db init
3. python3 manage.py db migrate
4. python3 manage.py create_admin
5. python3 manage.py create_trashbag
6. python3 manage.py runserver
7. Navigate to 127.0.0.1:5000 to demo BCeV.

Credit & Acknowledgement:

Credit and acknowledgement goes to GitHub user mjhea0, for his repo https://github.com/mjhea0/flask-basic-registration.git for which we used it for our user registration.