osb/app/Http/Controllers/HomeController.php

<?php

namespace App\Http\Controllers;

use Clarkeash\Doorman\Exceptions\{DoormanException,ExpiredInviteCode};
use Clarkeash\Doorman\Facades\Doorman;
use Illuminate\Contracts\View\Factory;
use Illuminate\Support\Facades\Auth;
use Illuminate\Support\Facades\Log;
use Illuminate\View\View;

use App\Models\{Invoice,Service,User};

/**
 * Class HomeController
 * This controller is the logged in users home page
 *
 * The methods to this controller should be projected by the route
 *
 * @package App\Http\Controllers
 */
class HomeController extends Controller
{
	/**
	 * Logged in users home page
	 *
	 * @return Factory|View
	 */
	public function home(User $o): View
	{
		if (! $o->exists)
			$o = Auth::user();

		$o->load(['services.invoice_items','services.type']);

		return View('u.home',['o'=>$o]);
	}

	/**
	 * Enable the user to down an invoice by providing a link in email
	 *
	 * @param Invoice $o
	 * @param string  $code
	 * @return \Illuminate\Http\RedirectResponse|mixed
	 */
	public function invoice_pdf_email(Invoice $o,string $code)
	{
		try {
			Doorman::redeem($code,$o->account->user->email);

		} catch (ExpiredInviteCode $e) {
			Log::alert(sprintf('User is using an expired token for invoice [%s] using [%s]',$o->id,$code));

			return redirect()->to('/login');

		} catch (DoormanException $e) {
			Log::alert(sprintf('An attempt to read invoice id [%s] using [%s]',$o->id,$code));

			abort(404);
		}

		return $this->invoice($o);
	}

	/**
	 * Return details on the users service
	 *
	 * @param Service $o
	 * @return View
	 */
	public function service(Service $o): View
	{
		$breadcrumb = collect();
		$breadcrumb->put($o->account->user->full_name,url('u/home',$o->account->user_id));

		return View('u.service.home')
				->with('breadcrumb',$breadcrumb)
				->with('o',$o);
	}

	/**
	 * Progress the order to the next stage
	 *
	 * @note: Route Middleware protects this path
	 * @param Service $o
	 * @param string  $status
	 * @return \Illuminate\Http\RedirectResponse
	 * @deprecated
	 */
	public function service_progress(Service $o,string $status)
	{
		return redirect()->to($o->action($status) ?: url('u/service',$o->id));
	}
}