Concierge::takeReservation() - Code Metrics - Inspection of "Remember duplicated appointment for query" - timegridio/concierge - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — master ( 894ab0...03c043 )

by Ariel

created 2016-03-04 01:15 UTC

Concierge::takeReservation() A

↳ Parent: Concierge

Complexity

Conditions	4
Paths	5

Size

Total Lines	56
Code Lines	31

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	32
CRAP Score	4

Importance

Changes	13
Bugs	2	Features	2

Metric	Value
c	13
b	2
f	2
dl	0
loc	56
ccs	32
cts	32
cp	1
rs	9.0544
cc	4
eloc	31
nc	5
nop	1
crap	4

How to fix Long Method

<?php

namespace Timegridio\Concierge;

use Carbon\Carbon;
use Illuminate\Support\Arr;
use Timegridio\Concierge\Booking\BookingManager;
use Timegridio\Concierge\Calendar\Calendar;
use Timegridio\Concierge\Exceptions\DuplicatedAppointmentException;
use Timegridio\Concierge\Models\Appointment;
use Timegridio\Concierge\Models\Business;
use Timegridio\Concierge\Models\Service;
use Timegridio\Concierge\Timetable\Strategies\TimetableStrategy;
use Timegridio\Concierge\Vacancy\VacancyManager;

/*******************************************************************************
 * Concierge Service Layer
 *     High level booking manager
 ******************************************************************************/
class Concierge extends Workspace
{
    protected $timetable = null;

    protected $calendar = null;

    protected $booking = null;

    protected $vacancies = null;

    protected $appointment = null;

    protected function calendar()
    {
        if ($this->calendar === null) {
            $this->calendar = new Calendar($this->business->strategy, $this->business->vacancies(), $this->business->timezone);
        }

        return $this->calendar;
    }

    public function timetable()
    {
        if ($this->timetable === null) {
            $this->timetable = new TimetableStrategy($this->business->strategy);
        }

        return $this->timetable;
    }

    public function vacancies()
    {
        if ($this->vacancies === null && $this->business !== null) {
            $this->vacancies = new VacancyManager($this->business);
        }

        return $this->vacancies;
    }

    public function booking()
    {
        if ($this->booking === null && $this->business !== null) {
            $this->booking = new BookingManager($this->business);
        }

        return $this->booking;
    }

    public function takeReservation(array $request)
    {
        $issuer = $request['issuer'];
        $service = $request['service'];
        $contact = $request['contact'];
        $comments = $request['comments'];

        $vacancies = $this->calendar()
                          ->forService($service->id)
                          ->withDuration($service->duration)
                          ->forDate($request['date'])
                          ->atTime($request['time'])
                          ->find();

        if ($vacancies->count() == 0) {
            // TODO: Log failure feedback message / raise exception
            return false;
        }

//      DEBUG / INCONSISTENT DB RECORDS CHECK
//        if ($vacancies->count() > 1) {
//            // Log unexpected behavior message / raise exception
//            $vacancy = $vacancies->first();
//        }

        if ($vacancies->count() == 1) {
            $vacancy = $vacancies->first();
        }

        $startAt = $this->makeDateTimeUTC($request['date'], $request['time'], $request['timezone']);
        $finishAt = $startAt->copy()->addMinutes($service->duration);

        $appointment = $this->generateAppointment(
            $issuer,
            $this->business->id,
            $contact->id,
            $service->id,
            $startAt,
            $finishAt,
            $comments
        );

        /* Should be moved inside generateAppointment() */
        if ($appointment->duplicates()) {
            
            $this->appointment = $appointment;

            throw new DuplicatedAppointmentException($appointment->code);
<?php

/**
 * @property int $x
 * @property int $y
 * @property string $text
 */
class MyLabel
{
    private $properties;

    private $allowedProperties = array('x', 'y', 'text');

    public function __get($name)
    {
        if (isset($properties[$name]) && in_array($name, $this->allowedProperties)) {
            return $properties[$name];
        } else {
            return null;
        }
    }

    public function __set($name, $value)
    {
        if (in_array($name, $this->allowedProperties)) {
            $properties[$name] = $value;
        } else {
            throw new \LogicException("Property $name is not defined.");
        }
    }

}
        }

        /* Should be moved inside generateAppointment() */
        $appointment->vacancy()->associate($vacancy);
function myFunction($a) {
    switch ($a) {
        case 'foo':
            $x = 1;
            break;

        case 'bar':
            $x = 2;
            break;
    }

    // $x is potentially undefined here.
    echo $x;
}
        $appointment->save();

        return $appointment;
    }

