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,60 @@
+<?php
+
+namespace App\Actions\Tickets;
+
+use App\Enums\TicketWorklogEntryType;
+use App\Models\Ticket;
+use App\Models\TicketLink;
+use App\Models\User;
+use Illuminate\Support\Facades\DB;
+
+class DeleteProjectTicketLink
+{
+    public function __construct(
+        private readonly CreateTicketWorklogEntry $createTicketWorklogEntry,
+    ) {}
+
+    public function handle(Ticket $ticket, TicketLink $ticketLink, User $user): string
+    {
+        $ticketLink->load(['sourceTicket', 'targetTicket', 'ticketLinkType']);
+
+        abort_unless(
+            $ticketLink->source_ticket_id === $ticket->id || $ticketLink->target_ticket_id === $ticket->id,
+            404,
+        );
+
+        $linkedTicket = $ticketLink->source_ticket_id === $ticket->id
+            ? $ticketLink->targetTicket
+            : $ticketLink->sourceTicket;
+
+        $label = $ticketLink->ticketLinkType->label;
+
+        DB::transaction(function () use ($label, $linkedTicket, $user, $ticket, $ticketLink): void {
+            $ticketLink->delete();
+
+            $this->createTicketWorklogEntry->handle(
+                $ticket,
+                $user,
+                TicketWorklogEntryType::LinkRemoved,
+                "Removed {$label} link to {$linkedTicket->ticket_key}.",
+                [
+                    'linked_ticket_key' => $linkedTicket->ticket_key,
+                    'ticket_link_type' => $label,
+                ],
+            );
+
+            $this->createTicketWorklogEntry->handle(
+                $linkedTicket,
+                $user,
+                TicketWorklogEntryType::LinkRemoved,
+                "Removed {$label} link to {$ticket->ticket_key}.",
+                [
+                    'linked_ticket_key' => $ticket->ticket_key,
+                    'ticket_link_type' => $label,
+                ],
+            );
+        });
+
+        return $label;
+    }
+}