2009-01-08 16:33:27 +01:00
# == Schema Information
# Schema version: 20090102171850
#
# Table name: groups
#
# id :integer(4) not null, primary key
# type :string(255) default(""), not null
# name :string(255) default(""), not null
# description :string(255)
# actual_size :integer(4)
# account_balance :decimal(8, 2) default(0.0), not null
# account_updated :datetime
# created_on :datetime not null
# role_admin :boolean(1) not null
# role_suppliers :boolean(1) not null
# role_article_meta :boolean(1) not null
# role_finance :boolean(1) not null
# role_orders :boolean(1) not null
# weekly_task :boolean(1)
# weekday :integer(4)
# task_name :string(255)
# task_description :string(255)
# task_required_users :integer(4) default(1)
#
2009-01-14 12:46:01 +01:00
# Ordergroups can order, they are "children" of the class Group
2009-01-06 11:49:19 +01:00
#
2009-01-14 12:46:01 +01:00
# Ordergroup have the following attributes, in addition to Group
2009-01-06 11:49:19 +01:00
# * account_balance (decimal)
# * account_updated (datetime)
2009-01-14 12:46:01 +01:00
# * actual_size (int) : how many persons are ordering through the Ordergroup
class Ordergroup < Group
2009-01-06 11:49:19 +01:00
has_many :financial_transactions , :dependent = > :destroy
has_many :group_orders , :dependent = > :destroy
has_many :orders , :through = > :group_orders
has_many :group_order_article_results , :through = > :group_orders # TODO: whats this???
has_many :group_order_results , :finder_sql = > 'SELECT * FROM group_order_results as r WHERE r.group_name = "#{name}"'
validates_inclusion_of :actual_size , :in = > 1 .. 99
validates_numericality_of :account_balance , :message = > 'ist keine gültige Zahl'
attr_accessible :actual_size , :account_updated
# messages
ERR_NAME_IS_USED_IN_ARCHIVE = " Der Name ist von einer ehemaligen Gruppe verwendet worden. "
2009-01-14 12:46:01 +01:00
# if the ordergroup.name is changed, group_order_result.name has to be adapted
2009-01-06 11:49:19 +01:00
def before_update
2009-01-14 12:46:01 +01:00
ordergroup = Ordergroup . find ( self . id )
2009-01-06 11:49:19 +01:00
unless ( ordergroup . name == self . name ) || ordergroup . group_order_results . empty?
# rename all finished orders
for result in ordergroup . group_order_results
result . update_attribute ( :group_name , self . name )
end
end
end
# Returns the available funds for this order group (the account_balance minus price of all non-booked GroupOrders of this group).
# * excludeGroupOrder (GroupOrder): exclude this GroupOrder from the calculation
def getAvailableFunds ( excludeGroupOrder = nil )
funds = account_balance
2009-01-14 12:46:01 +01:00
for order in GroupOrder . find_all_by_ordergroup_id ( self . id )
2009-01-06 11:49:19 +01:00
unless order == excludeGroupOrder
funds -= order . price
end
end
for order_result in self . findFinishedNotBooked
funds -= order_result . price
end
return funds
end
2009-01-14 12:46:01 +01:00
# Creates a new FinancialTransaction for this Ordergroup and updates the account_balance accordingly.
2009-01-06 11:49:19 +01:00
# Throws an exception if it fails.
def addFinancialTransaction ( amount , note , user )
transaction do
2009-01-14 12:46:01 +01:00
trans = FinancialTransaction . new ( :ordergroup = > self , :amount = > amount , :note = > note , :user = > user )
2009-01-06 11:49:19 +01:00
trans . save!
self . account_balance += trans . amount
self . account_updated = trans . created_on
save!
notifyNegativeBalance ( trans )
end
end
# Returns all GroupOrders by this group that are currently running.
def findCurrent
group_orders . find ( :all , :conditions = > [ " orders.finished = ? AND orders.starts < ? AND (orders.ends IS NULL OR orders.ends > ?) " , false , Time . now , Time . now ] , :include = > :order )
end
#find expired (lapsed) but not manually finished orders
def findExpiredOrders
group_orders . find ( :all , :conditions = > [ " orders.ends < ? " , Time . now ] , :include = > :order , :order = > 'orders.ends DESC' )
end
# Returns all GroupOrderResults by this group that are finished but not booked yet.
def findFinishedNotBooked
GroupOrderResult . find ( :all ,
:conditions = > [ " group_order_results.group_name = ? AND group_order_results.order_id = orders.id AND orders.finished = ? AND orders.booked = ? " , self . name , true , false ] ,
:include = > :order ,
:order = > 'orders.ends DESC' )
end
# Returns all GroupOrderResults for booked orders
def findBookedOrders ( limit = false , offset = 0 )
GroupOrderResult . find ( :all ,
:conditions = > [ " group_order_results.group_name = ? AND group_order_results.order_id = orders.id AND orders.finished = ? AND orders.booked = ? " , self . name , true , true ] ,
:include = > :order ,
:order = > " orders.ends DESC " ,
:limit = > limit ,
:offset = > offset )
end
private
# If this order group's account balance is made negative by the given/last transaction,
# a message is sent to all users who have enabled notification.
def notifyNegativeBalance ( transaction )
# Notify only when order group had a positive balance before the last transaction:
if ( transaction . amount < 0 && self . account_balance < 0 && self . account_balance - transaction . amount > = 0 )
2009-01-15 18:26:37 +01:00
users = self . users . reject { | u | u . settings [ " notify.negativeBalance " ] != '1' }
unless users . empty?
Message . from_template (
'negative_balance' ,
{ :group = > self , :transaction = > transaction } ,
{ :recipients_ids = > users . collect ( & :id ) , :subject = > " Gruppenkonto im Minus " }
) . save!
2009-01-06 11:49:19 +01:00
end
2009-01-15 20:10:50 +01:00
end
2009-01-06 11:49:19 +01:00
end
# before create or update, check if the name is already used in GroupOrderResults
def validate_on_create
errors . add ( :name , ERR_NAME_IS_USED_IN_ARCHIVE ) unless GroupOrderResult . find_all_by_group_name ( self . name ) . empty?
end
def validate_on_update
2009-01-14 12:46:01 +01:00
ordergroup = Ordergroup . find ( self . id )
2009-01-06 11:49:19 +01:00
errors . add ( :name , ERR_NAME_IS_USED_IN_ARCHIVE ) unless ordergroup . name == self . name || GroupOrderResult . find_all_by_group_name ( self . name ) . empty?
end
end