App\Http\Controllers\JobController

Complexity

Total Complexity

53

Size/Duplication

Total Lines	623
Duplicated Lines	0 %

Test Coverage

Coverage

71.07%

Importance

Changes

0

14 Methods

Rating	Name	Duplication	Size	Complexity
A	index()	0	23	1
A	managerIndex()	0	13	1
A	submitForReview()	0	21	2
A	destroy()	0	3	1
B	show()	0	77	8
A	fillAndSaveJobPosterTasks()	0	24	5
A	populateDefaultQuestions()	0	30	3
A	createAsManager()	0	38	3
B	populateCreateView()	0	102	6
A	fillAndSaveJobPosterQuestions()	0	26	5
A	create()	0	3	1
A	fillAndSaveJobPoster()	0	37	2
A	store()	0	29	4
B	fillAndSaveJobPosterCriteria()	0	40	10

<?php

namespace App\Http\Controllers;

use Illuminate\Support\Facades\Lang;
use Illuminate\Support\Facades\Auth;
use Illuminate\Support\Facades\Log;
use Illuminate\Support\Facades\Mail;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\Http\Response;
use Illuminate\View\View;
use App\Http\Controllers\Controller;

use Carbon\Carbon;

use App\Mail\JobPosterReviewRequested;

use App\Exceptions\AdminException;

use App\Models\Criteria;
use App\Models\JobPoster;
use App\Models\JobPosterKeyTask;
use App\Models\JobPosterQuestion;
use App\Models\Lookup\JobTerm;
use App\Models\Lookup\Province;
use App\Models\Lookup\SecurityClearance;
use App\Models\Lookup\LanguageRequirement;
use App\Models\Lookup\Department;
use App\Models\Lookup\SkillLevel;
use App\Models\Lookup\CriteriaType;
use App\Models\Skill;
use App\Models\Manager;

use App\Services\Validation\JobPosterValidator;
use Jenssegers\Date\Date;

class JobController extends Controller
{
    /**
     * Display a listing of JobPosters.
     *
     * @return \Illuminate\View\View|\Illuminate\Contracts\View\Factory
     */
    public function index()
    {
        $now = Carbon::now();

        // Find published jobs that are currently open for applications.
        // Eager load required relationships: Department, Province, JobTerm.
        // Eager load the count of submitted applications, to prevent the relationship
        // from being actually loaded and firing off events.
        $jobs = JobPoster::where('open_date_time', '<=', $now)
            ->where('close_date_time', '>=', $now)
            ->where('published', true)
            ->with([
                'department',
                'province',
                'job_term',
            ])
            ->withCount([
                'submitted_applications',
            ])
            ->get();
        return view('applicant/job_index', [
            'job_index' => Lang::get('applicant/job_index'),
            'jobs' => $jobs
        ]);
    }

    /**
     * Display a listing of a manager's JobPosters.
     *
     * @return \Illuminate\View\View|\Illuminate\Contracts\View\Factory
     */
    public function managerIndex()
    {
        $manager = Auth::user()->manager;

Accessing manager on the interface Illuminate\Contracts\Auth\Authenticatable suggest that you code against a concrete implementation. How about adding an instanceof check?

        $jobs = JobPoster::where('manager_id', $manager->id)
            ->withCount('submitted_applications')
            ->get();

        return view('manager/job_index', [
            /*Localization Strings*/
            'jobs_l10n' => Lang::get('manager/job_index'),

            /* Data */
            'jobs' => $jobs,
        ]);
    }

    /**
     * Submit the Job Poster for review.
     *
     * @param \Illuminate\Http\Request $request   Incoming request object.
     * @param \App\Models\JobPoster    $jobPoster Job Poster object.
     *
     * @return \Illuminate\View\View|\Illuminate\Contracts\View\Factory
     */
    public function submitForReview(Request $request, JobPoster $jobPoster)
    {
        // Update review request timestamp
        $jobPoster->review_requested_at = new Date();
        $jobPoster->save();

        // Refresh model instance with updated DB values.
        $jobPoster = JobPoster::withCount('submitted_applications')->where('id', $jobPoster->id)->first();

        // Send email
        $reviewer_email = config('mail.reviewer_email');
        if (isset($reviewer_email)) {
            Mail::to($reviewer_email)->send(new JobPosterReviewRequested($jobPoster, Auth::user()));

It seems like Illuminate\Support\Facades\Auth::user() can also be of type null; however, parameter $manager of App\Mail\JobPosterReviewRequested::__construct() does only seem to accept App\Models\User, maybe add an additional type check?

        } else {
            Log::error('The reviewer email environment variable is not set.');
        }

        return view('manager/job_index/job', [
            /*Localization Strings*/
            'jobs_l10n' => Lang::get('manager/job_index'),
            'job' => $jobPoster
        ]);
    }

