decidim-assemblies 0.8.4 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 36bdde02af4051c46ec0dfe0fa5f01a80bb4c4ee
-  data.tar.gz: a761f3f9f2ec9a17707a5987559ba09ed766e6ad
+SHA256:
+  metadata.gz: 239b54948da6dacd5224932fd59660b9593c5f47658af0ece3f2e77cac509574
+  data.tar.gz: f781b393aeaf19a7a5d5646c6fbb98fd450c79449ff054d0bb7d639490703ef7
 SHA512:
-  metadata.gz: 67d0794a61829846d36a3d8fc3c3c5ce11f4acbf8c57f59ea78e90e0263c257eef2bd8c1b75df0e548b20e5b26c7b96535af9f4b053037a0fb597fcdf3fd0d00
-  data.tar.gz: e2c685cf545dd8890512dc11b9c699f9c1e741957844729e00c67cd82f71199e1694c7e121543786b6ae5f642eccd79fc4f080c55b9c1adcce5c489d427cad43
+  metadata.gz: 6ca312550fe3293500f448d66eca8c343192cf4e6f416f5e8e22c2fc8e106f3b7cb7ac4f444db1b5e29a413dede542e54754b06258ee8d124ce17061a11a26f3
+  data.tar.gz: 3a2eaf20e4de03122cf94a3a1b71d8e8058bf1acbcff54c01f973aa6f0a947e0142260e3d7bcbcf481925911728c70f7405fbc56faf716f22afc237ee17d95b3

data/README.md

@@ -9,7 +9,7 @@ can be fully managed via an administration UI.
 
 ## Usage
 
-This plugin provides:
+This module provides:
 
 * A CRUD engine to manage assemblies.
 

data/app/assets/javascripts/decidim/assemblies/admin/assemblies.js.es6

@@ -1,12 +1,14 @@
 $(() => {
-  const $assemblyScopeEnabled = $('#assembly_scopes_enabled');
-  const $assemblyScopeId = $("#assembly_scope_id");
+  ((exports) => {
+    const $assemblyScopeEnabled = $('#assembly_scopes_enabled');
+    const $assemblyScopeId = $("#assembly_scope_id");
 
-  if ($('.edit_assembly, .new_assembly').length > 0) {
-    $assemblyScopeEnabled.on('change', (event) => {
-      const checked = event.target.checked;
-      $assemblyScopeId.attr("disabled", !checked);
-    })
-    $assemblyScopeId.attr("disabled", !$assemblyScopeEnabled.prop('checked'));
-  }
+    if ($('.edit_assembly, .new_assembly').length > 0) {
+      $assemblyScopeEnabled.on('change', (event) => {
+        const checked = event.target.checked;
+        exports.theDataPicker.enabled($assemblyScopeId, checked);
+      })
+      exports.theDataPicker.enabled($assemblyScopeId, $assemblyScopeEnabled.prop('checked'));
+    }
+  })(window);
 });

data/app/commands/decidim/assemblies/admin/create_assembly_admin.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Assemblies
+    module Admin
+      # A command with all the business logic when creating a new participatory
+      # process admin in the system.
+      class CreateAssemblyAdmin < Rectify::Command
+        # Public: Initializes the command.
+        #
+        # form - A form object with the params.
+        # assembly - The Assembly that will hold the
+        #   user role
+        def initialize(form, current_user, assembly)
+          @form = form
+          @current_user = current_user
+          @assembly = assembly
+        end
+
+        # Executes the command. Broadcasts these events:
+        #
+        # - :ok when everything is valid.
+        # - :invalid if the form wasn't valid and we couldn't proceed.
+        #
+        # Returns nothing.
+        def call
+          return broadcast(:invalid) if form.invalid?
+
+          ActiveRecord::Base.transaction do
+            create_or_invite_user
+            create_role
+          end
+
+          broadcast(:ok)
+        rescue ActiveRecord::RecordInvalid
+          form.errors.add(:email, :taken)
+          broadcast(:invalid)
+        end
+
+        private
+
+        attr_reader :form, :assembly, :current_user, :user
+
+        def create_role
+          Decidim::AssemblyUserRole.find_or_create_by!(
+            role: form.role.to_sym,
+            user: user,
+            assembly: @assembly
+          )
+        end
+
+        def create_or_invite_user
+          @user ||= existing_user || new_user
+        end
+
+        def existing_user
+          return @existing_user if defined?(@existing_user)
+
+          @existing_user = User.where(
+            email: form.email,
+            organization: assembly.organization
+          ).first
+
+          InviteUserAgain.call(@existing_user, invitation_instructions) if @existing_user && !@existing_user.invitation_accepted?
+
+          @existing_user
+        end
+
+        def new_user
+          @new_user ||= InviteUser.call(user_form) do
+            on(:ok) do |user|
+              return user
+            end
+          end
+        end
+
+        def user_form
+          OpenStruct.new(name: form.name,
+                         email: form.email.downcase,
+                         organization: assembly.organization,
+                         admin: false,
+                         invited_by: current_user,
+                         invitation_instructions: invitation_instructions)
+        end
+
+        def invitation_instructions
+          return "invite_admin" if form.role == "admin"
+          "invite_collaborator"
+        end
+      end
+    end
+  end
+end

