格式化代码

app/Console/Kernel.php

@@ -22,6 +22,7 @@ class Kernel extends ConsoleKernel
      * Define the application's command schedule.
      *
      * @param Schedule $schedule
+     *
      * @return void
      */
     protected function schedule(Schedule $schedule): void

app/Exceptions/Handler.php

@@ -69,6 +69,7 @@ public function register(): void
      *
      * @param Request                 $request
      * @param AuthenticationException $exception
+     *
      * @return JsonResponse|RedirectResponse
      */
     protected function unauthenticated($request, AuthenticationException $exception): JsonResponse|RedirectResponse

app/Helpers/Auth/AuthenticatesUsers.php

@@ -29,6 +29,7 @@ public function showLoginForm(): View
      * Handle a login request to the application.
      *
      * @param Request $request
+     *
      * @return Response
      *
      * @throws ValidationException
@@ -67,6 +68,7 @@ public function login(Request $request): Response
      * Validate the user login request.
      *
      * @param Request $request
+     *
      * @return void
      *
      * @throws ValidationException
@@ -79,10 +81,21 @@ protected function validateLogin(Request $request): void
         ]);
     }
 
+    /**
+     * Get the login username to be used by the controller.
+     *
+     * @return string
+     */
+    public function username(): string
+    {
+        return 'email';
+    }
+
     /**
      * Attempt to log the user into the application.
      *
      * @param Request $request
+     *
      * @return bool
      */
     protected function attemptLogin(Request $request): bool
@@ -92,10 +105,21 @@ protected function attemptLogin(Request $request): bool
         );
     }
 
+    /**
+     * Get the guard to be used during authentication.
+     *
+     * @return StatefulGuard
+     */
+    protected function guard(): StatefulGuard
+    {
+        return Auth::guard();
+    }
+
     /**
      * Get the needed authorization credentials from the request.
      *
      * @param Request $request
+     *
      * @return array
      */
     protected function credentials(Request $request): array
@@ -107,6 +131,7 @@ protected function credentials(Request $request): array
      * Send the response after the user was authenticated.
      *
      * @param Request $request
+     *
      * @return JsonResponse|RedirectResponse
      */
     protected function sendLoginResponse(Request $request): JsonResponse|RedirectResponse
@@ -124,18 +149,6 @@ protected function sendLoginResponse(Request $request): JsonResponse|RedirectRes
             : redirect()->intended($this->redirectPath());
     }
 
-    /**
-     * The user has been authenticated.
-     *
-     * @param  Request  $request
-     * @param  mixed  $user
-     * @return void
-     */
-    protected function authenticated(Request $request, mixed $user): void
-    {
-        //
-    }
-
     /**
      * Get the failed login response instance.
      *
@@ -151,20 +164,11 @@ protected function sendFailedLoginResponse(): Response
         ]);
     }
 
-    /**
-     * Get the login username to be used by the controller.
-     *
-     * @return string
-     */
-    public function username(): string
-    {
-        return 'email';
-    }
-
     /**
      * Log the user out of the application.
      *
      * @param Request $request
+     *
      * @return RedirectResponse|JsonResponse
      */
     public function logout(Request $request): JsonResponse|RedirectResponse
@@ -184,24 +188,28 @@ public function logout(Request $request): JsonResponse|RedirectResponse
             : redirect('/');
     }
 
+    /**
+     * The user has been authenticated.
+     *
+     * @param Request $request
+     * @param mixed   $user
+     *
+     * @return void
+     */
+    protected function authenticated(Request $request, mixed $user): void
+    {
+        //
+    }
+
     /**
      * The user has logged out of the application.
      *
      * @param Request $request
+     *
      * @return void
      */
     protected function loggedOut(Request $request): void
     {
         //
     }
-
-    /**
-     * Get the guard to be used during authentication.
-     *
-     * @return StatefulGuard
-     */
-    protected function guard(): StatefulGuard
-    {
-        return Auth::guard();
-    }
 }

app/Helpers/Auth/ConfirmsPasswords.php

@@ -25,6 +25,7 @@ public function showConfirmForm(): View
      * Confirm the given user's password.
      *
      * @param Request $request
+     *
      * @return RedirectResponse|JsonResponse
      */
     public function confirm(Request $request): JsonResponse|RedirectResponse
@@ -38,17 +39,6 @@ public function confirm(Request $request): JsonResponse|RedirectResponse
             : redirect()->intended($this->redirectPath());
     }
 
-    /**
-     * Reset the password confirmation timeout.
-     *
-     * @param  Request  $request
-     * @return void
-     */
-    protected function resetPasswordConfirmationTimeout(Request $request): void
-    {
-        $request->session()->put('auth.password_confirmed_at', time());
-    }
-
     /**
      * Get the password confirmation validation rules.
      *
@@ -70,4 +60,16 @@ protected function validationErrorMessages(): array
     {
         return [];
     }
+
+    /**
+     * Reset the password confirmation timeout.
+     *
+     * @param Request $request
+     *
+     * @return void
+     */
+    protected function resetPasswordConfirmationTimeout(Request $request): void
+    {
+        $request->session()->put('auth.password_confirmed_at', time());
+    }
 }

