The Website for co-ordinating the rehabilitation of the people affected in the Kerala Floods.

• Requirements
  • Docker
  • Python 3
  • Postgres
  • Git
  • Redis
  • Setting up an S3 Account
• Getting started
• Creating migration files
• Running tests
• Enable HTTPS connections
• How can you help?
  • Verification of Rescue Requests
  • Contribution Guidelines
  • Testing PRs
  • Submitting PRs

^top

• Check out this Wiki to see how to run docker for this project.

• Follow https://django-storages.readthedocs.io/en/latest/backends/amazon-S3.html and https://www.caktusgroup.com/blog/2014/11/10/Using-Amazon-S3-to-store-your-Django-sites-static-and-media-files/ to setup s3 bucket, and download access keys.

^top

psql user=postgres
Password:
psql (10.4 (Ubuntu 10.4-0ubuntu0.18.04))
Type "help" for help.

postgres=# CREATE DATABASE rescuekerala;
CREATE DATABASE
postgres=# CREATE USER rescueuser WITH PASSWORD 'password';
CREATE ROLE
postgres=# GRANT ALL PRIVILEGES ON DATABASE rescuekerala TO rescueuser;
GRANT
postgres=# \q

git clone https://github.com/IEEEKeralaSection/rescuekerala.git
cd rescuekerala

    cp .env.example .env

pip3 install -r requirements_debug.txt

    python3 manage.py migrate

    python3 manage.py collectstatic

    python3 manage.py runserver

^top

If your code changes anything in models.py, you might need to make changes in database schema, or other constraints. To create migrations files, run python3 manage.py makemigrations --settings=floodrelief.settings after making your changes. Also make sure to add these files in the commit.

^top

When running tests, Django creates a test replica of the database in order for the tests not to change the data on the real database. Because of that, you need to alter the Postgres user that you created and add to it the CREATEDB privilege:

ALTER USER rescueuser CREATEDB;

To run the tests, run this command:

python3 manage.py test --settings=floodrelief.test_settings

^top

Certain features (example: GPS location collection) only work with HTTPS connections. To enable HTTPS connections,follow the below steps.

Create self-signed certificate with openssl

$openssl req -x509 -newkey rsa:4096 -keyout key.key -out certificate.crt -days 365 -subj '/CN=localhost' -nodes

[https://stackoverflow.com/questions/10175812/how-to-create-a-self-signed-certificate-with-openssl#10176685]

Install django-sslserver

$pip3 install django-sslserver

Update INSTALLED_APPS with sslserver by editing the file floodrelief/settings.py (diff below)

 INSTALLED_APPS = [
+    'sslserver',
     'mainapp.apps.MainappConfig',
     'django.contrib.admin',

Run the server

python3 manage.py runsslserver 10.0.0.131:8002  --certificate /path/to/certificate.crt --key /path/to/key.key

In the above example the server is being run on a local IP address on port 8002 to enable HTTPS access from mobile/laptop/desktop for testing.

^top

You can help us with verifying user submitted request from our Ushahidi volunteer portal. Please follow the usermanual available in either English or Malayalam

Check out this Wiki for our contribution guidelines.

Please find issues that we need help here. Go through the comments in the issue to check if someone else is already working on it. Don't forget to drop a comment when you start working on it.

You can find the repo for the Flood Map here : https://github.com/aswinmohanme/kerala-flood-map