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,42 @@
+<?php
+
+namespace App\Actions\ProjectBoard;
+
+use App\Models\Project;
+use App\Models\TicketStatus;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+
+trait ManagesTicketStatusPositions
+{
+    private function nextStatusPosition(Project $project, ?int $boardColumnId): int
+    {
+        return $this->statusContextQuery($project, $boardColumnId)->count() + 1;
+    }
+
+    private function normalizeStatusPositions(Project $project, ?int $boardColumnId): void
+    {
+        $this->statusContextQuery($project, $boardColumnId)
+            ->get()
+            ->values()
+            ->each(function (TicketStatus $ticketStatus, int $index): void {
+                $ticketStatus->forceFill([
+                    'position' => $index + 1,
+                ])->saveQuietly();
+            });
+    }
+
+    private function statusContextLabel(TicketStatus $ticketStatus): string
+    {
+        return $ticketStatus->boardColumn?->name ?? 'Backlog';
+    }
+
+    private function statusContextQuery(Project $project, ?int $boardColumnId): HasMany
+    {
+        return $project->ticketStatuses()
+            ->when(
+                $boardColumnId === null,
+                fn ($query) => $query->whereNull('board_column_id'),
+                fn ($query) => $query->where('board_column_id', $boardColumnId),
+            );
+    }
+}