app/Helpers/Auth/RegistersUsers.php

@@ -28,6 +28,7 @@ public function showRegistrationForm(): View
      * Handle a registration request for the application.
      *
      * @param Request $request
+     *
      * @return RedirectResponse|JsonResponse
      */
     public function register(Request $request): JsonResponse|RedirectResponse
@@ -62,6 +63,7 @@ protected function guard(): StatefulGuard
      *
      * @param Request $request
      * @param mixed   $user
+     *
      * @return void
      */
     protected function registered(Request $request, mixed $user): void

app/Helpers/Auth/ResetsPasswords.php

@@ -29,6 +29,7 @@ trait ResetsPasswords
      * If no token is present, display the link request form.
      *
      * @param Request $request
+     *
      * @return Factory|View
      */
     public function showResetForm(Request $request): Factory|View
@@ -44,6 +45,7 @@ public function showResetForm(Request $request): Factory|View
      * Reset the given user's password.
      *
      * @param Request $request
+     *
      * @return RedirectResponse|JsonResponse
      */
     public function reset(Request $request): JsonResponse|RedirectResponse
@@ -96,10 +98,21 @@ protected function validationErrorMessages(): array
         return [];
     }
 
+    /**
+     * Get the broker to be used during password reset.
+     *
+     * @return PasswordBroker
+     */
+    public function broker(): PasswordBroker
+    {
+        return Password::broker();
+    }
+
     /**
      * Get the password reset credentials from the request.
      *
      * @param Request $request
+     *
      * @return array
      */
     protected function credentials(Request $request): array
@@ -114,6 +127,7 @@ protected function credentials(Request $request): array
      *
      * @param CanResetPassword|User $user
      * @param string                $password
+     *
      * @return void
      */
     protected function resetPassword(CanResetPassword|User $user, string $password): void
@@ -134,6 +148,7 @@ protected function resetPassword(CanResetPassword|User $user, string $password):
      *
      * @param CanResetPassword $user
      * @param string           $password
+     *
      * @return void
      */
     protected function setUserPassword(CanResetPassword $user, string $password): void
@@ -144,11 +159,22 @@ protected function setUserPassword(CanResetPassword $user, string $password): vo
         }
     }
 
+    /**
+     * Get the guard to be used during password reset.
+     *
+     * @return StatefulGuard
+     */
+    protected function guard(): StatefulGuard
+    {
+        return Auth::guard();
+    }
+
     /**
      * Get the response for a successful password reset.
      *
      * @param Request $request
      * @param string  $response
+     *
      * @return RedirectResponse|JsonResponse
      */
     protected function sendResetResponse(Request $request, string $response): JsonResponse|RedirectResponse
@@ -166,6 +192,7 @@ protected function sendResetResponse(Request $request, string $response): JsonRe
      *
      * @param Request $request
      * @param string  $response
+     *
      * @return RedirectResponse
      */
     protected function sendResetFailedResponse(Request $request, string $response): RedirectResponse
@@ -180,24 +207,4 @@ protected function sendResetFailedResponse(Request $request, string $response):
             ->withInput($request->only('email'))
             ->withErrors(['email' => trans($response)]);
     }
-
-    /**
-     * Get the broker to be used during password reset.
-     *
-     * @return PasswordBroker
-     */
-    public function broker(): PasswordBroker
-    {
-        return Password::broker();
-    }
-
-    /**
-     * Get the guard to be used during password reset.
-     *
-     * @return StatefulGuard
-     */
-    protected function guard(): StatefulGuard
-    {
-        return Auth::guard();
-    }
 }

app/Helpers/Auth/SendsPasswordResetEmails.php

@@ -26,6 +26,7 @@ public function showLinkRequestForm(): View
      * Send a reset link to the given user.
      *
      * @param Request $request
+     *
      * @return RedirectResponse|JsonResponse
      */
     public function sendResetLinkEmail(Request $request): JsonResponse|RedirectResponse
@@ -48,6 +49,7 @@ public function sendResetLinkEmail(Request $request): JsonResponse|RedirectRespo
      * Validate the email for the given request.
      *
      * @param Request $request
+     *
      * @return void
      */
     protected function validateEmail(Request $request): void
@@ -55,10 +57,21 @@ protected function validateEmail(Request $request): void
         $request->validate(['email' => 'required|email']);
     }
 
+    /**
+     * Get the broker to be used during password reset.
+     *
+     * @return PasswordBroker
+     */
+    public function broker(): PasswordBroker
+    {
+        return Password::broker();
+    }
+
     /**
      * Get the needed authentication credentials from the request.
      *
      * @param Request $request
+     *
      * @return array
      */
     protected function credentials(Request $request): array
@@ -71,6 +84,7 @@ protected function credentials(Request $request): array
      *
      * @param Request $request
      * @param string  $response
+     *
      * @return RedirectResponse|JsonResponse
      */
     protected function sendResetLinkResponse(Request $request, string $response): JsonResponse|RedirectResponse