    /**
     * Delete a draft Job Poster.
     *
     * @param \Illuminate\Http\Request $request   Incoming request object.
     * @param \App\Models\JobPoster    $jobPoster Job Poster object.
     *
     * @return void
     */
    public function destroy(Request $request, JobPoster $jobPoster) : void
    {
        $jobPoster->delete();
    }

    /**
     * Display the specified job poster.
     *
     * @param \Illuminate\Http\Request $request   Incoming request object.
     * @param \App\Models\JobPoster    $jobPoster Job Poster object.
     *
     * @return \Illuminate\View\View|\Illuminate\Contracts\View\Factory
     */
    public function show(Request $request, JobPoster $jobPoster)
    {
        $jobPoster->load([
            'department',
            'criteria.skill.skill_type',
            'manager.team_culture',
            'manager.work_environment'
        ]);

        $user = Auth::user();

The assignment to $user is dead and can be removed.

        //TODO: Improve workplace photos, and reference them in template direction from WorkEnvironment model
        $workplacePhotos = [];
        foreach ($jobPoster->manager->work_environment->workplace_photo_captions as $photoCaption) {
            $workplacePhotos[] = [
                'description' => $photoCaption->description,
                'url' => '/images/user.png'
            ];
        }

        //TODO: replace route('manager.show',manager.id) in templates with link using slug

        $criteria = [
            'essential' => $jobPoster->criteria->filter(
                function ($value, $key) {
                    return $value->criteria_type->name == 'essential';
                }
            ),
            'asset' => $jobPoster->criteria->filter(
                function ($value, $key) {
                    return $value->criteria_type->name == 'asset';
                }
            ),
        ];

        $jobLang = Lang::get('applicant/job_post');

        $applyButton = [];
        if (!$jobPoster->published && $this->authorize('update', $jobPoster)) {
            $applyButton = [
                'href' => route('manager.jobs.edit', $jobPoster->id),
                'title' => $jobLang['apply']['edit_link_title'],
                'text' => $jobLang['apply']['edit_link_label'],
            ];
        } elseif (Auth::check() && $jobPoster->isOpen()) {
            $applyButton = [
                'href' => route('job.application.edit.1', $jobPoster->id),
                'title' => $jobLang['apply']['apply_link_title'],
                'text' => $jobLang['apply']['apply_link_label'],
            ];
        } elseif (Auth::guest() && $jobPoster->isOpen()) {
            $applyButton = [
                'href' => route('job.application.edit.1', $jobPoster->id),
                'title' => $jobLang['apply']['login_link_title'],
                'text' => $jobLang['apply']['login_link_label'],
            ];
        } else {
            $applyButton = [
                'href' => null,
                'title' => null,
                'text' => $jobLang['apply']['job_closed_label'],
            ];
        }

        return view(
            'applicant/job_post',
            [
                'job_post' => $jobLang,
                'manager' => $jobPoster->manager,
                'manager_profile_photo_url' => '/images/user.png', //TODO get real photo
                'team_culture' => $jobPoster->manager->team_culture,
                'work_environment' => $jobPoster->manager->work_environment,
                'workplace_photos' => $workplacePhotos,
                'job' => $jobPoster,
                'criteria' => $criteria,
                'apply_button' => $applyButton,
                'skill_template' => Lang::get('common/skills'),
            ]
        );
    }

    /**
     * Create a blank job poster for the specified manager
     *
     * @param Manager $manager

Missing parameter comment

     * @return \Illuminate\View\View|\Illuminate\Contracts\View\Factory Job Create view
     */

Missing @throws tag in function comment

