Gelinkt Notuleren

Backend systems and editor built on top of the Besluit and Mandaat model and application profile as defined on:

• http://data.vlaanderen.be/ns/besluit
• http://data.vlaanderen.be/doc/applicatieprofiel/besluit-publicatie/
• http://data.vlaanderen.be/ns/mandaat
• http://data.vlaanderen.be/doc/applicatieprofiel/mandatendatabank/

What's included?

This repository harvest three setups. The base of these setups resides in the standard docker-compose.yml.

• docker-compose.yml This provides you with the backend components. There is a frontend application included which you can publish using a separate proxy (we tend to put a letsencrypt proxy in front).
• docker-compose.dev.yml Provides changes for a good frontend development setup.
  • publishes the backend services on port 80 directly, so you can run ember serve --proxy http://localhost when developing the frontend apps natively.
  • publishes the database instance on port 8890 so you can easily see what content is stored in the base triplestore
  • provides a mock-login backend service so you don't need the ACM/IDM integration.
• docker-compose.demo.yml Provides a setup for demo purposes. It is similar to the dev setup, but publishes the frontend application directly:
  • publishes the frontend editor on port 80 so you can visit the app at http://localhost/
  • publishes the database instance on port 8890 so you can easily see what content is stored in the base triplestore
  • provides a mock-login backend service so you don't need the ACM/IDM integration

Running and maintaining

General information on running and maintaining an installation

How to setup the stack

First choose what you intend to run based on the description above. Two scenario's are included here: the demo setup and the dev setup.

Running the demo setup

First install git-lfs (see https://github.com/git-lfs/git-lfs/wiki/Installation)

Execute the following:

# Make sure git-lfs is enabled after installation
git lfs install

# Clone this repository
git clone https://github.com/lblod/app-gelinkt-notuleren.git

# Move into the directory
cd app-gelinkt-notuleren

# Start the system
docker-compose -f docker-compose.yml -f docker-compose.demo.yml up

Wait for everything to boot to ensure clean caches. You may choose to monitor the migrations service in a separate terminal to and wait for the overview of all migrations to appear: docker-compose logs -f --tail=100 migrations.

Once the migrations have ran, visit the application at http://localhost/

Running the dev setup

First install git-lfs (see https://github.com/git-lfs/git-lfs/wiki/Installation)

Execute the following:

# Make sure git-lfs is enabled after installation
git lfs install

# Clone this repository
git clone https://github.com/lblod/app-gelinkt-notuleren.git

# Move into the directory
cd app-gelinkt-notuleren

# Start the system
docker-compose -f docker-compose.yml -f docker-compose.dev.yml up

Wait for everything to boot to ensure clean caches. You may choose to monitor the migrations service in a separate terminal to and wait for the overview of all migrations to appear: docker-compose logs -f --tail=100 migrations.

Once the migrations have ran, you can start developing your application by connecting the ember frontend application to this backend. See https://github.com/lblod/frontend-gelinkt-notuleren for more information on development with the ember application.

Upgrading your setup

Once installed, you may desire to upgrade your current setup to follow development of the main stack. The following example describes how to do this easily for both the demo setup, as well as for the dev setup.

Upgrading the demo setup

First we bring down the stack so we can upgrade things easily:

# Move to the right directory
cd place-where-you-clone-repository/app-gelinkt-notuleren

# Bring the application down
docker-compose -f docker-compose.yml -f docker-compose.demo.yml down

If you don't need the database of your current setup anymore, you may whish to remove its current contents. Once we hit the first release, the migrations should take care of upgrading your application as needed, until then you may possibly hit a breaking change.

# Remove all contents in the database folder
rm -Rf data/db

# Checkout the required files from the repository
git checkout data/db

Next up is pulling in the changes from the upstream and launching the stack again.

# Pull in the changes
git pull origin master

# Launch the stack
docker-compose -f docker-compose.yml -f docker-compose.demo.yml up

As with the initial setup, we wait for everything to boot to ensure clean caches. You may choose to monitor the migrations service in a separate terminal to and wait for the overview of all migrations to appear: docker-compose logs -f --tail=100 migrations.

Once the migrations have ran, visit the application at http://localhost/

Upgrading the dev setup

For the dev setup, we assume you'll pull more often and thus will most likely clear the database separately:

# Bring the application down
docker-compose -f docker-compose.yml -f docker-compose.dev.yml down
# Pull in the changes
git pull origin master
# Launch the stack
docker-compose -f docker-compose.yml -f docker-compose.demo.yml up

As with the initial setup, we wait for everything to boot to ensure clean caches. You may choose to monitor the migrations service in a separate terminal to and wait for the overview of all migrations to appear: docker-compose logs -f --tail=100 migrations.

Once the migrations have ran, you can go on with your current setup.

Cleaning the database

At some times you may want te clean the database and make sure it's in a pristine state. For development this is the following (for demo, replace the docker-compose.dev.yml with docker-compose.demo.yml):

# Bring down our current setup
docker-compose -f docker-compose.yml -f docker-compose.dev.yml down
# Keep only required database files
rm -Rf data/db
git checkout data/db
# Bring the stack back up
docker-compose -f docker-compose.yml -f docker-compose.dev.yml up

Make sure to wait for the migrations to run.

General application structure

This stack is built based on the mu.semte.ch architecture. The starting point for this stack is mu-project.

API documentation

The vast amount of API space offered by this stack is covered by mu-cl-resources. The OpenAPI documentation can be generated using cl-resources-openapi-generator. We also advise to checkout the JSONAPI documentation which covers the general way in which our APIs work and the mu-cl-resources documentation for specific extensions to this api.