Getting started

The project is developed in Python using the Django framework. There are 3 sections below, focussing on developers, running the project using Docker and hints for running the project in production.

Installation

Prerequisites

You need the following libraries and/or programs:

Python 3.12
Python Virtualenv and Pip
PostgreSQL 14.0 or above
Docker 19.03 or above (and docker-compose)

Step by step

Developers can follow the following steps to set up the project on their local development machine.

Navigate to the location where you want to place your project.

Get the code:

$ git clone git@github.com:maykinmedia/open-organisatie.git
$ cd open-organisatie

At this point you can already built the Docker image and run Open Organisatie. You can skip this if you don’t want that.
```
$ docker-compose up
```
Note: If you are using Git on Windows, line-endings might change in checked out files depending on your core.autocrlf setting in .gitconfig. This is problematic because files are copied into a Docker image, which runs on Linux. Specifically, the bin/docker_start.sh file is affected by this which causes the Docker container fail to start up.

Install all required libraries:

$ virtualenv env  # or, python -m venv env
$ source env/bin/activate
$ pip install --requirement requirements/dev.txt

Activate your virtual environment and create the statics and database:
```
$ source env/bin/activate
$ python src/manage.py migrate
```
Create a superuser to access the management interface:
```
$ python src/manage.py createsuperuser
```
You can now run your installation and point your browser to the address given by this command:
```
$ python src/manage.py runserver
```

Note: If you are making local, machine specific, changes, add them to src/openorganisatie/conf/local.py. You can also set certain common variables in a local .env file. You can base these files on the example files included in the same directory.

Update installation

When updating an existing installation:

Activate the virtual environment:

$ cd open-organisatie
$ source env/bin/activate

Update the code and libraries:

$ git pull
$ pip install --requirement requirements/dev.txt

Update the statics and database:
```
$ python src/manage.py migrate
```

Testsuite

To run the test suite:

$ python src/manage.py test openorganisatie

Configuration via environment variables

A number of common settings/configurations can be modified by setting environment variables, add them to your .env file or persist them in src/openorganisatie/conf/local.py.

SECRET_KEY: the secret key to use. A default is set in dev.py
DB_NAME: name of the database for the project. Defaults to openorganisatie.
DB_USER: username to connect to the database with. Defaults to openorganisatie.
DB_PASSWORD: password to use to connect to the database. Defaults to openorganisatie.
DB_HOST: database host. Defaults to localhost
DB_PORT: database port. Defaults to 5432.
SENTRY_DSN: the DSN of the project in Sentry. If set, enabled Sentry SDK as logger and will send errors/logging to Sentry. If unset, Sentry SDK will be disabled.

Settings

All settings for the project can be found in src/openorganisatie/conf`. The file local.py overwrites settings from the base configuration, and is only loaded for the dev settings.

Running background tasks

We use Celery as background task queue.

You can run celery worker(s) in a shell to activate the asynchronous task queue processing.

To start the background workers executing tasks:

$ ./bin/celery_worker.sh

To start flower for task monitoring:

$ ./bin/celery_flower.sh