Cooperative social balance app

Running Backend

1. Create virtualenv using python3 (follow https://virtualenvwrapper.readthedocs.io/en/latest/install.html)

    mkvirtualenv coobs
   

2. Activate the virtualenv

    workon coobs
   

3. Install python requirements

    make install-requirements
   

4. Copy the settings template

    cp coobs/settings/dev.template.py coobs/settings/dev.py
   

5. Generate new Django secret key and update SECRET_KEY value at coobs/settings/dev.py

    sed -i "s!SECRET_KEY = .*!SECRET_KEY = '$(openssl rand -base64 32)'!g" coobs/settings/dev.py
   

6. Setup postgres user for coobs database

    sudo -iu postgres bash -c "psql -c \"CREATE USER coobs WITH PASSWORD 'coobspass';\""
    sudo -iu postgres bash -c "psql -c \"ALTER ROLE coobs SET client_encoding TO 'utf8';\""
    sudo -iu postgres bash -c "psql -c \"ALTER ROLE coobs SET default_transaction_isolation TO 'read committed';\""
    sudo -iu postgres bash -c "psql -c \"ALTER ROLE coobs SET timezone TO 'UTC';\""
   

7. Configure database parameters at coobs/settings/dev.py

    DATABASES = {
            'default': {
                    'ENGINE': 'django.db.backends.postgresql_psycopg2',
                    'NAME': 'coobs',
                    'USER': 'coobs',
                    'PASSWORD': 'coobspass',
                    'HOST': 'localhost',
                    'PORT': '5432'
            },
    }
   

8. Create the coobs database, run migrations and create Django superuser

    make reset-db
   

9. Run the server

    make server
   

10. API now should be accessible at:

    http://localhost:8000/api/
    

Running Frontend

1. Install node dependencies:

    make install-frontend
   

2. Start the frontend app:

    make frontend
   

3. App core, landing and help pages should be accesible at:

    http://localhost:8080/app/
    http://localhost:8080/landing/
    http://localhost:8080/help/
   

Frontend translations

Adding new language

1. Go to /coobs/frontend/locales and add the new language in langs.json file

    key -> language short ISO code
    value -> language name
   

2. In the same folder add a new file with ISO code as name and .json extension

3. Add all existing translations for the new language.

Adding new translation

1. Try to find if translation does not already exist.

2. Add new pair key/value in each translations file.

Backend translations

Adding new language

1. Add new locale file

    python manage.py makemessages -l <ISO_language_code>
   
    (i.e.) python manage.py makemessages -l es
   

Adding new models

1. Define model name associated to translations

    class Meta:
      verbose_name = _('class_name')
   

Adding new fields

1. Define field name associated to translations

    option -> verbose_name=_('field_name')
   

Common fields (Boolean, Char, Text, etc) can have this verbose name as the first parameter without include the verbose_name attribute name. The attribute name is a must for relations (ManyToMany, ForeignKeys, etc).

Adding new model and field keys to .po files

1. Add keys to all .po files

    python manage.py makemessages
   

2. Translate each key for all existing languages

3. Compile new translations

    python manage.py compilemessages
   

Generating new releases

To create a release just follow this steps:

1. Merge master into production

    git checkout master
    git pull
    git checkout production
    git pull
    git merge --no-ff master
    git push origin production
    git checkout master
   

2. Generate a new release here and make sure to select the production branch!
   Write a brief release description and use a senver string for tag and title like: vX.Y.Z

3. Click the "Publish release" button and the deploy action will be triggered!

Running tests

Just run make test and there you go!