decidim-participatory_processes 0.30.2 → 0.31.0.rc1

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

@@ -0,0 +1,312 @@
+# frozen_string_literal: true
+
+module Decidim
+  module ParticipatoryProcesses
+    # Presenter class for calculating and displaying democratic quality statistics
+    # for a participatory process. It handles both automatic metrics and manual
+    # auto-evaluation metrics.
+    class ParticipatoryProcessDemocraticQualityStatsPresenter
+      attr_reader :content_block, :participatory_process
+
+      def initialize(content_block, participatory_process)
+        @content_block = content_block
+        @participatory_process = participatory_process
+      end
+
+      def stats
+        @stats ||= {
+          global_score: calculate_global_score, precision: 2,
+          # Automatic metrics based on platform data
+          automatic: {
+            influence: calculate_automatic_influence,
+            hybridization: calculate_automatic_hybridization,
+            transparency: calculate_automatic_transparency,
+            traceability: calculate_automatic_traceability
+          },
+          # Auto-evaluation metrics based on survey responses
+          auto_evaluation: {
+            inclusiveness: calculate_auto_evaluation_inclusiveness,
+            citizen_influence: calculate_auto_evaluation_citizen_influence,
+            informativeness: calculate_auto_evaluation_informativeness
+          }
+        }
+      end
+
+      # @return [Boolean]
+      def finished_survey?
+        settings.functional_diversity_invited != -1 &&
+          settings.languages_communicated != -1 &&
+          settings.mobility_meeting_access != -1 &&
+          settings.participation_scheduling_times != -1 &&
+          settings.digital_support_offered != -1 &&
+          settings.citizen_influence_level != -1 &&
+          settings.citizen_decisional_intervention != -1 &&
+          settings.published_information_clarity != -1 &&
+          settings.information_provided != -1
+      end
+
+      private
+
+      # Global score
+
+      # @return [Float]
+      def calculate_global_score
+        automatic_metrics = (
+          calculate_automatic_influence +
+          calculate_automatic_hybridization +
+          calculate_automatic_transparency +
+          calculate_automatic_traceability
+        ) / 4.0
+
+        if finished_survey?
+          auto_evaluation_metrics = (
+            calculate_auto_evaluation_inclusiveness +
+            calculate_auto_evaluation_citizen_influence +
+            calculate_auto_evaluation_informativeness
+          ) / 4.0
+
+          (automatic_metrics + auto_evaluation_metrics) / 2.0
+        else
+          automatic_metrics
+        end
+      end
+
+      # Automatic metrics
+
+      # Influence
+
+      # @return [Float]
+      def calculate_automatic_influence
+        (approved_proposals_score +
+          approved_citizen_proposals_relative_score +
+          approved_citizen_proposals_absolute_score +
+          citizen_linked_results_score) / 4.0
+      end
+
+      # @return [Float]
+      def approved_proposals_score
+        percentage_to_scale(all_proposals.accepted.count, all_proposals.count)
+      end
+
+      # @return [Float]
+      def approved_citizen_proposals_relative_score
+        approved_citizen_proposals_count = all_proposals.accepted.with_participants_origin.count
+        total_citizen_proposals_count = all_proposals.with_participants_origin.count
+
+        percentage_to_scale(approved_citizen_proposals_count, total_citizen_proposals_count)
+      end
+
+      # @return [Float]
+      def approved_citizen_proposals_absolute_score
+        approved_citizen_proposals_count = all_proposals.accepted.with_participants_origin.count
+
+        percentage_to_scale(approved_citizen_proposals_count, all_proposals.accepted.count)
+      end
+
+      # @return [Float]
+      def citizen_linked_results_score
+        citizen_results = all_proposals
+                          .with_participants_origin
+                          .joins(:resource_links_from)
+                          .where(
+                            decidim_resource_links: {
+                              name: "linked_results",
+                              to_type: "Decidim::Accountability::Result"
+                            }
+                          )
+
+        percentage_to_scale(citizen_results.count, all_accountability_results.count)
+      end
+
+      # Hybridization
+
+      # @return [Float]
+      def calculate_automatic_hybridization
+        (meetings_component_score +
+           meetings_online_score +
+           meetings_in_person_score +
+           meetings_hybrid_score +
+           meetings_with_proposals_score) / 5.0
+      end
+
+      # @return [Float]
+      def meetings_component_score
+        components.where(manifest_name: "meetings").any? ? 5.0 : 0.0
+      end
+
+      # @return [Float]
+      def meetings_online_score
+        all_meetings.online.any? ? 5.0 : 0.0
+      end
+
+      # @return [Float]
+      def meetings_in_person_score
+        all_meetings.in_person.any? ? 5.0 : 0.0
+      end
+
+      # @return [Float]
+      def meetings_hybrid_score
+        all_meetings.hybrid.any? ? 5.0 : 0.0
+      end
+
+      # @return [Float]
+      def meetings_with_proposals_score
+        if all_meetings.joins(:resource_links_to)
+                       .where(
+                         decidim_resource_links: {
+                           name: "proposals_from_meeting",
+                           to_type: "Decidim::Meetings::Meeting"
+                         }
+                       )
+                       .any?
+          5.0
+        else
+          0.0
+        end
+      end
+
+      # Transparency
+
+      # @return [Float]
+      def calculate_automatic_transparency
+        [
+          answered_proposals_score,
+          completed_results_score
+        ].sum / 2.0
+      end
+
+      # @return [Float]
+      def answered_proposals_score
+        percentage_to_scale(all_proposals.answered.count, all_proposals.count)
+      end
+
+      # @return [Float]
+      def completed_results_score
+        results = all_accountability_results.where(progress: 100)
+        percentage_to_scale(results.count, all_accountability_results.count)
+      end
+
+      # Traceability
+
+      # @return [Float]
+      def calculate_automatic_traceability
+        [
+          proposals_with_history_score,
+          linked_results_score,
+          quality_meetings_score,
+          proposals_linked_to_budgets_score
+        ].sum / 4.0
+      end
+
+      # @return [Float]
+      def proposals_with_history_score
+        linked_proposals_ids = (
+          all_proposals.joins(:resource_links_from).pluck(:id) +
+          all_proposals.joins(:resource_links_to).pluck(:id)
+        ).uniq
+
+        percentage_to_scale(linked_proposals_ids.count, all_proposals.count)
+      end
+
+      # @return [Float]
+      def linked_results_score
+        results = all_proposals
+                  .joins(:resource_links_from)
+                  .where(
+                    decidim_resource_links: {
+                      name: "linked_results",
+                      to_type: "Decidim::Accountability::Result"
+                    }
+                  )
+        percentage_to_scale(results.count, all_proposals.count)
+      end
+
+      # @return [Float]
+      def quality_meetings_score
+        meetings = all_meetings
+                   .where.not(type_of_meeting: Decidim::Meetings::Meeting::TYPE_OF_MEETING[:online])
+                   .where.not(end_time: nil)
+
+        percentage_to_scale(meetings.count, all_meetings.count)
+      end
+
+      # @return [Float]
+      def proposals_linked_to_budgets_score
+        proposals = all_proposals
+                    .joins(:resource_links_to)
+                    .where(decidim_resource_links: { name: "included_proposals", from_type: "Decidim::Budgets::Project" })
+
+        percentage_to_scale(proposals.count, all_proposals.count)
+      end
+
+      # Auto-evaluation metrics
+
+      # @return [Float]
+      def calculate_auto_evaluation_inclusiveness
+        [
+          settings.functional_diversity_invited,
+          settings.languages_communicated,
+          settings.mobility_meeting_access,
+          settings.participation_scheduling_times,
+          settings.digital_support_offered
+        ].sum / 5.0
+      end
+
+      # @return [Float]
+      def calculate_auto_evaluation_citizen_influence
+        (settings.citizen_influence_level + settings.citizen_decisional_intervention) / 2.0
+      end
+
+      # @return [Float]
+      def calculate_auto_evaluation_informativeness
+        (settings.published_information_clarity + settings.information_provided) / 2.0
+      end
+
+      # @return [Float]
+      def percentage_to_scale(value, total)
+        return 1.0 if total.zero?
+
+        percentage = (value.to_f / total) * 100
+        case percentage
+        when 0..20 then 1.0
+        when 20.1..40 then 2.0
+        when 40.1..60 then 3.0
+        when 60.1..80 then 4.0
+        else 5.0
+        end
+      end
+
+      def settings
+        content_block.settings
+      end
+
+      def all_proposals
+        Decidim::Proposals::Proposal.where(component: proposals_components)
+      end
+
+      def all_meetings
+        Decidim::Meetings::Meeting.where(component: meetings_components)
+      end
+
+      def all_accountability_results
+        Decidim::Accountability::Result.where(component: accountability_components)
+      end
+
+      def proposals_components
+        @proposals_components ||= components.where(manifest_name: "proposals")
+      end
+
+      def meetings_components
+        @meetings_components ||= components.where(manifest_name: "meetings")
+      end
+
+      def accountability_components
+        @accountability_components ||= components.where(manifest_name: "accountability")
+      end
+
+      def components
+        @components ||= participatory_process.components
+      end
+    end
+  end
+end

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

@@ -8,17 +8,7 @@ module Decidim
 
       private
 
-      def participatory_space = __getobj__.fetch(:participatory_process_group)
-
-      def participatory_space_sym = :participatory_process_group
-
-      def participatory_processes
-        @participatory_processes ||= participatory_space.participatory_processes
-      end
-
-      def published_components
-        @published_components ||= Component.where(participatory_space: participatory_processes).published
-      end
+      def scope_entity = __getobj__.fetch(:participatory_process_group)
     end
   end
 end

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

@@ -2,7 +2,11 @@
 
 module Decidim
   module ParticipatoryProcesses
-    class ParticipatoryProcessPresenter < SimpleDelegator
+    class ParticipatoryProcessPresenter < ResourcePresenter
+      include Decidim::ResourceHelper
+      include ActionView::Helpers::UrlHelper
+      include Decidim::SanitizeHelper
+
       def hero_image_url
         process.attached_uploader(:hero_image).url
       end
@@ -13,6 +17,36 @@ module Decidim
         Decidim::AreaPresenter.new(process.area).translated_name_with_type
       end
 
+      def title(html_escape: false, all_locales: false)
+        return unless process
+
+        super(process.title, html_escape, all_locales)
+      end
+
+      def description(links: false, strip_tags: false, all_locales: false)
+        return unless process
+
+        content_handle_locale(process.description, all_locales, links, strip_tags)
+      end
+
+      def editor_description(all_locales: false)
+        return unless process
+
+        editor_locales(process.description, all_locales)
+      end
+
+      def short_description(links: false, strip_tags: false, all_locales: false)
+        return unless process
+
+        content_handle_locale(process.short_description, all_locales, links, strip_tags)
+      end
+
+      def editor_short_description(all_locales: false)
+        return unless process
+
+        editor_locales(process.short_description, all_locales)
+      end
+
       def process
         __getobj__
       end

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

