decidim-participatory_processes 0.6.0

data/app/models/decidim/participatory_process_group.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Decidim
+  class ParticipatoryProcessGroup < ApplicationRecord
+    has_many :participatory_processes,
+             foreign_key: "decidim_participatory_process_group_id",
+             class_name: "Decidim::ParticipatoryProcess",
+             inverse_of: :participatory_process_group
+    belongs_to :organization,
+               foreign_key: "decidim_organization_id",
+               class_name: "Decidim::Organization"
+
+    mount_uploader :hero_image, Decidim::HeroImageUploader
+  end
+end

data/app/models/decidim/participatory_process_step.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Decidim
+  # A ParticipatoryProcess is composed of many steps that hold different
+  # features that will show up in the depending on what step is currently
+  # active.
+  class ParticipatoryProcessStep < ApplicationRecord
+    belongs_to :participatory_process, foreign_key: "decidim_participatory_process_id", class_name: "Decidim::ParticipatoryProcess"
+    has_one :organization, through: :participatory_process
+
+    validates :start_date, date: { before: :end_date, allow_blank: true, if: proc { |obj| obj.end_date.present? } }
+    validates :end_date, date: { after: :start_date, allow_blank: true, if: proc { |obj| obj.start_date.present? } }
+
+    validates :active, uniqueness: { scope: :decidim_participatory_process_id }, if: proc { |step| step.active? }
+
+    validates :position, numericality: { greater_than_or_equal_to: 0, only_integer: true }, allow_blank: true
+    validates :position, uniqueness: { scope: :decidim_participatory_process_id }
+
+    before_create :set_position
+
+    private
+
+    # Internal: Sets the position of the step if it is `nil`. That means that
+    # when the step is the first of the process, and no position is set
+    # manually, it will be set to 0, and when it is not the only one it will be
+    # set to the last step's position + 1.
+    #
+    # Note: This allows manual positioning, but there is a validation that
+    # forbids two steps from the same proccess to have the same position. Take
+    # that into account. It would be best if you did not use manual
+    # positioning.
+    def set_position
+      return if position.present?
+      return self.position = 0 if participatory_process.steps.select(&:persisted?).empty?
+
+      self.position = participatory_process.steps.pluck(:position).last + 1
+    end
+  end
+end

data/app/models/decidim/participatory_processes/abilities/admin/admin_ability.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Decidim
+  module ParticipatoryProcesses
+    module Abilities
+      module Admin
+        # Defines the abilities for a user in the admin section. Intended to be
+        # used with `cancancan`.
+        class AdminAbility < Decidim::Abilities::AdminAbility
+          def define_abilities
+            super
+
+            can :manage, ParticipatoryProcess
+            can :manage, ParticipatoryProcessGroup
+            can :manage, ParticipatoryProcessStep
+          end
+        end
+      end
+    end
+  end
+end

data/app/models/decidim/participatory_processes/abilities/admin_ability.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Decidim
+  module ParticipatoryProcesses
+    module Abilities
+      # Defines the abilities for an admin user. Intended to be used with `cancancan`.
+      class AdminAbility < Decidim::Abilities::AdminAbility
+        def define_abilities
+          super
+
+          can :read, ParticipatoryProcess
+        end
+      end
+    end
+  end
+end

data/app/models/decidim/participatory_processes/abilities/everyone_ability.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Decidim
+  module ParticipatoryProcesses
+    module Abilities
+      # Defines the base abilities related to participatory processes for any
+      # user. Guest users will use these too. Intended to be used with
+      # `cancancan`.
+      class EveryoneAbility < Decidim::Abilities::EveryoneAbility
+        def initialize(user, context)
+          super(user, context)
+
+          can :read, ParticipatoryProcessGroup
+          can :read, ParticipatoryProcess, &:published?
+        end
+      end
+    end
+  end
+end