    public function createAsManager(Manager $manager)
    {
        $jobPoster = new JobPoster();
        $jobPoster->manager_id = $manager->id;
        $managerEn = $manager->translate('en');
        $managerFr = $manager->translate('fr');

        try {
            $jobPoster->fill([
                'department_id' => $manager->department_id,
                'en' => [
                    'branch' => $managerEn->branch,
                    'division' => $managerEn->division,
                ],
                'fr' => [
                    'branch' => $managerFr->branch,
                    'division' => $managerFr->division,
                ]
            ]);
            $jobPoster->save();
        } catch (\Exception $e) {
            throw new AdminException(
                'Manager missing the following required fields: Department, Branch and Division.',
                500,
                null,
                [
                    'Back to Admin' => '/admin',
                    'Manager Profile' => "/manager/profile/$manager->id/edit"
                ]
            );
        }

        $defaultQuestions = $this->populateDefaultQuestions();
        if (!empty($defaultQuestions)) {
            $jobPoster->job_poster_questions()->saveMany($defaultQuestions);
        }

        return redirect()->route('manager.jobs.edit', $jobPoster->id);

The expression return redirect()->route('manager.jobs.edit', $jobPoster->id) returns the type Illuminate\Http\RedirectResponse which is incompatible with the documented return type Illuminate\Contracts\View\Factory|Illuminate\View\View.

    }

    /**
     * Display the form for creating a new Job Poster
     *
     * @param \Illuminate\Http\Request $request Incoming request object.
     *
     * @return \Illuminate\View\View|\Illuminate\Contracts\View\Factory Job Create view
     */
    public function create(Request $request)
    {
        return $this->populateCreateView($request);
    }

    /**
     * Display the form for editing an existing Job Poster
     *
     * @param \Illuminate\Http\Request $request   Incoming request object.
     * @param \App\Models\JobPoster    $jobPoster Job Poster object.
     *
     * @return \Illuminate\View\View|\Illuminate\Contracts\View\Factory Job Create view
     */
    public function edit(Request $request, JobPoster $jobPoster)
    {
        return $this->populateCreateView($request, $jobPoster);
    }

    /**
     * Get the manager from the request object and check if creating or editing
     *
     * @param \Illuminate\Http\Request $request   Incoming request object.
     * @param \App\Models\JobPoster    $jobPoster Optional Job Poster object.
     *
     * @return \Illuminate\View\View|\Illuminate\Contracts\View\Factory Job Create view
     */
    public function populateCreateView(Request $request, JobPoster $jobPoster = null)
    {
        if ($jobPoster == null || $jobPoster->manager == null) {
            $manager = $request->user() ? $request->user()->manager : null;
        } else {
            $manager = $jobPoster->manager;
        }

        if (isset($jobPoster)) {
            $job = $jobPoster;
            $route = ['manager.jobs.update', $jobPoster];
            $jobHeading = 'manager/job_edit';
        } else {
            $job = [];
            $defaultQuestions = $this->populateDefaultQuestions();
            if (!empty($defaultQuestions)) {
                $job['job_poster_questions'] = $defaultQuestions;
            }
            $route = ['manager.jobs.store'];
            $jobHeading = 'manager/job_create';
        }

        $skillLangs = Lang::get('common/skills');

        $softSkills = Skill::whereHas(
            'skill_type',
            function ($query) : void {
                $query->where('name', '=', 'soft');
            }
        )->get()
            ->mapWithKeys(
                function ($skill) {
                    return [
                        $skill->id => $skill->name
                    ];
                }
            )
            ->all();

        $hardSkills = Skill::whereHas(
            'skill_type',
            function ($query) : void {
                $query->where('name', '=', 'hard');
            }
        )->get()
            ->mapWithKeys(
                function ($skill) {
                    return [
                        $skill->id => $skill->name
                    ];
                }
            )
            ->all();

        asort($softSkills, SORT_LOCALE_STRING);
        asort($hardSkills, SORT_LOCALE_STRING);

        $skills = [
            'essential' => [
                'hard' => $hardSkills,
                'soft' => $softSkills
            ],
            'asset' => [
                'hard' => $hardSkills,
                'soft' => $softSkills
            ]
        ];

        $skillLevelCollection = SkillLevel::all();

        $skillLevels = array();

        $skillLevels['hard'] = $skillLevelCollection->mapWithKeys(
            function ($skillLevel) use ($skillLangs) {
                return [$skillLevel->id => $skillLangs['skill_levels']['hard'][$skillLevel->name]];
            }
        )->all();

        $skillLevels['soft'] = $skillLevelCollection->mapWithKeys(
            function ($skillLevel) use ($skillLangs) {
                return [$skillLevel->id => $skillLangs['skill_levels']['soft'][$skillLevel->name]];
            }
        )->all();

        return view(
            'manager/job_create',
            [
                /*Localization Strings*/
                'job_l10n' => Lang::get('manager/job_create'),

                /* Data */
                'job' => Lang::get($jobHeading),
                'manager' => $manager,
                'provinces' => Province::all(),
                'departments' => Department::all(),
                'language_requirments' => LanguageRequirement::all(),
                'security_clearances' => SecurityClearance::all(),
                'job' => $job,
                'form_action_url' => route(/** @scrutinizer ignore-type */ ...$route), // phpcs:ignore

$route is expanded, but the parameter $name of route() does not expect variable arguments.

                'skills' => $skills,
                'skill_levels' => $skillLevels,
                'skill_template' => $skillLangs,
            ]
        );
    }

