Class: Decidim::Proposals::Proposal

Inherits:
ApplicationRecord show all
Includes:
Amendable, Coauthorable, DownloadYourData, Endorsable, FilterableResource, Fingerprintable, Followable, HasAttachments, HasCategory, HasComponent, HasReference, Loggable, NewsletterParticipant, CommentableProposal, Evaluable, ParticipatoryTextSection, Decidim::Publicable, Randomable, Reportable, Resourceable, ScopableResource, Searchable, SoftDeletable, Taxonomizable, Traceable, TranslatableAttributes, TranslatableResource
Defined in:
decidim-proposals/app/models/decidim/proposals/proposal.rb

Overview

The data store for a Proposal in the Decidim::Proposals component.

Constant Summary

Constants included from ParticipatoryTextSection

Decidim::Proposals::ParticipatoryTextSection::LEVELS

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Decidim::Publicable

#previously_published?, #publish!, #published?, #unpublish!

Methods included from TranslatableAttributes

#attachment?, #default_locale?

Methods included from Amendable

#add_author, #amendable?, #amendable_fields, #amendable_form, #amendment, #emendation?, #linked_promoted_resource, #notifiable_identities, #visible_amendments_for, #visible_emendations_for

Methods included from Fingerprintable

#fingerprint

Methods included from Searchable

searchable_resources, searchable_resources_by_type, searchable_resources_of_type_comment, searchable_resources_of_type_component, searchable_resources_of_type_participant, searchable_resources_of_type_participatory_space

Methods included from Followable

#followers

Methods included from HasAttachments

#attachment_context

Class Method Details

.download_your_data_images(user) ⇒ Object 



459
460
461
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 459

def self.download_your_data_images(user)
  user_collection(user).map { |p| p.attachments.collect(&:file) }
end

.evaluator_role_ids_has(value) ⇒ Object

method to filter by assigned evaluator role ID



383
384
385
386
387
388
389
390
391
392
393
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 383

def self.evaluator_role_ids_has(value)
  query = "  :value = any(\n    (SELECT decidim_proposals_evaluation_assignments.evaluator_role_id\n    FROM decidim_proposals_evaluation_assignments\n    WHERE decidim_proposals_evaluation_assignments.decidim_proposal_id = decidim_proposals_proposals.id\n    )\n  )\n  SQL\n  where(query, value:)\nend\n".squish

.export_serializer ⇒ Object 



455
456
457
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 455

def self.export_serializer
  Decidim::Proposals::DownloadYourDataProposalSerializer
end

.log_presenter_class_for(_log) ⇒ Object 



180
181
182
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 180

def self.log_presenter_class_for(_log)
  Decidim::Proposals::AdminLog::ProposalPresenter
end

.newsletter_participant_ids(component) ⇒ Object 



203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 203

def self.newsletter_participant_ids(component)
  proposals = retrieve_proposals_for(component).uniq

  coauthors_recipients_ids = proposals.map { |p| p.notifiable_identities.pluck(:id) }.flatten.compact.uniq

  participants_has_voted_ids = Decidim::Proposals::ProposalVote.joins(:proposal).where(proposal: proposals).joins(:author).map(&:decidim_author_id).flatten.compact.uniq

  endorsements_participants_ids = Decidim::Endorsement.where(resource: proposals)
                                                      .where(decidim_author_type: "Decidim::UserBaseEntity")
                                                      .pluck(:decidim_author_id).to_a.compact.uniq

  commentators_ids = Decidim::Comments::Comment.user_commentators_ids_in(proposals)

  (endorsements_participants_ids + participants_has_voted_ids + coauthors_recipients_ids + commentators_ids).flatten.compact.uniq
end

.ransack(params = {}, options = {}) ⇒ Object 



378
379
380
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 378

def self.ransack(params = {}, options = {})
  ProposalSearch.new(self, params, options)
end

.ransackable_associations(_auth_object = nil) ⇒ Object 



407
408
409
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 407

def self.ransackable_associations(_auth_object = nil)
  %w(taxonomies proposal_state)
end

.ransackable_attributes(_auth_object = nil) ⇒ Object 



403
404
405
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 403

def self.ransackable_attributes(_auth_object = nil)
  %w(id_string search_text title body is_emendation comments_count proposal_votes_count published_at proposal_notes_count)
end

.ransackable_scopes(_auth_object = nil) ⇒ Object 



395
396
397
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 395

def self.ransackable_scopes(_auth_object = nil)
  [:with_any_origin, :with_any_state, :state_eq, :voted_by, :coauthored_by, :related_to, :with_any_taxonomies, :evaluator_role_ids_has]
end

.retrieve_proposals_for(component) ⇒ Object 



194
195
196
197
198
199
200
201
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 194

def self.retrieve_proposals_for(component)
  Decidim::Proposals::Proposal.where(component:).joins(:coauthorships)
                              .includes(:votes, :endorsements)
                              .where(decidim_coauthorships: { decidim_author_type: "Decidim::UserBaseEntity" })
                              .not_hidden
                              .published
                              .not_withdrawn
end

.sort_by_translated_title_asc ⇒ Object 



424
425
426
427
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 424