@@ -8,9 +8,7 @@ module Decidim
 
       private
 
-      def participatory_space = __getobj__.fetch(:participatory_process)
-
-      def participatory_space_sym = :participatory_processes
+      def scope_entity = __getobj__.fetch(:participatory_process)
     end
   end
 end

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

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Decidim
+  module ParticipatoryProcesses
+    # This class counts all Followers of a participatory process or
+    # participatory processes belonging to a participatory process group
+    class ParticipatoryProcessesStatsFollowersCount < Decidim::StatsFollowersCount
+      def self.for(participatory_space)
+        return 0 unless participatory_space.is_a?(Decidim::ParticipatoryProcess) ||
+                        (participatory_space.is_a?(Decidim::ParticipatoryProcessGroup) &&
+                         participatory_space.participatory_processes.exists?)
+
+        new(participatory_space).query
+      end
+
+      private
+
+      def participatory_space_items
+        @participatory_space_items ||= if participatory_space.is_a?(Decidim::ParticipatoryProcess)
+                                         participatory_space
+                                       else
+                                         participatory_space.participatory_processes
+                                       end
+      end
+
+      def space_components
+        Decidim::Component.where(participatory_space: participatory_space_items).published
+      end
+    end
+  end
+end

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

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Decidim
+  module ParticipatoryProcesses
+    # This class counts unique Participants on a participatory process or
+    # participatory processes belonging to a participatory process group
+    class ParticipatoryProcessesStatsParticipantsCount < Decidim::StatsParticipantsCount
+      def self.for(participatory_space)
+        return 0 unless participatory_space.is_a?(Decidim::ParticipatoryProcess) ||
+                        (participatory_space.is_a?(Decidim::ParticipatoryProcessGroup) &&
+                         participatory_space.participatory_processes.exists?)
+
+        new(participatory_space).query
+      end
+
+      private
+
+      def space_components
+        @space_components ||= if participatory_space.is_a?(Decidim::ParticipatoryProcess)
+                                participatory_space.components
+                              else
+                                Decidim::Component.where(participatory_space: participatory_space.participatory_processes)
+                              end
+      end
+    end
+  end
+end