    protected function generateAppointment(
        $issuerId,
        $businessId,
        $contactId,
        $serviceId,
        Carbon $startAt,
        Carbon $finishAt,
        $comments = null)
    {
        $appointment = new Appointment();

        $appointment->doReserve();
        $appointment->setStartAtAttribute($startAt);
        $appointment->setFinishAtAttribute($finishAt);
        $appointment->business()->associate($businessId);
        $appointment->issuer()->associate($issuerId);
        $appointment->contact()->associate($contactId);
        $appointment->service()->associate($serviceId);
        $appointment->comments = $comments;
<?php

/**
 * @property int $x
 * @property int $y
 * @property string $text
 */
class MyLabel
{
    private $properties;

    private $allowedProperties = array('x', 'y', 'text');

    public function __get($name)
    {
        if (isset($properties[$name]) && in_array($name, $this->allowedProperties)) {
            return $properties[$name];
        } else {
            return null;
        }
    }

    public function __set($name, $value)
    {
        if (in_array($name, $this->allowedProperties)) {
            $properties[$name] = $value;
        } else {
            throw new \LogicException("Property $name is not defined.");
        }
    }

}
        $appointment->doHash();

        return $appointment;
    }

    /**
     * Determine if the Business has any published Vacancies available for booking.
     *
     * @return bool
     */
    public function isBookable($fromDate = 'today', $days = 7)
    {
        $timetable = $this->timetable()->buildTimetable($this->business->vacancies, $fromDate, $days);

        $timetable = Arr::flatten($timetable);

        $sum = array_sum($timetable);

        return $sum > 0;
    }

    //////////////////
    // FOR REFACTOR //
    //////////////////

    public function getActiveAppointments()
    {
        return $this->business
            ->bookings()->with('contact')
            ->with('business')
            ->with('service')
            ->active()
            ->orderBy('start_at')
            ->get();
    }

    public function getUnservedAppointments()
    {
        return $this->business
            ->bookings()->with('contact')
            ->with('business')
            ->with('service')
            ->unserved()
            ->orderBy('start_at')
            ->get();
    }

    protected function makeDateTime($date, $time, $timezone = null)
    {
        return Carbon::parse("{$date} {$time} {$timezone}");
    }

    protected function makeDateTimeUTC($date, $time, $timezone = null)
    {
        return $this->makeDateTime($date, $time, $timezone)->timezone('UTC');
    }

    public function appointment()
    {
        return $this->appointment;
    }
}


