Decidim::Collaborations

This rails engine implements a Decidim feature that allows to the administrators to configure crowfunding campaigns for a participatory space.

Usage

This plugin provides:

A CRUD engine to manage crowfunding campaigns.
Public views for for crowfunding campaigns via a menu inside each participatory space.
An interface with Census API.
Rake tasks necessary to automatize recurrent payments.

Installation

Add the following lines to your application's Gemfile:

gem 'decidim-collaborations'

And then execute:

$ bundle
$ bundle exec rails decidim_collaborations:install:migrations
$ bundle exec rails db:migrate

Tests

In order to execute the tests data from iban_bic gem must be populated as well:

$ bundle exec rails db:migrate RAILS_ENV=test

Docker & Docker compose

This engine is supplied with Docker compose files. If you want to use them you need to check the spec/decidim_dummy_app/database.yml and adjust the database settings:

default: &default
  adapter: postgresql
  encoding: unicode
  # For details on connection pooling, see rails configuration guide
  # http://guides.rubyonrails.org/configuring.html#database-pooling
  pool: <%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %>
  host: <%= ENV.fetch("DATABASE_HOST") { "db" } %>
  username: <%= ENV.fetch("DATABASE_USERNAME") { "admin" } %>
  password: <%= ENV.fetch("DATABASE_PASSWORD") { "admin" } %>

If you desire to use different settingsyou need to check the Docker compose settings and adjust the setup of the PostgreSQL image.

Finally remember that the Docker file do not includes any command relative to the database setup. Due to this limitation, the first time that you execute the app you must execute the following commands:

$ docker-compose run web bash
$ cd spec/decidim_dummy_app
$ bundle exec rails db:create
$ bundle exec rails db:migrate
$ bundle exec rails db:seed

Rake tasks

This engine provides the following rake tasks: