firefly-iii/app/models/Account.php

<?php
use LaravelBook\Ardent\Ardent as Ardent;

/**
 * Account
 *
 * @property integer $id
 * @property \Carbon\Carbon $created_at
 * @property \Carbon\Carbon $updated_at
 * @property integer $user_id
 * @property integer $account_type_id
 * @property string $name
 * @property boolean $active
 * @property-read \AccountType $accountType
 * @property-read \User $user
 * @property-read \Illuminate\Database\Eloquent\Collection|\Transaction[] $transactions
 * @method static \Illuminate\Database\Query\Builder|\Account whereId($value) 
 * @method static \Illuminate\Database\Query\Builder|\Account whereCreatedAt($value) 
 * @method static \Illuminate\Database\Query\Builder|\Account whereUpdatedAt($value) 
 * @method static \Illuminate\Database\Query\Builder|\Account whereUserId($value) 
 * @method static \Illuminate\Database\Query\Builder|\Account whereAccountTypeId($value) 
 * @method static \Illuminate\Database\Query\Builder|\Account whereName($value) 
 * @method static \Illuminate\Database\Query\Builder|\Account whereActive($value) 
 */
class Account extends Ardent
{

    /**
     * Validation rules.
     *
     * @var array
     */
    public static $rules
        = [
            'name'            => 'required|between:1,100',
            'user_id'         => 'required|exists:users,id',
            'account_type_id' => 'required|exists:account_types,id',
            'active'          => 'required|between:0,1|numeric'

        ];

    /**
     * Factory instructions
     *
     * @var array
     */
    public static $factory
        = [
            'name'            => 'string',
            'user_id'         => 'factory|User',
            'account_type_id' => 'factory|AccountType',
            'active'          => '1'
        ];

    /**
     * Account type.
     *
     * @return \Illuminate\Database\Eloquent\Relations\BelongsTo
     */
    public function accountType()
    {
        return $this->belongsTo('AccountType');
    }

    /**
     * User
     *
     * @return \Illuminate\Database\Eloquent\Relations\BelongsTo
     */
    public function user()
    {
        return $this->belongsTo('User');
    }

    /**
     * Get an accounts current balance.
     *
     * @param \Carbon\Carbon $date
     *
     * @return float
     */
    public function balance(\Carbon\Carbon $date = null)
    {
        $date = is_null($date) ? new \Carbon\Carbon : $date;

        return floatval(
            $this->transactions()
                ->leftJoin(
                    'transaction_journals', 'transaction_journals.id', '=', 'transactions.transaction_journal_id'
                )
                ->where('transaction_journals.date', '<=', $date->format('Y-m-d'))->sum('transactions.amount')
        );
    }

    /**
     * Transactions.
     *
     * @return \Illuminate\Database\Eloquent\Relations\HasMany
     */
    public function transactions()
    {
        return $this->hasMany('Transaction');
    }

}