Open Raadsinformatie API

Master: Develop:

Open Raadsinformatie (ORI) aims to collect and standardize governmental decision making documents of Dutch municipalities (gemeenten, provincies, waterschappen). Open Raadsinformatie is a collaborative effort of the Open State Foundation, Ontola and VNG Realisatie.

Important links

• Docs for API
• Search engine
• Open Raadsinformatie homepage
• Official source code repository
• Issue tracker

Installation and usage

See this guide to install the Open Raadsinformatie API using Docker, Vagrant or manually. There are also a few usage commands to get you started. Check out the maintenance guide for info on how to manage this project in production.

Latest docker version uses "-" as separator when creating container names instead of "_". You can still get the old functionality by adding "--compatibility" to docker compose. So when using the latest Docker in development, use the following to start the containers: docker compose --compatibility -f docker-compose.yml -f docker-compose.dev.yml up --build -d

The Nginx container was installed separately in production. To mimic this in development, clone https://github.com/openstate/nginx-load-balancer/, follow the instructions in INSTALL.txt and start the container with docker compose --compatibility up -d

Testing

The next lines were copied from the Github workflow (which never actually ran):

• docker compose --compatibility -f docker-compose.yml -f docker-compose.test.yml up --build -d
• docker exec ori_backend_1 bin/run_tests.sh 2>&1
• docker exec ori_backend_1 pylint ocd_backend -E -sy

Getting data in development

See script manual_retrieval.py See also the Troubleshooting section in the maintenance_guide.

Supported Sources

Data extraction support is available for the following source systems:

• GO GemeenteOplossingen
• Visma Roxit / GreenValley
• Notubiz
• iBabs
• Parlaeus
• Tweede Kamer

How to add your municipality

Get in touch with Sander Bakker from VNG Realisatie. Your griffie (municipality clerk) needs to formally agree that the data becomes open data, and the source system might need some configuration.

Related repositories

• openbesluitvorming, the new search interface.

Contributing

Please read through our contributing guidelines. Included are directions for opening issues, coding standards, and notes on development.

Bugs and feature requests

Have a bug or a feature request? Please first read through and search for existing and closed issues. If your problem or idea is not addressed yet, please open a new issue.

Authors and contributors

The Open Raadsinformatie API was originally based on the Open Cultuur Data API.

Authors and contributors of both projects are:

• Bart de Goede (@bartdegoede)
• Justin van Wees (@justin_v_w)
• Breyten Ernsting (@breyten)
• Sicco van Sas (@siccovansas)
• Jurrian Tromp (@jurrian, @ontola)
• Jorrit van Belzen (@jorritb, @ontola)
• Joep Meindertsma (@joepio)
• Rob van Dijk (@robvandijk)

Contributors:

• DutchCoders
• Benno Kruit

Copyright and license

The Open Raadsinformatie project is distributed under the MIT license.