@@ -85,6 +99,7 @@ protected function sendResetLinkResponse(Request $request, string $response): Js
      *
      * @param Request $request
      * @param string  $response
+     *
      * @return RedirectResponse
      *
      * @throws ValidationException
@@ -101,14 +116,4 @@ protected function sendResetLinkFailedResponse(Request $request, string $respons
             ->withInput($request->only('email'))
             ->withErrors(['email' => trans($response)]);
     }
-
-    /**
-     * Get the broker to be used during password reset.
-     *
-     * @return PasswordBroker
-     */
-    public function broker(): PasswordBroker
-    {
-        return Password::broker();
-    }
 }

app/Helpers/Auth/ThrottlesLogins.php

@@ -15,6 +15,7 @@ trait ThrottlesLogins
      * Determine if the user has too many failed login attempts.
      *
      * @param Request $request
+     *
      * @return bool
      */
     protected function hasTooManyLoginAttempts(Request $request): bool
@@ -24,10 +25,43 @@ protected function hasTooManyLoginAttempts(Request $request): bool
         );
     }
 
+    /**
+     * Get the rate limiter instance.
+     *
+     * @return RateLimiter
+     */
+    protected function limiter(): RateLimiter
+    {
+        return app(RateLimiter::class);
+    }
+
+    /**
+     * Get the throttle key for the given request.
+     *
+     * @param Request $request
+     *
+     * @return string
+     */
+    protected function throttleKey(Request $request): string
+    {
+        return Str::transliterate(Str::lower($request->input($this->username())) . '|' . $request->ip());
+    }
+
+    /**
+     * Get the maximum number of attempts to allow.
+     *
+     * @return int
+     */
+    public function maxAttempts(): int
+    {
+        return property_exists($this, 'maxAttempts') ? $this->maxAttempts : 5;
+    }
+
     /**
      * Increment the login attempts for the user.
      *
      * @param Request $request
+     *
      * @return void
      */
     protected function incrementLoginAttempts(Request $request): void
@@ -37,10 +71,21 @@ protected function incrementLoginAttempts(Request $request): void
         );
     }
 
+    /**
+     * Get the number of minutes to throttle for.
+     *
+     * @return int
+     */
+    public function decayMinutes(): int
+    {
+        return property_exists($this, 'decayMinutes') ? $this->decayMinutes : 1;
+    }
+
     /**
      * Redirect the user after determining they are locked out.
      *
      * @param Request $request
+     *
      * @return ResponseAlias
      *
      * @throws ValidationException
@@ -63,6 +108,7 @@ protected function sendLockoutResponse(Request $request): ResponseAlias
      * Clear the login locks for the given user credentials.
      *
      * @param Request $request
+     *
      * @return void
      */
     protected function clearLoginAttempts(Request $request): void
@@ -74,51 +120,11 @@ protected function clearLoginAttempts(Request $request): void
      * Fire an event when a lockout occurs.
      *
      * @param Request $request
+     *
      * @return void
      */
     protected function fireLockoutEvent(Request $request): void
     {
         event(new Lockout($request));
     }
-
-    /**
-     * Get the throttle key for the given request.
-     *
-     * @param  Request  $request
-     * @return string
-     */
-    protected function throttleKey(Request $request): string
-    {
-        return Str::transliterate(Str::lower($request->input($this->username())).'|'.$request->ip());
-    }
-
-    /**
-     * Get the rate limiter instance.
-     *
-     * @return RateLimiter
-     */
-    protected function limiter(): RateLimiter
-    {
-        return app(RateLimiter::class);
-    }
-
-    /**
-     * Get the maximum number of attempts to allow.
-     *
-     * @return int
-     */
-    public function maxAttempts(): int
-    {
-        return property_exists($this, 'maxAttempts') ? $this->maxAttempts : 5;
-    }
-
-    /**
-     * Get the number of minutes to throttle for.
-     *
-     * @return int
-     */
-    public function decayMinutes(): int
-    {
-        return property_exists($this, 'decayMinutes') ? $this->decayMinutes : 1;
-    }
 }

app/Helpers/Auth/VerifiesEmails.php

@@ -17,6 +17,7 @@ trait VerifiesEmails
      * Show the email verification notice.
      *
      * @param Request $request
+     *
      * @return RedirectResponse|View
      */
     public function show(Request $request): View|RedirectResponse
@@ -30,6 +31,7 @@ public function show(Request $request): View|RedirectResponse
      * Mark the authenticated user's email address as verified.
      *
      * @param Request $request
+     *
      * @return JsonResponse|RedirectResponse
      *
      * @throws AuthorizationException
@@ -63,21 +65,11 @@ public function verify(Request $request): JsonResponse|RedirectResponse
             : redirect($this->redirectPath())->with('verified', true);
     }
 
-    /**
-     * The user has been verified.
-     *
-     * @param  Request  $request
-     * @return void
-     */
-    protected function verified(Request $request): void
-    {
-        //
-    }
-
     /**
      * Resend the email verification notification.
      *
      * @param Request $request
+     *
      * @return JsonResponse|RedirectResponse
      */
     public function resend(Request $request): JsonResponse|RedirectResponse