    /**
     * Create a new resource in storage
     *
     * @param \Illuminate\Http\Request $request   Incoming request object.
     * @param \App\Models\JobPoster    $jobPoster Optional Job Poster object.
     *
     * @return \Illuminate\Routing\Redirector|\Illuminate\Http\RedirectResponse A redirect to the Job Index
     */
    public function store(Request $request, JobPoster $jobPoster = null)
    {
        // Don't allow edits for published Job Posters
        // Also check auth while we're at it
        if (isset($jobPoster)) {
            $this->authorize('update', $jobPoster);
            JobPosterValidator::validateUnpublished($jobPoster);
        } else {
            $this->authorize('create', JobPoster::class);
        }

        $input = $request->input();

        $job = (isset($jobPoster) ? $jobPoster : new JobPoster());

        if ($job->manager_id == null) {
            $job->manager_id = $request->user()->manager->id;
            $job->save();
        }

        $this->fillAndSaveJobPoster($input, $job);

        $this->fillAndSaveJobPosterTasks($input, $job, isset($jobPoster));

        $this->fillAndSaveJobPosterQuestions($input, $job, isset($jobPoster));

        $this->fillAndSaveJobPosterCriteria($input, $job, isset($jobPoster));

        return redirect(route('manager.jobs.show', $job->id));
    }

    /**
     * Fill Job Poster model's properties and save
     *
     * @param mixed[]               $input     Field values.
     * @param \App\Models\JobPoster $jobPoster Job Poster object.
     *
     * @return void
     */
    protected function fillAndSaveJobPoster(array $input, JobPoster $jobPoster) : void
    {
        $jobPoster->fill(
            [
                'job_term_id' => JobTerm::where('name', 'month')->firstOrFail()->id,
                'term_qty' => $input['term_qty'],
                'open_date_time' => ptDayStartToUtcTime($input['open_date']),
                'close_date_time' => ptDayEndToUtcTime($input['close_date']),
                'start_date_time' => ptDayStartToUtcTime($input['start_date']),
                'department_id' => $input['department'],
                'province_id' => $input['province'],
                'salary_min' => $input['salary_min'],
                'salary_max' => $input['salary_max'],
                'noc' => $input['noc'],
                'classification' => $input['classification'],
                'security_clearance_id' => $input['security_clearance'],
                'language_requirement_id' => $input['language_requirement'],
                'remote_work_allowed' => (isset($input['remote_work_allowed']) ? $input['remote_work_allowed'] : false),
                'en' => [
                    'city' => $input['city'],
                    'title' => $input['title']['en'],
                    'impact' => $input['impact']['en'],
                    'branch' => $input['branch']['en'],
                    'division' => $input['division']['en'],
                    'education' => $input['education']['en'],
                ],
                'fr' => [
                    'city' => $input['city'],
                    'title' => $input['title']['fr'],
                    'impact' => $input['impact']['fr'],
                    'branch' => $input['branch']['fr'],
                    'division' => $input['division']['fr'],
                    'education' => $input['education']['fr'],
                ],
            ]
        );
        $jobPoster->save();
    }

    /**
     * Fill Job Poster's tasks and save
     *
     * @param mixed[]               $input     Field values.
     * @param \App\Models\JobPoster $jobPoster Job Poster object.
     * @param boolean               $replace   Remove existing relationships.
     *
     * @return void
     */
    protected function fillAndSaveJobPosterTasks(array $input, JobPoster $jobPoster, bool $replace) : void
    {
        if ($replace) {
            $jobPoster->job_poster_key_tasks()->delete();
        }

        if (!array_key_exists('task', $input) || !is_array($input['task'])) {
            return;
        }

        foreach ($input['task'] as $task) {
            $jobPosterTask = new JobPosterKeyTask();
            $jobPosterTask->job_poster_id = $jobPoster->id;
            $jobPosterTask->fill(
                [
                    'en' => [
                        'description' => $task['en']
                    ],
                    'fr' => [
                        'description' => $task['fr']
                    ]
                ]
            );
            $jobPosterTask->save();
        }
    }

