openproject/app/models/status.rb

#-- encoding: UTF-8
#-- copyright
# OpenProject is a project management system.
# Copyright (C) 2012-2017 the OpenProject Foundation (OPF)
#
# This program is free software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License version 3.
#
# OpenProject is a fork of ChiliProject, which is a fork of Redmine. The copyright follows:
# Copyright (C) 2006-2017 Jean-Philippe Lang
# Copyright (C) 2010-2013 the ChiliProject Team
#
# 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.
#
# See doc/COPYRIGHT.rdoc for more details.
#++

class Status < ActiveRecord::Base
  extend Pagination::Model

  default_scope { order('position ASC') }
  before_destroy :check_integrity
  has_many :workflows, foreign_key: 'old_status_id'
  acts_as_list

  before_destroy :delete_workflows

  validates_presence_of :name
  validates_uniqueness_of :name
  validates_length_of :name, maximum: 30
  validates_inclusion_of :default_done_ratio, in: 0..100, allow_nil: true

  after_save :unmark_old_default_value, if: :is_default?

  def unmark_old_default_value
    Status.where(['id <> ?', id]).update_all("is_default=#{self.class.connection.quoted_false}")
  end

  # Returns the default status for new issues
  def self.default
    where(['is_default=?', true]).first
  end

  # Update all the +Issues+ setting their done_ratio to the value of their +Status+
  def self.update_work_package_done_ratios
    if WorkPackage.use_status_for_done_ratio?
      Status.where(['default_done_ratio >= 0']).each do |status|
        WorkPackage.where(['status_id = ?', status.id])
          .update_all(['done_ratio = ?', status.default_done_ratio])
      end
    end

    WorkPackage.use_status_for_done_ratio?
  end

  # Returns an array of all statuses the given role can switch to
  # Uses association cache when called more than one time
  def new_statuses_allowed_to(roles, type, author = false, assignee = false)
    if roles && type
      role_ids = roles.map(&:id)
      transitions = workflows.select { |w|
        role_ids.include?(w.role_id) &&
        w.type_id == type.id &&
        (author || !w.author) &&
        (assignee || !w.assignee)
      }
      transitions.map(&:new_status).uniq.compact.sort
    else
      []
    end
  end

  # Same thing as above but uses a database query
  # More efficient than the previous method if called just once
  def find_new_statuses_allowed_to(roles, type, author = false, assignee = false)
    if roles && type
      conditions = { role_id: roles.map(&:id), type_id: type.id }
      conditions[:author] = false unless author
      conditions[:assignee] = false unless assignee

      workflows.includes(:new_status)
        .where(conditions)
        .map(&:new_status).compact.sort
    else
      []
    end
  end

  def <=>(status)
    position <=> status.position
  end

  def to_s; name end

  private

  def check_integrity
    raise "Can't delete status" if WorkPackage.where(['status_id=?', id]).any?
  end

  # Deletes associated workflows
  def delete_workflows
    Workflow.delete_all(['old_status_id = :id OR new_status_id = :id', { id: id }])
  end
end