City Infrastructure Platform REST-API backend application.

Install PostgreSQL and PostGIS.

# Ubuntu 18.04
sudo apt-get install python3-dev libpq-dev postgresql postgis

# Ubuntu 18.04
sudo apt-get install binutils libproj-dev gdal-bin
export CPLUS_INCLUDE_PATH=/usr/include/gdal
export C_INCLUDE_PATH=/usr/include/gdal

Create a Python 3.x virtualenv either using the venv tool or using the great virtualenvwrapper toolset. Assuming the latter, once installed, simply do:

mkvirtualenv -p /usr/bin/python3 city-infrastructure-platform

The virtualenv will automatically activate. To activate it in the future, just do:

workon city-infrastructure-platform

• Run prequ update

• Run pip install -r requirements.txt
• For development also run pip install -r requirements-dev.txt

Enable PostGIS extension for the default template

sudo -u postgres psql -d template1 -c "CREATE EXTENSION IF NOT EXISTS postgis;"

Create user and database

sudo -u postgres createuser -P -R -S city-infrastructure-platform  # use password `city-infrastructure-platform`
sudo -u postgres createdb -O city-infrastructure-platform city-infrastructure-platform

Allow user to create test database

sudo -u postgres psql -c "ALTER USER city-infrastructure-platform CREATEDB;"

Environment variables are used to customize configuration in city-infrastructure-platform/settings.py. If you wish to override any settings, you can place them in a local .env file which will automatically be sourced when Django imports the settings file.

Copy .env.example file as .env: cp .env.example .env

• Enable debug echo 'DEBUG=True' >> .env
• Run python manage.py migrate
• Run python manage.py runserver 0.0.0.0:8000

Build Docker image: docker build -t city-infrastructure-platform .

Run container: docker run -d -p 8000:8000 -e DEBUG=1 city-infrastructure-platform

Available configs (environment variables):

To set any of the settings below, use the -e <ENV_VAR>=<VALUE> flag when running the Docker container.

• DATABASE_HOST: Set to the host address of the PostgreSQL (with PostGIS) database server, default is empty value.
• DATABASE_PORT: Set to port of the database server, default is 5432.
• DEV_SERVER: Set to 1 to run manage.py runserver instead of uwsgi, default is empty value.
• COLLECT_STATIC: Set to 1 to collect static files on startup, default is empty value.
• APPLY_MIGRATIONS: Set to 1 to run manage.py migrate on startup, default is empty value.

Run the application docker-compose up

Run script ./makemessages.sh

Traffic sign icons are from Finnish Transport Infrastructure Agency which has released these icons in public domain under Creative Commons 1.0 universal (CC0 1.0) license. Original icons can be found here.