Implement ticket links and blocker state

2026-03-25 09:12:17 +01:00
parent 3b31e6bb7d
commit 70b90f32d4
34 changed files with 1722 additions and 10 deletions
@@ -7,6 +7,7 @@ use App\Actions\Tickets\UpdateProjectTicket;
 use App\Http\Requests\UpdateProjectTicketRequest;
 use App\Models\Project;
 use App\Models\Ticket;
+use App\Models\TicketLink;
 use App\Models\User;
 use Illuminate\Http\RedirectResponse;
 use Illuminate\Http\Request;
@@ -32,6 +33,7 @@ class ProjectTicketController extends Controller
        return Inertia::render('projects/Ticket', [
            'canEditTicket' => $this->projectPermissionService->userHasPermission($request->user(), $project, 'edit'),
            'childTicketTree' => $this->buildChildTicketTree($ticket),
+            'linkedTickets' => $this->linkedTickets($ticket),
            'parentTicketOptions' => Ticket::query()
                ->where('project_id', $project->id)
                ->whereNotIn('id', $excludedParentIds)
@@ -54,6 +56,17 @@ class ProjectTicketController extends Controller
                'worklogEntries.actor',
            ]),
            'ticketFieldDefinitions' => $project->ticketFieldDefinitions()->get(),
+            'ticketLinkOptions' => Ticket::query()
+                ->where('project_id', $project->id)
+                ->whereKeyNot($ticket->id)
+                ->orderByDesc('sequence_number')
+                ->get()
+                ->map(fn (Ticket $linkedTicket): array => [
+                    'id' => $linkedTicket->id,
+                    'ticket_key' => $linkedTicket->ticket_key,
+                    'title' => $linkedTicket->title,
+                ]),
+            'ticketLinkTypes' => $project->ticketLinkTypes()->get(),
            'ticketPriorities' => $project->ticketPriorities()->get(),
            'ticketTypes' => $project->ticketTypes()->get(),
            'users' => User::query()
@@ -124,4 +137,50 @@ class ProjectTicketController extends Controller
            ->values()
            ->all();
    }
+
+    /**
+     * @return array<int, array{
+     *     created_at: string|null,
+     *     id: int,
+     *     linked_ticket: array{id: int, ticket_key: string, title: string},
+     *     source_ticket_id: int,
+     *     target_ticket_id: int,
+     *     ticket_link_type: mixed,
+     *     ticket_link_type_id: int,
+     *     updated_at: string|null
+     * }>
+     */
+    private function linkedTickets(Ticket $ticket): array
+    {
+        return 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()
+            ->map(function (TicketLink $ticketLink) use ($ticket): array {
+                $linkedTicket = $ticketLink->source_ticket_id === $ticket->id
+                    ? $ticketLink->targetTicket
+                    : $ticketLink->sourceTicket;
+
+                return [
+                    'created_at' => $ticketLink->created_at?->toISOString(),
+                    'id' => $ticketLink->id,
+                    'linked_ticket' => [
+                        'id' => $linkedTicket->id,
+                        'ticket_key' => $linkedTicket->ticket_key,
+                        'title' => $linkedTicket->title,
+                    ],
+                    'source_ticket_id' => $ticketLink->source_ticket_id,
+                    'target_ticket_id' => $ticketLink->target_ticket_id,
+                    'ticket_link_type' => $ticketLink->ticketLinkType,
+                    'ticket_link_type_id' => $ticketLink->ticket_link_type_id,
+                    'updated_at' => $ticketLink->updated_at?->toISOString(),
+                ];
+            })
+            ->all();
+    }
 }