data/app/commands/decidim/assemblies/admin/update_assembly_admin.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Assemblies
+    module Admin
+      # A command with all the business logic when updated a participatory
+      # process admin in the system.
+      class UpdateAssemblyAdmin < Rectify::Command
+        # Public: Initializes the command.
+        #
+        # form - A form object with the params.
+        # user_role - The AssemblyUSerRole to update
+        def initialize(form, user_role)
+          @form = form
+          @user_role = user_role
+        end
+
+        # Executes the command. Broadcasts these events:
+        #
+        # - :ok when everything is valid.
+        # - :invalid if the form wasn't valid and we couldn't proceed.
+        #
+        # Returns nothing.
+        def call
+          return broadcast(:invalid) if form.invalid?
+          return broadcast(:invalid) unless user_role
+
+          update_role!
+          broadcast(:ok)
+        end
+
+        private
+
+        attr_reader :form, :user_role
+
+        def update_role!
+          user_role.update_attributes!(role: form.role)
+        end
+      end
+    end
+  end
+end

data/app/controllers/decidim/assemblies/admin/assemblies_controller.rb

@@ -6,7 +6,7 @@ module Decidim
       # Controller that allows managing assemblies.
       #
       class AssembliesController < Decidim::Admin::ApplicationController
-        helper_method :current_assembly
+        helper_method :current_assembly, :current_participatory_space
         layout "decidim/admin/assemblies"
 
         def index
@@ -83,9 +83,7 @@ module Decidim
           ).first
         end
 
-        def current_participatory_space
-          current_assembly
-        end
+        alias current_participatory_space current_assembly
 
         def collection
           @collection ||= OrganizationAssemblies.new(current_user.organization).query

data/app/controllers/decidim/assemblies/admin/assembly_user_roles_controller.rb

@@ -0,0 +1,99 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Assemblies
+    module Admin
+      # Controller that allows managing assembly user roles.
+      #
+      class AssemblyUserRolesController < Decidim::Assemblies::Admin::ApplicationController
+        include Concerns::AssemblyAdmin
+
+        def index
+          authorize! :read, Decidim::AssemblyUserRole
+          @assembly_user_roles = collection
+        end
+
+        def new
+          authorize! :create, Decidim::AssemblyUserRole
+          @form = form(AssemblyUserRoleForm).instance
+        end
+
+        def create
+          authorize! :create, Decidim::AssemblyUserRole
+          @form = form(AssemblyUserRoleForm).from_params(params)
+
+          CreateAssemblyAdmin.call(@form, current_user, current_assembly) do
+            on(:ok) do
+              flash[:notice] = I18n.t("assembly_user_roles.create.success", scope: "decidim.admin")
+            end
+
+            on(:invalid) do
+              flash[:alert] = I18n.t("assembly_user_roles.create.error", scope: "decidim.admin")
+            end
+            redirect_to assembly_user_roles_path(current_assembly)
+          end
+        end
+
+        def edit
+          @user_role = collection.find(params[:id])
+          authorize! :update, @user_role
+          @form = form(AssemblyUserRoleForm).from_model(@user_role.user)
+        end
+
+        def update
+          @user_role = collection.find(params[:id])
+          authorize! :update, @user_role
+          @form = form(AssemblyUserRoleForm).from_params(params)
+
+          UpdateAssemblyAdmin.call(@form, @user_role) do
+            on(:ok) do
+              flash[:notice] = I18n.t("assembly_user_roles.update.success", scope: "decidim.admin")
+              redirect_to assembly_user_roles_path(current_assembly)
+            end
+
+            on(:invalid) do
+              flash.now[:alert] = I18n.t("assembly_user_roles.update.error", scope: "decidim.admin")
+              render :edit
+            end
+          end
+        end
+
+        def destroy
+          @assembly_user_role = collection.find(params[:id])
+          authorize! :destroy, @assembly_user_role
+          @assembly_user_role.destroy!
+
+          flash[:notice] = I18n.t("assembly_user_roles.destroy.success", scope: "decidim.admin")
+
+          redirect_to assembly_user_roles_path(@assembly_user_role.assembly)
+        end
+
+        def resend_invitation
+          @user_role = collection.find(params[:id])
+          authorize! :invite, @user_role
+
+          InviteUserAgain.call(@user_role.user, "invite_admin") do
+            on(:ok) do
+              flash[:notice] = I18n.t("users.resend_invitation.success", scope: "decidim.admin")
+            end
+
+            on(:invalid) do
+              flash[:alert] = I18n.t("users.resend_invitation.error", scope: "decidim.admin")
+            end
+          end
+
+          redirect_to assembly_user_roles_path(current_assembly)
+        end
+
+        private
+
+        def collection
+          @collection ||= Decidim::AssemblyUserRole
+                          .includes(:user)
+                          .where(assembly: current_assembly)
+                          .order(:role, "decidim_users.name")
+        end
+      end
+    end
+  end
+end

