phorge-phorge/src/applications/fund/storage/FundBacker.php

<?php

final class FundBacker extends FundDAO
  implements
    PhabricatorPolicyInterface,
    PhabricatorApplicationTransactionInterface {

  protected $initiativePHID;
  protected $backerPHID;
  protected $amountInCents;
  protected $status;
  protected $properties = array();

  private $initiative = self::ATTACHABLE;

  const STATUS_NEW = 'new';
  const STATUS_IN_CART = 'in-cart';

  public static function initializeNewBacker(PhabricatorUser $actor) {
    return id(new FundBacker())
      ->setBackerPHID($actor->getPHID())
      ->setStatus(self::STATUS_NEW);
  }

  public function getConfiguration() {
    return array(
      self::CONFIG_AUX_PHID => true,
      self::CONFIG_SERIALIZATION => array(
        'properties' => self::SERIALIZATION_JSON,
      ),
      self::CONFIG_COLUMN_SCHEMA => array(
        'status' => 'text32',
        'amountInCents' => 'uint32',
      ),
      self::CONFIG_KEY_SCHEMA => array(
        'key_initiative' => array(
          'columns' => array('initiativePHID'),
        ),
        'key_backer' => array(
          'columns' => array('backerPHID'),
        ),
      ),
    ) + parent::getConfiguration();
  }

  public function generatePHID() {
    return PhabricatorPHID::generateNewPHID(FundBackerPHIDType::TYPECONST);
  }

  protected function didReadData() {
    // The payment processing code is strict about types.
    $this->amountInCents = (int)$this->amountInCents;
  }

  public function getProperty($key, $default = null) {
    return idx($this->properties, $key, $default);
  }

  public function setProperty($key, $value) {
    $this->properties[$key] = $value;
    return $this;
  }

  public function getInitiative() {
    return $this->assertAttached($this->initiative);
  }

  public function attachInitiative(FundInitiative $initiative = null) {
    $this->initiative = $initiative;
    return $this;
  }


/* -(  PhabricatorPolicyInterface  )----------------------------------------- */


  public function getCapabilities() {
    return array(
      PhabricatorPolicyCapability::CAN_VIEW,
    );
  }

  public function getPolicy($capability) {
    switch ($capability) {
      case PhabricatorPolicyCapability::CAN_VIEW:
        // If we have the initiative, use the initiative's policy.
        // Otherwise, return NOONE. This allows the backer to continue seeing
        // a backer even if they're no longer allowed to see the initiative.

        $initiative = $this->getInitiative();
        if ($initiative) {
          return $initiative->getPolicy($capability);
        }
        return PhabricatorPolicies::POLICY_NOONE;
    }
  }

  public function hasAutomaticCapability($capability, PhabricatorUser $viewer) {
    return ($viewer->getPHID() == $this->getBackerPHID());
  }

  public function describeAutomaticCapability($capability) {
    return pht('A backer can always see what they have backed.');
  }


/* -(  PhabricatorApplicationTransactionInterface  )------------------------- */


  public function getApplicationTransactionEditor() {
    return new FundBackerEditor();
  }

  public function getApplicationTransactionObject() {
    return $this;
  }

  public function getApplicationTransactionTemplate() {
    return new FundBackerTransaction();
  }

}