decidim-elections 0.23.3 → 0.24.0.rc1

data/app/forms/decidim/elections/trustee_zone/trustee_form.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Elections
+    module TrusteeZone
+      # This class holds a form to modify trustee information.
+      class TrusteeForm < Decidim::Form
+        mimic :trustee
+
+        attribute :name, String
+        attribute :public_key, String
+        validates :name, :public_key, presence: true
+        validate :dont_change_data
+
+        def dont_change_data
+          errors.add :name, :cant_be_changed if trustee.name.present?
+          errors.add :public_key, :cant_be_changed if trustee.public_key.present?
+        end
+
+        def trustee
+          @trustee ||= context[:trustee]
+        end
+      end
+    end
+  end
+end

data/app/forms/decidim/elections/voter/encrypted_vote_form.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Elections
+    module Voter
+      # This class holds the data to cast a vote.
+      class EncryptedVoteForm < Decidim::Form
+        attribute :encrypted_vote, String
+        attribute :encrypted_vote_hash, String
+
+        validates :encrypted_vote, :encrypted_vote_hash, :current_user, :election, presence: true
+        validate :hash_is_valid
+
+        delegate :id, to: :election, prefix: true
+
+        def election_unique_id
+          @election_unique_id ||= Decidim::BulletinBoard::MessageIdentifier.unique_election_id(bulletin_board.authority_slug, election_id)
+        end
+
+        # Public: computes a unique id for the voter/election pair.
+        def voter_id
+          @voter_id ||= Digest::SHA256.hexdigest([current_user.created_at, current_user.id, election.id, bulletin_board.authority_slug].join("."))
+        end
+
+        # Public: returns the associated election for the vote.
+        def election
+          @election ||= context.election
+        end
+
+        def bulletin_board
+          @bulletin_board ||= context[:bulletin_board] || Decidim::Elections.bulletin_board
+        end
+
+        def current_user
+          @current_user ||= context[:current_user]
+        end
+
+        private
+
+        # Private: check if the hash sent by the browser is correct.
+        def hash_is_valid
+          return if encrypted_vote.blank? || encrypted_vote_hash.blank?
+
+          errors.add(:encrypted_vote_hash, :invalid) if Digest::SHA256.hexdigest(encrypted_vote) != encrypted_vote_hash
+        end
+      end
+    end
+  end
+end

data/app/forms/decidim/votings/admin/monitoring_committee_member_form.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Votings
+    module Admin
+      class MonitoringCommitteeMemberForm < Decidim::Form
+        attribute :name, String
+        attribute :email, String
+        attribute :user_id, Integer
+        attribute :existing_user, Boolean, default: false
+
+        validates :email, presence: true, format: { with: ::Devise.email_regexp }, unless: ->(form) { form.existing_user }
+        validates :name, presence: true, format: { with: UserBaseEntity::REGEXP_NAME }, unless: ->(form) { form.existing_user }
+        validates :user, presence: true, if: ->(form) { form.existing_user }
+
+        def map_model(model)
+          self.user_id = model.decidim_user_id
+          self.existing_user = user_id.present?
+        end
+
+        def user
+          @user ||= current_organization.users.find_by(id: user_id)
+        end
+      end
+    end
+  end
+end

data/app/forms/decidim/votings/admin/polling_officer_form.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Votings
+    module Admin
+      class PollingOfficerForm < Decidim::Form
+        attribute :name, String
+        attribute :email, String
+        attribute :user_id, Integer
+        attribute :existing_user, Boolean, default: false
+
+        validates :email, presence: true, format: { with: ::Devise.email_regexp }, unless: ->(form) { form.existing_user }
+        validates :name, presence: true, format: { with: UserBaseEntity::REGEXP_NAME }, unless: ->(form) { form.existing_user }
+        validates :user, presence: true, if: ->(form) { form.existing_user }
+
+        def map_model(model)
+          self.user_id = model.decidim_user_id
+          self.existing_user = user_id.present?
+        end
+
+        def user
+          @user ||= current_organization.users.find_by(id: user_id)
+        end
+      end
+    end
+  end
+end

