decidim-department_admin 0.8.0

data/lib/decidim/department_admin/engine.rb

@@ -0,0 +1,136 @@
+# frozen_string_literal: true
+
+require "rails"
+require "decidim/core"
+
+module Decidim
+  module DepartmentAdmin
+    # This is the engine that runs on the public interface of department_admin.
+    class Engine < ::Rails::Engine
+      isolate_namespace Decidim::DepartmentAdmin
+
+      # make decorators autoload in development env
+      config.autoload_paths << File.join(
+        Decidim::DepartmentAdmin::Engine.root, "app", "decorators", "{**}"
+      )
+
+      routes do
+        # Add engine routes here
+        # resources :department_admin
+        # root to: "department_admin#index"
+      end
+
+      initializer "department_admin.webpacker.assets_path" do
+        Decidim.register_assets_path File.expand_path("app/packs", root)
+      end
+
+      # rubocop: disable Lint/ConstantDefinitionInBlock
+      initializer "department_admin.permissions_registry" do
+        # activate Decidim LayoutHelper for the overriden views
+        ::Decidim::Admin::ApplicationController.helper ::Decidim::LayoutHelper
+        ::Decidim::ApplicationController.helper ::Decidim::LayoutHelper
+
+        # avoid webpacker to crash when executing before Decidim is loaded
+        next unless Rails.env.test? || defined? DecidimController
+
+        # **
+        # Modify decidim-admin permissions registry
+        # **
+        artifact = ::Decidim::Admin::ApplicationController
+        AdminApplicationControllerPermissions = Class.new(::Decidim::DepartmentAdmin::Permissions)
+        register_new_permissions_for(artifact, AdminApplicationControllerPermissions)
+
+        # **
+        # Modify decidim-particypatory_processes permissions registry
+        # **
+
+        # force the concern to be included so that registry is initialized
+        # we choose some random class already including it
+        require "decidim/participatory_processes/admin/categories_controller"
+        artifact = ::Decidim::ParticipatoryProcesses::Admin::Concerns::ParticipatoryProcessAdmin
+        ParticipatoryProcessesAdminConcernPermissions = Class.new(::Decidim::DepartmentAdmin::Permissions)
+        register_new_permissions_for(artifact, ParticipatoryProcessesAdminConcernPermissions)
+
+        artifact = Decidim::ParticipatoryProcesses::Admin::ApplicationController
+        ParticipatoryProcessesAdminApplicationControllerPermissions = Class.new(::Decidim::DepartmentAdmin::Permissions)
+        register_new_permissions_for(artifact, ParticipatoryProcessesAdminApplicationControllerPermissions)
+
+        # public views produce problems with Devise's current_user
+        # require 'decidim/participatory_processes/application_controller'
+        # artifact= 'Decidim::ParticipatoryProcesses::ApplicationController'
+        # chain= ::Decidim.permissions_registry.chain_for(artifact)
+        # chain << ::Decidim::DepartmentAdmin::Permissions
+
+        # **
+        # Modify decidim-assemblies permissions registry
+        # **
+        require "decidim/assemblies/admin/assembly_copies_controller"
+        require "decidim/assemblies/admin/components_controller"
+        artifact = ::Decidim::Assemblies::Admin::Concerns::AssemblyAdmin
+        AssembliesAdminConcernPermissions = Class.new(::Decidim::DepartmentAdmin::Permissions)
+        register_new_permissions_for(artifact, AssembliesAdminConcernPermissions)
+
+        artifact = Decidim::Assemblies::Admin::ApplicationController
+        AssembliesAdminApplicationControllerPermissions = Class.new(::Decidim::DepartmentAdmin::Permissions)
+        register_new_permissions_for(artifact, AssembliesAdminApplicationControllerPermissions)
+
+        if Decidim::DepartmentAdmin.conferences_defined?
+          # **
+          # Modify decidim-conferences permissions registry
+          # **
+          require "decidim/conferences/admin/conference_copies_controller"
+          require "decidim/conferences/admin/components_controller"
+          artifact = ::Decidim::Conferences::Admin::Concerns::ConferenceAdmin
+          ConferencesAdminConcernPermissions = Class.new(::Decidim::DepartmentAdmin::Permissions)
+          register_new_permissions_for(artifact, ConferencesAdminConcernPermissions)
+
+          artifact = Decidim::Conferences::Admin::ApplicationController
+          ConferencesAdminApplicationControllerPermissions = Class.new(::Decidim::DepartmentAdmin::Permissions)
+          register_new_permissions_for(artifact, ConferencesAdminApplicationControllerPermissions)
+        end
+      end
+      # rubocop: enable Lint/ConstantDefinitionInBlock
+
+      # make decorators available to applications that use this Engine
+      config.to_prepare do
+        decorators = "#{Decidim::DepartmentAdmin::Engine.root}/app/decorators"
+        Dir.glob("#{decorators}/**/*_decorator.rb").each do |decorator|
+          require_dependency(decorator)
+        end
+      end
+
+      config.after_initialize do
+        require "decidim/participatory_processes/participatory_space"
+        # override participatory_processes space manifest permissions with DepartmentAdmin's one
+        manifest = Decidim.find_participatory_space_manifest(:participatory_processes)
+        manifest.permissions_class_name = "Decidim::ParticipatoryProcesses::ParticipatorySpacePermissions"
+        # override assemblies space manifest permissions with DepartmentAdmin's one
+        manifest = Decidim.find_participatory_space_manifest(:assemblies)
+        manifest.permissions_class_name = "Decidim::Assemblies::ParticipatorySpacePermissions"
+        if Decidim::DepartmentAdmin.conferences_defined?
+          # override conferences space manifest permissions with DepartmentAdmin's one
+          manifest = Decidim.find_participatory_space_manifest(:conferences)
+          manifest.permissions_class_name = "Decidim::Conferences::ParticipatorySpacePermissions"
+        end
+      end
+
+      #------------------------------------------------------
+
+      private
+
+      #------------------------------------------------------
+
+      # Modifies the permissions registry for the given +artifact+ with +new_permissions_class+.
+      # NOTE: Previous permissions are cleared and setted to the +new_permissions_class+ for delegation.
+      def register_new_permissions_for(artifact, new_permissions_class)
+        chain = ::Decidim.permissions_registry.chain_for(artifact)
+        # configure old chain, in case new permissions has to delegate
+        new_permissions_class.delegate_chain = chain.dup
+        # re-set the permissions classes to DepartmentAdmin::Permissions' subclass
+        chain.clear
+        chain << new_permissions_class
+        Rails.logger.info("Registered new permissions for #{artifact} to: #{::Decidim.permissions_registry.chain_for(artifact)}")
+      end
+    end
+  end
+end