1		<?php
2
3		namespace Timegridio\Concierge;
4
5		use Carbon\Carbon;
6		use Illuminate\Support\Arr;
7		use Timegridio\Concierge\Booking\BookingManager;
8		use Timegridio\Concierge\Calendar\Calendar;
9		use Timegridio\Concierge\Exceptions\DuplicatedAppointmentException;
10		use Timegridio\Concierge\Models\Appointment;
11		use Timegridio\Concierge\Models\Business;
12		use Timegridio\Concierge\Models\Service;
13		use Timegridio\Concierge\Timetable\Strategies\TimetableStrategy;
14		use Timegridio\Concierge\Vacancy\VacancyManager;
15
16		/*******************************************************************************
17		* Concierge Service Layer
18		* High level booking manager
19		******************************************************************************/
20		class Concierge extends Workspace
21		{
22		protected $timetable = null;
23
24		protected $calendar = null;
25
26		protected $booking = null;
27
28		protected $vacancies = null;
29
30		protected $appointment = null;
31
32	6	protected function calendar()
33		{
34	6	if ($this->calendar === null) {
35	6	$this->calendar = new Calendar($this->business->strategy, $this->business->vacancies(), $this->business->timezone);
36	6	}
37
38	6	return $this->calendar;
39		}
40
41	2	public function timetable()
42		{
43	2	if ($this->timetable === null) {
44	2	$this->timetable = new TimetableStrategy($this->business->strategy);
45	2	}
46
47	2	return $this->timetable;
48		}
49
50	1	public function vacancies()
51		{
52	1	if ($this->vacancies === null && $this->business !== null) {
53	1	$this->vacancies = new VacancyManager($this->business);
54	1	}
55
56	1	return $this->vacancies;
57		}
58
59	3	public function booking()
60		{
61	3	if ($this->booking === null && $this->business !== null) {
62	3	$this->booking = new BookingManager($this->business);
63	3	}
64
65	3	return $this->booking;
66		}
67
68	6	public function takeReservation(array $request)
69		{
70	6	$issuer = $request['issuer'];
71	6	$service = $request['service'];
72	6	$contact = $request['contact'];
73	6	$comments = $request['comments'];
74
75	6	$vacancies = $this->calendar()
76	6	->forService($service->id)
77	6	->withDuration($service->duration)
78	6	->forDate($request['date'])
79	6	->atTime($request['time'])
80	6	->find();
81
82	6	if ($vacancies->count() == 0) {
83		// TODO: Log failure feedback message / raise exception
84	2	return false;
85		}
86
87		// DEBUG / INCONSISTENT DB RECORDS CHECK
88		// if ($vacancies->count() > 1) {
89		// // Log unexpected behavior message / raise exception
90		// $vacancy = $vacancies->first();
91		// }
92
93	4	if ($vacancies->count() == 1) {
94	4	$vacancy = $vacancies->first();
95	4	}
96
97	4	$startAt = $this->makeDateTimeUTC($request['date'], $request['time'], $request['timezone']);
98	4	$finishAt = $startAt->copy()->addMinutes($service->duration);
99
100	4	$appointment = $this->generateAppointment(
101	4	$issuer,
102	4	$this->business->id,
103	4	$contact->id,
104	4	$service->id,
105	4	$startAt,
106	4	$finishAt,
107		$comments
108	4	);
109
110		/* Should be moved inside generateAppointment() */
111	4	if ($appointment->duplicates()) {
112
113	2	$this->appointment = $appointment;
114
115	2	throw new DuplicatedAppointmentException($appointment->code);
		0 ignored issues – show Documentation introduced 2016-03-04 01:24 UTC by Report Bug Copy Issue Report The property `code` does not exist on `object<Timegridio\Concierge\Models\Appointment>`. Since you implemented `__get`, maybe consider adding a @property annotation. Since your code implements the magic getter `_get`, this function will be called for any read access on an undefined variable. You can add the `@property` annotation to your class or interface to document the existence of this variable. <?php /** * @property int $x * @property int $y * @property string $text */ class MyLabel { private $properties; private $allowedProperties = array('x', 'y', 'text'); public function __get($name) { if (isset($properties[$name]) && in_array($name, $this->allowedProperties)) { return $properties[$name]; } else { return null; } } public function __set($name, $value) { if (in_array($name, $this->allowedProperties)) { $properties[$name] = $value; } else { throw new \LogicException("Property $name is not defined."); } } } If the property has read access only, you can use the @property-read annotation instead. Of course, you may also just have mistyped another name, in which case you should fix the error. See also the PhpDoc documentation for @property. Loading history...
116		}
117
118		/* Should be moved inside generateAppointment() */
119	4	$appointment->vacancy()->associate($vacancy);
		0 ignored issues – show Bug introduced 2016-02-05 10:34 UTC by Report Bug Copy Issue Report The variable `$vacancy` does not seem to be defined for all execution paths leading up to this point. If you define a variable conditionally, it can happen that it is not defined for all execution paths. Let’s take a look at an example: function myFunction($a) { switch ($a) { case 'foo': $x = 1; break; case 'bar': $x = 2; break; } // $x is potentially undefined here. echo $x; } In the above example, the variable `$x` is defined if you pass “foo” or “bar” as argument for `$a`. However, since the `switch` statement has no default case statement, if you pass any other value, the variable `$x` would be undefined. Available Fixes Check for existence of the variable explicitly: function myFunction($a) { switch ($a) { case 'foo': $x = 1; break; case 'bar': $x = 2; break; } if (isset($x)) { // Make sure it's always set. echo $x; } } Define a default value for the variable: function myFunction($a) { $x = ''; // Set a default which gets overridden for certain paths. switch ($a) { case 'foo': $x = 1; break; case 'bar': $x = 2; break; } echo $x; } Add a value for the missing path: function myFunction($a) { switch ($a) { case 'foo': $x = 1; break; case 'bar': $x = 2; break; // We add support for the missing case. default: $x = ''; break; } echo $x; } Loading history...
120	4	$appointment->save();
121
122	4	return $appointment;
123		}
124
125	4	protected function generateAppointment(
126		$issuerId,
127		$businessId,
128		$contactId,
129		$serviceId,
130		Carbon $startAt,
131		Carbon $finishAt,
132		$comments = null)
133		{
134	4	$appointment = new Appointment();
135
136	4	$appointment->doReserve();
137	4	$appointment->setStartAtAttribute($startAt);
138	4	$appointment->setFinishAtAttribute($finishAt);
139	4	$appointment->business()->associate($businessId);
140	4	$appointment->issuer()->associate($issuerId);
141	4	$appointment->contact()->associate($contactId);
142	4	$appointment->service()->associate($serviceId);
143	4	$appointment->comments = $comments;
		0 ignored issues – show Documentation introduced 2016-02-05 18:46 UTC by Report Bug Copy Issue Report The property `comments` does not exist on `object<Timegridio\Concierge\Models\Appointment>`. Since you implemented `__set`, maybe consider adding a @property annotation. Since your code implements the magic setter `_set`, this function will be called for any write access on an undefined variable. You can add the `@property` annotation to your class or interface to document the existence of this variable. <?php /** * @property int $x * @property int $y * @property string $text */ class MyLabel { private $properties; private $allowedProperties = array('x', 'y', 'text'); public function __get($name) { if (isset($properties[$name]) && in_array($name, $this->allowedProperties)) { return $properties[$name]; } else { return null; } } public function __set($name, $value) { if (in_array($name, $this->allowedProperties)) { $properties[$name] = $value; } else { throw new \LogicException("Property $name is not defined."); } } } Since the property has write access only, you can use the @property-write annotation instead. Of course, you may also just have mistyped another name, in which case you should fix the error. See also the PhpDoc documentation for @property. Loading history...
144	4	$appointment->doHash();
145
146	4	return $appointment;
147		}
148
149		/**
150		* Determine if the Business has any published Vacancies available for booking.
151		*
152		* @return bool
153		*/
154	2	public function isBookable($fromDate = 'today', $days = 7)
155		{
156	2	$timetable = $this->timetable()->buildTimetable($this->business->vacancies, $fromDate, $days);
157
158	2	$timetable = Arr::flatten($timetable);
159
160	2	$sum = array_sum($timetable);
161
162	2	return $sum > 0;
163		}
164
165		//////////////////
166		// FOR REFACTOR //
167		//////////////////
168
169	2	public function getActiveAppointments()
170		{
171	2	return $this->business
172	2	->bookings()->with('contact')
173	2	->with('business')
174	2	->with('service')
175	2	->active()
176	2	->orderBy('start_at')
177	2	->get();
178		}
179
180		public function getUnservedAppointments()
181		{
182		return $this->business
183		->bookings()->with('contact')
184		->with('business')
185		->with('service')
186		->unserved()
187		->orderBy('start_at')
188		->get();
189		}
190
191	4	protected function makeDateTime($date, $time, $timezone = null)
192		{
193	4	return Carbon::parse("{$date} {$time} {$timezone}");
194		}
195
196	4	protected function makeDateTimeUTC($date, $time, $timezone = null)
197		{
198	4	return $this->makeDateTime($date, $time, $timezone)->timezone('UTC');
199		}
200
201		public function appointment()
202		{
203		return $this->appointment;
204		}
205		}
206

timegridio / concierge

Push — master ( 894ab0...03c043 )

Concierge::takeReservation() A

Complexity

Size

Duplication

Code Coverage

Importance

How to fix Long Method

Long Method

Available Fixes

Duplication Side-by-Side

Filter issues like