data/app/forms/decidim/votings/admin/polling_station_form.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Votings
+    module Admin
+      # This class holds a Form to create/update votings from Decidim's admin panel.
+      class PollingStationForm < Decidim::Form
+        include TranslatableAttributes
+
+        def map_model(model)
+          self.polling_station_president_id = model.polling_station_president&.id
+          self.polling_station_manager_ids = model.polling_station_managers.pluck(:id)
+        end
+
+        def geocoding_enabled?
+          Decidim::Map.available?(:geocoding)
+        end
+
+        def has_address?
+          geocoding_enabled? && address.present?
+        end
+
+        def geocoded?
+          latitude.present? && longitude.present?
+        end
+
+        def polling_station_president
+          @polling_station_president ||= PollingOfficer.find_by(id: polling_station_president_id)
+        end
+
+        def polling_station_managers
+          @polling_station_managers ||= PollingOfficer.where(id: polling_station_manager_ids)
+        end
+
+        def voting
+          @voting ||= context[:voting]
+        end
+
+        translatable_attribute :title, String
+        translatable_attribute :location, String
+        translatable_attribute :location_hints, String
+        attribute :address, String
+        attribute :latitude, Float
+        attribute :longitude, Float
+        attribute :polling_station_president_id, Integer
+        attribute :polling_station_manager_ids, Array[Integer]
+
+        validates :title, translatable_presence: true
+        validates :location, translatable_presence: true
+        validates :location_hints, translatable_presence: true
+        validates :address, presence: true
+        validates :address, geocoding: true, if: ->(form) { form.has_address? && !form.geocoded? }
+
+        alias component voting
+      end
+    end
+  end
+end

data/app/forms/decidim/votings/admin/voting_form.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Votings
+    module Admin
+      # This class holds a Form to create/update votings from Decidim's admin panel.
+      class VotingForm < Decidim::Form
+        include TranslatableAttributes
+
+        translatable_attribute :title, String
+        translatable_attribute :description, String
+        attribute :slug, String
+        attribute :start_time, Decidim::Attributes::TimeWithZone
+        attribute :end_time, Decidim::Attributes::TimeWithZone
+        attribute :scope_id, Integer
+        attribute :promoted, Boolean
+        attribute :remove_banner_image
+        attribute :banner_image, String
+        attribute :remove_introductory_image
+        attribute :introductory_image, String
+        attribute :voting_type, String
+
+        validates :title, translatable_presence: true
+        validates :description, translatable_presence: true
+        validates :slug, presence: true, format: { with: Decidim::Votings::Voting.slug_format }
+        validate :slug_uniqueness
+        validates :start_time, presence: true, date: { before: :end_time }
+        validates :end_time, presence: true, date: { after: :start_time }
+        validates :banner_image, passthru: { to: Decidim::Votings::Voting }
+        validates :introductory_image, passthru: { to: Decidim::Votings::Voting }
+        validates :voting_type, presence: true, inclusion: { in: Votings::Voting.voting_types, message: "%{value} is not a valid voting type" }
+
+        validates :scope, presence: true, if: proc { |object| object.scope_id.present? }
+
+        alias organization current_organization
+
+        def map_model(model)
+          self.scope_id = model.decidim_scope_id
+        end
+
+        def scope
+          @scope ||= current_organization.scopes.find_by(id: scope_id)
+        end
+
+        def options_for_voting_type_select
+          Voting.voting_types.map do |key, value|
+            [
+              I18n.t("voting_type.#{key}", scope: "decidim.votings.admin.votings.form"),
+              value
+            ]
+          end
+        end
+
+        private
+
+        def organization_votings
+          Voting.where(organization: current_organization)
+        end
+
+        def slug_uniqueness
+          return unless organization_votings
+                        .where(slug: slug)
+                        .where.not(id: context[:voting_id])
+                        .any?
+
+          errors.add(:slug, :taken)
+        end
+      end
+    end
+  end
+end