@@ -94,4 +86,16 @@ public function resend(Request $request): JsonResponse|RedirectResponse
             ? new JsonResponse([], 202)
             : back()->with('resent', true);
     }
+
+    /**
+     * The user has been verified.
+     *
+     * @param Request $request
+     *
+     * @return void
+     */
+    protected function verified(Request $request): void
+    {
+        //
+    }
 }

app/Http/Controllers/Admin/AdminController.php

@@ -27,6 +27,7 @@ public function index(): View
      * Store a newly created resource in storage.
      *
      * @param Request $request
+     *
      * @return RedirectResponse
      */
     public function store(Request $request): RedirectResponse
@@ -61,6 +62,7 @@ public function create(): View
      * Show the form for editing the specified resource.
      *
      * @param Admin $admin
+     *
      * @return View
      */
     public function edit(Admin $admin): View
@@ -73,6 +75,7 @@ public function edit(Admin $admin): View
      *
      * @param Request $request
      * @param Admin   $admin
+     *
      * @return RedirectResponse
      */
     public function update(Request $request, Admin $admin): RedirectResponse
@@ -107,6 +110,7 @@ public function update(Request $request, Admin $admin): RedirectResponse
      * Remove the specified resource from storage.
      *
      * @param Admin $admin
+     *
      * @return RedirectResponse
      */
     public function destroy(Admin $admin): RedirectResponse

app/Http/Controllers/Admin/ApplicationController.php

@@ -26,6 +26,7 @@ public function index(): View
      * Store a newly created resource in storage.
      *
      * @param Request $request
+     *
      * @return View
      */
     public function store(Request $request): View
@@ -59,6 +60,7 @@ public function create(): View
      * Display the specified resource.
      *
      * @param Application $application
+     *
      * @return RedirectResponse
      */
     public function show(Application $application): RedirectResponse
@@ -72,6 +74,7 @@ public function show(Application $application): RedirectResponse
      * Show the form for editing the specified resource.
      *
      * @param Application $application
+     *
      * @return View
      */
     public function edit(Application $application): View
@@ -86,6 +89,7 @@ public function edit(Application $application): View
      *
      * @param Request     $request
      * @param Application $application
+     *
      * @return RedirectResponse
      */
     public function update(Request $request, Application $application): RedirectResponse
@@ -107,6 +111,7 @@ public function update(Request $request, Application $application): RedirectResp
      * Remove the specified resource from storage.
      *
      * @param Application $application
+     *
      * @return RedirectResponse
      */
     public function destroy(Application $application): RedirectResponse

app/Http/Controllers/Admin/AuthController.php

@@ -23,6 +23,7 @@ public function index(): View|RedirectResponse
 
     /**
      * @param Request $request
+     *
      * @return RedirectResponse
      */
     public function login(Request $request): RedirectResponse

app/Http/Controllers/Admin/HostController.php

@@ -15,6 +15,7 @@ class HostController extends Controller
      *
      *
      * @param Request $request
+     *
      * @return View
      */
     public function index(Request $request): View
@@ -39,6 +40,7 @@ public function index(Request $request): View
      * Show the form for editing the specified resource.
      *
      * @param Host $host
+     *
      * @return View
      */
     public function edit(Host $host): View
@@ -51,6 +53,7 @@ public function edit(Host $host): View
      *
      * @param Request $request
      * @param Host    $host
+     *
      * @return RedirectResponse
      */
     public function update(Request $request, Host $host): RedirectResponse
@@ -71,6 +74,7 @@ public function update(Request $request, Host $host): RedirectResponse
      * Remove the specified resource from storage.
      *
      * @param Host $host
+     *
      * @return RedirectResponse
      */
     public function destroy(Host $host): RedirectResponse

app/Http/Controllers/Admin/ModuleController.php

@@ -17,6 +17,7 @@ class ModuleController extends Controller
      * Display a listing of the resource.
      *
      * @param Module $module
+     *
      * @return View
      */
     public function index(Module $module): View
@@ -40,6 +41,7 @@ public function create(): View
      * Store a newly created resource in storage.
      *
      * @param Request $request
+     *
      * @return RedirectResponse
      */
     public function store(Request $request): RedirectResponse
@@ -80,6 +82,7 @@ private function rules(): array
      * Display the specified resource.
      *
      * @param Module $module
+     *
      * @return View
      */
     public function show(Module $module): View
@@ -95,6 +98,7 @@ public function show(Module $module): View
      * Show the form for editing the specified resource.
      *
      * @param Module $module
+     *
      * @return View
      */
     public function edit(Module $module): View
@@ -109,6 +113,7 @@ public function edit(Module $module): View
      *
      * @param Request $request
      * @param Module  $module
+     *
      * @return RedirectResponse
      */
     public function update(Request $request, Module $module): RedirectResponse
@@ -162,6 +167,7 @@ public function update(Request $request, Module $module): RedirectResponse
      * Remove the specified resource from storage.
      *
      * @param Module $module
+     *
      * @return RedirectResponse
      */
     public function destroy(Module $module): RedirectResponse

app/Http/Controllers/Admin/NotificationController.php

