Class: Plutus::Account Abstract

Inherits:
ActiveRecord::Base
  • Object
show all
Includes:
NoTenancy, Tenancy
Defined in:
app/models/plutus/account.rb

Overview

This class is abstract.

An account must be a subclass to be saved to the database. The Account class has a singleton method Account.trial_balance to calculate the balance on all Accounts.

The Account class represents accounts in the system. Each account must be subclassed as one of the following types:

TYPE        | NORMAL BALANCE    | DESCRIPTION
--------------------------------------------------------------------------
Asset       | Debit             | Resources owned by the Business Entity
Liability   | Credit            | Debts owed to outsiders
Equity      | Credit            | Owners rights to the Assets
Revenue     | Credit            | Increases in owners equity
Expense     | Debit             | Assets or services consumed in the generation of revenue

Each account can also be marked as a “Contra Account”. A contra account will have it’s normal balance swapped. For example, to remove equity, a “Drawing” account may be created as a contra equity account as follows:

Plutus::Equity.create(:name => "Drawing", contra => true)

At all times the balance of all accounts should conform to the “accounting equation”

Plutus::Assets = Liabilties + Owner's Equity

Each sublclass account acts as it’s own ledger. See the individual subclasses for a description.

See Also:

Author:

  • Michael Bulat

Direct Known Subclasses

Asset, Equity, Expense, Liability, Revenue

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.balance(options = {}) ⇒ BigDecimal

This class method is used to return the balance of all accounts for a given class and is intended for use only on account subclasses.

Contra accounts are automatically subtracted from the balance.

Takes an optional hash specifying :from_date and :to_date for calculating balances during periods. :from_date and :to_date may be strings of the form “yyyy-mm-dd” or Ruby Date objects

Examples:

>> Plutus::Liability.balance({:from_date => "2000-01-01", :to_date => Date.today})
=> #<BigDecimal:103259bb8,'0.1E4',4(12)>
>> Plutus::Liability.balance
=> #<BigDecimal:1030fcc98,'0.82875E5',8(20)>

Returns:

  • (BigDecimal) —

    The decimal value balance



146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
 
# File 'app/models/plutus/account.rb', line 146

def self.balance(options={})
  if self.new.class == Plutus::Account
    raise(NoMethodError, "undefined method 'balance'")
  else
    accounts_balance = BigDecimal('0')
    accounts = self.all
    accounts.each do ||
      if .contra
        accounts_balance -= .balance(options)
      else
        accounts_balance += .balance(options)
      end
    end
    accounts_balance
  end
end

.trial_balance ⇒ BigDecimal

The trial balance of all accounts in the system. This should always equal zero, otherwise there is an error in the system.

Examples:

>> Account.trial_balance.to_i
=> 0

Returns:

  • (BigDecimal) —

    The decimal value balance of all accounts



171
172
173
174
175
176
177
 
# File 'app/models/plutus/account.rb', line 171

def self.trial_balance
  if self.new.class == Plutus::Account
    Plutus::Asset.balance - (Plutus::Liability.balance + Plutus::Equity.balance + Plutus::Revenue.balance - Plutus::Expense.balance)
  else
    raise(NoMethodError, "undefined method 'trial_balance'")
  end
end

.types ⇒ Object 



44
45
46
47
48
49
50
51
52
 
# File 'app/models/plutus/account.rb', line 44

def self.types
  [
    ::Plutus::Asset,
    ::Plutus::Equity,
    ::Plutus::Expense,
    ::Plutus::Liability,
    ::Plutus::Revenue,
  ]
end

Instance Method Details

#balance(options = {}) ⇒ BigDecimal

The balance of the account. This instance method is intended for use only on instances of account subclasses.

If the account has a normal credit balance, the debits are subtracted from the credits unless this is a contra account, in which case credits are substracted from debits.

For a normal debit balance, the credits are subtracted from the debits unless this is a contra account, in which case debits are subtracted from credits.

Takes an optional hash specifying :from_date and :to_date for calculating balances during periods. :from_date and :to_date may be strings of the form “yyyy-mm-dd” or Ruby Date objects

Examples:

>> liability.balance({:from_date => "2000-01-01", :to_date => Date.today})
=> #<BigDecimal:103259bb8,'0.1E4',4(12)>
>> liability.balance
=> #<BigDecimal:103259bb8,'0.2E4',4(12)>

Returns:

  • (BigDecimal) —

    The decimal value balance



81
82
83
84
85
86
87
88
89
90
91
 
# File 'app/models/plutus/account.rb', line 81

def balance(options={})
  if self.class == Plutus::Account
    raise(NoMethodError, "undefined method 'balance'")
  else
    if self.normal_credit_balance ^ contra
      credits_balance(options) - debits_balance(options)
    else
      debits_balance(options) - credits_balance(options)
    end
  end
end

#credits_balance(options = {}) ⇒ BigDecimal

The credit balance for the account.

Takes an optional hash specifying :from_date and :to_date for calculating balances during periods. :from_date and :to_date may be strings of the form “yyyy-mm-dd” or Ruby Date objects

Examples:

>> asset.credits_balance({:from_date => "2000-01-01", :to_date => Date.today})
=> #<BigDecimal:103259bb8,'0.1E4',4(12)>
>> asset.credits_balance
=> #<BigDecimal:103259bb8,'0.1E4',4(12)>

Returns:

  • (BigDecimal) —

    The decimal value credit balance



107
108
109
 
# File 'app/models/plutus/account.rb', line 107

def credits_balance(options={})
  credit_amounts.balance(options)
end

#debits_balance(options = {}) ⇒ BigDecimal

The debit balance for the account.

Takes an optional hash specifying :from_date and :to_date for calculating balances during periods. :from_date and :to_date may be strings of the form “yyyy-mm-dd” or Ruby Date objects

Examples:

>> asset.debits_balance({:from_date => "2000-01-01", :to_date => Date.today})
=> #<BigDecimal:103259bb8,'0.1E4',4(12)>
>> asset.debits_balance
=> #<BigDecimal:103259bb8,'0.3E4',4(12)>

Returns:

  • (BigDecimal) —

    The decimal value credit balance



125
126
127
 
# File 'app/models/plutus/account.rb', line 125

def debits_balance(options={})
  debit_amounts.balance(options)
end