#-- copyright # OpenProject is an open source project management software. # Copyright (C) 2012-2021 the OpenProject GmbH # # 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-2013 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 docs/COPYRIGHT.rdoc for more details. #++ require 'date' class Sprint < Version scope :open_sprints, lambda { |project| where(["versions.status = 'open' and versions.project_id = ?", project.id]) .order_by_date } # null last ordering scope :order_by_date, -> { reorder(Arel.sql("start_date ASC NULLS LAST, effective_date ASC NULLS LAST")) } scope :apply_to, lambda { |project| where("#{Version.table_name}.project_id = #{project.id}" + " OR (#{Project.table_name}.active = #{true} AND (" + " #{Version.table_name}.sharing = 'system'" + " OR (#{Project.table_name}.lft >= #{project.root.lft} AND #{Project.table_name}.rgt <= #{project.root.rgt} AND #{Version.table_name}.sharing = 'tree')" + " OR (#{Project.table_name}.lft < #{project.lft} AND #{Project.table_name}.rgt > #{project.rgt} AND #{Version.table_name}.sharing IN ('hierarchy', 'descendants'))" + " OR (#{Project.table_name}.lft > #{project.lft} AND #{Project.table_name}.rgt < #{project.rgt} AND #{Version.table_name}.sharing = 'hierarchy')" + '))') .includes(:project) .references(:projects) } scope :displayed_left, lambda { |project| joins(sanitize_sql_array([ "LEFT OUTER JOIN (SELECT * from #{VersionSetting.table_name}" + ' WHERE project_id = ? ) version_settings' + ' ON version_settings.version_id = versions.id', project.id ])) .where([ '(version_settings.project_id = ? AND version_settings.display = ?)' + ' OR (version_settings.project_id is NULL)', project.id, VersionSetting::DISPLAY_LEFT ]) .joins(" LEFT OUTER JOIN (SELECT * FROM #{VersionSetting.table_name}) AS vs ON vs.version_id = #{Version.table_name}.id AND vs.project_id = #{Version.table_name}.project_id ") # next take only those versions which define 'display left' in their home project or the given project (or don't define anything) .where( "(version_settings.display = ? OR vs.display = ? OR vs.display IS NULL)", VersionSetting::DISPLAY_LEFT, VersionSetting::DISPLAY_LEFT ) } scope :displayed_right, lambda { |project| where(['version_settings.project_id = ? AND version_settings.display = ?', project.id, VersionSetting::DISPLAY_RIGHT]) .includes(:version_settings) .references(:version_settings) } def stories(project, options = {}) Story.sprint_backlog(project, self, options) end def points stories.inject(0) { |sum, story| sum + story.story_points.to_i } end def has_wiki_page return false if wiki_page_title.blank? page = project.wiki.find_page(wiki_page_title) return false if !page template = project.wiki.find_page(Setting.plugin_openproject_backlogs['wiki_template']) return false if template && page.text == template.text true end def wiki_page return '' unless project.wiki update_attribute(:wiki_page_title, name) if wiki_page_title.blank? page = project.wiki.find_page(wiki_page_title) template = project.wiki.find_page(Setting.plugin_openproject_backlogs['wiki_template']) if template and not page page = project.wiki.pages.build(title: wiki_page_title) page.build_content(text: "h1. #{name}\n\n#{template.text}") page.save! end wiki_page_title end def days(cutoff = nil, alldays = false) # TODO: Assumes mon-fri are working days, sat-sun are not. This assumption # is not globally right, we need to make this configurable. cutoff = effective_date if cutoff.nil? (start_date..cutoff).select { |d| alldays || (d.wday > 0 and d.wday < 6) } end def has_burndown? !!(effective_date and start_date) end def activity bd = burndown('up') return false if bd.blank? # Assume a sprint is active if it's only 2 days old return true if bd.remaining_hours.size <= 2 WorkPackage.exists?(['version_id = ? and ((updated_at between ? and ?) or (created_at between ? and ?))', id, -2.days.from_now, Time.now, -2.days.from_now, Time.now]) end def burndown(project, burn_direction = nil) return nil unless has_burndown? @cached_burndown ||= Burndown.new(self, project, burn_direction) end def self.generate_burndown(only_current = true) conditions = if only_current ['? BETWEEN start_date AND effective_date', Date.today] else '1 = 1' end Version.where(conditions).each(&:burndown) end def impediments(project) # for reasons beyond me, # the default_scope needs to be explicitly applied. Impediment.default_scope.where(version_id: self, project_id: project) end end