Add application API and OpenAPI docs

app/Http/Controllers/ProjectController.php

@@ -3,7 +3,10 @@
 namespace App\Http\Controllers;
 
 use App\Actions\Permissions\PermissionService;
-use App\Actions\ProjectTicketMetadata\InitializeProjectTicketMetadata;
+use App\Actions\Projects\BuildProjectBacklogPayload;
+use App\Actions\Projects\CreateProject;
+use App\Actions\Projects\DeleteProject;
+use App\Actions\Projects\ListVisibleProjects;
 use App\Enums\Permission;
 use App\Http\Requests\DeleteProjectRequest;
 use App\Http\Requests\StoreProjectRequest;
@@ -11,14 +14,9 @@ use App\Http\Requests\SyncProjectPermissionsRequest;
 use App\Http\Resources\PermissionOptionResource;
 use App\Http\Resources\ProjectResource;
 use App\Http\Resources\TeamResource;
-use App\Http\Resources\TicketPriorityResource;
-use App\Http\Resources\TicketResource;
-use App\Http\Resources\TicketStatusResource;
-use App\Http\Resources\TicketTypeResource;
 use App\Http\Resources\UserResource;
 use App\Models\Project;
 use App\Models\Team;
-use App\Models\Ticket;
 use App\Models\User;
 use Illuminate\Http\RedirectResponse;
 use Illuminate\Http\Request;
@@ -29,7 +27,10 @@ use Inertia\Response;
 class ProjectController extends Controller
 {
     public function __construct(
-        private readonly InitializeProjectTicketMetadata $initializeProjectTicketMetadata,
+        private readonly BuildProjectBacklogPayload $buildProjectBacklogPayload,
+        private readonly CreateProject $createProject,
+        private readonly DeleteProject $deleteProject,
+        private readonly ListVisibleProjects $listVisibleProjects,
         private readonly PermissionService $permissionService,
     ) {}
 
@@ -37,24 +38,8 @@ class ProjectController extends Controller
     {
         $user = $request->user();
 
-        $projectQuery = Project::query()
-            ->orderByDesc('id');
-
-        if (! $this->permissionService->allows($user, Permission::GlobalAdmin)) {
-            $viewableProjectIds = $this->permissionService->viewableProjectIds($user);
-
-            if ($viewableProjectIds === []) {
-                return Inertia::render('projects/Index', [
-                    'projects' => ProjectResource::collection(collect())->resolve(),
-                    'status' => session('status'),
-                ]);
-            }
-
-            $projectQuery->whereIn('id', $viewableProjectIds);
-        }
-
         return Inertia::render('projects/Index', [
-            'projects' => ProjectResource::collection($projectQuery->get())->resolve(),
+            'projects' => ProjectResource::collection($this->listVisibleProjects->handle($user))->resolve(),
             'status' => session('status'),
         ]);
     }
@@ -71,9 +56,7 @@ class ProjectController extends Controller
 
     public function store(StoreProjectRequest $request): RedirectResponse
     {
-        $project = Project::query()->create($request->validated());
-        $this->initializeProjectTicketMetadata->handle($project);
-        $this->permissionService->grant($request->user(), Permission::ProjectAdmin, $project);
+        $project = $this->createProject->handle($request->validated(), $request->user());
 
         return to_route('projects.show', $project);
     }
@@ -102,44 +85,10 @@ class ProjectController extends Controller
             403,
         );
 
-        $canManageTickets = $this->permissionService->allows($user, Permission::ProjectWrite, $project);
-
-        return Inertia::render('projects/Backlog', [
-            'backlogTicketStatuses' => TicketStatusResource::collection(
-                $project->ticketStatuses()
-                    ->whereNull('board_column_id')
-                    ->get(),
-            )->resolve(),
-            'canCreateTickets' => $canManageTickets,
-            'canEditTickets' => $canManageTickets,
-            'project' => ProjectResource::make($project)->resolve(),
-            'status' => session('status'),
-            'ticketStatusOptions' => TicketStatusResource::collection(
-                $project->ticketStatuses()
-                    ->with('boardColumn')
-                    ->get(),
-            )->resolve(),
-            'ticketPriorities' => TicketPriorityResource::collection($project->ticketPriorities()->get())->resolve(),
-            'ticketTypes' => TicketTypeResource::collection($project->ticketTypes()->get())->resolve(),
-            'tickets' => TicketResource::collection(
-                Ticket::query()
-                    ->with([
-                        'ticketPriority',
-                        'ticketStatus.allowedTargetStatuses.boardColumn',
-                        'ticketStatus.boardColumn',
-                        'ticketType',
-                    ])
-                    ->where('project_id', $project->id)
-                    ->whereHas('ticketStatus', fn ($query) => $query->whereNull('board_column_id'))
-                    ->orderByDesc('sequence_number')
-                    ->get(),
-            )->resolve(),
-            'users' => UserResource::collection(
-                User::query()
-                    ->orderBy('name')
-                    ->get(),
-            )->resolve(),
-        ]);
+        return Inertia::render(
+            'projects/Backlog',
+            $this->buildProjectBacklogPayload->handle($project, $user, session('status')),
+        );
     }
 
     public function general(Request $request, Project $project): Response
@@ -223,9 +172,7 @@ class ProjectController extends Controller
     {
         $request->validated();
 
-        $projectName = $project->name;
-
-        $project->delete();
+        $projectName = $this->deleteProject->handle($project);
 
         return to_route('projects.index')
             ->with('status', "Project {$projectName} was deleted.");