data/app/serializers/decidim/participatory_processes/participatory_process_importer.rb

@@ -28,7 +28,6 @@ module Decidim
             title:,
             slug:,
             subtitle: attributes["subtitle"],
-            hashtag: attributes["hashtag"],
             description: attributes["description"],
             short_description: attributes["short_description"],
             promoted: attributes["promoted"],

data/app/views/decidim/participatory_processes/admin/{participatory_process_copies → participatory_process_duplicates}/_form.html.erb

@@ -4,26 +4,26 @@
       <div class="row column">
         <%= form.translated :text_field, :title, autofocus: true, aria: { label: :title } %>
       </div>
-      <div class="row column">
+      <div class="row column" data-controller="slug">
         <%= form.text_field :slug, help_text: t(".slug_help_html", url: decidim_form_slug_url(:processes, form.object.slug)) %>
       </div>
       <div class="row column">
         <div class="card">
           <div class="card-divider">
-            <legend><%= t("participatory_process_copies.new.select", scope: "decidim.admin") %></legend>
+            <legend><%= t("participatory_process_duplicates.new.select", scope: "decidim.admin") %></legend>
           </div>
           <div class="card-section">
             <div class="row">
               <div class="columns">
-                <%= form.check_box :copy_steps %>
+                <%= form.check_box :duplicate_steps %>
               </div>
 
               <div class="columns">
-                <%= form.check_box :copy_components %>
+                <%= form.check_box :duplicate_components %>
               </div>
 
               <div class="columns">
-                <%= form.check_box :copy_landing_page_blocks %>
+                <%= form.check_box :duplicate_landing_page_blocks %>
               </div>
             </div>
           </div>

data/app/views/decidim/participatory_processes/admin/participatory_process_duplicates/new.html.erb

@@ -0,0 +1,19 @@
+<% add_decidim_page_title(t("participatory_process_duplicates.new.title", scope: "decidim.admin")) %>
+<div class="item_show__header">
+  <h1 class="item_show__header-title">
+    <%= t("participatory_process_duplicates.new.title", scope: "decidim.admin") %>
+  </h1>
+</div>
+
+<div class="item__edit item__edit-1col">
+  <div class="item__edit-form">
+    <%= decidim_form_for(@form, url: participatory_process_duplicates_path(current_participatory_process), method: :post, html: { class: "form form-defaults duplicate_participatory_process" }) do |f| %>
+      <%= render partial: "form", object: f %>
+      <div class="item__edit-sticky">
+        <div class="item__edit-sticky-container">
+          <%= f.submit t("participatory_process_duplicates.new.duplicate", scope: "decidim.admin"), class: "button button__sm button__secondary" %>
+        </div>
+      </div>
+    <% end %>
+  </div>
+</div>

data/app/views/decidim/participatory_processes/admin/participatory_process_groups/_form.html.erb

@@ -1,5 +1,5 @@
 <div class="form__wrapper">
-  <div class="card" data-component="accordion" id="accordion-title">
+  <div class="card" data-controller="accordion" id="accordion-title">
     <div class="card-divider">
       <button class="card-divider-button" data-open="true" data-controls="panel-title" type="button">
         <%= icon "arrow-right-s-line" %>
@@ -30,7 +30,7 @@
     </div>
   </div>
 
-  <div class="card" data-component="accordion" id="accordion-metadata">
+  <div class="card" data-controller="accordion" id="accordion-metadata">
     <div class="card-divider">
       <button class="card-divider-button" data-open="true" data-controls="panel-metadata" type="button">
         <%= icon "arrow-right-s-line" %>
@@ -41,10 +41,6 @@
     </div>
 
     <div id="panel-metadata" class="card-section">
-      <div class="row column">
-        <%= form.text_field :hashtag %>
-      </div>
-
       <div class="row column">
         <%= form.text_field :group_url %>
       </div>
@@ -75,7 +71,7 @@
     </div>
   </div>
 
-  <div class="card" data-component="accordion" id="accordion-visibility">
+  <div class="card" data-controller="accordion" id="accordion-visibility">
     <div class="card-divider">
       <button class="card-divider-button" data-open="true" data-controls="panel-visibility" type="button">
         <%= icon "arrow-right-s-line" %>

