pmgr/models/ledger.php

<?php
class Ledger extends AppModel {

  var $belongsTo = array(
    'Account',
    'PriorLedger' => array('className' => 'Ledger'),
    'Close',
  );

  var $hasMany = array(
    'Entry',

    'DoubleEntry' => array(
      'foreignKey' => false,

      // conditions will be used when JOINing tables
      // (such as find with LinkableBehavior)
      'conditions' => array('OR' =>
			    array('DoubleEntry.debit_ledger_id = %{MODEL_ALIAS}.id',
				  'DoubleEntry.credit_ledger_id = %{MODEL_ALIAS}.id')),

      // finderQuery will be used when tables are put
      // together across several querys, not with JOIN.
      // (such as find with ContainableBehavior)
      'finderQuery' => 'SELECT `DoubleEntry`.*
                         FROM pmgr_double_entries AS `DoubleEntry`
                         WHERE DoubleEntry.debit_ledger_id = ({$__cakeID__$})
                            OR DoubleEntry.credit_ledger_id = ({$__cakeID__$})',

      'counterQuery' => ''
    ),
  );


  /**************************************************************************
   **************************************************************************
   **************************************************************************
   * function: accountID
   *  - Returns the account ID for the given ledger
   */
  function accountID($id) {
    $this->cacheQueries = true;
    $item = $this->find('first', array
			('link' => array('Account'),
			 'conditions' => array('Ledger.id' => $id),
			 ));
    $this->cacheQueries = false;
    //pr(compact('id', 'item'));
    return $item['Account']['id'];
  }


  /**************************************************************************
   **************************************************************************
   **************************************************************************
   * function: currentLedgerID
   *  - Returns the current ledger ID of the account for the given ledger.
   */
  function currentLedgerID($id) {
    return $this->Account->currentLedgerID($this->accountID($id));
  }


  /**************************************************************************
   **************************************************************************
   **************************************************************************
   * function: closeLedger
   *  - Closes the current ledger, and returns a fresh one
   */
  function closeLedger($id, $close_id) {
    $this->recursive = -1;

    $stamp = date('Y-m-d G:i:s');
    $this->id = $id;
    $this->read();
    $this->data['Ledger']['close_id'] = $close_id;
    $this->save($this->data, false);

    $stats = $this->stats($id);

    $this->read();
    $this->data['Ledger']['id'] = null;
    $this->data['Ledger']['close_id'] = null;
    $this->data['Ledger']['prior_ledger_id'] = $id;
    $this->data['Ledger']['comment'] = null;
    ++$this->data['Ledger']['sequence'];
    $this->id = null;
    $this->save($this->data, false);
    //pr($this->data);

    if ($stats['balance'] == 0)
      return $this->id;

    $this->read();
    $ftype = $this->Account->fundamentalType($this->data['Ledger']['account_id']);
    $otype = $this->Account->fundamentalOpposite($ftype);

    // Create a transaction for balance transfer
    $transaction = new Transaction();
    $transaction->create();
    if (!$transaction->save(array(), false)) {
      return null;
    }

    // Create an entry to carry the balance forward
    $carry_entry_data = array
      ($ftype.'_ledger_id' => $this->id,
       $otype.'_ledger_id' => $id,
       'transaction_id' => $transaction->id,
       'amount' => $stats['balance'],
       'comment' => "Ledger Balance Forward",
       );

    $carry_entry = new DoubleEntry();
    $carry_entry->create();
    if (!$carry_entry->save($carry_entry_data, false)) {
      return null;
    }

    return $this->id;
    }


  /**************************************************************************
   **************************************************************************
   **************************************************************************
   * function: debitCreditFields
   *  - Returns the fields necessary to determine whether the queried
   *    entries are a debit, or a credit, and also the effect each have
   *    on the overall balance of the ledger.
   */
  function debitCreditFields($id, $sum = false,
			     $entry_name = 'Entry', $double_name = 'DoubleEntry') {
    return $this->Account->debitCreditFields
      ($this->accountID($id), $sum, $entry_name, $double_name);
  }

  /**************************************************************************
   **************************************************************************
   **************************************************************************
   * function: ledgerEntries
   *  - Returns an array of ledger entries that belong to a given
   *    ledger. There is extra work done to establish debit/credit
   */
  function ledgerEntries($ids, $cond = null, $link = null) {
    if (empty($ids))
      return null;

/*     $id = (is_array($ids) ? $ids[0] : $ids); */
/*     $ftype = strtoupper($this->Account->fundamentalType($this->accountID($id))); */

    $entries = $this->Entry->find
      ('all', array
       ('contain' => array('DoubleEntry' => array('fields' => array('amount'))),
	'fields' => array_merge(array("Entry.*"),
				$this->debitCreditFields(is_array($ids) ? $ids[0] : $ids)),
/* 			  "IF(Entry.crdr = 'CREDIT', DoubleEntry.amount, NULL) AS credit", */
/* 			  "IF(Entry.crdr = 'DEBIT',  DoubleEntry.amount, NULL) AS debit", */
/* 			  "IF(Entry.crdr = '$ftype', 1, -1) * DoubleEntry.amount AS balance", */

	'conditions' => array('Entry.ledger_id' => $ids),
	));

    //pr(compact('entries'));
    return $entries;
  }


  /**************************************************************************
   **************************************************************************
   **************************************************************************
   * function: stats
   *  - Returns summary data from the requested ledger.
   */
  function stats($id, $query = null) {
    if (!$id)
      return null;

    $this->queryInit($query);

    if (!isset($query['link']['Account']))
      $query['link']['Account'] = array();
    if (!isset($query['link']['Account']['fields']))
      $query['link']['Account']['fields'] = array();
    if (!isset($query['link']['Entry']))
      $query['link']['Entry'] = array();
    if (!isset($query['link']['Entry']['DoubleEntry']))
      $query['link']['Entry']['DoubleEntry'] = array();
    if (!isset($query['link']['Entry']['DoubleEntry']['fields']))
      $query['link']['Entry']['DoubleEntry']['fields'] = array();
    if (!isset($query['link']['Entry']['DoubleEntry']['Transaction']))
      $query['link']['Entry']['DoubleEntry']['Transaction'] = array();
    if (!isset($query['link']['Entry']['DoubleEntry']['Transaction']['fields']))
      $query['link']['Entry']['DoubleEntry']['Transaction']['fields'] = array();
    $query['link']['Entry']['DoubleEntry']['Transaction']['fields'][] = 'stamp';

    if (!isset($query['fields']))
      $query['fields'] = array();

    $query['fields'] = array_merge($query['fields'],
				   $this->debitCreditFields($id, true));

    $query['conditions'][] = array('Ledger.id' => $id);
    $query['group'][] = 'Ledger.id';

    $stats = $this->find('first', $query);

    unset($query['group']);
    $query['fields'] = $this->debitCreditFields($id, false);
    $stats = $this->find('all', $query);
    pr(compact('query', 'stats'));

    // The fields are all tucked into the [0] index,
    // and the rest of the array is useless (empty).
    $stats = $stats[0];

    // Make sure we have a non-null balance
    if (!isset($stats['balance']))
      $stats['balance'] = 0;

    return $stats;
  }

}
?>