Implement ticket links and blocker state

app/Http/Requests/StoreTicketLinkRequest.php

@@ -0,0 +1,74 @@
+<?php
+
+namespace App\Http\Requests;
+
+use App\Models\Project;
+use App\Models\Ticket;
+use Illuminate\Contracts\Validation\ValidationRule;
+use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Validation\Rule;
+use Illuminate\Validation\Validator;
+
+class StoreTicketLinkRequest extends FormRequest
+{
+    /**
+     * Determine if the user is authorized to make this request.
+     */
+    public function authorize(): bool
+    {
+        return $this->user() !== null;
+    }
+
+    /**
+     * Get the validation rules that apply to the request.
+     *
+     * @return array<string, ValidationRule|array<mixed>|string>
+     */
+    public function rules(): array
+    {
+        /** @var Project $project */
+        $project = $this->route('project');
+
+        return [
+            'linked_ticket_id' => [
+                'required',
+                'integer',
+                Rule::exists('tickets', 'id')->where('project_id', $project->id),
+            ],
+            'ticket_link_type_id' => [
+                'required',
+                'integer',
+                Rule::exists('ticket_link_types', 'id')->where('project_id', $project->id),
+            ],
+        ];
+    }
+
+    /**
+     * @return array<int, callable(Validator): void>
+     */
+    public function after(): array
+    {
+        return [
+            function (Validator $validator): void {
+                /** @var Ticket $ticket */
+                $ticket = $this->route('ticket');
+
+                $linkedTicketId = $this->input('linked_ticket_id');
+
+                if (is_numeric($linkedTicketId) && (int) $linkedTicketId === $ticket->id) {
+                    $validator->errors()->add('linked_ticket_id', 'A ticket cannot be linked to itself.');
+                }
+            },
+        ];
+    }
+
+    public function linkedTicketId(): int
+    {
+        return (int) $this->validated('linked_ticket_id');
+    }
+
+    public function ticketLinkTypeId(): int
+    {
+        return (int) $this->validated('ticket_link_type_id');
+    }
+}

app/Http/Requests/UpdateProjectTicketRequest.php

@@ -33,6 +33,7 @@ class UpdateProjectTicketRequest extends FormRequest
 
         return [
             'acceptance_criteria' => ['nullable', 'string'],
+            'blocked_comment' => ['nullable', 'string'],
             'description' => ['nullable', 'string'],
             'field_values' => ['array'],
             'field_values.*' => ['array'],
@@ -43,6 +44,7 @@ class UpdateProjectTicketRequest extends FormRequest
             ],
             'field_values.*.value_number' => ['nullable', 'numeric'],
             'field_values.*.value_user_id' => ['nullable', 'integer', Rule::exists('users', 'id')],
+            'is_blocked' => ['required', 'boolean'],
             'parent_ticket_id' => [
                 'nullable',
                 'integer',
@@ -116,6 +118,10 @@ class UpdateProjectTicketRequest extends FormRequest
                 ) {
                     $validator->errors()->add('ticket_type_id', 'Tickets with child tickets must keep a Parent type.');
                 }
+
+                if ($this->boolean('is_blocked') && blank($this->input('blocked_comment'))) {
+                    $validator->errors()->add('blocked_comment', 'Blocked tickets require a blocker comment.');
+                }
             },
         ];
     }
@@ -123,7 +129,9 @@ class UpdateProjectTicketRequest extends FormRequest
     /**
      * @return array{
      *     acceptance_criteria: string|null,
+     *     blocked_comment: string|null,
      *     description: string|null,
+     *     is_blocked: bool,
      *     parent_ticket_id: int|null,
      *     ticket_priority_id: int,
      *     ticket_type_id: int,
@@ -134,7 +142,9 @@ class UpdateProjectTicketRequest extends FormRequest
     {
         /** @var array{
          *     acceptance_criteria: string|null,
+         *     blocked_comment: string|null,
          *     description: string|null,
+         *     is_blocked: bool,
          *     parent_ticket_id: int|null,
          *     ticket_priority_id: int,
          *     ticket_type_id: int,
@@ -144,12 +154,16 @@ class UpdateProjectTicketRequest extends FormRequest
         $attributes = array_merge(
             [
                 'acceptance_criteria' => null,
+                'blocked_comment' => null,
                 'description' => null,
+                'is_blocked' => false,
                 'parent_ticket_id' => null,
             ],
             Arr::only($this->validated(), [
                 'acceptance_criteria',
+                'blocked_comment',
                 'description',
+                'is_blocked',
                 'parent_ticket_id',
                 'ticket_priority_id',
                 'ticket_type_id',