def self.sort_by_translated_title_asc
  field = Arel::Nodes::InfixOperation.new("->>", arel_table[:title], Arel::Nodes.build_quoted(I18n.locale))
  order(Arel::Nodes::InfixOperation.new("", field, Arel.sql("ASC")))
end

.sort_by_translated_title_desc ⇒ Object 



429
430
431
432
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 429

def self.sort_by_translated_title_desc
  field = Arel::Nodes::InfixOperation.new("->>", arel_table[:title], Arel::Nodes.build_quoted(I18n.locale))
  order(Arel::Nodes::InfixOperation.new("", field, Arel.sql("DESC")))
end

.user_collection(author) ⇒ Object

Returns a collection scoped by an author. Overrides this method in DownloadYourData to support Coauthorable.



186
187
188
189
190
191
192
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 186

def self.user_collection(author)
  return unless author.is_a?(Decidim::User)

  joins(:coauthorships)
    .where(decidim_coauthorships: { coauthorable_type: name })
    .where("decidim_coauthorships.decidim_author_id = ? AND decidim_coauthorships.decidim_author_type = ? ", author.id, author.class.base_class.name)
end

.with_evaluation_assigned_to(user, space) ⇒ Object 



161
162
163
164
165
166
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 161

def self.with_evaluation_assigned_to(user, space)
  evaluator_roles = space.user_roles(:evaluator).where(user:)

  includes(:evaluation_assignments)
    .where(decidim_proposals_evaluation_assignments: { evaluator_role_id: evaluator_roles })
end

Instance Method Details

#accepted? ⇒ Boolean

Public: Checks if the organization has accepted a proposal.

Returns Boolean.

Returns:

  • (Boolean) 


281
282
283
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 281

def accepted?
  state == "accepted"
end

#actions_for_comment(comment, current_user) ⇒ Object 



506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 506

def actions_for_comment(comment, current_user)
  return if comment.commentable != self
  return unless authors.include?(current_user)
  return unless user_has_actions?(comment.author)

  if coauthor_invitations_for(comment.author).any?
    [
      {
        label: I18n.t("decidim.proposals.actions.cancel_coauthor_invitation"),
        url: EngineRouter.main_proxy(component).cancel_proposal_invite_coauthors_path(proposal_id: id, id: comment.author.id),
        icon: "user-forbid-line",
        method: :delete,
        data: { confirm: I18n.t("decidim.proposals.actions.cancel_coauthor_invitation_confirm") }
      }
    ]
  else
    [
      {
        label: I18n.t("decidim.proposals.actions.mark_as_coauthor"),
        url: EngineRouter.main_proxy(component).proposal_invite_coauthors_path(proposal_id: id, id: comment.author.id),
        icon: "user-add-line",
        method: :post,
        data: { confirm: I18n.t("decidim.proposals.actions.mark_as_coauthor_confirm") }
      }
    ]
  end
end

#allow_resource_permissions? ⇒ Boolean

