2018-07-25 09:30:33 +00:00
|
|
|
# frozen_string_literal: true
|
|
|
|
|
2019-03-28 13:17:42 +00:00
|
|
|
class Todo < ApplicationRecord
|
2016-07-26 21:21:20 +00:00
|
|
|
include Sortable
|
2018-09-11 15:31:34 +00:00
|
|
|
include FromUnion
|
2016-07-26 21:21:20 +00:00
|
|
|
|
2018-12-11 18:15:10 +00:00
|
|
|
# Time to wait for todos being removed when not visible for user anymore.
|
|
|
|
# Prevents TODOs being removed by mistake, for example, removing access from a user
|
|
|
|
# and giving it back again.
|
|
|
|
WAIT_FOR_DELETE = 1.hour
|
|
|
|
|
2016-12-05 12:12:22 +00:00
|
|
|
ASSIGNED = 1
|
|
|
|
MENTIONED = 2
|
|
|
|
BUILD_FAILED = 3
|
|
|
|
MARKED = 4
|
|
|
|
APPROVAL_REQUIRED = 5 # This is an EE-only feature
|
|
|
|
UNMERGEABLE = 6
|
|
|
|
DIRECTLY_ADDRESSED = 7
|
2016-02-12 18:45:44 +00:00
|
|
|
|
2016-06-15 11:20:30 +00:00
|
|
|
ACTION_NAMES = {
|
|
|
|
ASSIGNED => :assigned,
|
|
|
|
MENTIONED => :mentioned,
|
|
|
|
BUILD_FAILED => :build_failed,
|
2016-07-11 10:02:11 +00:00
|
|
|
MARKED => :marked,
|
2016-12-14 14:37:31 +00:00
|
|
|
APPROVAL_REQUIRED => :approval_required,
|
2016-12-05 12:12:22 +00:00
|
|
|
UNMERGEABLE => :unmergeable,
|
|
|
|
DIRECTLY_ADDRESSED => :directly_addressed
|
2017-02-21 23:32:18 +00:00
|
|
|
}.freeze
|
2016-06-15 11:20:30 +00:00
|
|
|
|
2016-02-12 13:17:42 +00:00
|
|
|
belongs_to :author, class_name: "User"
|
2016-02-17 19:45:32 +00:00
|
|
|
belongs_to :note
|
2016-02-12 13:17:42 +00:00
|
|
|
belongs_to :project
|
2018-07-16 13:35:19 +00:00
|
|
|
belongs_to :group
|
2019-03-02 17:31:36 +00:00
|
|
|
belongs_to :target, -> {
|
|
|
|
if self.klass.respond_to?(:with_api_entity_associations)
|
|
|
|
self.with_api_entity_associations
|
|
|
|
else
|
|
|
|
self
|
|
|
|
end
|
|
|
|
}, polymorphic: true, touch: true # rubocop:disable Cop/PolymorphicAssociations
|
2019-05-21 19:20:27 +00:00
|
|
|
|
2016-02-12 13:17:42 +00:00
|
|
|
belongs_to :user
|
2019-05-21 19:20:27 +00:00
|
|
|
belongs_to :issue, -> { where("target_type = 'Issue'") }, foreign_key: :target_id
|
2016-02-12 13:17:42 +00:00
|
|
|
|
2016-02-12 18:45:44 +00:00
|
|
|
delegate :name, :email, to: :author, prefix: true, allow_nil: true
|
|
|
|
|
2018-07-16 13:35:19 +00:00
|
|
|
validates :action, :target_type, :user, presence: true
|
2018-02-04 19:46:14 +00:00
|
|
|
validates :author, presence: true
|
2016-03-18 13:27:26 +00:00
|
|
|
validates :target_id, presence: true, unless: :for_commit?
|
|
|
|
validates :commit_id, presence: true, if: :for_commit?
|
2018-07-16 13:35:19 +00:00
|
|
|
validates :project, presence: true, unless: :group_id
|
|
|
|
validates :group, presence: true, unless: :project_id
|
2016-02-12 13:17:42 +00:00
|
|
|
|
2016-02-12 18:45:44 +00:00
|
|
|
scope :pending, -> { with_state(:pending) }
|
|
|
|
scope :done, -> { with_state(:done) }
|
2018-09-20 13:18:04 +00:00
|
|
|
scope :for_action, -> (action) { where(action: action) }
|
|
|
|
scope :for_author, -> (author) { where(author: author) }
|
|
|
|
scope :for_project, -> (project) { where(project: project) }
|
|
|
|
scope :for_group, -> (group) { where(group: group) }
|
|
|
|
scope :for_type, -> (type) { where(target_type: type) }
|
2018-09-20 15:05:26 +00:00
|
|
|
scope :for_target, -> (id) { where(target_id: id) }
|
|
|
|
scope :for_commit, -> (id) { where(commit_id: id) }
|
2019-06-24 17:48:50 +00:00
|
|
|
scope :with_entity_associations, -> { preload(:target, :author, :note, group: :route, project: [:route, { namespace: :route }]) }
|
2019-05-21 19:20:27 +00:00
|
|
|
scope :joins_issue_and_assignees, -> { left_joins(issue: :assignees) }
|
2016-02-12 18:45:44 +00:00
|
|
|
|
2016-02-12 13:17:42 +00:00
|
|
|
state_machine :state, initial: :pending do
|
2016-02-15 19:49:28 +00:00
|
|
|
event :done do
|
2016-03-16 23:56:23 +00:00
|
|
|
transition [:pending] => :done
|
2016-02-15 19:49:28 +00:00
|
|
|
end
|
|
|
|
|
2016-02-12 13:17:42 +00:00
|
|
|
state :pending
|
|
|
|
state :done
|
|
|
|
end
|
2016-02-12 18:45:44 +00:00
|
|
|
|
2018-07-16 13:35:19 +00:00
|
|
|
after_save :keep_around_commit, if: :commit_id
|
2016-07-03 23:58:58 +00:00
|
|
|
|
2016-07-26 21:21:20 +00:00
|
|
|
class << self
|
2018-09-20 13:18:04 +00:00
|
|
|
# Returns all todos for the given group and its descendants.
|
|
|
|
#
|
|
|
|
# group - A `Group` to retrieve todos for.
|
|
|
|
#
|
|
|
|
# Returns an `ActiveRecord::Relation`.
|
|
|
|
def for_group_and_descendants(group)
|
|
|
|
groups = group.self_and_descendants
|
|
|
|
|
|
|
|
from_union([
|
|
|
|
for_project(Project.for_group(groups)),
|
|
|
|
for_group(groups)
|
|
|
|
])
|
|
|
|
end
|
|
|
|
|
2018-09-20 15:05:26 +00:00
|
|
|
# Returns `true` if the current user has any todos for the given target.
|
|
|
|
#
|
|
|
|
# target - The value of the `target_type` column, such as `Issue`.
|
|
|
|
def any_for_target?(target)
|
|
|
|
exists?(target: target)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Updates the state of a relation of todos to the new state.
|
|
|
|
#
|
|
|
|
# new_state - The new state of the todos.
|
|
|
|
#
|
|
|
|
# Returns an `Array` containing the IDs of the updated todos.
|
|
|
|
def update_state(new_state)
|
|
|
|
# Only update those that are not really on that state
|
|
|
|
base = where.not(state: new_state).except(:order)
|
|
|
|
ids = base.pluck(:id)
|
|
|
|
|
|
|
|
base.update_all(state: new_state)
|
|
|
|
|
|
|
|
ids
|
|
|
|
end
|
|
|
|
|
2017-03-10 11:10:48 +00:00
|
|
|
# Priority sorting isn't displayed in the dropdown, because we don't show
|
|
|
|
# milestones, but still show something if the user has a URL with that
|
|
|
|
# selected.
|
2018-04-04 09:19:47 +00:00
|
|
|
def sort_by_attribute(method)
|
2018-03-05 16:41:48 +00:00
|
|
|
sorted =
|
|
|
|
case method.to_s
|
|
|
|
when 'priority', 'label_priority' then order_by_labels_priority
|
|
|
|
else order_by(method)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Break ties with the ID column for pagination
|
|
|
|
sorted.order(id: :desc)
|
2016-07-26 21:21:20 +00:00
|
|
|
end
|
|
|
|
|
|
|
|
# Order by priority depending on which issue/merge request the Todo belongs to
|
|
|
|
# Todos with highest priority first then oldest todos
|
|
|
|
# Need to order by created_at last because of differences on Mysql and Postgres when joining by type "Merge_request/Issue"
|
|
|
|
def order_by_labels_priority
|
2016-10-17 20:03:06 +00:00
|
|
|
params = {
|
2016-10-28 00:26:56 +00:00
|
|
|
target_type_column: "todos.target_type",
|
2016-10-17 20:03:06 +00:00
|
|
|
target_column: "todos.target_id",
|
|
|
|
project_column: "todos.project_id"
|
|
|
|
}
|
|
|
|
|
|
|
|
highest_priority = highest_label_priority(params).to_sql
|
2016-07-26 21:21:20 +00:00
|
|
|
|
2017-06-21 13:48:12 +00:00
|
|
|
select("#{table_name}.*, (#{highest_priority}) AS highest_priority")
|
|
|
|
.order(Gitlab::Database.nulls_last_order('highest_priority', 'ASC'))
|
|
|
|
.order('todos.created_at')
|
2016-07-26 21:21:20 +00:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2018-07-16 13:35:19 +00:00
|
|
|
def parent
|
|
|
|
project
|
|
|
|
end
|
|
|
|
|
2016-12-14 14:37:31 +00:00
|
|
|
def unmergeable?
|
|
|
|
action == UNMERGEABLE
|
|
|
|
end
|
|
|
|
|
2016-03-08 18:22:50 +00:00
|
|
|
def build_failed?
|
|
|
|
action == BUILD_FAILED
|
|
|
|
end
|
|
|
|
|
2017-04-10 15:51:15 +00:00
|
|
|
def assigned?
|
|
|
|
action == ASSIGNED
|
|
|
|
end
|
|
|
|
|
2016-06-15 11:20:30 +00:00
|
|
|
def action_name
|
|
|
|
ACTION_NAMES[action]
|
|
|
|
end
|
|
|
|
|
2016-02-18 19:16:39 +00:00
|
|
|
def body
|
|
|
|
if note.present?
|
|
|
|
note.note
|
|
|
|
else
|
|
|
|
target.title
|
|
|
|
end
|
2016-02-17 19:45:32 +00:00
|
|
|
end
|
2016-03-16 23:31:30 +00:00
|
|
|
|
|
|
|
def for_commit?
|
|
|
|
target_type == "Commit"
|
|
|
|
end
|
|
|
|
|
|
|
|
# override to return commits, which are not active record
|
|
|
|
def target
|
|
|
|
if for_commit?
|
2016-03-18 16:27:27 +00:00
|
|
|
project.commit(commit_id) rescue nil
|
2016-03-16 23:31:30 +00:00
|
|
|
else
|
|
|
|
super
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2016-03-18 16:24:47 +00:00
|
|
|
def target_reference
|
2016-03-16 23:31:30 +00:00
|
|
|
if for_commit?
|
2017-01-10 23:53:51 +00:00
|
|
|
target.reference_link_text(full: true)
|
2016-03-16 23:31:30 +00:00
|
|
|
else
|
2017-01-10 23:53:51 +00:00
|
|
|
target.to_reference(full: true)
|
2016-03-16 23:31:30 +00:00
|
|
|
end
|
|
|
|
end
|
2016-07-03 23:58:58 +00:00
|
|
|
|
2017-04-10 15:51:15 +00:00
|
|
|
def self_added?
|
|
|
|
author == user
|
|
|
|
end
|
|
|
|
|
|
|
|
def self_assigned?
|
|
|
|
assigned? && self_added?
|
|
|
|
end
|
|
|
|
|
2016-07-03 23:58:58 +00:00
|
|
|
private
|
|
|
|
|
|
|
|
def keep_around_commit
|
|
|
|
project.repository.keep_around(self.commit_id)
|
|
|
|
end
|
2016-02-12 13:17:42 +00:00
|
|
|
end
|