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
@@ -2,32 +2,16 @@

 namespace App\Http\Controllers;

-use App\Actions\Git\BuildSuggestedTicketBranchName;
-use App\Actions\Git\ResolveTicketBranchMatches;
-use App\Actions\Git\ResolveTicketPullRequestMatches;
 use App\Actions\Permissions\PermissionService;
+use App\Actions\Projects\BuildProjectTicketDetailPayload;
+use App\Actions\Projects\BuildProjectTicketOptionsPayload;
 use App\Actions\Tickets\CreateProjectTicket;
 use App\Actions\Tickets\UpdateProjectTicket;
 use App\Enums\Permission;
 use App\Http\Requests\StoreProjectTicketRequest;
 use App\Http\Requests\UpdateProjectTicketRequest;
-use App\Http\Resources\ProjectResource;
-use App\Http\Resources\TicketFieldDefinitionResource;
-use App\Http\Resources\TicketLinkResource;
-use App\Http\Resources\TicketLinkTypeResource;
-use App\Http\Resources\TicketPriorityResource;
-use App\Http\Resources\TicketReferenceResource;
-use App\Http\Resources\TicketRepositoryBranchResource;
-use App\Http\Resources\TicketRepositoryPullRequestResource;
-use App\Http\Resources\TicketResource;
-use App\Http\Resources\TicketStatusResource;
-use App\Http\Resources\TicketTreeNodeResource;
-use App\Http\Resources\TicketTypeResource;
-use App\Http\Resources\UserResource;
 use App\Models\Project;
 use App\Models\Ticket;
-use App\Models\TicketLink;
-use App\Models\User;
 use Illuminate\Http\RedirectResponse;
 use Illuminate\Http\Request;
 use Illuminate\Support\Arr;
@@ -37,11 +21,10 @@ use Inertia\Response;
 class ProjectTicketController extends Controller
 {
    public function __construct(
-        private readonly BuildSuggestedTicketBranchName $buildSuggestedTicketBranchName,
+        private readonly BuildProjectTicketDetailPayload $buildProjectTicketDetailPayload,
+        private readonly BuildProjectTicketOptionsPayload $buildProjectTicketOptionsPayload,
        private readonly CreateProjectTicket $createProjectTicket,
        private readonly PermissionService $permissionService,
-        private readonly ResolveTicketBranchMatches $resolveTicketBranchMatches,
-        private readonly ResolveTicketPullRequestMatches $resolveTicketPullRequestMatches,
        private readonly UpdateProjectTicket $updateProjectTicket,
    ) {}

@@ -54,33 +37,14 @@ class ProjectTicketController extends Controller
            403,
        );

-        $source = Arr::get($request->query(), 'source') === 'board'
-            ? 'board'
-            : 'backlog';
-        $defaultTicketStatus = $source === 'board'
-            ? $project->ticketStatuses()->whereNotNull('board_column_id')->first()
-            : $project->ticketStatuses()->whereNull('board_column_id')->first();
-
-        $defaultTicketStatus ??= $project->ticketStatuses()->first();
-
-        return Inertia::render('projects/TicketCreate', [
-            'defaultTicketStatusId' => $defaultTicketStatus?->id,
-            'project' => ProjectResource::make($project)->resolve(),
-            'source' => $source,
-            'status' => session('status'),
-            'ticketPriorities' => TicketPriorityResource::collection($project->ticketPriorities()->get())->resolve(),
-            'ticketStatusOptions' => TicketStatusResource::collection(
-                $project->ticketStatuses()
-                    ->with('boardColumn')
-                    ->get(),
-            )->resolve(),
-            'ticketTypes' => TicketTypeResource::collection($project->ticketTypes()->get())->resolve(),
-            'users' => UserResource::collection(
-                User::query()
-                    ->orderBy('name')
-                    ->get(),
-            )->resolve(),
-        ]);
+        return Inertia::render(
+            'projects/TicketCreate',
+            $this->buildProjectTicketOptionsPayload->handle(
+                $project,
+                Arr::get($request->query(), 'source') === 'board' ? 'board' : 'backlog',
+                session('status'),
+            ),
+        );
    }

    public function store(StoreProjectTicketRequest $request, Project $project): RedirectResponse