Public: Overrides the ‘allow_resource_permissions?` Resourceable concern method.

Returns:

  • (Boolean) 


464
465
466
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 464

def allow_resource_permissions?
  component.settings.resources_permissions_enabled
end

#answered? ⇒ Boolean

Public: Checks if the organization has given an answer for the proposal.

Returns Boolean.

Returns:

  • (Boolean) 


267
268
269
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 267

def answered?
  answered_at.present?
end

#assign_state(token) ⇒ Object 



35
36
37
38
39
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 35

def assign_state(token)
  proposal_state = Decidim::Proposals::ProposalState.where(component:, token:).first

  self.proposal_state = proposal_state
end

#can_accumulate_votes_beyond_threshold ⇒ Object

Public: Can accumulate more votes than maximum for this proposal.

Returns true if can accumulate, false otherwise



348
349
350
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 348

def can_accumulate_votes_beyond_threshold
  component.settings.can_accumulate_votes_beyond_threshold
end

#coauthor_invitations_for(user) ⇒ Object 



534
535
536
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 534

def coauthor_invitations_for(user)
  Decidim::Notification.where(event_class: "Decidim::Proposals::CoauthorInvitedEvent", resource: self, user:)
end

#draft? ⇒ Boolean

Public: Whether the proposal is a draft or not.

Returns:

  • (Boolean) 


374
375
376
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 374

def draft?
  published_at.nil?
end

#editable_by?(user) ⇒ Boolean

Checks whether the user can edit the given proposal.

user - the user to check for authorship

Returns:

  • (Boolean) 


355
356
357
358
359
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 355

def editable_by?(user)
  return true if draft? && created_by?(user)

  !published_state? && within_edit_time_limit? && !copied_from_other_component? && created_by?(user)
end

#evaluating? ⇒ Boolean

Public: Checks if the organization has marked the proposal as evaluating it.

Returns Boolean.

Returns:

  • (Boolean) 


295
296
297
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 295

def evaluating?
  state == "evaluating"
end

#internal_state ⇒ Object

Public: Returns the internal state of the proposal.

Returns Boolean.



251
252
253
254
255
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 251

def internal_state
  return amendment.state if emendation?

  proposal_state&.token || "not_answered"
end

#maximum_votes ⇒ Object

Public: The maximum amount of votes allowed for this proposal.

Returns an Integer with the maximum amount of votes, nil otherwise.



329
330
331
332
333
334
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 329

def maximum_votes
  maximum_votes = component.settings.threshold_per_proposal
  return nil if maximum_votes.zero?

  maximum_votes
end

#maximum_votes_reached? ⇒ Boolean

Public: The maximum amount of votes allowed for this proposal. 0 means infinite.

Returns true if reached, false otherwise.

Returns:

  • (Boolean) 


339
340
341
342
343
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 339

def maximum_votes_reached?
  return false unless maximum_votes

  votes.count >= maximum_votes
end

#official? ⇒ Boolean

Public: Whether the proposal is official or not.

Returns:

  • (Boolean) 


317
318
319
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 317

def official?
  authors.first.is_a?(Decidim::Organization)
end

#official_meeting? ⇒ Boolean

Public: Whether the proposal is created in a meeting or not.

Returns:

  • (Boolean) 


322
323
324
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 322

def official_meeting?
  authors.first.instance_of?(Decidim::Meetings::Meeting)
end

#presenter ⇒ Object

Returns the presenter for this author, to be used in the views. Required by ResourceRenderer.



301
302
303
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 301

def presenter
  Decidim::Proposals::ProposalPresenter.new(self)
end

#process_amendment_state_change! ⇒ Object 



487
488
489
490
491
492
493
494
495
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 487

def process_amendment_state_change!
  return withdraw! if amendment.withdrawn?
  return unless %w(accepted rejected evaluating).member?(amendment.state)

  PaperTrail.request(enabled: false) do
    assign_state(amendment.state)
    update!(state_published_at: Time.current)
  end
end

#published_state? ⇒ Boolean

Public: Checks if the organization has published the state for the proposal.

Returns Boolean.

Returns:

  • (Boolean) 


260
261
262
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 260

def published_state?
  emendation? || state_published_at.present?
end

#rejected? ⇒ Boolean

Public: Checks if the organization has rejected a proposal.

Returns Boolean.

Returns:

  • (Boolean) 


288
289
290
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 288

def rejected?
  state == "rejected"
end

#reported_attributes ⇒ Object

Public: Overrides the ‘reported_attributes` Reportable concern method.



306
307
308
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 306

def reported_attributes
  [:title, :body]
end

#reported_searchable_content_extras ⇒ Object

Public: Overrides the ‘reported_searchable_content_extras` Reportable concern method. Returns authors name or title in case it is a meeting



312
313
314
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 312

def reported_searchable_content_extras
  [authors.map { |p| p.respond_to?(:name) ? p.name : p.title }.join("\n")]
end

#state ⇒ Object

Public: Returns the published state of the proposal.

Returns Boolean.



238
239
240
241
242
243
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 238

def state
  return amendment.state if emendation?
  return nil unless published_state? || withdrawn?

  proposal_state&.token || "not_answered"
end

#update_votes_count ⇒ Object

Public: Updates the vote count of this proposal.

Returns nothing. rubocop:disable Rails/SkipsModelValidations



223
224
225
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 223

def update_votes_count
  update_columns(proposal_votes_count: votes.count)
end

#user_has_actions?(user) ⇒ Boolean

Returns:

  • (Boolean) 


497
498
499
500
501
502
503
504
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 497

def user_has_actions?(user)
  return false if authors.include?(user)
  return false if user&.blocked?
  return false if user&.deleted?
  return false unless user&.confirmed?

  true
end

#voted_by?(user) ⇒ Boolean

Public: Check if the user has voted the proposal.

Returns Boolean.

Returns:

  • (Boolean) 


231
232
233
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 231

def voted_by?(user)
  ProposalVote.where(proposal: self, author: user).any?
end

#withdraw! ⇒ Object 



368
369
370
371
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 368

def withdraw!
  self.withdrawn_at = Time.zone.now
  save
end

#withdrawable_by?(user) ⇒ Boolean

Checks whether the user can withdraw the given proposal.

user - the user to check for withdrawability.

Returns:

  • (Boolean) 


364
365
366
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 364

def withdrawable_by?(user)
  user && !withdrawn? && authored_by?(user) && !copied_from_other_component?
end

#withdrawn? ⇒ Boolean

Public: Checks if the author has withdrawn the proposal.

Returns Boolean.

Returns:

  • (Boolean) 


274
275
276
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 274

def withdrawn?
  withdrawn_at.present?
end

#within_edit_time_limit? ⇒ Boolean

Checks whether the proposal is inside the time window to be editable or not once published.

Returns:

  • (Boolean) 


469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
 
# File 'decidim-proposals/app/models/decidim/proposals/proposal.rb', line 469

def within_edit_time_limit?
  return true if draft?
  return true if component.settings.proposal_edit_time == "infinite"

  time_value, time_unit = component.settings.edit_time

  limit_time = case time_unit
               when "minutes"
                 updated_at + time_value.minutes
               when "hours"
                 updated_at + time_value.hours
               else
                 updated_at + time_value.days
               end

  Time.current < limit_time
end