data/app/forms/decidim/assemblies/admin/assembly_user_role_form.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Assemblies
+    module Admin
+      # A form object used to create assembly user roles from the admin dashboard.
+      #
+      class AssemblyUserRoleForm < Form
+        mimic :assembly_user_role
+
+        attribute :name, String
+        attribute :email, String
+        attribute :role, String
+
+        validates :email, :role, presence: true
+        validates :name, presence: true
+        validates :role, inclusion: { in: Decidim::AssemblyUserRole::ROLES }
+
+        def roles
+          Decidim::AssemblyUserRole::ROLES.map do |role|
+            [
+              I18n.t(role, scope: "decidim.admin.models.assembly_user_role.roles"),
+              role
+            ]
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -10,6 +10,7 @@ module Decidim
             super
 
             can :manage, Assembly
+            can :manage, Decidim::AssemblyUserRole
           end
         end
       end

data/app/models/decidim/assemblies/abilities/admin/assembly_admin_ability.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Assemblies
+    module Abilities
+      module Admin
+        # Defines the abilities for an assembly admin user. Intended to be used
+        # with `cancancan`.
+        class AssemblyAdminAbility < Decidim::Assemblies::Abilities::Admin::AssemblyRoleAbility
+          def define_abilities
+            super
+
+            can :manage, Assembly do |assembly|
+              can_manage_assembly?(assembly)
+            end
+
+            cannot :create, Assembly
+            cannot :destroy, Assembly
+          end
+
+          def role
+            :admin
+          end
+
+          def define_assembly_abilities
+            can :manage, Feature do |feature|
+              can_manage_assembly?(feature.participatory_space)
+            end
+
+            can :manage, Category do |category|
+              can_manage_assembly?(category.participatory_space)
+            end
+
+            can :manage, Attachment do |attachment|
+              attachment.attached_to.is_a?(Decidim::Assembly) && can_manage_assembly?(attachment.attached_to)
+            end
+
+            can :manage, AssemblyUserRole do |role|
+              can_manage_assembly?(role.assembly) && role.user != @user
+            end
+
+            can :manage, Moderation do |moderation|
+              can_manage_assembly?(moderation.participatory_space)
+            end
+
+            can [:unreport, :hide], Reportable do |reportable|
+              can_manage_assembly?(reportable.feature.participatory_space)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/app/models/decidim/assemblies/abilities/admin/assembly_collaborator_ability.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Assemblies
+    module Abilities
+      module Admin
+        # Defines the abilities for an assembly collaborator user. Intended to be used
+        # with `cancancan`.
+        class AssemblyCollaboratorAbility < Decidim::Assemblies::Abilities::Admin::AssemblyRoleAbility
+          def define_abilities
+            super
+
+            can [:read, :preview], Assembly do |assembly|
+              can_manage_assembly?(assembly)
+            end
+          end
+
+          def role
+            :collaborator
+          end
+        end
+      end
+    end
+  end
+end

data/app/models/decidim/assemblies/abilities/admin/assembly_moderator_ability.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Assemblies
+    module Abilities
+      module Admin
+        # Defines the abilities for an assembly moderator user. Intended to be used
+        # with `cancancan`.
+        class AssemblyModeratorAbility < Decidim::Assemblies::Abilities::Admin::AssemblyRoleAbility
+          def define_abilities
+            super
+
+            can [:index, :read], Assembly do |assembly|
+              can_manage_assembly?(assembly)
+            end
+
+            can :manage, Moderation do |moderation|
+              can_manage_assembly?(moderation.participatory_space)
+            end
+
+            can [:unreport, :hide], Reportable do |reportable|
+              can_manage_assembly?(reportable.feature.participatory_space)
+            end
+          end
+
+          def role
+            :moderator
+          end
+        end
+      end
+    end
+  end
+end