data/app/helpers/decidim/elections/admin/answers_helper.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Elections
+    module Admin
+      # Custom helpers for answers on admin dashboard.
+      #
+      module AnswersHelper
+        def selected_label_action_for(answer)
+          if answer.selected
+            t("answers.select.disable", scope: "decidim.elections.admin")
+          else
+            t("answers.select.enable", scope: "decidim.elections.admin")
+          end
+        end
+      end
+    end
+  end
+end

data/app/helpers/decidim/elections/admin/steps_helper.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Elections
+    module Admin
+      # Custom helpers for election steps on admin dashboard.
+      #
+      module StepsHelper
+        def steps(current_step)
+          step_class = "text-success"
+          (["create_election"] + Decidim::Elections::Election.bb_statuses.keys).map do |step|
+            if step == current_step
+              step_class = "text-muted"
+              [step, "text-warning"]
+            else
+              [step, step_class]
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/app/helpers/decidim/elections/admin/trustees_participatory_spaces_helper.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Elections
+    module Admin
+      # Custom helpers for trustees admin.
+      #
+      module TrusteesParticipatorySpacesHelper
+        def trustee_current_participatory_space(trustee)
+          trustee.trustees_participatory_spaces.find_by(participatory_space: current_participatory_space)
+        end
+
+        def considered_icon_action_for(trustee)
+          if trustee_current_participatory_space(trustee).considered
+            "x"
+          else
+            "check"
+          end
+        end
+
+        def considered_label_action_for(trustee)
+          if trustee_current_participatory_space(trustee).considered
+            t("trustees_participatory_spaces.actions.disable", scope: "decidim.elections.admin")
+          else
+            t("trustees_participatory_spaces.actions.enable", scope: "decidim.elections.admin")
+          end
+        end
+      end
+    end
+  end
+end

data/app/helpers/decidim/elections/elections_helper.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Elections
+    # Custom helpers for the elections views.
+    #
+    module ElectionsHelper
+      def vote_action_button
+        if already_voted?
+          last_vote_accepted? ? t("change-vote", scope: "decidim.elections.elections.show.action-button") : t("vote-again", scope: "decidim.elections.elections.show.action-button")
+        else
+          t("vote", scope: "decidim.elections.elections.show.action-button")
+        end
+      end
+
+      def callout_text
+        last_vote_accepted? ? t("already-voted", scope: "decidim.elections.elections.show.callout") : t("vote-rejected", scope: "decidim.elections.elections.show.callout")
+      end
+
+      def already_voted?
+        last_vote.present?
+      end
+
+      def last_vote_accepted?
+        !!last_vote&.accepted?
+      end
+    end
+  end
+end

data/app/helpers/decidim/votings/admin/polling_officers_picker_helper.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Votings
+    module Admin
+      # This class contains helpers needed to show the polling officers picker.
+      module PollingOfficersPickerHelper
+        def polling_officers_picker(form, field, url)
+          picker_options = {
+            id: sanitize_to_id(field),
+            class: "picker-multiple",
+            name: "#{form.object_name}[#{field.to_s.sub(/s$/, "_ids")}]",
+            multiple: true,
+            autosort: true
+          }
+
+          prompt_params = {
+            url: url,
+            text: t("polling_officers_picker.choose_polling_officers", scope: "decidim.votings.admin.polling_officers")
+          }
+
+          form.data_picker(field, picker_options, prompt_params) do |item|
+            { url: url, text: item.name }
+          end
+        end
+      end
+    end
+  end
+end

