Awesome
Open Raadsinformatie API
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:
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:
Copyright and license
The Open Raadsinformatie project is distributed under the MIT license.