@@ -111,88 +75,10 @@ class ProjectTicketController extends Controller
            403,
        );

-        $canEditTicket = $this->permissionService->allows($user, Permission::ProjectWrite, $project);
-        $canManageProject = $this->permissionService->allows($user, Permission::ProjectAdmin, $project);
-        $displayTicket = $ticket->load([
-            'assignee',
-            'author',
-            'fieldValues.ticketFieldDefinition',
-            'fieldValues.userValue',
-            'parentTicket',
-            'ticketPriority',
-            'ticketStatus.boardColumn',
-            'ticketType',
-            'worklogEntries.actor',
-        ]);
-
-        if (! $project->show_author && ! $canManageProject) {
-            $displayTicket->setRelation('author', null);
-            $displayTicket->author_user_id = null;
-        }
-
-        return Inertia::render('projects/Ticket', [
-            'canEditTicket' => $canEditTicket,
-            'canManageProject' => $canManageProject,
-            'childTicketTree' => TicketTreeNodeResource::collection(
-                $ticket->childTickets()
-                    ->with('ticketType')
-                    ->get(),
-            )->resolve(),
-            'linkedTickets' => TicketLinkResource::collection(
-                TicketLink::query()
-                    ->with(['sourceTicket', 'targetTicket', 'ticketLinkType'])
-                    ->where(function ($query) use ($ticket): void {
-                        $query
-                            ->where('source_ticket_id', $ticket->id)
-                            ->orWhere('target_ticket_id', $ticket->id);
-                    })
-                    ->orderBy('id')
-                    ->get()
-                    ->each(fn (TicketLink $ticketLink) => $ticketLink->setAttribute('current_ticket_id', $ticket->id)),
-            )->resolve(),
-            'parentTicketOptions' => TicketReferenceResource::collection(
-                Ticket::query()
-                    ->where('project_id', $project->id)
-                    ->whereKeyNot($ticket->id)
-                    ->whereHas('ticketType', fn ($query) => $query->where('is_parent', true))
-                    ->orderByDesc('sequence_number')
-                    ->get(),
-            )->resolve(),
-            'project' => ProjectResource::make($project)->resolve(),
-            'repositoryBranches' => TicketRepositoryBranchResource::collection(
-                $this->resolveTicketBranchMatches->handle(
-                    $user,
-                    $project,
-                    $ticket,
-                ),
-            )->resolve(),
-            'repositoryPullRequests' => TicketRepositoryPullRequestResource::collection(
-                $this->resolveTicketPullRequestMatches->handle(
-                    $user,
-                    $project,
-                    $ticket,
-                ),
-            )->resolve(),
-            'status' => session('status'),
-            'suggestedBranchName' => $this->buildSuggestedTicketBranchName->handle($ticket),
-            'ticket' => TicketResource::make($displayTicket)->resolve(),
-            'ticketFieldDefinitions' => TicketFieldDefinitionResource::collection($project->ticketFieldDefinitions()->get())->resolve(),
-            'ticketLinkOptions' => TicketReferenceResource::collection(
-                Ticket::query()
-                    ->where('project_id', $project->id)
-                    ->whereKeyNot($ticket->id)
-                    ->orderByDesc('sequence_number')
-                    ->get(),
-            )->resolve(),
-            'ticketLinkTypes' => TicketLinkTypeResource::collection($project->ticketLinkTypes()->get())->resolve(),
-            'ticketPriorities' => TicketPriorityResource::collection($project->ticketPriorities()->get())->resolve(),
-            'ticketTypes' => TicketTypeResource::collection($project->ticketTypes()->get())->resolve(),
-            'users' => UserResource::collection(
-                User::query()
-                    ->orderBy('name')
-                    ->get(),
-            )->resolve(),
-        ]);
+        return Inertia::render(
+            'projects/Ticket',
+            $this->buildProjectTicketDetailPayload->handle($project, $ticket, $user, session('status')),
+        );
    }

    public function update(