@@ -18,6 +18,7 @@ class NotificationController extends Controller
      * Show the form for creating a new resource.
      *
      * @param Request $request
+     *
      * @return View
      */
     public function create(Request $request): View
@@ -68,6 +69,7 @@ public function query(Request|array $request): User|CachedBuilder|Builder
      * Store a newly created resource in storage.
      *
      * @param Request $request
+     *
      * @return RedirectResponse
      */
     public function store(Request $request): RedirectResponse

app/Http/Controllers/Admin/ReplyController.php

@@ -16,6 +16,7 @@ class ReplyController extends Controller
      *
      * @param Request   $request
      * @param WorkOrder $work_order
+     *
      * @return RedirectResponse
      */
     public function store(Request $request, WorkOrder $work_order): RedirectResponse
@@ -42,6 +43,7 @@ public function store(Request $request, WorkOrder $work_order): RedirectResponse
      *
      * @param WorkOrder $work_order
      * @param Reply     $reply
+     *
      * @return View
      */
     public function edit(WorkOrder $work_order, Reply $reply): View
@@ -55,6 +57,7 @@ public function edit(WorkOrder $work_order, Reply $reply): View
      * @param Request   $request
      * @param WorkOrder $work_order
      * @param Reply     $reply
+     *
      * @return RedirectResponse
      */
     public function update(Request $request, WorkOrder $work_order, Reply $reply): RedirectResponse
@@ -75,6 +78,7 @@ public function update(Request $request, WorkOrder $work_order, Reply $reply): R
      *
      * @param WorkOrder $work_order
      * @param Reply     $reply
+     *
      * @return RedirectResponse
      */
     public function destroy(WorkOrder $work_order, Reply $reply): RedirectResponse

app/Http/Controllers/Admin/UserController.php

@@ -58,6 +58,7 @@ public function index(Request $request): View
      * Display the specified resource.
      *
      * @param User $user
+     *
      * @return RedirectResponse
      */
     public function show(User $user): RedirectResponse
@@ -71,6 +72,7 @@ public function show(User $user): RedirectResponse
      * Show the form for editing the specified resource.
      *
      * @param User $user
+     *
      * @return View
      */
     public function edit(User $user): View
@@ -88,6 +90,7 @@ public function edit(User $user): View
      *
      * @param Request $request
      * @param User    $user
+     *
      * @return RedirectResponse
      */
     public function update(Request $request, User $user): RedirectResponse
@@ -155,6 +158,7 @@ public function update(Request $request, User $user): RedirectResponse
      * Remove the specified resource from storage.
      *
      * @param User $user
+     *
      * @return RedirectResponse
      */
     public function destroy(User $user): RedirectResponse

app/Http/Controllers/Admin/UserGroupController.php

@@ -27,6 +27,7 @@ public function index(): View
      * Store a newly created resource in storage.
      *
      * @param Request $request
+     *
      * @return RedirectResponse
      */
     public function store(Request $request): RedirectResponse
@@ -64,6 +65,7 @@ public function create(): View
      * Display the specified resource.
      *
      * @param UserGroup $user_group
+     *
      * @return View
      */
     public function show(UserGroup $user_group): View
@@ -77,6 +79,7 @@ public function show(UserGroup $user_group): View
      * Show the form for editing the specified resource.
      *
      * @param UserGroup $user_group
+     *
      * @return View
      */
     public function edit(UserGroup $user_group): View
@@ -91,6 +94,7 @@ public function edit(UserGroup $user_group): View
      *
      * @param Request   $request
      * @param UserGroup $user_group
+     *
      * @return RedirectResponse
      */
     public function update(Request $request, UserGroup $user_group): RedirectResponse
@@ -107,6 +111,7 @@ public function update(Request $request, UserGroup $user_group): RedirectRespons
      * Remove the specified resource from storage.
      *
      * @param UserGroup $user_group
+     *
      * @return RedirectResponse
      */
     public function destroy(UserGroup $user_group): RedirectResponse

app/Http/Controllers/Admin/WorkOrderController.php

@@ -17,6 +17,7 @@ class WorkOrderController extends Controller
      *
      * @param Request   $request
      * @param WorkOrder $workOrder
+     *
      * @return View
      */
     public function index(Request $request, WorkOrder $workOrder): View
@@ -36,6 +37,7 @@ public function index(Request $request, WorkOrder $workOrder): View
      * Display the specified resource.
      *
      * @param WorkOrder $workOrder
+     *
      * @return View
      */
     public function show(WorkOrder $workOrder): View
@@ -51,6 +53,7 @@ public function show(WorkOrder $workOrder): View
      * Show the form for editing the specified resource.
      *
      * @param WorkOrder $workOrder
+     *
      * @return View
      */
     public function edit(WorkOrder $workOrder): View
@@ -63,6 +66,7 @@ public function edit(WorkOrder $workOrder): View
      *
      * @param Request   $request
      * @param WorkOrder $workOrder
+     *
      * @return RedirectResponse
      */
     public function update(Request $request, WorkOrder $workOrder): RedirectResponse
