Helsinki participatory democracy system, built on the Decidim platform.
This software is mainly used for Helsinki City participatory budgeting needs. Read more:
This Decidim implementation is used for running the participatory budgeting processes for the City of Helsinki. The software allows democratic participation online. People can cast their vote on how the city should spend some of their budgeted money on publicly funded projects.
The live instance is visible in the following address:
Technically the software is based on the Decidim participatory framework built on the Ruby on Rails framework.
Decidim is an open source project participatory democracy system built in Barcelona, Spain.
Participate in Decidim's development in Metadecidim
Documentation and administration manual for Decidim can be found from the following URLs:
Please note the version numbers the documents have been written to. Generally documentation lacks behind the software itself because it is constantly evolving as a rather fresh project.
This is an instance of the Decidim platform, using Decidim's core with some custom modules and customizations.
With all customizations and modifications, try to keep the application as maintainable as possible against the Decidim core. Try to avoid hard core customizations which require lots of efforts to maintain during Decidim's core updates.
This repository contains some custom Rake tasks mainly to import and export data from the live instances. These are mostly used on an as-needed basis and they may not always be up to date.
The used OmniAuth bindings are enabled by default for all environments. However, they may not automatically work in case you do not provide their configuration values in your local environment variables. You can define them for the application e.g. using rbenv.
Tunnistamo requires the following environment variables to be available:
OMNIAUTH_OPENIDCONNECT_APP_ID- The OIDC app ID assigned for the environmentOMNIAUTH_OPENIDCONNECT_APP_SECRET- The OIDC app secret for the environment
In order to learn more about Tunnistamo or install it locally to test the connectivity, please refer to the Tunnistamo documentation:
https://github.com/City-of-Helsinki/tunnistamo
Suomi.fi requires the following environment variables to be available:
SUOMIFI_MODE- Defines the Suomi.fi environment to connect to. Either"test"or"production".- For the development environment, use
"test"
- For the development environment, use
SUOMIFI_ENTITY_ID- The entity ID for Suomi.fi- For the development environment, you can define this as:
http://localhost:3000/users/auth/suomifi/metadata
- For the development environment, you can define this as:
SUOMIFI_CERT_FILE- A certificate file that contains the certificate sent to Suomi.fi as part of the metadata. This is used to encrypt messages at Suomi.fi before they are sent to the service.- For the development environment, you can use the development certificate
from the
decidim-suomifirepository: https://git.io/fjdaM
- For the development environment, you can use the development certificate
from the
SUOMIFI_PKEY_FILE- The private key corresponding to the certificate. This is used to decrypt messages coming from Suomi.fi.- For the development environment, you can use the development private key
from the
decidim-suomifirepository: https://git.io/fjda1
- For the development environment, you can use the development private key
from the
MPASSid requires the following environment variables to be available:
MPASSID_MODE- Defines the MPASSid environment to connect to. Either"test"or"production".- For the development environment, use
"test"
- For the development environment, use
MPASSID_ENTITY_ID- The entity ID for Suomi.fi
- For the development environment, you can define this as:
http://localhost:3000/users/auth/mpassid/metadata
For deployment instructions, please refer to Decidim's own guide:
https://docs.decidim.org/en/install/#_deploy
For further instructions, consult the organization in charge of the maintenance.