data/app/views/decidim/participatory_processes/admin/participatory_process_groups/index.html.erb

@@ -15,18 +15,18 @@
 <%= admin_tabs(:admin_participatory_processes_menu).render %>
 
 <div class="card">
-  <div class="table-scroll">
+  <div class="table-stacked">
     <table class="table-list">
       <thead>
         <tr>
           <th><%= t("models.participatory_process_group.fields.title", scope: "decidim.admin") %></th>
-          <th></th>
+          <th><%= t("models.participatory_process_group.fields.actions", scope: "decidim.admin") %></th>
         </tr>
       </thead>
       <tbody>
         <% collection.each do |group| %>
           <tr>
-            <td>
+            <td data-label="<%= t("models.participatory_process_group.fields.title", scope: "decidim.admin") %>">
               <% if group.promoted? %>
                 <%= icon_with_tooltip "star-s-fill", t("models.assembly.fields.promoted", scope: "decidim.admin") %>
               <% end %>
@@ -36,20 +36,36 @@
                 <%= translated_attribute(group.title) %>
               <% end %>
             </td>
-            <td class="table-list__actions">
-              <% if allowed_to? :update, :process_group, process_group: group %>
-                <%= icon_link_to "pencil-line", [:edit, group], t("actions.edit", scope: "decidim.admin"), class: "action-icon--edit" %>
-              <% else %>
-                <span class="action-space icon"></span>
-              <% end %>
+            <td class="table-list__actions" data-label="<%= t("models.participatory_process_group.fields.actions", scope: "decidim.admin") %>">
+              <button type="button" data-controller="dropdown" data-target="actions-process-group-<%= group.id %>" aria-label="<%= t("decidim.admin.actions.actions_label", resource: translated_attribute(group.title)) %>">
+                <%= icon "more-fill", class: "text-secondary" %>
+              </button>
 
-              <%= icon_link_to "eye-line", decidim_participatory_processes.participatory_process_group_path(group), t("actions.preview", scope: "decidim.admin"), class: "action-icon--preview", target: "_blank", data: { "external-link": false } %>
+              <div class="inline-block relative">
+                <ul id="actions-process-group-<%= group.id %>" class="dropdown dropdown__action" aria-hidden="true">
+                  <% if allowed_to? :update, :process_group, process_group: group %>
+                    <li class="dropdown__item">
+                      <%= link_to [:edit, group], class: "dropdown__button" do %>
+                        <%= icon "pencil-line" %> <%= t("actions.edit", scope: "decidim.admin") %>
+                      <% end %>
+                    </li>
+                  <% end %>
 
-              <% if allowed_to? :destroy, :process_group, process_group: group %>
-                <%= icon_link_to "delete-bin-line", group, t("actions.destroy", scope: "decidim.admin"), class: "action-icon--remove", method: :delete, data: { confirm: t("actions.confirm_destroy", scope: "decidim.admin") } %>
-              <% else %>
-                <span class="action-space icon"></span>
-              <% end %>
+                  <li class="dropdown__item">
+                    <%= link_to decidim_participatory_processes.participatory_process_group_path(group), class: "dropdown__button", target: "_blank", data: { "external-link": false } do %>
+                      <%= icon "eye-line" %> <%= t("actions.preview", scope: "decidim.admin") %>
+                    <% end %>
+                  </li>
+
+                  <% if allowed_to? :destroy, :process_group, process_group: group %>
+                    <li class="dropdown__item">
+                      <%= link_to group, method: :delete, data: { confirm: t("actions.confirm_destroy", scope: "decidim.admin") }, class: "dropdown__button dropdown__button--danger" do %>
+                        <%= icon "delete-bin-line" %> <%= t("actions.destroy", scope: "decidim.admin") %>
+                      <% end %>
+                    </li>
+                  <% end %>
+                </ul>
+              </div>
             </td>
           </tr>
         <% end %>

data/app/views/decidim/participatory_processes/admin/participatory_process_steps/_form.html.erb

@@ -17,7 +17,7 @@
         <%= form.datetime_field :end_date %>
       </div>
 
-      <div class="row column slug">
+      <div class="row column" data-controller="slug">
         <%= form.text_field :cta_path,
                             help_text: t(".cta_path_help_html", url: decidim_form_slug_url("processes/" + current_participatory_process.slug, form.object.cta_path)) %>
       </div>