@@ -84,6 +88,7 @@ public function update(Request $request, WorkOrder $workOrder): RedirectResponse
      * Remove the specified resource from storage.
      *
      * @param WorkOrder $workOrder
+     *
      * @return RedirectResponse
      */
     public function destroy(WorkOrder $workOrder): RedirectResponse

app/Http/Controllers/Api/BalanceController.php

@@ -25,6 +25,7 @@ public function index(): JsonResponse
      * Store a newly created resource in storage.
      *
      * @param Request $request
+     *
      * @return JsonResponse
      */
     public function store(Request $request): JsonResponse
@@ -50,6 +51,7 @@ public function store(Request $request): JsonResponse
      * Display the specified resource.
      *
      * @param Balance $balance
+     *
      * @return JsonResponse
      */
     public function show(Balance $balance): JsonResponse

app/Http/Controllers/Api/ForumController.php

@@ -4,11 +4,11 @@
 
 use App\Http\Controllers\Controller;
 use Closure;
-use function config;
 use Illuminate\Http\Client\PendingRequest;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Support\Facades\Cache;
 use Illuminate\Support\Facades\Http;
+use function config;
 
 class ForumController extends Controller
 {
@@ -22,6 +22,15 @@ public function __construct()
         $this->http = Http::baseUrl($this->baseUrl . '/api')->throw();
     }
 
