decidim-elections 0.22.0

data/app/commands/decidim/elections/admin/update_question.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Elections
+    module Admin
+      # This command is executed when the user updates a Question
+      # from the admin panel.
+      class UpdateQuestion < Rectify::Command
+        def initialize(form, question)
+          @form = form
+          @question = question
+        end
+
+        # Updates the question if valid.
+        #
+        # Broadcasts :ok if successful, :invalid otherwise.
+        def call
+          return broadcast(:invalid) if invalid?
+
+          update_question!
+
+          broadcast(:ok, question)
+        end
+
+        private
+
+        attr_reader :form, :question
+
+        def invalid?
+          question.election.started? || form.invalid?
+        end
+
+        def update_question!
+          attributes = {
+            title: form.title,
+            description: form.description,
+            max_selections: form.max_selections,
+            weight: form.weight,
+            random_answers_order: form.random_answers_order
+          }
+
+          Decidim.traceability.update!(
+            question,
+            form.current_user,
+            attributes,
+            visibility: "all"
+          )
+        end
+      end
+    end
+  end
+end

data/app/controllers/decidim/elections/admin/answers_controller.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Elections
+    module Admin
+      # This controller allows the create or update answers for a question.
+      class AnswersController < Admin::ApplicationController
+        include Decidim::Proposals::Admin::Picker
+        helper Decidim::ApplicationHelper
+        helper_method :election, :question, :answers, :answers
+
+        def new
+          enforce_permission_to :update, :answer, election: election, question: question
+          @form = form(AnswerForm).instance
+        end
+
+        def create
+          enforce_permission_to :update, :answer, election: election, question: question
+          @form = form(AnswerForm).from_params(params, election: election, question: question)
+
+          CreateAnswer.call(@form) do
+            on(:ok) do
+              flash[:notice] = I18n.t("answers.create.success", scope: "decidim.elections.admin")
+              redirect_to election_question_answers_path(election, question)
+            end
+
+            on(:invalid) do
+              flash.now[:alert] = I18n.t("answers.create.invalid", scope: "decidim.elections.admin")
+              render action: "new"
+            end
+          end
+        end
+
+        def edit
+          enforce_permission_to :update, :answer, election: election, question: question
+          @form = form(AnswerForm).from_model(answer)
+        end
+
+        def update
+          enforce_permission_to :update, :answer, election: election, question: question
+          @form = form(AnswerForm).from_params(params, election: election, question: question)
+
+          UpdateAnswer.call(@form, answer) do
+            on(:ok) do
+              flash[:notice] = I18n.t("answers.update.success", scope: "decidim.elections.admin")
+              redirect_to election_question_answers_path(election, question)
+            end
+
+            on(:invalid) do
+              flash.now[:alert] = I18n.t("answers.update.invalid", scope: "decidim.elections.admin")
+              render action: "edit"
+            end
+          end
+        end
+
+        def destroy
+          enforce_permission_to :update, :answer, election: election, question: question
+
+          DestroyAnswer.call(answer, current_user) do
+            on(:ok) do
+              flash[:notice] = I18n.t("answers.destroy.success", scope: "decidim.elections.admin")
+            end
+
+            on(:invalid) do
+              flash.now[:alert] = I18n.t("answers.destroy.invalid", scope: "decidim.elections.admin")
+            end
+          end
+
+          redirect_to election_question_answers_path(election, question)
+        end
+
+        private
+
+        def election
+          @election ||= Election.where(component: current_component).find_by(id: params[:election_id])
+        end
+
+        def question
+          @question ||= election.questions.find_by(id: params[:question_id])
+        end
+
+        def answers
+          @answers ||= question.answers
+        end
+
+        def answer
+          answers.find(params[:id])
+        end
+      end
+    end
+  end
+end

data/app/controllers/decidim/elections/admin/application_controller.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Elections
+    module Admin
+      # This controller is the abstract class from which all other controllers of
+      # this engine inherit.
+      #
+      # Note that it inherits from `Decidim::Admin::Components::BaseController`, which
+      # override its layout and provide all kinds of useful methods.
+      class ApplicationController < Decidim::Admin::Components::BaseController
+      end
+    end
+  end
+end

