Decidim Suara

Free Open-Source participatory democracy, citizen participation and open government for cities and organizations

This is the open-source repository for decidim_application, based on Decidim.

Setting up the application

You will need to do some steps before having the app working properly once you've deployed it:

1. Open a Rails console in the server: bundle exec rails console
2. Create a System Admin user:

user = Decidim::System::Admin.new(email: <email>, password: <password>, password_confirmation: <password>)
user.save!

3. Visit <your app url>/system and login with your system admin credentials
4. Create a new organization. Check the locales you want to use for that organization, and select a default locale.
5. Set the correct default host for the organization, otherwise the app will not work properly. Note that you need to include any subdomain you might be using.
6. Fill the rest of the form and submit it.

You're good to go!

Decorators, overrides with Deface and override complete views

The following files must be checked in each upgrade of Decidim.

Blank vote

• app/decorators/decidim/consultations/multi_vote_form_decorator.rb
• app/decorators/decidim/consultations/admin/create_response_decorator.rb

---

• app/overrides/decidim/consultations/admin/responses/add_blank_vote_to_consultations_responses_form.rb
• app/overrides/decidim/consultations/admin/responses/add_js_to_consultations_responses_form.rb
• app/overrides/decidim/consultations/admin/responses/add_js_to_edit_consultations_responses.rb
• app/overrides/add_blank_vote_to_question_configuration_form.rb

---

• app/views/decidim/consultations/question_multiple_votes/_form.html.erb

Custom Suara permissions in Participatory Spaces

• app/decorators/commands/decidim/assemblies/admin/create_assembly_decorator.rb
• app/decorators/commands/decidim/consultations/admin/create_consultation_decorator.rb

---

• app/overrides/decidim/assemblies/admin/assemblies/add_permissions_sections_to_assemblies_form.rb
• app/overrides/decidim/participatory_processes/admin/participatory_processes/add_permissions_sections_to_participatory_processes_form.rb
• app/overrides/decidim/consultations/admin/add_permissions_sections_to_consultations_form.rb

Meetings

Filter by hours and days

• app/decorators/controllers/decidim/meetings/meetings_controller_decorator.rb
• app/decorators/lib/decidim/filter_form_builder_decorator.rb
• app/decorators/lib/decidim/form_builder_decorator.rb
• app/decorators/models/decidim/meeting_decorator.rb
• config/initializers/decidim/meetings/component_filterable_override.rb

---

• app/views/decidim/meetings/meetings/_meetings.html.erb
• app/views/decidim/meetings/meetings/_filters.html.erb

Card visualization

• app/decorators/cells/decidim/ meetings/join_meeting_button_cell_decorator.rb

---

• app/views/decidim/meetings/meetings/_meetings.html.erb

From Module Action Delegator:

• app/decorators/queries/decidim/action_delegator/voted_with_direct_verification_decorator.rb

Consultations

Fields improvements

• app/overrides/decidim/consultations/questions/hide_fields_in_technical_data.rb
• app/overrides/layouts/decidim/add_button_to_consultation_show.rb
• app/decorators/forms/decidim/consultations/question_form_decorator.rb

---

• app/views/decidim/consultations/questions/show.html.erb

Add hours to voting dates

• app/decorators/forms/decidim/consultations/admin/consultation_form_decorator.rb
• app/decorators/models/decidim/consultation_decorator.rb

---

• app/overrides/decidim/consultations/admin/change_voting_date_to_datetime_field_in_consultations_form.rb
• app/overrides/layouts/decidim/add_format_to_start_voting_date_in_show.rb

Add questions left to response

• app/decorators/controllers/decidim/consultations/consultations_controller_decorator.rb

---

• app/overrides/layouts/decidim/add_questions_left_to_response.rb

Remove comments from questions

• app/views/decidim/consultations/questions/show.html.erb

Override Quill editor

• app/packs/src/decidim/editor.js

Testing

Run rake decidim:generate_external_test_app to generate a dummy application.

Require missing factories in spec/factories.rb

Add require "spec_helper" to your specs and execute them from the root directory, i.e.:

bundle exec rspec spec

License

This engine is distributed under the GNU AFFERO GENERAL PUBLIC LICENSE.