data/app/helpers/decidim/votings/votings_helper.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Votings
+    module VotingsHelper
+      include Decidim::CheckBoxesTreeHelper
+
+      def filter_states_values
+        TreeNode.new(
+          TreePoint.new("", t("votings.filters.all", scope: "decidim.votings")),
+          [
+            TreePoint.new("active", t("votings.filters.active", scope: "decidim.votings")),
+            TreePoint.new("upcoming", t("votings.filters.upcoming", scope: "decidim.votings")),
+            TreePoint.new("finished", t("votings.filters.finished", scope: "decidim.votings"))
+          ]
+        )
+      end
+    end
+  end
+end

data/app/models/decidim/elections/action.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Elections
+    # The data store for tracking asynchronous Actions done in the Bulletin Board from the Decidim::Elections component.
+    class Action < ApplicationRecord
+      belongs_to :election, foreign_key: "decidim_elections_election_id", class_name: "Decidim::Elections::Election"
+
+      enum status: [:pending, :accepted, :rejected]
+      enum action: [:start_key_ceremony, :start_vote, :end_vote, :start_tally]
+    end
+  end
+end

data/app/models/decidim/elections/election.rb

@@ -13,12 +13,19 @@ module Decidim
       include Decidim::TranslatableResource
       include Traceable
       include Loggable
+      include Decidim::Forms::HasQuestionnaire
 
       translatable_fields :title, :description
+      enum bb_status: [:created, :key_ceremony, :key_ceremony_ended, :vote, :vote_ended, :tally, :tally_ended, :results_published]
+        .map { |status| [status, status.to_s] }.to_h, _prefix: :bb
 
       component_manifest_name "elections"
 
       has_many :questions, foreign_key: "decidim_elections_election_id", class_name: "Decidim::Elections::Question", inverse_of: :election, dependent: :destroy
+      has_many :elections_trustees, foreign_key: "decidim_elections_election_id", dependent: :destroy
+      has_many :trustees, through: :elections_trustees
+      has_many :votes, foreign_key: "decidim_elections_election_id", class_name: "Decidim::Elections::Vote", dependent: :restrict_with_exception
+      has_many :actions, foreign_key: "decidim_elections_election_id", class_name: "Decidim::Elections::Action", dependent: :restrict_with_exception
 
       scope :active, lambda {
         where("start_time <= ?", Time.current)
@@ -60,13 +67,46 @@ module Decidim
         started? && !finished?
       end
 
+      # Public: Checks if the election start_time is minimum some hours later than the present time
+      #
+      # Returns a boolean.
+      def minimum_hours_before_start?
+        start_time > (Time.zone.at(Decidim::Elections.setup_minimum_hours_before_start.hours.from_now))
+      end
+
+      # Public: Checks if the election start_time is maximum some hours before than the present time
+      #
+      # Returns a boolean.
+      def maximum_hours_before_start?
+        start_time < (Time.zone.at(Decidim::Elections.start_vote_maximum_hours_before_start.hours.from_now))
+      end
+
+      # Public: Checks if the number of answers are minimum 2 for each question
+      #
+      # Returns a boolean.
+      def minimum_answers?
+        questions.all? { |question| question.answers.size > 1 }
+      end
+
+      # Public: Checks if the election results are published and election finished
+      #
+      # Returns a boolean.
+      def results_published?
+        bb_results_published?
+      end
+
+      # Public: Checks if the election results present
+      #
+      # Returns a boolean.
+      def results?
+        bb_tally_ended?
+      end
+
       # Public: Checks if the election questions are valid
       #
       # Returns a boolean.
       def valid_questions?
-        questions.each do |question|
-          return false unless question.valid_max_selection?
-        end
+        questions.all?(&:valid_max_selection?)
       end
 
       # Public: Gets the voting period status of the election
@@ -82,6 +122,17 @@ module Decidim
         end
       end
 
+      def trustee_action_required?
+        bb_key_ceremony? || bb_tally?
+      end
+
+      # Public: Checks if the election has a blocked_at value
+      #
+      # Returns a boolean.
+      def blocked?
+        blocked_at.present?
+      end
+
       # Public: Overrides the Resourceable concern method to allow setting permissions at resource level
       def allow_resource_permissions?
         true