2018-07-25 09:30:33 +00:00
|
|
|
# frozen_string_literal: true
|
|
|
|
|
2017-04-06 15:05:57 +00:00
|
|
|
# A note on the root of an issue, merge request, commit, or snippet.
|
|
|
|
#
|
|
|
|
# A note of this type is never resolvable.
|
2019-03-28 13:17:42 +00:00
|
|
|
class Note < ApplicationRecord
|
2016-05-10 22:41:46 +00:00
|
|
|
extend ActiveModel::Naming
|
2020-07-16 12:09:22 +00:00
|
|
|
include Gitlab::Utils::StrongMemoize
|
2015-04-21 13:23:20 +00:00
|
|
|
include Participable
|
2015-10-14 14:20:11 +00:00
|
|
|
include Mentionable
|
2016-05-25 19:07:36 +00:00
|
|
|
include Awardable
|
2016-06-13 11:34:36 +00:00
|
|
|
include Importable
|
2016-08-08 14:18:13 +00:00
|
|
|
include FasterCacheKeys
|
2018-09-20 14:14:46 +00:00
|
|
|
include Redactable
|
2016-10-06 21:52:44 +00:00
|
|
|
include CacheMarkdownField
|
2016-10-13 15:26:44 +00:00
|
|
|
include AfterCommitQueue
|
2017-03-10 01:29:11 +00:00
|
|
|
include ResolvableNote
|
2017-05-18 12:24:34 +00:00
|
|
|
include Editable
|
2017-11-24 10:45:19 +00:00
|
|
|
include Gitlab::SQL::Pattern
|
2017-12-01 13:52:16 +00:00
|
|
|
include ThrottledTouch
|
2018-09-11 15:31:34 +00:00
|
|
|
include FromUnion
|
2017-04-04 22:41:04 +00:00
|
|
|
|
2017-07-29 15:04:42 +00:00
|
|
|
module SpecialRole
|
|
|
|
FIRST_TIME_CONTRIBUTOR = :first_time_contributor
|
|
|
|
|
|
|
|
class << self
|
|
|
|
def values
|
2019-10-16 03:06:12 +00:00
|
|
|
constants.map {|const| self.const_get(const, false)}
|
2017-07-29 15:04:42 +00:00
|
|
|
end
|
2019-07-31 13:49:56 +00:00
|
|
|
|
|
|
|
def value?(val)
|
|
|
|
values.include?(val)
|
|
|
|
end
|
2017-07-29 15:04:42 +00:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2017-04-19 14:38:46 +00:00
|
|
|
cache_markdown_field :note, pipeline: :note, issuable_state_filter_enabled: true
|
2013-05-09 23:37:47 +00:00
|
|
|
|
2018-09-20 14:14:46 +00:00
|
|
|
redact_field :note
|
|
|
|
|
2019-10-25 12:46:40 +00:00
|
|
|
TYPES_RESTRICTED_BY_ABILITY = {
|
|
|
|
branch: :download_code
|
|
|
|
}.freeze
|
|
|
|
|
2017-05-03 11:16:36 +00:00
|
|
|
# Aliases to make application_helper#edited_time_ago_with_tooltip helper work properly with notes.
|
2019-09-18 14:02:45 +00:00
|
|
|
# See https://gitlab.com/gitlab-org/gitlab-foss/merge_requests/10392/diffs#note_28719102
|
2017-05-03 11:11:19 +00:00
|
|
|
alias_attribute :last_edited_at, :updated_at
|
|
|
|
alias_attribute :last_edited_by, :updated_by
|
|
|
|
|
2018-10-06 12:47:30 +00:00
|
|
|
# Attribute containing rendered and redacted Markdown as generated by
|
|
|
|
# Banzai::ObjectRenderer.
|
2016-10-06 21:52:44 +00:00
|
|
|
attr_accessor :redacted_note_html
|
2016-06-21 11:35:09 +00:00
|
|
|
|
2018-09-27 18:58:23 +00:00
|
|
|
# Total of all references as generated by Banzai::ObjectRenderer
|
|
|
|
attr_accessor :total_reference_count
|
|
|
|
|
2018-10-06 12:47:30 +00:00
|
|
|
# Number of user visible references as generated by Banzai::ObjectRenderer
|
2016-07-04 05:31:43 +00:00
|
|
|
attr_accessor :user_visible_reference_count
|
|
|
|
|
2017-07-29 15:04:42 +00:00
|
|
|
# Attribute used to store the attributes that have been changed by quick actions.
|
2016-11-24 06:32:32 +00:00
|
|
|
attr_accessor :commands_changes
|
|
|
|
|
2017-07-29 15:04:42 +00:00
|
|
|
# A special role that may be displayed on issuable's discussions
|
2020-07-22 18:09:27 +00:00
|
|
|
attr_reader :special_role
|
2017-08-29 13:46:40 +00:00
|
|
|
|
2014-04-09 10:36:25 +00:00
|
|
|
default_value_for :system, false
|
|
|
|
|
2016-05-26 11:38:28 +00:00
|
|
|
attr_mentionable :note, pipeline: :note
|
2015-10-14 14:20:11 +00:00
|
|
|
participant :author
|
2012-09-26 18:17:17 +00:00
|
|
|
|
2011-10-08 21:36:38 +00:00
|
|
|
belongs_to :project
|
2017-12-01 13:52:16 +00:00
|
|
|
belongs_to :noteable, polymorphic: true # rubocop:disable Cop/PolymorphicAssociations
|
2012-09-27 06:20:36 +00:00
|
|
|
belongs_to :author, class_name: "User"
|
2015-07-30 12:45:54 +00:00
|
|
|
belongs_to :updated_by, class_name: "User"
|
2017-05-03 05:32:21 +00:00
|
|
|
belongs_to :last_edited_by, class_name: 'User'
|
2020-05-26 18:08:20 +00:00
|
|
|
belongs_to :review, inverse_of: :notes
|
2011-10-08 21:36:38 +00:00
|
|
|
|
2018-02-05 11:26:33 +00:00
|
|
|
has_many :todos
|
2018-12-13 19:17:19 +00:00
|
|
|
|
|
|
|
# The delete_all definition is required here in order
|
|
|
|
# to generate the correct DELETE sql for
|
|
|
|
# suggestions.delete_all calls
|
|
|
|
has_many :suggestions, -> { order(:relative_order) },
|
|
|
|
inverse_of: :note, dependent: :delete_all # rubocop:disable Cop/ActiveRecordDependent
|
2019-09-06 09:54:58 +00:00
|
|
|
has_many :events, as: :target, dependent: :delete_all # rubocop:disable Cop/ActiveRecordDependent
|
2017-03-15 13:19:45 +00:00
|
|
|
has_one :system_note_metadata
|
2018-05-16 15:46:18 +00:00
|
|
|
has_one :note_diff_file, inverse_of: :diff_note, foreign_key: :diff_note_id
|
2020-04-15 12:09:18 +00:00
|
|
|
has_many :diff_note_positions
|
2016-02-17 19:45:32 +00:00
|
|
|
|
2016-03-06 01:43:12 +00:00
|
|
|
delegate :gfm_reference, :local_reference, to: :noteable
|
2012-09-27 06:20:36 +00:00
|
|
|
delegate :name, to: :project, prefix: true
|
|
|
|
delegate :name, :email, to: :author, prefix: true
|
2016-05-08 18:05:45 +00:00
|
|
|
delegate :title, to: :noteable, allow_nil: true
|
2011-11-03 10:56:26 +00:00
|
|
|
|
2017-01-05 13:36:06 +00:00
|
|
|
validates :note, presence: true
|
2019-07-17 09:54:40 +00:00
|
|
|
validates :note, length: { maximum: Gitlab::Database::MAX_TEXT_SIZE_LIMIT }
|
2017-11-01 17:35:14 +00:00
|
|
|
validates :project, presence: true, if: :for_project_noteable?
|
2016-06-01 09:23:09 +00:00
|
|
|
|
2015-03-20 12:11:12 +00:00
|
|
|
# Attachments are deprecated and are handled by Markdown uploader
|
|
|
|
validates :attachment, file_size: { maximum: :max_attachment_size }
|
2011-10-08 21:36:38 +00:00
|
|
|
|
2016-04-29 10:16:18 +00:00
|
|
|
validates :noteable_type, presence: true
|
2016-06-13 11:34:36 +00:00
|
|
|
validates :noteable_id, presence: true, unless: [:for_commit?, :importing?]
|
2016-04-26 07:35:03 +00:00
|
|
|
validates :commit_id, presence: true, if: :for_commit?
|
2015-11-19 16:12:17 +00:00
|
|
|
validates :author, presence: true
|
2017-03-31 01:33:45 +00:00
|
|
|
validates :discussion_id, presence: true, format: { with: /\A\h{40}\z/ }
|
2012-12-18 18:02:00 +00:00
|
|
|
|
2018-02-28 07:48:23 +00:00
|
|
|
validate unless: [:for_commit?, :importing?, :skip_project_check?] do |note|
|
2016-04-26 11:50:48 +00:00
|
|
|
unless note.noteable.try(:project) == note.project
|
2017-03-17 19:25:52 +00:00
|
|
|
errors.add(:project, 'does not match noteable project')
|
2016-04-25 12:28:23 +00:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2019-10-11 21:05:59 +00:00
|
|
|
validate :does_not_exceed_notes_limit?, on: :create, unless: [:system?, :importing?]
|
|
|
|
|
2018-01-29 17:57:34 +00:00
|
|
|
# @deprecated attachments are handler by the MarkdownUploader
|
2012-12-01 11:19:16 +00:00
|
|
|
mount_uploader :attachment, AttachmentUploader
|
2012-10-09 00:10:04 +00:00
|
|
|
|
|
|
|
# Scopes
|
2013-01-05 11:11:15 +00:00
|
|
|
scope :for_commit_id, ->(commit_id) { where(noteable_type: "Commit", commit_id: commit_id) }
|
2017-08-09 09:52:22 +00:00
|
|
|
scope :system, -> { where(system: true) }
|
|
|
|
scope :user, -> { where(system: false) }
|
|
|
|
scope :common, -> { where(noteable_type: ["", nil]) }
|
|
|
|
scope :fresh, -> { order(created_at: :asc, id: :asc) }
|
|
|
|
scope :updated_after, ->(time) { where('updated_at > ?', time) }
|
2020-07-17 00:09:37 +00:00
|
|
|
scope :with_updated_at, ->(time) { where(updated_at: time) }
|
|
|
|
scope :by_updated_at, -> { reorder(:updated_at, :id) }
|
2017-08-09 09:52:22 +00:00
|
|
|
scope :inc_author_project, -> { includes(:project, :author) }
|
|
|
|
scope :inc_author, -> { includes(:author) }
|
2017-03-15 13:18:44 +00:00
|
|
|
scope :inc_relations_for_view, -> do
|
2018-07-16 16:18:52 +00:00
|
|
|
includes(:project, { author: :status }, :updated_by, :resolved_by, :award_emoji,
|
2020-04-15 18:09:36 +00:00
|
|
|
{ system_note_metadata: :description_version }, :note_diff_file, :diff_note_positions, :suggestions)
|
2017-03-15 13:18:44 +00:00
|
|
|
end
|
2011-10-18 11:33:30 +00:00
|
|
|
|
2018-10-23 09:49:45 +00:00
|
|
|
scope :with_notes_filter, -> (notes_filter) do
|
|
|
|
case notes_filter
|
|
|
|
when UserPreference::NOTES_FILTERS[:only_comments]
|
|
|
|
user
|
2018-11-05 12:30:14 +00:00
|
|
|
when UserPreference::NOTES_FILTERS[:only_activity]
|
|
|
|
system
|
2018-10-23 09:49:45 +00:00
|
|
|
else
|
|
|
|
all
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2017-08-09 09:52:22 +00:00
|
|
|
scope :diff_notes, -> { where(type: %w(LegacyDiffNote DiffNote)) }
|
|
|
|
scope :new_diff_notes, -> { where(type: 'DiffNote') }
|
|
|
|
scope :non_diff_notes, -> { where(type: ['Note', 'DiscussionNote', nil]) }
|
2016-05-10 22:41:46 +00:00
|
|
|
|
2015-10-15 08:41:09 +00:00
|
|
|
scope :with_associations, -> do
|
2016-06-21 05:26:43 +00:00
|
|
|
# FYI noteable cannot be loaded for LegacyDiffNote for commits
|
|
|
|
includes(:author, :noteable, :updated_by,
|
2018-11-14 05:07:35 +00:00
|
|
|
project: [:project_members, :namespace, { group: [:group_members] }])
|
2015-10-14 10:44:10 +00:00
|
|
|
end
|
2017-11-21 13:31:23 +00:00
|
|
|
scope :with_metadata, -> { includes(:system_note_metadata) }
|
2011-10-18 11:33:30 +00:00
|
|
|
|
2019-10-16 15:06:17 +00:00
|
|
|
scope :for_note_or_capitalized_note, ->(text) { where(note: [text, text.capitalize]) }
|
|
|
|
scope :like_note_or_capitalized_note, ->(text) { where('(note LIKE ? OR note LIKE ?)', text, text.capitalize) }
|
|
|
|
|
2016-07-22 22:26:33 +00:00
|
|
|
before_validation :nullify_blank_type, :nullify_blank_line_code
|
2019-12-04 15:11:23 +00:00
|
|
|
after_save :keep_around_commit, if: :for_project_noteable?, unless: :importing?
|
|
|
|
after_save :expire_etag_cache, unless: :importing?
|
|
|
|
after_save :touch_noteable, unless: :importing?
|
2017-04-11 12:20:25 +00:00
|
|
|
after_destroy :expire_etag_cache
|
2020-02-14 00:09:07 +00:00
|
|
|
after_save :store_mentions!, if: :any_mentionable_attributes_changed?
|
2020-05-13 18:08:47 +00:00
|
|
|
after_commit :notify_after_create, on: :create
|
|
|
|
after_commit :notify_after_destroy, on: :destroy
|
2013-08-04 16:01:57 +00:00
|
|
|
|
2013-12-25 11:32:43 +00:00
|
|
|
class << self
|
2016-05-10 22:41:46 +00:00
|
|
|
def model_name
|
|
|
|
ActiveModel::Name.new(self, nil, 'note')
|
|
|
|
end
|
2013-12-25 11:32:43 +00:00
|
|
|
|
2017-04-07 16:29:29 +00:00
|
|
|
def discussions(context_noteable = nil)
|
2017-05-31 19:00:30 +00:00
|
|
|
Discussion.build_collection(all.includes(:noteable).fresh, context_noteable)
|
2013-12-25 11:32:43 +00:00
|
|
|
end
|
2012-05-20 18:35:03 +00:00
|
|
|
|
2019-07-04 03:33:14 +00:00
|
|
|
# Note: Where possible consider using Discussion#lazy_find to return
|
|
|
|
# Discussions in order to benefit from having records batch loaded.
|
2017-03-10 01:29:11 +00:00
|
|
|
def find_discussion(discussion_id)
|
|
|
|
notes = where(discussion_id: discussion_id).fresh.to_a
|
2018-02-28 00:10:43 +00:00
|
|
|
|
2017-03-10 01:29:11 +00:00
|
|
|
return if notes.empty?
|
|
|
|
|
|
|
|
Discussion.build(notes)
|
2013-12-25 11:32:43 +00:00
|
|
|
end
|
2012-05-20 18:35:03 +00:00
|
|
|
|
2017-10-07 04:25:17 +00:00
|
|
|
# Group diff discussions by line code or file path.
|
|
|
|
# It is not needed to group by line code when comment is
|
|
|
|
# on an image.
|
2017-03-31 23:39:14 +00:00
|
|
|
def grouped_diff_discussions(diff_refs = nil)
|
2017-05-22 20:56:20 +00:00
|
|
|
groups = {}
|
2017-04-30 20:32:09 +00:00
|
|
|
|
|
|
|
diff_notes.fresh.discussions.each do |discussion|
|
2017-10-07 04:25:17 +00:00
|
|
|
group_key =
|
|
|
|
if discussion.on_image?
|
|
|
|
discussion.file_new_path
|
|
|
|
else
|
|
|
|
discussion.line_code_in_diffs(diff_refs)
|
|
|
|
end
|
|
|
|
|
|
|
|
if group_key
|
|
|
|
discussions = groups[group_key] ||= []
|
2017-05-22 20:56:20 +00:00
|
|
|
discussions << discussion
|
|
|
|
end
|
2017-04-30 20:32:09 +00:00
|
|
|
end
|
|
|
|
|
|
|
|
groups
|
2014-06-06 20:15:54 +00:00
|
|
|
end
|
2017-01-23 20:40:25 +00:00
|
|
|
|
2019-10-10 00:06:44 +00:00
|
|
|
def positions
|
|
|
|
where.not(position: nil)
|
|
|
|
.select(:id, :type, :position) # ActiveRecord needs id and type for typecasting.
|
|
|
|
.map(&:position)
|
|
|
|
end
|
|
|
|
|
2017-01-23 20:40:25 +00:00
|
|
|
def count_for_collection(ids, type)
|
2017-06-21 13:48:12 +00:00
|
|
|
user.select('noteable_id', 'COUNT(*) as count')
|
|
|
|
.group(:noteable_id)
|
|
|
|
.where(noteable_type: type, noteable_id: ids)
|
2017-01-23 20:40:25 +00:00
|
|
|
end
|
2017-08-02 14:06:28 +00:00
|
|
|
|
|
|
|
def has_special_role?(role, note)
|
|
|
|
note.special_role == role
|
|
|
|
end
|
2017-11-24 10:45:19 +00:00
|
|
|
|
|
|
|
def search(query)
|
2017-11-24 11:24:24 +00:00
|
|
|
fuzzy_search(query, [:note])
|
2017-11-24 10:45:19 +00:00
|
|
|
end
|
2015-05-01 03:16:19 +00:00
|
|
|
end
|
2014-10-03 05:48:35 +00:00
|
|
|
|
2018-08-27 15:31:01 +00:00
|
|
|
# rubocop: disable CodeReuse/ServiceClass
|
2020-02-24 03:09:05 +00:00
|
|
|
def system_note_with_references?
|
2017-11-16 14:23:32 +00:00
|
|
|
return unless system?
|
|
|
|
|
|
|
|
if force_cross_reference_regex_check?
|
|
|
|
matches_cross_reference_regex?
|
|
|
|
else
|
2019-10-08 15:06:04 +00:00
|
|
|
::SystemNotes::IssuablesService.cross_reference?(note)
|
2017-11-16 14:23:32 +00:00
|
|
|
end
|
2013-05-30 23:16:49 +00:00
|
|
|
end
|
2018-08-27 15:31:01 +00:00
|
|
|
# rubocop: enable CodeReuse/ServiceClass
|
2013-05-30 23:16:49 +00:00
|
|
|
|
2016-05-10 22:41:46 +00:00
|
|
|
def diff_note?
|
|
|
|
false
|
2015-03-20 12:11:12 +00:00
|
|
|
end
|
|
|
|
|
2013-08-04 17:43:49 +00:00
|
|
|
def active?
|
2016-05-13 19:53:31 +00:00
|
|
|
true
|
2014-09-08 18:54:52 +00:00
|
|
|
end
|
|
|
|
|
2016-05-10 22:41:46 +00:00
|
|
|
def max_attachment_size
|
2018-02-02 18:39:55 +00:00
|
|
|
Gitlab::CurrentSettings.max_attachment_size.megabytes.to_i
|
2014-09-08 13:27:12 +00:00
|
|
|
end
|
|
|
|
|
2016-05-10 22:41:46 +00:00
|
|
|
def hook_attrs
|
2018-06-20 13:53:19 +00:00
|
|
|
Gitlab::HookData::NoteBuilder.new(self).build
|
2012-10-29 14:49:37 +00:00
|
|
|
end
|
|
|
|
|
2018-12-13 19:17:19 +00:00
|
|
|
def supports_suggestion?
|
|
|
|
false
|
|
|
|
end
|
|
|
|
|
2012-10-29 14:49:37 +00:00
|
|
|
def for_commit?
|
|
|
|
noteable_type == "Commit"
|
|
|
|
end
|
|
|
|
|
2012-10-30 02:27:36 +00:00
|
|
|
def for_issue?
|
|
|
|
noteable_type == "Issue"
|
|
|
|
end
|
|
|
|
|
2012-10-29 14:49:37 +00:00
|
|
|
def for_merge_request?
|
|
|
|
noteable_type == "MergeRequest"
|
|
|
|
end
|
|
|
|
|
2016-03-31 07:20:27 +00:00
|
|
|
def for_snippet?
|
2015-03-05 18:38:23 +00:00
|
|
|
noteable_type == "Snippet"
|
|
|
|
end
|
|
|
|
|
2020-06-12 12:08:56 +00:00
|
|
|
def for_alert_mangement_alert?
|
|
|
|
noteable_type == 'AlertManagement::Alert'
|
|
|
|
end
|
|
|
|
|
2017-01-05 13:36:06 +00:00
|
|
|
def for_personal_snippet?
|
2017-01-20 10:28:40 +00:00
|
|
|
noteable.is_a?(PersonalSnippet)
|
|
|
|
end
|
|
|
|
|
2017-11-01 17:35:14 +00:00
|
|
|
def for_project_noteable?
|
|
|
|
!for_personal_snippet?
|
|
|
|
end
|
|
|
|
|
2020-05-04 06:10:10 +00:00
|
|
|
def for_design?
|
|
|
|
noteable_type == DesignManagement::Design.name
|
|
|
|
end
|
|
|
|
|
2018-07-16 13:35:19 +00:00
|
|
|
def for_issuable?
|
|
|
|
for_issue? || for_merge_request?
|
|
|
|
end
|
|
|
|
|
2017-01-20 10:28:40 +00:00
|
|
|
def skip_project_check?
|
2018-02-28 07:48:23 +00:00
|
|
|
!for_project_noteable?
|
2017-01-05 13:36:06 +00:00
|
|
|
end
|
|
|
|
|
2017-06-29 21:19:09 +00:00
|
|
|
def commit
|
2017-12-06 15:57:10 +00:00
|
|
|
@commit ||= project.commit(commit_id) if commit_id.present?
|
2017-06-29 21:19:09 +00:00
|
|
|
end
|
|
|
|
|
2020-03-12 00:09:34 +00:00
|
|
|
# Notes on merge requests and commits can be traced back to one or several
|
|
|
|
# MRs. This method returns a relation if the note is for one of these types,
|
|
|
|
# or nil if it is a note on some other object.
|
|
|
|
def merge_requests
|
|
|
|
if for_commit?
|
|
|
|
project.merge_requests.by_commit_sha(commit_id)
|
|
|
|
elsif for_merge_request?
|
|
|
|
MergeRequest.id_in(noteable_id)
|
|
|
|
else
|
|
|
|
nil
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2012-10-13 14:23:12 +00:00
|
|
|
# override to return commits, which are not active record
|
|
|
|
def noteable
|
2017-12-06 15:57:10 +00:00
|
|
|
return commit if for_commit?
|
|
|
|
|
|
|
|
super
|
2012-03-14 13:31:31 +00:00
|
|
|
rescue
|
2017-12-06 15:57:10 +00:00
|
|
|
# Temp fix to prevent app crash
|
|
|
|
# if note commit id doesn't exist
|
2012-01-20 07:51:48 +00:00
|
|
|
nil
|
2012-01-04 20:19:41 +00:00
|
|
|
end
|
2012-02-10 02:59:39 +00:00
|
|
|
|
2013-03-25 11:58:09 +00:00
|
|
|
# FIXME: Hack for polymorphic associations with STI
|
2015-01-18 15:29:37 +00:00
|
|
|
# For more information visit http://api.rubyonrails.org/classes/ActiveRecord/Associations/ClassMethods.html#label-Polymorphic+Associations
|
2015-10-12 12:30:44 +00:00
|
|
|
def noteable_type=(noteable_type)
|
|
|
|
super(noteable_type.to_s.classify.constantize.base_class.to_s)
|
2013-03-25 11:58:09 +00:00
|
|
|
end
|
2013-12-13 19:40:45 +00:00
|
|
|
|
2020-03-17 00:09:12 +00:00
|
|
|
def noteable_assignee_or_author?(user)
|
|
|
|
return false unless user
|
|
|
|
return noteable.assignee_or_author?(user) if [MergeRequest, Issue].include?(noteable.class)
|
|
|
|
|
|
|
|
noteable.author_id == user.id
|
|
|
|
end
|
|
|
|
|
2017-07-29 15:04:42 +00:00
|
|
|
def special_role=(role)
|
2019-07-24 18:11:18 +00:00
|
|
|
raise "Role is undefined, #{role} not found in #{SpecialRole.values}" unless SpecialRole.value?(role)
|
2017-08-02 14:06:28 +00:00
|
|
|
|
2017-07-29 15:04:42 +00:00
|
|
|
@special_role = role
|
|
|
|
end
|
|
|
|
|
|
|
|
def has_special_role?(role)
|
2017-08-02 14:06:28 +00:00
|
|
|
self.class.has_special_role?(role, self)
|
2017-07-29 15:04:42 +00:00
|
|
|
end
|
|
|
|
|
2017-08-15 13:21:27 +00:00
|
|
|
def specialize_for_first_contribution!(noteable)
|
|
|
|
return unless noteable.author_id == self.author_id
|
2017-08-29 13:46:40 +00:00
|
|
|
|
|
|
|
self.special_role = Note::SpecialRole::FIRST_TIME_CONTRIBUTOR
|
2017-08-15 13:21:27 +00:00
|
|
|
end
|
2017-08-29 13:46:40 +00:00
|
|
|
|
2020-05-27 09:08:30 +00:00
|
|
|
def confidential?(include_noteable: false)
|
|
|
|
return true if confidential
|
|
|
|
|
|
|
|
include_noteable && noteable.try(:confidential?)
|
2018-04-03 11:00:33 +00:00
|
|
|
end
|
|
|
|
|
2014-08-29 12:19:35 +00:00
|
|
|
def editable?
|
2016-04-16 19:09:08 +00:00
|
|
|
!system?
|
2014-08-29 12:19:35 +00:00
|
|
|
end
|
2015-12-02 07:48:21 +00:00
|
|
|
|
2019-03-14 04:00:12 +00:00
|
|
|
# Since we're using `updated_at` as `last_edited_at`, it could be touched by transforming / resolving a note.
|
|
|
|
# This makes sure it is only marked as edited when the note body is updated.
|
|
|
|
def edited?
|
|
|
|
return false if updated_by.blank?
|
|
|
|
|
|
|
|
super
|
|
|
|
end
|
|
|
|
|
2020-02-24 03:09:05 +00:00
|
|
|
# This method is to be used for checking read permissions on a note instead of `system_note_with_references_visible_for?`
|
|
|
|
def readable_by?(user)
|
|
|
|
# note_policy accounts for #system_note_with_references_visible_for?(user) check when granting read access
|
|
|
|
Ability.allowed?(user, :read_note, self)
|
2019-08-09 12:54:57 +00:00
|
|
|
end
|
|
|
|
|
2016-04-16 19:09:08 +00:00
|
|
|
def award_emoji?
|
2016-06-20 17:15:44 +00:00
|
|
|
can_be_award_emoji? && contains_emoji_only?
|
2015-12-02 07:48:21 +00:00
|
|
|
end
|
|
|
|
|
2016-06-15 10:29:57 +00:00
|
|
|
def emoji_awardable?
|
|
|
|
!system?
|
|
|
|
end
|
|
|
|
|
2016-06-20 17:15:44 +00:00
|
|
|
def can_be_award_emoji?
|
2017-03-10 01:29:11 +00:00
|
|
|
noteable.is_a?(Awardable) && !part_of_discussion?
|
2015-12-05 21:09:52 +00:00
|
|
|
end
|
|
|
|
|
2015-12-02 07:48:21 +00:00
|
|
|
def contains_emoji_only?
|
2015-12-15 15:10:32 +00:00
|
|
|
note =~ /\A#{Banzai::Filter::EmojiFilter.emoji_pattern}\s?\Z/
|
2015-12-02 07:48:21 +00:00
|
|
|
end
|
|
|
|
|
2017-01-20 10:28:40 +00:00
|
|
|
def to_ability_name
|
2019-10-17 03:55:04 +00:00
|
|
|
model_name.singular
|
|
|
|
end
|
|
|
|
|
|
|
|
def noteable_ability_name
|
2020-06-12 12:08:56 +00:00
|
|
|
if for_snippet?
|
|
|
|
'snippet'
|
|
|
|
elsif for_alert_mangement_alert?
|
|
|
|
'alert_management_alert'
|
|
|
|
else
|
|
|
|
noteable_type.demodulize.underscore
|
|
|
|
end
|
2017-01-20 10:28:40 +00:00
|
|
|
end
|
|
|
|
|
2017-03-10 01:29:11 +00:00
|
|
|
def can_be_discussion_note?
|
2017-04-06 15:05:57 +00:00
|
|
|
self.noteable.supports_discussions? && !part_of_discussion?
|
2017-04-05 23:42:07 +00:00
|
|
|
end
|
|
|
|
|
2018-02-28 07:48:23 +00:00
|
|
|
def can_create_todo?
|
2020-08-13 03:10:13 +00:00
|
|
|
# Skip system notes, and notes on snippets
|
2018-02-28 07:48:23 +00:00
|
|
|
!system? && !for_snippet?
|
|
|
|
end
|
|
|
|
|
2017-03-10 01:29:11 +00:00
|
|
|
def discussion_class(noteable = nil)
|
|
|
|
# When commit notes are rendered on an MR's Discussion page, they are
|
2017-04-04 22:27:23 +00:00
|
|
|
# displayed in one discussion instead of individually.
|
|
|
|
# See also `#discussion_id` and `Discussion.override_discussion_id`.
|
2017-03-17 19:25:52 +00:00
|
|
|
if noteable && noteable != self.noteable
|
|
|
|
OutOfContextDiscussion
|
2017-03-10 01:29:11 +00:00
|
|
|
else
|
|
|
|
IndividualNoteDiscussion
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2017-04-04 22:27:23 +00:00
|
|
|
# See `Discussion.override_discussion_id` for details.
|
2017-03-10 01:29:11 +00:00
|
|
|
def discussion_id(noteable = nil)
|
2019-12-23 18:07:33 +00:00
|
|
|
discussion_class(noteable).override_discussion_id(self) || super() || ensure_discussion_id
|
2017-03-10 01:29:11 +00:00
|
|
|
end
|
|
|
|
|
2017-03-31 03:06:09 +00:00
|
|
|
# Returns a discussion containing just this note.
|
|
|
|
# This method exists as an alternative to `#discussion` to use when the methods
|
|
|
|
# we intend to call on the Discussion object don't require it to have all of its notes,
|
|
|
|
# and just depend on the first note or the type of discussion. This saves us a DB query.
|
2017-03-10 01:29:11 +00:00
|
|
|
def to_discussion(noteable = nil)
|
|
|
|
Discussion.build([self], noteable)
|
|
|
|
end
|
|
|
|
|
2017-03-31 03:06:09 +00:00
|
|
|
# Returns the entire discussion this note is part of.
|
|
|
|
# Consider using `#to_discussion` if we do not need to render the discussion
|
|
|
|
# and all its notes and if we don't care about the discussion's resolvability status.
|
2017-03-10 01:29:11 +00:00
|
|
|
def discussion
|
2020-07-16 12:09:22 +00:00
|
|
|
strong_memoize(:discussion) do
|
|
|
|
full_discussion = self.noteable.notes.find_discussion(self.discussion_id) if part_of_discussion?
|
|
|
|
full_discussion || to_discussion
|
|
|
|
end
|
2017-03-10 01:29:11 +00:00
|
|
|
end
|
|
|
|
|
2019-11-21 09:06:16 +00:00
|
|
|
def start_of_discussion?
|
|
|
|
discussion.first_note == self
|
|
|
|
end
|
|
|
|
|
2017-03-10 01:29:11 +00:00
|
|
|
def part_of_discussion?
|
2017-03-17 19:25:52 +00:00
|
|
|
!to_discussion.individual_note?
|
|
|
|
end
|
|
|
|
|
|
|
|
def in_reply_to?(other)
|
|
|
|
case other
|
|
|
|
when Note
|
|
|
|
if part_of_discussion?
|
|
|
|
in_reply_to?(other.noteable) && in_reply_to?(other.to_discussion)
|
|
|
|
else
|
|
|
|
in_reply_to?(other.noteable)
|
|
|
|
end
|
|
|
|
when Discussion
|
|
|
|
self.discussion_id == other.id
|
|
|
|
when Noteable
|
|
|
|
self.noteable == other
|
|
|
|
else
|
|
|
|
false
|
|
|
|
end
|
2017-03-10 01:29:11 +00:00
|
|
|
end
|
|
|
|
|
2017-12-08 21:45:57 +00:00
|
|
|
def references
|
|
|
|
refs = [noteable]
|
|
|
|
|
2017-09-15 06:58:21 +00:00
|
|
|
if part_of_discussion?
|
2017-12-08 21:45:57 +00:00
|
|
|
refs += discussion.notes.take_while { |n| n.id < id }
|
2017-09-15 06:58:21 +00:00
|
|
|
end
|
|
|
|
|
2017-12-08 21:45:57 +00:00
|
|
|
refs
|
2017-09-15 06:58:21 +00:00
|
|
|
end
|
|
|
|
|
2017-07-17 18:36:29 +00:00
|
|
|
def expire_etag_cache
|
2018-09-07 13:39:20 +00:00
|
|
|
noteable&.expire_note_etag_cache
|
2017-07-17 18:36:29 +00:00
|
|
|
end
|
|
|
|
|
2017-12-01 13:52:16 +00:00
|
|
|
def touch(*args)
|
|
|
|
# We're not using an explicit transaction here because this would in all
|
|
|
|
# cases result in all future queries going to the primary, even if no writes
|
|
|
|
# are performed.
|
|
|
|
#
|
|
|
|
# We touch the noteable first so its SELECT query can run before our writes,
|
|
|
|
# ensuring it runs on a secondary (if no prior write took place).
|
|
|
|
touch_noteable
|
|
|
|
super
|
|
|
|
end
|
|
|
|
|
|
|
|
# By default Rails will issue an "SELECT *" for the relation, which is
|
|
|
|
# overkill for just updating the timestamps. To work around this we manually
|
|
|
|
# touch the data so we can SELECT only the columns we need.
|
|
|
|
def touch_noteable
|
|
|
|
# Commits are not stored in the DB so we can't touch them.
|
|
|
|
return if for_commit?
|
|
|
|
|
|
|
|
assoc = association(:noteable)
|
|
|
|
|
|
|
|
noteable_object =
|
|
|
|
if assoc.loaded?
|
|
|
|
noteable
|
|
|
|
else
|
|
|
|
# If the object is not loaded (e.g. when notes are loaded async) we
|
|
|
|
# _only_ want the data we actually need.
|
|
|
|
assoc.scope.select(:id, :updated_at).take
|
|
|
|
end
|
|
|
|
|
|
|
|
noteable_object&.touch
|
2017-12-12 20:34:21 +00:00
|
|
|
|
2019-06-28 10:58:04 +00:00
|
|
|
# We return the noteable object so we can re-use it in EE for Elasticsearch.
|
2017-12-12 20:34:21 +00:00
|
|
|
noteable_object
|
2017-12-01 13:52:16 +00:00
|
|
|
end
|
|
|
|
|
2020-05-13 18:08:47 +00:00
|
|
|
def notify_after_create
|
|
|
|
noteable&.after_note_created(self)
|
|
|
|
end
|
|
|
|
|
|
|
|
def notify_after_destroy
|
|
|
|
noteable&.after_note_destroyed(self)
|
|
|
|
end
|
|
|
|
|
2017-11-20 14:02:01 +00:00
|
|
|
def banzai_render_context(field)
|
2020-05-27 06:08:13 +00:00
|
|
|
super.merge(noteable: noteable, system_note: system?, label_url_method: noteable_label_url_method)
|
2017-11-20 14:02:01 +00:00
|
|
|
end
|
|
|
|
|
2018-04-19 16:22:23 +00:00
|
|
|
def retrieve_upload(_identifier, paths)
|
|
|
|
Upload.find_by(model: self, path: paths)
|
|
|
|
end
|
|
|
|
|
2019-10-17 12:07:33 +00:00
|
|
|
def resource_parent
|
2018-12-10 11:51:21 +00:00
|
|
|
project
|
|
|
|
end
|
|
|
|
|
2019-12-10 15:07:52 +00:00
|
|
|
def user_mentions
|
2020-02-14 00:09:07 +00:00
|
|
|
return Note.none unless noteable.present?
|
|
|
|
|
2019-12-10 15:07:52 +00:00
|
|
|
noteable.user_mentions.where(note: self)
|
|
|
|
end
|
|
|
|
|
2020-02-24 03:09:05 +00:00
|
|
|
def system_note_with_references_visible_for?(user)
|
2020-09-08 15:08:41 +00:00
|
|
|
return true unless system?
|
|
|
|
|
2020-02-24 03:09:05 +00:00
|
|
|
(!system_note_with_references? || all_referenced_mentionables_allowed?(user)) && system_note_viewable_by?(user)
|
|
|
|
end
|
|
|
|
|
2020-08-14 15:10:05 +00:00
|
|
|
def parent_user
|
|
|
|
noteable.author if for_personal_snippet?
|
|
|
|
end
|
|
|
|
|
2020-08-28 09:10:32 +00:00
|
|
|
def skip_notification?
|
|
|
|
review.present?
|
|
|
|
end
|
|
|
|
|
2016-07-03 23:58:58 +00:00
|
|
|
private
|
|
|
|
|
2019-12-10 15:07:52 +00:00
|
|
|
# Using this method followed by a call to `save` may result in ActiveRecord::RecordNotUnique exception
|
|
|
|
# in a multithreaded environment. Make sure to use it within a `safe_ensure_unique` block.
|
|
|
|
def model_user_mention
|
2020-02-14 00:09:07 +00:00
|
|
|
return if user_mentions.is_a?(ActiveRecord::NullRelation)
|
|
|
|
|
2019-12-10 15:07:52 +00:00
|
|
|
user_mentions.first_or_initialize
|
|
|
|
end
|
|
|
|
|
2019-10-25 12:46:40 +00:00
|
|
|
def system_note_viewable_by?(user)
|
|
|
|
return true unless system_note_metadata
|
|
|
|
|
|
|
|
restriction = TYPES_RESTRICTED_BY_ABILITY[system_note_metadata.action.to_sym]
|
|
|
|
return Ability.allowed?(user, restriction, project) if restriction
|
|
|
|
|
|
|
|
true
|
|
|
|
end
|
|
|
|
|
2016-07-03 23:58:58 +00:00
|
|
|
def keep_around_commit
|
|
|
|
project.repository.keep_around(self.commit_id)
|
|
|
|
end
|
2016-07-22 22:26:33 +00:00
|
|
|
|
|
|
|
def nullify_blank_type
|
|
|
|
self.type = nil if self.type.blank?
|
|
|
|
end
|
|
|
|
|
|
|
|
def nullify_blank_line_code
|
|
|
|
self.line_code = nil if self.line_code.blank?
|
|
|
|
end
|
2016-08-17 17:14:44 +00:00
|
|
|
|
|
|
|
def ensure_discussion_id
|
2019-12-23 18:07:33 +00:00
|
|
|
return if self.attribute_present?(:discussion_id)
|
2016-08-17 17:14:44 +00:00
|
|
|
|
2019-12-23 18:07:33 +00:00
|
|
|
self.discussion_id = derive_discussion_id
|
2016-08-17 17:14:44 +00:00
|
|
|
end
|
|
|
|
|
2019-12-23 18:07:33 +00:00
|
|
|
def derive_discussion_id
|
|
|
|
discussion_class.discussion_id(self)
|
2016-08-17 17:14:44 +00:00
|
|
|
end
|
2017-11-16 14:23:32 +00:00
|
|
|
|
2018-09-27 18:58:23 +00:00
|
|
|
def all_referenced_mentionables_allowed?(user)
|
|
|
|
if user_visible_reference_count.present? && total_reference_count.present?
|
|
|
|
# if they are not equal, then there are private/confidential references as well
|
|
|
|
user_visible_reference_count > 0 && user_visible_reference_count == total_reference_count
|
|
|
|
else
|
2020-01-30 21:08:47 +00:00
|
|
|
refs = all_references(user)
|
|
|
|
refs.all.any? && refs.stateful_not_visible_counter == 0
|
2018-09-27 18:58:23 +00:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2017-11-16 14:23:32 +00:00
|
|
|
def force_cross_reference_regex_check?
|
|
|
|
return unless system?
|
|
|
|
|
2018-09-27 18:58:23 +00:00
|
|
|
system_note_metadata&.cross_reference_types&.include?(system_note_metadata&.action)
|
2017-11-16 14:23:32 +00:00
|
|
|
end
|
2019-10-11 21:05:59 +00:00
|
|
|
|
|
|
|
def does_not_exceed_notes_limit?
|
|
|
|
return unless noteable
|
|
|
|
|
|
|
|
errors.add(:base, _('Maximum number of comments exceeded')) if noteable.notes.count >= Noteable::MAX_NOTES_LIMIT
|
|
|
|
end
|
2020-05-27 06:08:13 +00:00
|
|
|
|
|
|
|
def noteable_label_url_method
|
|
|
|
for_merge_request? ? :project_merge_requests_url : :project_issues_url
|
|
|
|
end
|
2011-10-08 21:36:38 +00:00
|
|
|
end
|
2019-09-13 13:26:31 +00:00
|
|
|
|
|
|
|
Note.prepend_if_ee('EE::Note')
|