+    public function tag($tag): JsonResponse
+    {
+        $resp = $this->cache($tag, function () use ($tag) {
+            return $this->get('discussions?filter[tag]=' . $tag . '&page[offset]=0&sort=-createdAt');
+        });
+
+        return $this->resp($resp);
+    }
+
     public function cache($tag, Closure $callback)
     {
         return Cache::remember('forum.tag:' . $tag, 60, function () use ($callback) {
@@ -40,13 +49,4 @@ public function resp($data): JsonResponse
 
         return $this->success($data);
     }
-
-    public function tag($tag): JsonResponse
-    {
-        $resp = $this->cache($tag, function () use ($tag) {
-            return $this->get('discussions?filter[tag]='.$tag.'&page[offset]=0&sort=-createdAt');
-        });
-
-        return $this->resp($resp);
-    }
 }

app/Http/Controllers/Api/HostController.php

@@ -6,10 +6,10 @@
 use App\Http\Requests\User\HostRequest;
 use App\Jobs\Host\HostJob;
 use App\Models\Host;
-use function auth;
-use function dispatch;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Support\Facades\Cache;
+use function auth;
+use function dispatch;
 use function now;
 
 class HostController extends Controller

app/Http/Controllers/Api/ReplyController.php

@@ -5,9 +5,9 @@
 use App\Http\Controllers\Controller;
 use App\Models\WorkOrder\Reply;
 use App\Models\WorkOrder\WorkOrder;
-use function auth;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use function auth;
 
 class ReplyController extends Controller
 {
@@ -15,6 +15,7 @@ class ReplyController extends Controller
      * Display a listing of the resource.
      *
      * @param WorkOrder $workOrder
+     *
      * @return JsonResponse
      */
     public function index(WorkOrder $workOrder): JsonResponse
@@ -29,6 +30,7 @@ public function index(WorkOrder $workOrder): JsonResponse
      *
      * @param Request   $request
      * @param WorkOrder $workOrder
+     *
      * @return JsonResponse
      */
     public function store(Request $request, WorkOrder $workOrder): JsonResponse

app/Http/Controllers/Module/HostController.php

@@ -5,13 +5,13 @@
 use App\Http\Controllers\Controller;
 use App\Models\Host;
 use App\Models\User;
-use function auth;
 use Illuminate\Contracts\Pagination\Paginator;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
 use Illuminate\Http\Response;
 use Illuminate\Support\Str;
 use Illuminate\Validation\ValidationException;
+use function auth;
 
 // use App\Models\User;
 
@@ -29,6 +29,7 @@ public function index(Request $request): Paginator
      * Store a newly created resource in storage.
      *
      * @param Request $request
+     *
      * @return Response|JsonResponse
      *
      * @throws ValidationException
@@ -73,6 +74,7 @@ public function store(Request $request): Response|JsonResponse
      * Display the specified resource.
      *
      * @param Host $host
+     *
      * @return JsonResponse
      */
     public function show(Host $host): JsonResponse
@@ -88,6 +90,7 @@ public function show(Host $host): JsonResponse
      *
      * @param Request $request
      * @param Host    $host
+     *
      * @return JsonResponse
      *
      * @throws ValidationException
@@ -121,6 +124,7 @@ public function update(Request $request, Host $host): JsonResponse
      * Remove the specified resource from storage.
      *
      * @param    $host
+     *
      * @return JsonResponse
      */
     public function destroy($host): JsonResponse

app/Http/Controllers/Module/ReplyController.php

@@ -14,6 +14,7 @@ class ReplyController extends Controller
      * Display a listing of the resource.
      *
      * @param Request $request
+     *
      * @return JsonResponse
      */
     public function index(Request $request): JsonResponse

app/Http/Controllers/Module/TaskController.php

@@ -18,6 +18,7 @@ class TaskController extends Controller
      * Display a listing of the resource.
      *
      * @param Request $request
+     *
      * @return JsonResponse
      */
     public function index(Request $request): JsonResponse
@@ -31,6 +32,7 @@ public function index(Request $request): JsonResponse
      * Store a newly created resource in storage.
      *
      * @param Request $request
+     *
      * @return JsonResponse
      *
      * @throws ValidationException
@@ -54,6 +56,7 @@ public function store(Request $request): JsonResponse
      *
      * @param Request $request
      * @param Task    $task
+     *
      * @return JsonResponse
      *
      * @throws ValidationException

app/Http/Controllers/Web/Auth/RegisterController.php

@@ -45,6 +45,7 @@ public function __construct()
      * Get a validator for an incoming registration request.
      *
      * @param array $data
+     *
      * @return \Illuminate\Contracts\Validation\Validator
      */
     protected function validator(array $data): \Illuminate\Contracts\Validation\Validator
@@ -60,6 +61,7 @@ protected function validator(array $data): \Illuminate\Contracts\Validation\Vali
      * Create a new user instance after a valid registration.
      *
      * @param array $data
+     *
      * @return User
      */
     protected function create(array $data): User

app/Http/Controllers/Web/AuthController.php

@@ -6,13 +6,13 @@
 
 use App\Http\Controllers\Controller;
 use App\Notifications\User\UserNotification;
-use function back;
-use function config;
 use Illuminate\Http\RedirectResponse;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Auth;
 use Illuminate\Support\Facades\Cache;
 use Illuminate\View\View;
+use function back;
+use function config;
 use function redirect;
 use function session;
 use function view;

app/Http/Controllers/Web/BalanceController.php

@@ -241,6 +241,7 @@ public function notify(
      * 获取交易记录
      *
      * @param mixed $request
+     *
      * @return View
      */
     public function transactions(

app/Http/Middleware/AddHeaders.php

@@ -13,6 +13,7 @@ class AddHeaders
      *
      * @param Request $request
      * @param Closure $next
+     *
      * @return mixed
      */
     public function handle(Request $request, Closure $next): mixed

app/Http/Middleware/Admin/ValidateReferer.php

@@ -15,6 +15,7 @@ class ValidateReferer
      *
      * @param Request                                       $request
      * @param Closure(Request): (Response|RedirectResponse) $next
+     *
      * @return Response|RedirectResponse
      */
     public function handle(Request $request, Closure $next): Response|RedirectResponse

app/Http/Middleware/Authenticate.php

@@ -11,6 +11,7 @@ class Authenticate extends Middleware
      * Get the path the user should be redirected to when they are not authenticated.
      *
      * @param Request $request
+     *
      * @return string|null
      */
     protected function redirectTo($request): ?string

app/Http/Middleware/JsonResponse.php

@@ -14,6 +14,7 @@ class JsonResponse
      *
      * @param Request                                       $request
      * @param Closure(Request): (Response|RedirectResponse) $next
+     *
      * @return Response|RedirectResponse|\Illuminate\Http\JsonResponse
      */
     public function handle(Request $request, Closure $next): Response|\Illuminate\Http\JsonResponse|RedirectResponse

app/Http/Middleware/RealNamed.php

@@ -19,6 +19,7 @@ class RealNamed
      * @param Request $request
      * @param Closure $next
      * @param string  $guard
+     *
      * @return Response|RedirectResponse|JsonResponse
      */
     public function handle(Request $request, Closure $next, string $guard = 'web'): Response|RedirectResponse|JsonResponse

app/Http/Middleware/RedirectIfAuthenticated.php

@@ -17,6 +17,7 @@ class RedirectIfAuthenticated
      * @param Request                                       $request
      * @param Closure(Request): (Response|RedirectResponse) $next
      * @param string|null                                   ...$guards
+     *
      * @return Response|RedirectResponse
      */
     public function handle(Request $request, Closure $next, ...$guards): Response|RedirectResponse

app/Http/Middleware/ValidateUserIfBanned.php

@@ -15,6 +15,7 @@ class ValidateUserIfBanned
      *
      * @param Request $request
      * @param Closure $next
+     *
      * @return Response|RedirectResponse|JsonResponse
      */
     public function handle(Request $request, Closure $next): Response|RedirectResponse|JsonResponse

app/Models/Balance.php

@@ -4,11 +4,11 @@
 
 use App\Events\Users;
 use App\Notifications\User\UserCharged;
-use function auth;
 use GeneaLabs\LaravelModelCaching\Traits\Cachable;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo as BelongsToAlias;
 use Illuminate\Notifications\Notifiable;
+use function auth;
 
 class Balance extends Model
 {

app/Models/PersonalAccessToken.php

@@ -17,6 +17,7 @@ class PersonalAccessToken extends SanctumPersonalAccessToken
      * since we aren't going to use that column for anything.
      *
      * @param array $options
+     *
      * @return bool
      */
     public function save(array $options = []): bool

app/Models/Task.php

@@ -4,11 +4,11 @@
 
 use App\Events\Users;
 use App\Exceptions\CommonException;
-use function auth;
-use function broadcast;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Ramsey\Uuid\Uuid;
+use function auth;
+use function broadcast;
 
 class Task extends Model
 {

app/Models/User.php

@@ -202,6 +202,7 @@ public function startTransfer(self $to, string $amount, string|null $description
      * @param string      $description
      * @param bool        $fail
      * @param array       $options
+     *
      * @return string
      */
     public function reduce(string|null $amount = '0', string $description = '消费', bool $fail = false, array $options = []): string
@@ -247,6 +248,7 @@ public function reduce(string|null $amount = '0', string $description = '消费'
      * @param string      $payment
      * @param string      $description
      * @param array       $options
+     *
      * @return string
      */
     public function charge(string|null $amount = '0', string $payment = 'console', string $description = '充值', array $options = []): string

app/Models/UserGroup.php

@@ -35,6 +35,7 @@ public function users(): HasMany
      * @param User      $user
      * @param UserGroup $group
      * @param Carbon    $expired_at
+     *
      * @return User
      */
     public function setTempGroup(User $user, self $group, Carbon $expired_at): User

app/Models/WorkOrder/WorkOrder.php

@@ -136,16 +136,6 @@ public function isClosed(): bool
         return $this->status === 'closed';
     }
 
-    public function isWaitingForResponse(): bool
-    {
-        return $this->status === 'replied' || $this->status === 'user_replied';
-    }
-
-    public function isPlatform(): bool
-    {
-        return $this->module_id === null && $this->host_id === null;
-    }
-
     public function markAsRead(): bool
     {
         if (!$this->isWaitingForResponse()) {
@@ -163,6 +153,11 @@ public function markAsRead(): bool
         return true;
     }
 
+    public function isWaitingForResponse(): bool
+    {
+        return $this->status === 'replied' || $this->status === 'user_replied';
+    }
+
     /**
      * @throws CommonException
      */
@@ -181,6 +176,11 @@ public function safeDelete(): bool
         return true;
     }
 
+    public function isPlatform(): bool
+    {
+        return $this->module_id === null && $this->host_id === null;
+    }
+
     public function routeNotificationForMail(): array
     {
         $user = $this->user;

app/Notifications/Channels/WeComChannel.php

@@ -16,6 +16,7 @@ class WeComChannel extends Notification
      *
      * @param mixed        $notifiable
      * @param Notification $notification
+     *
      * @return void
      */
     public function send(mixed $notifiable, Notification $notification): void

app/Notifications/Channels/WebChannel.php

@@ -16,6 +16,7 @@ class WebChannel extends Notification
      *
      * @param mixed        $notifiable
      * @param Notification $notification
+     *
      * @return void
      */
     public function send(mixed $notifiable, Notification $notification): void

app/Notifications/WorkOrder/WorkOrder.php

@@ -31,6 +31,7 @@ public function __construct(WorkOrderModel $work_order)
      *
      *
      * @param WorkOrderModel $workOrder
+     *
      * @return array
      */
     public function via(WorkOrderModel $workOrder): array
@@ -49,6 +50,7 @@ public function via(WorkOrderModel $workOrder): array
      *
      *
      * @param WorkOrderModel $workOrder
+     *
      * @return MailMessage
      */
     public function toMail(WorkOrderModel $workOrder): MailMessage
@@ -64,6 +66,7 @@ public function toMail(WorkOrderModel $workOrder): MailMessage
      *
      *
      * @param WorkOrderModel $workOrder
+     *
      * @return array
      */
     public function toArray(WorkOrderModel $workOrder): array

app/Policies/WorkOrder/WorkOrderPolicy.php

@@ -17,6 +17,7 @@ class WorkOrderPolicy
      *
      * @param User|Module $user
      * @param WorkOrder   $workOrder
+     *
      * @return Response|bool
      */
     public function view(User|Module $user, WorkOrder $workOrder): Response|bool
@@ -33,6 +34,7 @@ public function view(User|Module $user, WorkOrder $workOrder): Response|bool
      *
      * @param User|Module $user
      * @param WorkOrder   $workOrder
+     *
      * @return Response|bool
      */
     public function update(User|Module $user, WorkOrder $workOrder): Response|bool
@@ -49,6 +51,7 @@ public function update(User|Module $user, WorkOrder $workOrder): Response|bool
      *
      * @param User|Module $user
      * @param WorkOrder   $workOrder
+     *
      * @return Response|bool
      */
     public function delete(User|Module $user, WorkOrder $workOrder): Response|bool

app/Support/ClusterSupport.php

@@ -67,6 +67,7 @@ public static function hset($key, $value, $data = []): void
      * @param string|array $events      事件名称
      * @param              $callback    callable 回调函数，接收一个参数，为事件数据。
      * @param              $ignore_self bool 是否忽略此节点的消息。
+     *
      * @return void
      */
     public static function listen(string|array $events, callable $callback, bool $ignore_self = true): void

app/Support/RealNameSupport.php

@@ -101,6 +101,7 @@ private function submit(string $id): string
      * 验证实名认证请求
      *
      * @param array $request
+     *
      * @return array|bool
      */
     public function verify(array $request): array|bool