data/lib/decidim/department_admin/test/factories.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require "decidim/core/test/factories"
+
+FactoryBot.define do
+  factory :department_admin, parent: :user do
+    roles { ["department_admin"] }
+    admin_terms_accepted_at { Time.zone.now }
+    transient do
+      area { nil }
+    end
+
+    after(:build) do |user, evaluator|
+      user.areas << evaluator.area if evaluator.area.present?
+    end
+  end
+end

data/lib/decidim/department_admin/version.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Decidim
+  # This holds the decidim-module-department_admin version.
+  module DepartmentAdmin
+    # see CHANGELOG.md
+    def self.version
+      "0.8.0"
+    end
+  end
+end

data/lib/decidim/department_admin.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require "decidim/department_admin/admin"
+require "decidim/department_admin/engine"
+require "decidim/department_admin/admin_engine"
+
+module Decidim
+  # This namespace holds the logic of the `DepartmentAdmin` module. This module
+  # allows users to create department_admin in a participatory space.
+  module DepartmentAdmin
+    def self.conferences_defined?
+      defined?(Decidim::Conferences::QueryExtensions)
+    end
+  end
+end

metadata

@@ -0,0 +1,189 @@
+--- !ruby/object:Gem::Specification
+name: decidim-department_admin
+version: !ruby/object:Gem::Version
+  version: 0.8.0
+platform: ruby
+authors:
+- Oliver Valls
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2024-11-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: decidim-admin
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.28.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.28.0
+- !ruby/object:Gem::Dependency
+  name: decidim-core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.28.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.28.0
+- !ruby/object:Gem::Dependency
+  name: decidim
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.28.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.28.0
+- !ruby/object:Gem::Dependency
+  name: decidim-conferences
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.28.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.28.0
+- !ruby/object:Gem::Dependency
+  name: decidim-dev
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.28.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.28.0
+description: This Dedicim's module produces a new "department admin" role which restricts
+  the permissions of an Admin into participatory spaces of a given Area.
+email:
+- oliver.vh@coditramuntana.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE-AGPLv3.txt
+- README.md
+- Rakefile
+- app/controllers/decidim/department_admin/admin/application_controller.rb
+- app/controllers/decidim/department_admin/application_controller.rb
+- app/decorators/decidim/admin/newsletters_controller_decorator.rb
+- app/decorators/decidim/admin/users_controller_decorator.rb
+- app/decorators/decidim/area_decorator.rb
+- app/decorators/decidim/assemblies/admin/assemblies_controller_decorator.rb
+- app/decorators/decidim/assemblies/admin/assemblies_helper_decorator.rb
+- app/decorators/decidim/assemblies/create_assembly_decorator.rb
+- app/decorators/decidim/assemblies/parent_assemblies_for_select_decorator.rb
+- app/decorators/decidim/assemblies/permissions_decorator.rb
+- app/decorators/decidim/assemblies/update_assembly_decorator.rb
+- app/decorators/decidim/assemblies_decorator.rb
+- app/decorators/decidim/assemblies_with_user_role_decorator.rb
+- app/decorators/decidim/conference_form_decorator.rb
+- app/decorators/decidim/conferences/admin/conferences_controller_decorator.rb
+- app/decorators/decidim/conferences/create_conference_decorator.rb
+- app/decorators/decidim/conferences/permissions_decorator.rb
+- app/decorators/decidim/conferences/update_conference_decorator.rb
+- app/decorators/decidim/conferences_decorator.rb
+- app/decorators/decidim/conferences_with_user_role_decorator.rb
+- app/decorators/decidim/decidim_form_helper_decorator.rb
+- app/decorators/decidim/invite_user_decorator.rb
+- app/decorators/decidim/invite_user_form_decorator.rb
+- app/decorators/decidim/newsletter_decorator.rb
+- app/decorators/decidim/newsletters_helper_decorator.rb
+- app/decorators/decidim/participatory_process_decorator.rb
+- app/decorators/decidim/participatory_process_group_decorator.rb
+- app/decorators/decidim/participatory_processes/admin/participatory_processes_controller_decorator.rb
+- app/decorators/decidim/participatory_processes/create_participatory_process_decorator.rb
+- app/decorators/decidim/participatory_processes/permissions_decorator.rb
+- app/decorators/decidim/participatory_processes/update_participatory_process_decorator.rb
+- app/decorators/decidim/participatory_processes_with_user_role_decorator.rb
+- app/decorators/decidim/user_decorator.rb
+- app/decorators/lib/decidim/participatory_space_resourceable_decorator.rb
+- app/helpers/decidim/admin/user_roles_helper.rb
+- app/helpers/decidim/department_admin/application_helper.rb
+- app/models/decidim/participatory_space_role_config/department_admin.rb
+- app/overrides/decidim/admin/shared/add_radio_buttons_to_filters.rb
+- app/packs/entrypoints/decidim_department_admin.js
+- app/packs/entrypoints/decidim_department_admin.scss
+- app/packs/images/decidim/department_admin/icon.svg
+- app/packs/stylesheets/decidim/admin/department_admin.scss
+- app/permissions/decidim/assemblies/participatory_space_permissions.rb
+- app/permissions/decidim/conferences/participatory_space_permissions.rb
+- app/permissions/decidim/department_admin/permissions.rb
+- app/permissions/decidim/participatory_processes/participatory_space_permissions.rb
+- app/queries/decidim/admin/user_admin_by_space_name_filter.rb
+- app/queries/decidim/admin/user_admin_filter.rb
+- app/views/decidim/admin/users/_filters.html.erb
+- app/views/decidim/admin/users/_form.html.erb
+- app/views/decidim/admin/users/index.html.erb
+- app/views/decidim/admin/users/show.html.erb
+- app/views/decidim/assemblies/admin/assemblies/index.html.erb
+- app/views/decidim/conferences/admin/conferences/_form.html.erb
+- app/views/decidim/conferences/admin/conferences/index.html.erb
+- app/views/decidim/participatory_processes/admin/participatory_processes/index.html.erb
+- config/assets.rb
+- config/i18n-tasks.yml
+- config/initializers/user_roles.rb
+- config/locales/ca.yml
+- config/locales/cs.yml
+- config/locales/en.yml
+- config/locales/es.yml
+- db/migrate/20190328130102_create_department_admin_areas.rb
+- db/migrate/20210420143021_add_area_to_conferences.rb
+- lib/decidim/department_admin.rb
+- lib/decidim/department_admin/admin.rb
+- lib/decidim/department_admin/admin_engine.rb
+- lib/decidim/department_admin/engine.rb
+- lib/decidim/department_admin/test/factories.rb
+- lib/decidim/department_admin/version.rb
+homepage: https://github.com/decidim/decidim-module-department_admin
+licenses:
+- AGPL-3.0
+metadata:
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.1
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.7
+signing_key:
+specification_version: 4
+summary: A decidim department_admin module
+test_files: []