deckshuffler 0.0.2

data/MIT-LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2006, 2007 Denis Bregeon
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+

data/Rakefile

@@ -0,0 +1,55 @@
+# Add your own tasks in files placed in lib/tasks ending in .rake,
+# for example lib/tasks/switchtower.rake, and they will automatically be available to Rake.
+
+require(File.join(File.dirname(__FILE__), 'config', 'boot'))
+
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+require 'rake/gempackagetask'
+require 'rcov/rcovtask'
+
+require 'tasks/rails'
+
+require 'rubygems'
+
+PKG_VERSION="0.0.2"
+PKG_FILES=Dir.glob('**/*', File::FNM_DOTMATCH).reject do |f| 
+     [ /\.$/,
+     /config\/database.yml$/,
+     /config\/database.yml-/, 
+     /config\/environments/, 
+     /tmp/,
+     /coverage/,
+     /\.project/,
+     /\.log$/,
+     /^pkg/,
+     /\.svn/,
+     /^vendor\/rails/,
+     /\~$/, 
+     /\/\._/,
+     /\/#/ ].any? {|regex| f =~ regex }
+ end
+
+SPEC = Gem::Specification.new do |s|
+  s.platform = Gem::Platform::RUBY
+  s.summary = "Web-based task management application."
+  s.name = 'deckshuffler'
+  s.version = PKG_VERSION
+  s.add_dependency("rails", ">= 1.1.6", "< 2.0.0")
+  s.add_dependency("rake", ">= 0.7.1", "< 1.0.0")
+  s.require_path = '.'
+  s.files = PKG_FILES
+  s.executables=(["deckshuffler"])
+  s.description = "Deckshuffler is a web application that enables to easily manage tasks (cards) in a software development project."
+end
+
+Rcov::RcovTask.new do |t|
+   t.test_files = FileList['test/unit/*.rb']
+   # t.verbose = true     # uncomment to see the executed command
+end
+
+Rake::GemPackageTask.new(SPEC) do |pkg|
+   pkg.need_zip = false
+   pkg.need_tar = false
+end

data/app/controllers/account_controller.rb

@@ -0,0 +1,41 @@
+class AccountController < ApplicationController
+  # GETs should be safe (see http://www.w3.org/2001/tag/doc/whenToUseGet.html)
+  verify :method => :post, :only => [ :login_post, :signup_post],
+         :redirect_to => :login
+         
+  skip_before_filter :login_required
+
+  def login_post
+    if authenticate(params[:login], params[:password])
+      flash[:notice] = "Logged in successfully"
+      redirect_back_or_default(home_page())
+    else
+      flash[:notice] = "Login failed."
+      redirect_to(:action => :login)
+    end
+  end
+  
+  def login
+  end
+  
+  def signup_post
+    user_signup!(params[:user])
+    redirect_back_or_default(home_page())
+    flash[:notice] = "Thanks for signing up!"
+  rescue ActiveRecord::RecordInvalid
+    redirect_to(:action => :signup)
+  end
+  
+  def signup
+  end
+  
+  def logout
+    user_logout()
+    flash[:notice] = "You have been logged out."
+    redirect_back_or_default(home_page())
+  end
+    
+  def page_title
+	'Welcome !'
+  end
+end

data/app/controllers/application.rb

@@ -0,0 +1,27 @@
+# Filters added to this controller will be run for all controllers in the application.
+# Likewise, all the methods added will be available for all controllers.
+class ApplicationController < ActionController::Base
+  private
+  
+  AUTHENTICATED_SYSTEM = "AuthenticatedSystem"
+  
+  include ModuleValidator
+  
+  def ApplicationController.validate_authentication_module!()
+    module_name = AUTHENTICATED_SYSTEM
+    project_info = ProjectInfo.find(:first)
+    module_name = project_info.authentication_module() unless (project_info.nil?() || project_info.authentication_module().nil?() || project_info.authentication_module().empty?())
+    # validate the module answers the required methods.
+    required_methods = [:login_from_cookie,:login_required, :user_name, :all_user_names, :authenticate, :user_signup!, :user_logout]
+    include(ModuleValidator.validate_module!(module_name, required_methods))
+    # If you want "remember me" functionality, add this before_filter to Application Controller
+    before_filter :login_from_cookie
+    before_filter :login_required
+  end
+  
+  # Dynamically loads the authentication module defined in the configuration.
+  validate_authentication_module!()
+
+  include ApplicationHelper
+  layout 'standard'
+end

data/app/controllers/board_controller.rb

@@ -0,0 +1,15 @@
+class BoardController < ApplicationController
+  include TransitionManager
+  
+  def index
+    if (! ProjectInfo.exists?(1))
+      redirect_to :controller => 'project_infos', :action => 'new'
+    end
+  end
+  
+  def page_title
+    if ('index' == action_name())
+	   "In Play, iteration #{ProjectInfo.find(1).current_iteration.to_s}"
+    end
+  end
+end

data/app/controllers/capacities_controller.rb

@@ -0,0 +1,52 @@
+class CapacitiesController < ApplicationController
+  # GETs should be safe (see http://www.w3.org/2001/tag/doc/whenToUseGet.html)
+  verify :method => :post, :only => [ :create, :update ],
+         :redirect_to => { :action => :list }
+
+  def index
+    list
+    render :action => 'list'
+  end
+
+  def list
+    @capacity_pages, @capacities = paginate :capacities, :conditions => 'capacities.iteration = ' + ProjectInfo.find(1).current_iteration.to_s, :per_page => 10
+  end
+
+  def show
+    @capacity = Capacity.find(params[:id])
+  end
+
+  def new
+    @capacity = Capacity.new
+  end
+
+  def create
+    @capacity = Capacity.new(params[:capacity])
+    @capacity.iteration= ProjectInfo.find(:first).current_iteration
+    if @capacity.save
+      flash[:notice] = 'Capacity was successfully created.'
+      redirect_to :action => 'list'
+    else
+      render :action => 'new'
+    end
+  end
+
+  def edit
+    @capacity = Capacity.find(params[:id])
+  end
+
+  def update
+    @capacity = Capacity.find(params[:id])
+    if @capacity.update_attributes(params[:capacity])
+      flash[:notice] = 'Capacity was successfully updated.'
+      redirect_to :action => 'list'
+    else
+      render :action => 'edit'
+    end
+  end
+  
+  def destroy
+    Capacity.find(params[:id]).destroy
+	redirect_to :action => 'list'
+  end
+end

data/app/controllers/card_sizes_controller.rb

@@ -0,0 +1,47 @@
+class CardSizesController < ApplicationController
+  def index
+    list
+    render :action => 'list'
+  end
+
+  def list
+    @card_size_pages, @card_sizes = paginate :card_sizes, :per_page => 10
+  end
+
+  def show
+    @card_size = CardSize.find(params[:id])
+  end
+
+  def new
+    @card_size = CardSize.new
+  end
+
+  def create
+    @card_size = CardSize.new(params[:card_size])
+    if @card_size.save
+      flash[:notice] = 'CardSize was successfully created.'
+      redirect_to :action => 'list'
+    else
+      render :action => 'new'
+    end
+  end
+
+  def edit
+    @card_size = CardSize.find(params[:id])
+  end
+
+  def update
+    @card_size = CardSize.find(params[:id])
+    if @card_size.update_attributes(params[:card_size])
+      flash[:notice] = 'CardSize was successfully updated.'
+      redirect_to :action => 'show', :id => @card_size
+    else
+      render :action => 'edit'
+    end
+  end
+
+  def destroy
+    CardSize.find(params[:id]).destroy
+    redirect_to :action => 'list'
+  end
+end

data/app/controllers/card_types_controller.rb

@@ -0,0 +1,47 @@
+class CardTypesController < ApplicationController
+  def index
+    list
+    render :action => 'list'
+  end
+
+  def list
+    @card_type_pages, @card_types = paginate :card_types, :per_page => 10
+  end
+
+  def show
+    @card_type = CardType.find(params[:id])
+  end
+
+  def new
+    @card_type = CardType.new
+  end
+
+  def create
+    @card_type = CardType.new(params[:card_type])
+    if @card_type.save
+      flash[:notice] = 'CardType was successfully created.'
+      redirect_to :action => 'list'
+    else
+      render :action => 'new'
+    end
+  end
+
+  def edit
+    @card_type = CardType.find(params[:id])
+  end
+
+  def update
+    @card_type = CardType.find(params[:id])
+    if @card_type.update_attributes(params[:card_type])
+      flash[:notice] = 'CardType was successfully updated.'
+      redirect_to :action => 'show', :id => @card_type
+    else
+      render :action => 'edit'
+    end
+  end
+
+  def destroy
+    CardType.find(params[:id]).destroy
+    redirect_to :action => 'list'
+  end
+end

data/app/controllers/cards_controller.rb

@@ -0,0 +1,233 @@
+require 'cards_csv_importer'
+require 'cards_csv_exporter'
+
+class CardsController < ApplicationController
+  include TransitionManager
+  
+  verify :method => :post, :only => [ :merge_update, :split_update, :create, :update, :import_update], 
+  :redirect_to => { :controller => "board", :action => "index" }
+  
+  before_filter :mark_snap_back, :only => [:raise_card, :edit, :split, :import]
+  before_filter :use_snap_back, :only => [:create, :update, :update_split, :import_update]
+  
+  def raise_card
+    @card = Card.new
+    @card.owner_name= user_name()
+  end
+  
+  def create
+    @card = Card.new(params[:card])
+    projectInfo = ProjectInfo.find(:first)
+    @card.project_id=(projectInfo.id)
+    @card.iteration_raised= projectInfo.current_iteration
+    if @card.save
+      flash[:notice] = 'Card was successfully created.'
+      snap_back()
+    else
+      render :action => 'raise_card'
+    end
+  end
+  
+  def edit
+    @card = Card.find(params[:id])
+  end
+  
+  def update
+    @card = Card.find(params[:id])
+    if @card.update_attributes(params[:card])
+      flash[:notice] = 'Card was successfully updated.'
+      snap_back()
+    else
+      render :action => 'edit'
+    end
+  end
+  
+  def change_status
+    @card = Card.find(params[:id])
+    status = Status.get(params[:status_name])
+    if (apply_transition(@card,status))
+      flash[:notice] = 'Card was successfully updated.'
+    end
+    snap_back()
+  end
+  
+  def split
+    @card = Card.find(params[:id])
+    redirect_to :back unless splitable?(@card)
+  end
+  
+  def update_split
+    @card = Card.find(params[:id])
+    slices = params[:slice][:slices].to_i
+    count = 0
+    while (count < slices) do
+      new_card = Card.new(@card.attributes())
+      new_card.id=(nil)
+      new_card.title=("#{new_card.title()} (#{count.to_s})")
+      new_card.save!()
+      count = count + 1
+    end
+    apply_transition(@card, Status::DROPPED)
+    
+    snap_back()
+  end
+  
+  def list_per_status
+    @status = Status.get(params[:status_name])
+    @card_pages, @cards = paginate :cards, :conditions => " status_name = '#{@status.name()}'", :order => "priority_rank, title", :per_page => 100
+  end
+  
+  def list_per_user
+    if (params[:owner_name]).nil?()
+      @owner = user_name()
+    else
+      @owner = params[:owner_name]
+    end
+    @card_pages, @cards = paginate :cards, :conditions => " owner_name = '#{@owner}'", :order => "status_name, priority_rank, title", :per_page => 100
+  end
+  
+  def list_per_milestone
+    @milestone = Milestone.find(params[:id])
+  end
+  
+  def list_per_functional_set
+    @functional_set = FunctionalSet.find(params[:id])
+  end
+  
+  def find_other_cards(card)
+    conditions = "status_name != '#{Status::DROPPED.name()}' AND status_name != '#{Status::DELIVERED.name()}'"
+    if (! card.id().nil?()) 
+      conditions += " AND id != #{@card.id()}"
+    end
+    Card.find(:all, :conditions => conditions)
+  end
+  
+  def merge
+    @cards = Card.find(:all, :conditions => "status_name in ('#{Status::NEW.name()}','#{Status::ESTIMATED.name()}','#{Status::IN_PLAY.name()}')")
+  end
+  
+  def merge_update
+    cards_to_merge = Array.new()
+    params[:merge_cards].each {|id, value| cards_to_merge<<Card.find(id) if (value == "true")}
+    if (cards_to_merge.empty?())
+      redirect_to :action => "index", :controller => "board"
+    else
+      merged_card = merge_cards(cards_to_merge, current_user())
+      redirect_to :action => "edit", :id => merged_card.id()
+    end
+  end
+  
+  def page_title
+    if ('list_per_functional_set' == action_name())
+	   "Cards in #{@functional_set.name()} Set"
+    elsif ('list_per_status' == action_name())
+      "#{@status.name()} Cards"
+    elsif ('list_per_user' == action_name())
+      "Cards for #{@owner}"
+    elsif ('list_per_milestone' == action_name())
+      "Cards for #{@milestone.name()}"
+      
+    elsif ('split' == action_name())
+      "Splitting #{@card.title()} Card"
+    else
+      super
+    end
+  end
+  
+  def splitable?(card)
+    [Status::NEW, Status::ESTIMATED, Status::IN_PLAY].include?(card.status())
+  end
+  
+  def merge_cards(cards,user = nil)
+    new_card = Card.create()
+    new_owner = cards[0].owner_name()
+    common_owner = true
+    new_priority = nil
+    new_milestone = nil
+    new_card_type = nil
+    new_card_size = nil
+    new_child_cards = Array.new()
+    new_parent_cards = Array.new()
+    new_functional_sets = Array.new()
+    new_description = ""
+    new_title = "merged from "
+    for card in cards
+      new_title += " #{card.id()},"
+      new_description += "#{card.description()}\n"
+      new_card_type = card.card_type() unless (! new_card_type.nil?()) && (new_card_type <= card.card_type())
+      new_priority = card.priority() unless (! new_priority.nil?()) && (new_priority <= card.priority())
+      new_card_size = card.estimated_size() unless (! new_card_size.nil?()) && (! card.estimated_size().nil?()) && (new_card_size >= card.estimated_size())
+      new_milestone = card.target_milestone() unless (! new_milestone.nil?()) && (new_milestone <= card.target_milestone())
+      new_child_cards.concat(card.child_cards())
+      new_parent_cards.concat(card.parent_cards())
+      new_functional_sets.concat(card.functional_sets())
+      common_owner = common_owner && (new_owner == card.owner_name())
+      apply_transition(card,Status::DROPPED)
+    end
+    new_owner = user unless (common_owner)
+    
+    new_card.title=(new_title.chop())
+    new_card.description=(new_description.chop())
+    new_card.owner_name=(new_owner)
+    new_card.priority=(new_priority)
+    new_card.target_milestone=(new_milestone)
+    new_card.card_type=(new_card_type)
+    new_card.estimated_size=(new_card_size)
+    new_card.child_cards=(new_child_cards.compact().select {|card| ! cards.include?(card)} )
+    new_card.parent_cards=(new_parent_cards.compact().select {|card| ! cards.include?(card)})
+    new_card.functional_sets=(new_functional_sets.compact())
+    new_card.save()
+    return new_card
+  end
+  
+  def export
+    filename = "#{params[:file_name]}.csv"
+    cards = Card.find(params[:card_ids].split("/"))
+    
+    if request.env['HTTP_USER_AGENT'] =~ /msie/i
+      response.headers['Pragma'] = 'public'
+      response.headers["Content-type"] = "text/plain" 
+      response.headers['Cache-Control'] = 'no-cache, must-revalidate, post-check=0, pre-check=0'
+      response.headers.headers['Content-Disposition'] = "attachment; filename=\"#{filename}\"" 
+      response.headers['Expires'] = "0" 
+    else
+      response.headers['Content-Type'] = "text/csv; charset=iso-8859-1; header=present"
+      response.headers['Content-Disposition'] = "attachment; filename=\"#{filename}\""
+    end
+    render :text => Proc.new { |response, output|
+      exporter = CardsCSVExporter.new()
+      exporter.export(cards,output)
+     }
+  end
+  
+  def import
+  end
+  
+  def import_update
+    if (! params[:import][:file].nil?())
+      parser = CardsCSVImporter.new()
+      begin
+        new_objects = parser.import(params[:import][:file])
+        for object in new_objects
+            if (object.kind_of?(Card))
+              object.owner_name=(user_name())
+            end
+            object.save()
+        end
+      rescue ArgumentError
+        flash[:notice] = "Failed to import file."
+      end
+    else
+      flash[:notice] = "No file to import."
+    end
+    snap_back()
+  end
+  
+  def header_menu
+    menu = [
+           ['Export table',{:action => 'export', :controller => 'cards', :file_name => page_title(), :card_ids => @cards.collect {|card| card.id()}}]
+           ]
+    menu<<(['Import Cards',{:action => 'import', :controller => 'cards'}]) if (action_name() == "list_per_status") && ((@status == Status::NEW) || (@status == Status::ESTIMATED))
+    return menu
+  end
+end