|
|
# Redmine - project management software
|
|
|
# Copyright (C) 2006-2015 Jean-Philippe Lang
|
|
|
#
|
|
|
# This program is free software; you can redistribute it and/or
|
|
|
# modify it under the terms of the GNU General Public License
|
|
|
# as published by the Free Software Foundation; either version 2
|
|
|
# of the License, or (at your option) any later version.
|
|
|
#
|
|
|
# This program is distributed in the hope that it will be useful,
|
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
# GNU General Public License for more details.
|
|
|
#
|
|
|
# You should have received a copy of the GNU General Public License
|
|
|
# along with this program; if not, write to the Free Software
|
|
|
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
|
|
|
|
|
class Member < ActiveRecord::Base
|
|
|
belongs_to :user
|
|
|
belongs_to :principal, :foreign_key => 'user_id'
|
|
|
has_many :member_roles, :dependent => :destroy
|
|
|
has_many :roles, :through => :member_roles
|
|
|
belongs_to :project
|
|
|
|
|
|
validates_presence_of :principal, :project
|
|
|
validates_uniqueness_of :user_id, :scope => :project_id
|
|
|
validate :validate_role
|
|
|
attr_protected :id
|
|
|
|
|
|
before_destroy :set_issue_category_nil
|
|
|
|
|
|
def role
|
|
|
end
|
|
|
|
|
|
def role=
|
|
|
end
|
|
|
|
|
|
def name
|
|
|
self.user.name
|
|
|
end
|
|
|
|
|
|
alias :base_role_ids= :role_ids=
|
|
|
def role_ids=(arg)
|
|
|
ids = (arg || []).collect(&:to_i) - [0]
|
|
|
# Keep inherited roles
|
|
|
ids += member_roles.select {|mr| !mr.inherited_from.nil?}.collect(&:role_id)
|
|
|
|
|
|
new_role_ids = ids - role_ids
|
|
|
# Add new roles
|
|
|
new_role_ids.each {|id| member_roles << MemberRole.new(:role_id => id, :member => self) }
|
|
|
# Remove roles (Rails' #role_ids= will not trigger MemberRole#on_destroy)
|
|
|
member_roles_to_destroy = member_roles.select {|mr| !ids.include?(mr.role_id)}
|
|
|
if member_roles_to_destroy.any?
|
|
|
member_roles_to_destroy.each(&:destroy)
|
|
|
end
|
|
|
end
|
|
|
|
|
|
def <=>(member)
|
|
|
a, b = roles.sort.first, member.roles.sort.first
|
|
|
if a == b
|
|
|
if principal
|
|
|
principal <=> member.principal
|
|
|
else
|
|
|
1
|
|
|
end
|
|
|
elsif a
|
|
|
a <=> b
|
|
|
else
|
|
|
1
|
|
|
end
|
|
|
end
|
|
|
|
|
|
def deletable?
|
|
|
member_roles.detect {|mr| mr.inherited_from}.nil?
|
|
|
end
|
|
|
|
|
|
def destroy
|
|
|
if member_roles.reload.present?
|
|
|
# destroying the last role will destroy another instance
|
|
|
# of the same Member record, #super would then trigger callbacks twice
|
|
|
member_roles.destroy_all
|
|
|
@destroyed = true
|
|
|
freeze
|
|
|
else
|
|
|
super
|
|
|
end
|
|
|
end
|
|
|
|
|
|
def include?(user)
|
|
|
if principal.is_a?(Group)
|
|
|
!user.nil? && user.groups.include?(principal)
|
|
|
else
|
|
|
self.user == user
|
|
|
end
|
|
|
end
|
|
|
|
|
|
def set_issue_category_nil
|
|
|
if user_id && project_id
|
|
|
# remove category based auto assignments for this member
|
|
|
IssueCategory.where(["project_id = ? AND assigned_to_id = ?", project_id, user_id]).
|
|
|
update_all("assigned_to_id = NULL")
|
|
|
end
|
|
|
end
|
|
|
|
|
|
# Creates memberships for principal with the attributes
|
|
|
# * project_ids : one or more project ids
|
|
|
# * role_ids : ids of the roles to give to each membership
|
|
|
#
|
|
|
# Example:
|
|
|
# Member.create_principal_memberships(user, :project_ids => [2, 5], :role_ids => [1, 3]
|
|
|
def self.create_principal_memberships(principal, attributes)
|
|
|
members = []
|
|
|
if attributes
|
|
|
project_ids = Array.wrap(attributes[:project_ids] || attributes[:project_id])
|
|
|
role_ids = attributes[:role_ids]
|
|
|
project_ids.each do |project_id|
|
|
|
members << Member.new(:principal => principal, :role_ids => role_ids, :project_id => project_id)
|
|
|
end
|
|
|
principal.members << members
|
|
|
end
|
|
|
members
|
|
|
end
|
|
|
|
|
|
# Finds or initilizes a Member for the given project and principal
|
|
|
def self.find_or_new(project, principal)
|
|
|
project_id = project.is_a?(Project) ? project.id : project
|
|
|
principal_id = principal.is_a?(Principal) ? principal.id : principal
|
|
|
|
|
|
member = Member.find_by_project_id_and_user_id(project_id, principal_id)
|
|
|
member ||= Member.new(:project_id => project_id, :user_id => principal_id)
|
|
|
member
|
|
|
end
|
|
|
|
|
|
protected
|
|
|
|
|
|
def validate_role
|
|
|
errors.add_on_empty :role if member_roles.empty? && roles.empty?
|
|
|
end
|
|
|
end
|
|
|
|
