/api/ui/push/phone_call_begin.class.php

<?php
/**
 * phone_call_begin.class.php
 * 
 * @author Patrick Emond <emondpd@mcmaster.ca>
 * @filesource
 */

namespace beartooth\ui\push;
use cenozo\lib, cenozo\log, beartooth\util;

/**
 * push: phone_call begin
 *
 * Assigns a participant to a phone call.
 */
class phone_call_begin extends \cenozo\ui\push
{
  /**
   * Constructor.
   * @author Patrick Emond <emondpd@mcmaster.ca>
   * @param array $args Push arguments
   * @access public
   */
  public function __construct( $args )
  {
    parent::__construct( 'phone_call', 'begin', $args );
  }

  /**
   * Validate the operation.
   * 
   * @author Patrick Emond <emondpd@mcmaster.ca>
   * @throws exception\notice
   * @access protected
   */
  protected function validate()
  {
    parent::validate();
    $session = lib::create( 'business\session' );

    // if the user is already in a phone call then don't start another one
    $db_phone_call = $session->get_current_phone_call();
    if( !is_null( $db_phone_call ) )
      throw lib::create( 'exception\notice',
        'You are already registered in a call, please refresh the application. '.
        'If this problem persists please report it to your coordinator.',
        __METHOD__ );

    $phone_id = $this->get_argument( 'phone_id', NULL );
    if( !is_null( $phone_id ) )
    {
      // make sure that interviewers are calling their current assignment only
      $db_assignment = $session->get_current_assignment();
      if( 'interviewer' == $session->get_role()->name )
        if( is_null( $db_assignment ) )
          throw lib::create( 'exception\runtime',
            'Interviewer tried to make call without an assignment.', __METHOD__ );

      // make sure the person being called is the same one who is assigned
      if( !is_null( $db_assignment ) )
      {
        $db_phone = lib::create( 'database\phone', $this->get_argument( 'phone_id' ) );
        $db_participant = $db_phone->get_person()->get_participant();
        if( is_null( $db_participant ) ||
            $db_participant->id != $db_assignment->get_interview()->participant_id )
          throw lib::create( 'exception\runtime',
            'User tried to make call to a different participant than who is currently assigned.',
            __METHOD__ );
      }
    }

    $phone_number = $this->get_argument( 'phone_number', NULL );
    if( !is_null( $phone_number ) )
    { // make sure the phone number is valid
      if( !util::validate_phone_number( $phone_number, true ) )
        throw lib::create( 'exception\notice',
          sprintf( 'Cannot dial phone number "%s" since it is not a valid.', $phone_number ),
          __METHOD__ );
    }
  }

  /**
   * This method executes the operation's purpose.
   * 
   * @author Patrick Emond <emondpd@mcmaster.ca>
   * @access protected
   */
  protected function execute()
  {
    parent::execute();

    // connect voip to phone
    $phone_id = $this->get_argument( 'phone_id', NULL );
    if( !is_null( $phone_id ) )
    {
      $db_phone = lib::create( 'database\phone', $this->get_argument( 'phone_id' ) );
      lib::create( 'business\voip_manager' )->call( $db_phone );

      $db_assignment = lib::create( 'business\session' )->get_current_assignment();
      if( !is_null( $db_assignment ) )
      { // create a record of the phone call
        $db_phone_call = lib::create( 'database\phone_call' );
        $db_phone_call->assignment_id = $db_assignment->id;
        $db_phone_call->phone_id = $db_phone->id;
        $db_phone_call->save();
      }
    }
    else // must be a phone number
    {
      lib::create( 'business\voip_manager' )->call( $this->get_argument( 'phone_number' ) );
    }
  }
}