data/app/presenters/decidim/participatory_processes/participatory_process_stats_presenter.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Decidim
+  module ParticipatoryProcesses
+    # A presenter to render statistics in the homepage.
+    class ParticipatoryProcessStatsPresenter < Rectify::Presenter
+      attribute :participatory_process, Decidim::ParticipatoryProcess
+      include Decidim::IconHelper
+
+      # Public: Render a collection of primary stats.
+      def highlighted
+        highlighted_stats = feature_stats(priority: StatsRegistry::HIGH_PRIORITY)
+        highlighted_stats = highlighted_stats.concat(feature_stats(priority: StatsRegistry::MEDIUM_PRIORITY))
+        highlighted_stats = highlighted_stats.reject(&:empty?)
+        highlighted_stats = highlighted_stats.reject { |_manifest, _name, data| data.zero? }
+        grouped_highlighted_stats = highlighted_stats.group_by { |stats| stats.first.name }
+
+        safe_join(
+          grouped_highlighted_stats.map do |_manifest_name, stats|
+            content_tag :div, class: "process_stats-item" do
+              safe_join(
+                stats.each_with_index.map do |stat, index|
+                  render_stats_data(stat[0], stat[1], stat[2], index)
+                end
+              )
+            end
+          end
+        )
+      end
+
+      private
+
+      def feature_stats(conditions)
+        Decidim.feature_manifests.map do |feature_manifest|
+          feature_manifest.stats.filter(conditions).with_context(published_features).map { |name, data| [feature_manifest, name, data] }.flatten
+        end
+      end
+
+      def render_stats_data(feature_manifest, name, data, index)
+        safe_join([
+                    index.zero? ? manifest_icon(feature_manifest) : " /&nbsp".html_safe,
+                    content_tag(:span, "#{number_with_delimiter(data)} " + I18n.t(name, scope: "decidim.participatory_processes.statistics"),
+                                class: "#{name} process_stats-text")
+                  ])
+      end
+
+      def published_features
+        @published_features ||= Feature.where(participatory_space: participatory_process).published
+      end
+    end
+  end
+end

data/app/queries/decidim/participatory_processes/admin/admin_users.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Decidim
+  module ParticipatoryProcesses
+    module Admin
+      # A class used to find the admins for a participatory process including
+      # organization admins.
+      class AdminUsers < Rectify::Query
+        # Syntactic sugar to initialize the class and return the queried objects.
+        #
+        # process - a process that needs to find its process admins
+        def self.for(process)
+          new(process).query
+        end
+
+        # Initializes the class.
+        #
+        # process - a process that needs to find its process admins
+        def initialize(process)
+          @process = process
+        end
+
+        # Finds organization admins and the users with role admin for the given process.
+        #
+        # Returns an ActiveRecord::Relation.
+        def query
+          Decidim::User.where(id: organization_admins).or(Decidim::User.where(id: process_admins))
+        end
+
+        private
+
+        attr_reader :process
+
+        def organization_admins
+          process.organization.admins
+        end
+
+        def process_admins
+          Decidim::ParticipatoryProcessUserRole
+            .where(participatory_process: process, role: :admin)
+            .pluck(:decidim_user_id)
+        end
+      end
+    end
+  end
+end

data/app/queries/decidim/participatory_processes/filtered_participatory_process_groups.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Decidim
+  module ParticipatoryProcesses
+    # This query class filters participatory processes groups given a filter name.
+    # The filter is applied checking the start and end dates of the processes in
+    # the group.
+    class FilteredParticipatoryProcessGroups < Rectify::Query
+      def initialize(filter = "active")
+        @filter = filter
+      end
+
+      def query
+        processes = Decidim::ParticipatoryProcess.all
+
+        processes = case @filter
+                    when "past"
+                      processes.where("decidim_participatory_processes.end_date <= ?", Time.current)
+                    when "upcoming"
+                      processes.where("decidim_participatory_processes.start_date > ?", Time.current)
+                    else
+                      processes
+                    end
+
+        Decidim::ParticipatoryProcessGroup.where(id: processes.pluck(:decidim_participatory_process_group_id))
+      end
+    end
+  end
+end

data/app/queries/decidim/participatory_processes/filtered_participatory_processes.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Decidim
+  module ParticipatoryProcesses
+    # This query class filters participatory processes given a filter name.
+    # It uses the start and end dates to select the correct processes.
+    class FilteredParticipatoryProcesses < Rectify::Query
+      def initialize(filter = "active")
+        @filter = filter
+      end
+
+      def query
+        processes = Decidim::ParticipatoryProcess.all
+
+        case @filter
+        when "past"
+          processes.where("decidim_participatory_processes.end_date <= ?", Time.current)
+        when "upcoming"
+          processes.where("decidim_participatory_processes.start_date > ?", Time.current)
+        else
+          processes
+        end
+      end
+    end
+  end
+end

data/app/queries/decidim/participatory_processes/highlighted_participatory_processes.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Decidim
+  module ParticipatoryProcesses
+    # This query selects some prioritized processes.
+    class HighlightedParticipatoryProcesses < Rectify::Query
+      def query
+        PrioritizedParticipatoryProcesses.new.query.limit(8)
+      end
+    end
+  end
+end

data/app/queries/decidim/participatory_processes/organization_participatory_process_groups.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Decidim
+  module ParticipatoryProcesses
+    # This query class filters participatory process groups given an organization.
+    class OrganizationParticipatoryProcessGroups < Rectify::Query
+      def initialize(organization)
+        @organization = organization
+      end
+
+      def query
+        Decidim::ParticipatoryProcessGroup.where(organization: @organization)
+      end
+    end
+  end
+end