@@ -0,0 +1,122 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Actions\ProjectPermissions\ProjectPermissionService;
+use App\Actions\Tickets\CreateTicketWorklogEntry;
+use App\Http\Requests\StoreTicketLinkRequest;
+use App\Models\Project;
+use App\Models\Ticket;
+use App\Models\TicketLink;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\DB;
+
+class ProjectTicketLinkController extends Controller
+{
+    public function __construct(
+        private readonly CreateTicketWorklogEntry $createTicketWorklogEntry,
+        private readonly ProjectPermissionService $projectPermissionService,
+    ) {}
+
+    public function store(
+        StoreTicketLinkRequest $request,
+        Project $project,
+        Ticket $ticket,
+    ): RedirectResponse {
+        abort_unless(
+            $this->projectPermissionService->userHasPermission($request->user(), $project, 'edit'),
+            403,
+        );
+
+        $linkedTicket = Ticket::query()
+            ->where('project_id', $project->id)
+            ->findOrFail($request->linkedTicketId());
+
+        [$sourceTicketId, $targetTicketId] = $this->normalizeTicketPair($ticket->id, $linkedTicket->id);
+
+        $ticketLink = DB::transaction(function () use ($linkedTicket, $request, $sourceTicketId, $targetTicketId, $ticket): TicketLink {
+            $ticketLink = TicketLink::query()->updateOrCreate(
+                [
+                    'source_ticket_id' => $sourceTicketId,
+                    'target_ticket_id' => $targetTicketId,
+                ],
+                [
+                    'ticket_link_type_id' => $request->ticketLinkTypeId(),
+                ],
+            );
+
+            $ticketLink->load('ticketLinkType');
+
+            $this->createTicketWorklogEntry->handle(
+                $ticket,
+                $request->user(),
+                'link_updated',
+                "Linked {$linkedTicket->ticket_key} as {$ticketLink->ticketLinkType->label}.",
+                [
+                    'linked_ticket_key' => $linkedTicket->ticket_key,
+                    'ticket_link_type' => $ticketLink->ticketLinkType->label,
+                ],
+            );
+
+            return $ticketLink;
+        });
+
+        return to_route('projects.tickets.show', [$project, $ticket])
+            ->with('status', "{$ticketLink->ticketLinkType->label} link was saved.");
+    }
+
+    public function destroy(
+        Request $request,
+        Project $project,
+        Ticket $ticket,
+        TicketLink $ticketLink,
+    ): RedirectResponse {
+        abort_unless(
+            $this->projectPermissionService->userHasPermission($request->user(), $project, 'edit'),
+            403,
+        );
+
+        $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, $request, $ticket, $ticketLink): void {
+            $ticketLink->delete();
+
+            $this->createTicketWorklogEntry->handle(
+                $ticket,
+                $request->user(),
+                'link_removed',
+                "Removed {$label} link to {$linkedTicket->ticket_key}.",
+                [
+                    'linked_ticket_key' => $linkedTicket->ticket_key,
+                    'ticket_link_type' => $label,
+                ],
+            );
+        });
+
+        return to_route('projects.tickets.show', [$project, $ticket])
+            ->with('status', "{$label} link was removed.");
+    }
+
+    /**
+     * @return array{0: int, 1: int}
+     */
+    private function normalizeTicketPair(int $firstTicketId, int $secondTicketId): array
+    {
+        return [
+            min($firstTicketId, $secondTicketId),
+            max($firstTicketId, $secondTicketId),
+        ];
+    }
+}
@@ -10,6 +10,7 @@ use App\Http\Requests\UpdateProjectNamedSettingRequest;
 use App\Http\Requests\UpdateTicketFieldDefinitionRequest;
 use App\Models\Project;
 use App\Models\TicketFieldDefinition;
+use App\Models\TicketLinkType;
 use App\Models\TicketPriority;
 use App\Models\TicketType;
 use Illuminate\Database\Eloquent\Model;
@@ -42,6 +43,7 @@ class ProjectTicketMetadataSettingsController extends Controller
            'project' => $project,
            'status' => session('status'),
            'ticketFieldDefinitions' => $project->ticketFieldDefinitions()->get(),
+            'ticketLinkTypes' => $project->ticketLinkTypes()->get(),
            'ticketPriorities' => $project->ticketPriorities()->get(),
            'ticketTypes' => $project->ticketTypes()->get(),
        ]);
@@ -249,6 +251,71 @@ class ProjectTicketMetadataSettingsController extends Controller
            ->with('status', "{$deletedLabel} field was removed.");
    }

+    public function storeLinkType(StoreProjectNamedSettingRequest $request, Project $project): RedirectResponse
+    {
+        $this->abortUnlessCanManage($request, $project);
+
+        $ticketLinkType = DB::transaction(function () use ($project, $request): TicketLinkType {
+            $ticketLinkType = $project->ticketLinkTypes()->create([
+                'label' => $request->validated('name'),
+                'position' => $project->ticketLinkTypes()->count() + 1,
+            ]);
+
+            $this->reorderModels(
+                $project->ticketLinkTypes()->whereKeyNot($ticketLinkType->id)->get()->values(),
+                $ticketLinkType,
+                $request->position() ?? $project->ticketLinkTypes()->count(),
+            );
+
+            return $ticketLinkType;
+        });
+
+        return to_route('projects.settings.metadata', $project)
+            ->with('status', "{$ticketLinkType->label} link type was added.");
+    }
+
+    public function updateLinkType(
+        UpdateProjectNamedSettingRequest $request,
+        Project $project,
+        TicketLinkType $ticketLinkType,
+    ): RedirectResponse {
+        $this->abortUnlessCanManage($request, $project);
+
+        DB::transaction(function () use ($project, $request, $ticketLinkType): void {
+            $ticketLinkType->update([
+                'label' => $request->validated('name'),
+            ]);
+
+            $this->reorderModels(
+                $project->ticketLinkTypes()->whereKeyNot($ticketLinkType->id)->get()->values(),
+                $ticketLinkType,
+                $request->position(),
+            );
+        });
+
+        return to_route('projects.settings.metadata', $project)
+            ->with('status', "{$ticketLinkType->fresh()->label} link type was updated.");
+    }
+
+    public function destroyLinkType(
+        Request $request,
+        Project $project,
+        TicketLinkType $ticketLinkType,
+    ): RedirectResponse {
+        $this->abortUnlessCanManage($request, $project);
+
+        $deletedLabel = $ticketLinkType->label;
+
+        DB::transaction(function () use ($project, $ticketLinkType): void {
+            $ticketLinkType->delete();
+
+            $this->persistOrderedModels($project->ticketLinkTypes()->get()->values());
+        });
+
+        return to_route('projects.settings.metadata', $project)
+            ->with('status', "{$deletedLabel} link type was removed.");
+    }
+
    private function abortUnlessCanManage(Request $request, Project $project): void
    {
        abort_unless(