data/app/controllers/decidim/elections/admin/elections_controller.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Elections
+    module Admin
+      # This controller allows the create or update an election.
+      class ElectionsController < Admin::ApplicationController
+        helper_method :elections, :election
+
+        def new
+          enforce_permission_to :create, :election
+          @form = form(ElectionForm).instance
+        end
+
+        def create
+          enforce_permission_to :create, :election
+          @form = form(ElectionForm).from_params(params, current_component: current_component)
+
+          CreateElection.call(@form) do
+            on(:ok) do
+              flash[:notice] = I18n.t("elections.create.success", scope: "decidim.elections.admin")
+              redirect_to elections_path
+            end
+
+            on(:invalid) do
+              flash.now[:alert] = I18n.t("elections.create.invalid", scope: "decidim.elections.admin")
+              render action: "new"
+            end
+          end
+        end
+
+        def edit
+          enforce_permission_to :update, :election, election: election
+          @form = form(ElectionForm).from_model(election)
+        end
+
+        def update
+          enforce_permission_to :update, :election, election: election
+          @form = form(ElectionForm).from_params(params, current_component: current_component)
+
+          UpdateElection.call(@form, election) do
+            on(:ok) do
+              flash[:notice] = I18n.t("elections.update.success", scope: "decidim.elections.admin")
+              redirect_to elections_path
+            end
+
+            on(:invalid) do
+              flash.now[:alert] = I18n.t("elections.update.invalid", scope: "decidim.elections.admin")
+              render action: "edit"
+            end
+          end
+        end
+
+        def destroy
+          enforce_permission_to :delete, :election, election: election
+
+          DestroyElection.call(election, current_user) do
+            on(:ok) do
+              flash[:notice] = I18n.t("elections.destroy.success", scope: "decidim.elections.admin")
+            end
+
+            on(:invalid) do
+              flash.now[:alert] = I18n.t("elections.destroy.invalid", scope: "decidim.elections.admin")
+            end
+          end
+
+          redirect_to elections_path
+        end
+
+        private
+
+        def elections
+          @elections ||= Election.where(component: current_component)
+        end
+
+        def election
+          @election ||= elections.find_by(id: params[:id])
+        end
+      end
+    end
+  end
+end

data/app/controllers/decidim/elections/admin/questions_controller.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Elections
+    module Admin
+      # This controller allows the create or update questions for an election.
+      class QuestionsController < Admin::ApplicationController
+        helper_method :election, :questions, :question
+
+        def new
+          enforce_permission_to :create, :question, election: election
+          @form = form(QuestionForm).instance
+        end
+
+        def create
+          enforce_permission_to :create, :question, election: election
+          @form = form(QuestionForm).from_params(params, election: election)
+
+          CreateQuestion.call(@form) do
+            on(:ok) do
+              flash[:notice] = I18n.t("questions.create.success", scope: "decidim.elections.admin")
+              redirect_to election_questions_path(election)
+            end
+
+            on(:invalid) do
+              flash.now[:alert] = I18n.t("questions.create.invalid", scope: "decidim.elections.admin")
+              render action: "new"
+            end
+          end
+        end
+
+        def edit
+          enforce_permission_to :update, :question, election: election, question: question
+          @form = form(QuestionForm).from_model(question)
+        end
+
+        def update
+          enforce_permission_to :update, :question, election: election, question: question
+          @form = form(QuestionForm).from_params(params, election: election)
+
+          UpdateQuestion.call(@form, question) do
+            on(:ok) do
+              flash[:notice] = I18n.t("questions.update.success", scope: "decidim.elections.admin")
+              redirect_to election_questions_path(election)
+            end
+
+            on(:invalid) do
+              flash.now[:alert] = I18n.t("questions.update.invalid", scope: "decidim.elections.admin")
+              render action: "edit"
+            end
+          end
+        end
+
+        def destroy
+          enforce_permission_to :update, :question, election: election, question: question
+
+          DestroyQuestion.call(question, current_user) do
+            on(:ok) do
+              flash[:notice] = I18n.t("questions.destroy.success", scope: "decidim.elections.admin")
+            end
+
+            on(:invalid) do
+              flash.now[:alert] = I18n.t("questions.destroy.invalid", scope: "decidim.elections.admin")
+            end
+          end
+
+          redirect_to election_questions_path(election)
+        end
+
+        private
+
+        def election
+          @election ||= Election.where(component: current_component).find_by(id: params[:election_id])
+        end
+
+        def questions
+          @questions ||= election.questions
+        end
+
+        def question
+          questions.find(params[:id])
+        end
+      end
+    end
+  end
+end

