Add application API and OpenAPI docs

app/Http/Controllers/Api/ProjectTicketBranchController.php

@@ -0,0 +1,61 @@
+<?php
+
+namespace App\Http\Controllers\Api;
+
+use App\Actions\Permissions\PermissionService;
+use App\Actions\Tickets\CreateProjectTicketBranch;
+use App\Actions\Tickets\ValidateProjectTicketBranch;
+use App\Enums\Permission;
+use App\Http\Requests\StoreProjectTicketBranchRequest;
+use App\Http\Requests\ValidateProjectTicketBranchRequest;
+use App\Models\Project;
+use App\Models\Ticket;
+use Illuminate\Http\JsonResponse;
+
+class ProjectTicketBranchController extends ApiController
+{
+    public function __construct(
+        private readonly CreateProjectTicketBranch $createProjectTicketBranch,
+        private readonly PermissionService $permissionService,
+        private readonly ValidateProjectTicketBranch $validateProjectTicketBranch,
+    ) {}
+
+    public function validate(
+        ValidateProjectTicketBranchRequest $request,
+        Project $project,
+        Ticket $ticket,
+    ): JsonResponse {
+        $user = $this->authenticatedUser($request);
+
+        abort_unless(
+            $this->permissionService->allows($user, Permission::ProjectWrite, $project),
+            403,
+        );
+
+        return response()->json([
+            'data' => $this->validateProjectTicketBranch->handle($project, $ticket, $user, $request->validated()),
+        ]);
+    }
+
+    public function store(
+        StoreProjectTicketBranchRequest $request,
+        Project $project,
+        Ticket $ticket,
+    ): JsonResponse {
+        $user = $this->authenticatedUser($request);
+
+        abort_unless(
+            $this->permissionService->allows($user, Permission::ProjectWrite, $project),
+            403,
+        );
+
+        $result = $this->createProjectTicketBranch->handle($project, $ticket, $user, $request->validated());
+
+        return response()->json([
+            'data' => $result,
+            'meta' => [
+                'message' => "{$result['branch_name']} was created in {$result['repository_full_name']}.",
+            ],
+        ], 201);
+    }
+}