    /**
     * Fill Job Poster's questions and save
     *
     * @param mixed[]               $input     Field values.
     * @param \App\Models\JobPoster $jobPoster Job Poster object.
     * @param boolean               $replace   Remove existing relationships.
     *
     * @return void
     */
    protected function fillAndSaveJobPosterQuestions(array $input, JobPoster $jobPoster, bool $replace) : void
    {
        if ($replace) {
            $jobPoster->job_poster_questions()->delete();
        }

        if (!array_key_exists('question', $input) || !is_array($input['question'])) {
            return;
        }

        foreach ($input['question'] as $question) {
            $jobQuestion = new JobPosterQuestion();
            $jobQuestion->job_poster_id = $jobPoster->id;
            $jobQuestion->fill(
                [
                    'en' => [
                        'question' => $question['question']['en'],
                        'description' => $question['description']['en']
                    ],
                    'fr' => [
                        'question' => $question['question']['fr'],
                        'description' => $question['description']['fr']
                    ]
                ]
            );
            $jobQuestion->save();
        }
    }

    /**
     * Fill Job Poster's criteria and save
     *
     * @param mixed[]               $input     Field values.
     * @param \App\Models\JobPoster $jobPoster Job Poster object.
     * @param boolean               $replace   Remove existing relationships.
     *
     * @return void
     */
    protected function fillAndSaveJobPosterCriteria(array $input, JobPoster $jobPoster, bool $replace) : void
    {
        if ($replace) {
            $jobPoster->criteria()->delete();
        }

        if (!array_key_exists('criteria', $input) || !is_array($input['criteria'])) {
            return;
        }

        $criteria = $input['criteria'];

        $combinedCriteria = [];
        if (isset($criteria['old'])) {
            $combinedCriteria = array_replace_recursive($combinedCriteria, $criteria['old']);
        }
        if (isset($criteria['new'])) {
            $combinedCriteria = array_replace_recursive($combinedCriteria, $criteria['new']);
        }

        if (! empty($combinedCriteria)) {
            foreach ($combinedCriteria as $criteriaType => $criteriaTypeInput) {
                foreach ($criteriaTypeInput as $skillType => $skillTypeInput) {
                    foreach ($skillTypeInput as $criteriaInput) {
                        $criteria = new Criteria();
                        $criteria->job_poster_id = $jobPoster->id;
                        $criteria->fill(
                            [
                                'criteria_type_id' => CriteriaType::where('name', $criteriaType)->firstOrFail()->id,
                                'skill_id' => $criteriaInput['skill_id'],
                                'skill_level_id' => $criteriaInput['skill_level_id'],
                                'en' => [
                                    'description' => $criteriaInput['description']['en'],
                                ],
                                'fr' => [
                                    'description' => $criteriaInput['description']['fr'],
                                ],
                            ]
                        );
                        $criteria->save();
                    }
                }
            }
        }
    }

    /**
     * Get the localized default questions and add them to an array.
     *
     * @return mixed[]|void
     */
    protected function populateDefaultQuestions()
    {
        $defaultQuestions = [
            'en' => array_values(Lang::get('manager/job_create', [], 'en')['questions']),
            'fr' => array_values(Lang::get('manager/job_create', [], 'fr')['questions']),
        ];

        if (count($defaultQuestions['en']) !== count($defaultQuestions['fr'])) {
            Log::warning('There must be the same number of French and English default questions for a Job Poster.');
            return;
        }

        $jobQuestions = [];

        for ($i = 0; $i < count($defaultQuestions['en']); $i++) {

It seems like you are calling the size function count() as part of the test condition. You might want to compute the size beforehand, and not on each iteration.

            $jobQuestion = new JobPosterQuestion();
            $jobQuestion->fill(
                [
                    'en' => [
                        'question' => $defaultQuestions['en'][$i],
                    ],
                    'fr' => [
                        'question' => $defaultQuestions['fr'][$i],
                    ]
                ]
            );
            $jobQuestions[] = $jobQuestion;
        }

        return $jobQuestions;
    }
}