data/app/controllers/decidim/elections/application_controller.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Elections
+    # This controller is the abstract class from which all other controllers of
+    # this engine inherit.
+    #
+    # Note that it inherits from `Decidim::Components::BaseController`, which
+    # override its layout and provide all kinds of useful methods.
+    class ApplicationController < Decidim::Components::BaseController
+    end
+  end
+end

data/app/controllers/decidim/elections/elections_controller.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Elections
+    # Exposes the elections resources so users can participate on them
+    class ElectionsController < Decidim::Elections::ApplicationController
+    end
+  end
+end

data/app/forms/decidim/elections/admin/answer_form.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Elections
+    module Admin
+      # This class holds a Form to create/update answers from Decidim's admin panel.
+      class AnswerForm < Decidim::Form
+        include TranslatableAttributes
+
+        translatable_attribute :title, String
+        translatable_attribute :description, String
+        attribute :proposal_ids, Array[Integer]
+        attribute :attachment, AttachmentForm
+        attribute :photos, Array[String]
+        attribute :add_photos, Array
+        attribute :weight, Integer, default: 0
+
+        validates :title, translatable_presence: true
+        validate :notify_missing_attachment_if_errored
+
+        def map_model(model)
+          self.proposal_ids = model.linked_resources(:proposals, "related_proposals").pluck(:id)
+        end
+
+        def proposals
+          @proposals ||= Decidim.find_resource_manifest(:proposals)
+                                .try(:resource_scope, current_component)
+                                &.where(id: proposal_ids)
+                                &.order(title: :asc)
+        end
+
+        def election
+          @election ||= context[:election]
+        end
+
+        def question
+          @question ||= context[:question]
+        end
+
+        private
+
+        # This method will add an error to the `attachment` field only if there's
+        # any error in any other field. This is needed because when the form has
+        # an error, the attachment is lost, so we need a way to inform the user of
+        # this problem.
+        def notify_missing_attachment_if_errored
+          errors.add(:attachment, :needs_to_be_reattached) if errors.any? && attachment.present?
+          errors.add(:add_photos, :needs_to_be_reattached) if errors.any? && add_photos.present?
+        end
+      end
+    end
+  end
+end

data/app/forms/decidim/elections/admin/election_form.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Elections
+    module Admin
+      # This class holds a Form to create/update elections from Decidim's admin panel.
+      class ElectionForm < Decidim::Form
+        include TranslatableAttributes
+
+        translatable_attribute :title, String
+        translatable_attribute :subtitle, String
+        translatable_attribute :description, String
+        attribute :start_time, Decidim::Attributes::TimeWithZone
+        attribute :end_time, Decidim::Attributes::TimeWithZone
+
+        validates :title, translatable_presence: true
+        validates :subtitle, translatable_presence: true
+        validates :description, translatable_presence: true
+        validates :start_time, presence: true, date: { before: :end_time }
+        validates :end_time, presence: true, date: { after: :start_time }
+      end
+    end
+  end
+end

data/app/forms/decidim/elections/admin/question_form.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Elections
+    module Admin
+      # This class holds a Form to create/update questions from Decidim's admin panel.
+      class QuestionForm < Decidim::Form
+        include TranslatableAttributes
+
+        translatable_attribute :title, String
+        translatable_attribute :description, String
+        attribute :max_selections, Integer, default: 1
+        attribute :weight, Integer, default: 0
+        attribute :random_answers_order, Boolean, default: true
+
+        validates :title, translatable_presence: true
+        validates :description, translatable_presence: true
+        validates :max_selections, presence: true, numericality: { greater_than_or_equal_to: 0 }
+
+        def election
+          @election ||= context[:election]
+        end
+      end
+    end
+  end
+end