TaakR

Voor het organiseren en beheren Taaktypes voor Meldingen Openbare Ruimte

Tech Stack

Django, Turbo JS, SCSS

Get Started 🚀

To get started, install Docker

We use the Makefile for commonly used commands

Start TaakR application

https://github.com/forza-mor-rotterdam/taakr

Create local dns entry

Add '127.0.0.1 taakr.mor.local' to your hosts file

sudo nano /etc/hosts

create docker networks

Use the Makefile command:

    make create_docker_networks

or:

    docker network create taakr_network
    docker network create mor_bridge_network

Build and run Docker container

Use the Makefile command:

    make run_and_build

or:

    docker compose build
    docker compose up

To only run the docker container use:

    make run

This will start a webserver. Authorize via the Django admin: http://taakr.mor.local:8009/admin/ You can login with the following credentials:

• Email: admin@admin.com
• Password: insecure You can view the website on http://taakr.mor.local:8009

Frontend

Use the Makefile command:

    make run_frontend

or in terminal go to 'app/frontend' and start front-end and watcher by typing

    npm install
    npm run watch

Code style

Pre-commit is used for formatting and linting Make sure pre-commit is installed on your system

    brew install pre-commit

and run

    pre-commit install

To manually run the pre-commit formatting run

    make format

Pre-commit currently runs black, flake8, autoflake, isort and some pre-commit hooks. Also runs prettier for the frontend.

Linking other applications to TaakR

To link the other applications to TaakR you need to create the users for those applications and the application-links in TaakR. Applications should be created automatically with the "create_applicaties" command. You can also run this command using:

make create_applicaties

Manual steps

• Go to the Django Admin in TaakR
• Users - Add new users for the applications, for example: fixer_username@forzamor.nl for fixer, the password is the default we use.
• Applicaties - Create a new application with the following data (fixer in this example):
  • name: FixeR
  • basis url: http://fixer.mor.local:8004
  • gebruiker: fixer_username@forzamor.nl
  • applicatie gebruiker naam: taakr_username@forzamor.nl
  • applicatie gebruiker wachtwoord: default password

In the corresponsing application you need to create a user for TaakR So in this example go to the FixeR Django Admin

• Users - Add a new user with email: taakr_username@forzamor.nl , password: default password

After adding these 3 things you should be able to "click save and continue editing" on the TaakR application-link and see the "Connectie met de applicatie is gelukt" message.