data/app/queries/decidim/participatory_processes/organization_participatory_processes.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Decidim
+  module ParticipatoryProcesses
+    # This query class filters all processes given an organization.
+    class OrganizationParticipatoryProcesses < Rectify::Query
+      def initialize(organization)
+        @organization = organization
+      end
+
+      def query
+        Decidim::ParticipatoryProcess.where(organization: @organization)
+      end
+    end
+  end
+end

data/app/queries/decidim/participatory_processes/organization_prioritized_participatory_process_groups.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Decidim
+  module ParticipatoryProcesses
+    # This query class filters participatory process groups given an organization and a filter.
+    class OrganizationPrioritizedParticipatoryProcessGroups < Rectify::Query
+      def initialize(organization, filter = "active")
+        @organization = organization
+        @filter = filter
+      end
+
+      def query
+        Rectify::Query.merge(
+          OrganizationParticipatoryProcessGroups.new(@organization),
+          FilteredParticipatoryProcessGroups.new(@filter)
+        ).query
+      end
+    end
+  end
+end

data/app/queries/decidim/participatory_processes/organization_prioritized_participatory_processes.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Decidim
+  module ParticipatoryProcesses
+    # This query class filters public processes given an organization and a
+    # filter in a meaningful prioritized order.
+    class OrganizationPrioritizedParticipatoryProcesses < Rectify::Query
+      def initialize(organization, filter = "active")
+        @organization = organization
+        @filter = filter
+      end
+
+      def query
+        Rectify::Query.merge(
+          OrganizationPublishedParticipatoryProcesses.new(@organization),
+          PrioritizedParticipatoryProcesses.new,
+          FilteredParticipatoryProcesses.new(@filter)
+        ).query
+      end
+    end
+  end
+end

data/app/queries/decidim/participatory_processes/organization_published_participatory_processes.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Decidim
+  module ParticipatoryProcesses
+    # This query class filters published processes given an organization.
+    class OrganizationPublishedParticipatoryProcesses < Rectify::Query
+      def initialize(organization)
+        @organization = organization
+      end
+
+      def query
+        Rectify::Query.merge(
+          OrganizationParticipatoryProcesses.new(@organization),
+          PublishedParticipatoryProcesses.new
+        ).query
+      end
+    end
+  end
+end

data/app/queries/decidim/participatory_processes/prioritized_participatory_processes.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Decidim
+  module ParticipatoryProcesses
+    # This query orders processes by importance, prioritizing promoted processes
+    # first, and closest to finalization date second.
+    class PrioritizedParticipatoryProcesses < Rectify::Query
+      def query
+        Decidim::ParticipatoryProcess.order(promoted: :desc).includes(:active_step).order("decidim_participatory_process_steps.end_date ASC")
+      end
+    end
+  end
+end

data/app/queries/decidim/participatory_processes/promoted_participatory_processes.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Decidim
+  module ParticipatoryProcesses
+    # This query filters processes so only promoted ones are returned.
+    class PromotedParticipatoryProcesses < Rectify::Query
+      def query
+        Decidim::ParticipatoryProcess.promoted
+      end
+    end
+  end
+end

data/app/queries/decidim/participatory_processes/published_participatory_processes.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Decidim
+  module ParticipatoryProcesses
+    # This query filters published processes only.
+    class PublishedParticipatoryProcesses < Rectify::Query
+      def query
+        Decidim::ParticipatoryProcess.published
+      end
+    end
+  end
+end

data/app/views/decidim/participatory_process_groups/_participatory_process_group.html.erb

@@ -0,0 +1,22 @@
+<div class="column">
+  <article class="card card--process">
+    <%= link_to participatory_process_group_path(participatory_process_group), class: "card__link" do %>
+      <div class="card__image-top"
+           style="background-image:url(<%= participatory_process_group.hero_image.url %>)"></div>
+    <% end %>
+    <div class="card__content">
+      <%= link_to participatory_process_group_path(participatory_process_group), class: "card__link" do %>
+        <h4 class="card__title"><%= translated_attribute participatory_process_group.name %></h4>
+      <% end %>
+      <p class="card__desc"><%== html_truncate(translated_attribute(participatory_process_group.description), length: 630, separator: '...') %></p>
+    </div>
+    <div class="card__footer">
+      <div class="card__support">
+        <span class="card--process__small"></span>
+        <%= link_to participatory_process_group_path(participatory_process_group), class: "card__button button small" do %>
+          <%= t(".browse", scope: "layouts") %>
+        <% end %>
+      </div>
+    </div>
+  </article>
+</div>