Add application API and OpenAPI docs

2026-04-20 13:22:56 +02:00
parent 70d760e3a6
commit 8b25421e7c
80 changed files with 6908 additions and 1277 deletions
@@ -0,0 +1,67 @@
+<?php
+
+namespace App\Actions\Projects;
+
+use App\Actions\Permissions\PermissionService;
+use App\Enums\Permission;
+use App\Http\Resources\ProjectResource;
+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\Ticket;
+use App\Models\User;
+
+class BuildProjectBacklogPayload
+{
+    public function __construct(
+        private readonly PermissionService $permissionService,
+    ) {}
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function handle(Project $project, User $user, mixed $status = null): array
+    {
+        $canManageTickets = $this->permissionService->allows($user, Permission::ProjectWrite, $project);
+
+        return [
+            'backlogTicketStatuses' => TicketStatusResource::collection(
+                $project->ticketStatuses()
+                    ->whereNull('board_column_id')
+                    ->get(),
+            )->resolve(),
+            'canCreateTickets' => $canManageTickets,
+            'canEditTickets' => $canManageTickets,
+            'project' => ProjectResource::make($project)->resolve(),
+            'status' => $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(),
+        ];
+    }
+}