Add application API and OpenAPI docs
linter / quality (pull_request) Successful in 1m18s
tests / ci (8.4) (pull_request) Successful in 1m28s

This commit is contained in:
2026-04-20 13:22:56 +02:00
parent 70d760e3a6
commit 8b25421e7c
80 changed files with 6908 additions and 1277 deletions
@@ -0,0 +1,19 @@
<?php
namespace App\Http\Controllers\Api;
use App\Http\Controllers\Controller;
use App\Models\User;
use Illuminate\Http\Request;
abstract class ApiController extends Controller
{
protected function authenticatedUser(Request $request): User
{
$user = $request->user();
abort_if($user === null, 401);
return $user;
}
}
@@ -0,0 +1,48 @@
<?php
namespace App\Http\Controllers\Api;
use App\Actions\Permissions\PermissionService;
use App\Actions\Projects\BuildProjectBacklogPayload;
use App\Actions\Projects\BuildProjectBoardPayload;
use App\Enums\Permission;
use App\Models\Project;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
class ProjectBoardController extends ApiController
{
public function __construct(
private readonly BuildProjectBacklogPayload $buildProjectBacklogPayload,
private readonly BuildProjectBoardPayload $buildProjectBoardPayload,
private readonly PermissionService $permissionService,
) {}
public function board(Request $request, Project $project): JsonResponse
{
$user = $this->authenticatedUser($request);
abort_unless(
$this->permissionService->allows($user, Permission::ProjectRead, $project),
403,
);
return response()->json([
'data' => $this->buildProjectBoardPayload->handle($project, $user),
]);
}
public function backlog(Request $request, Project $project): JsonResponse
{
$user = $this->authenticatedUser($request);
abort_unless(
$this->permissionService->allows($user, Permission::ProjectRead, $project),
403,
);
return response()->json([
'data' => $this->buildProjectBacklogPayload->handle($project, $user),
]);
}
}
@@ -0,0 +1,167 @@
<?php
namespace App\Http\Controllers\Api;
use App\Actions\Permissions\PermissionService;
use App\Actions\ProjectBoard\DeleteBoardColumn;
use App\Actions\ProjectBoard\DeleteTicketStatus;
use App\Actions\ProjectBoard\StoreBoardColumn;
use App\Actions\ProjectBoard\StoreTicketStatus;
use App\Actions\ProjectBoard\UpdateBoardColumn;
use App\Actions\ProjectBoard\UpdateTicketStatus;
use App\Actions\ProjectBoard\UpdateTicketStatusTransitions;
use App\Actions\Projects\BuildProjectBoardSettingsPayload;
use App\Enums\Permission;
use App\Http\Requests\StoreBoardColumnRequest;
use App\Http\Requests\StoreTicketStatusRequest;
use App\Http\Requests\UpdateBoardColumnRequest;
use App\Http\Requests\UpdateTicketStatusRequest;
use App\Http\Requests\UpdateTicketStatusTransitionsRequest;
use App\Http\Resources\BoardColumnResource;
use App\Http\Resources\TicketStatusResource;
use App\Models\BoardColumn;
use App\Models\Project;
use App\Models\TicketStatus;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
class ProjectBoardSettingsController extends ApiController
{
public function __construct(
private readonly BuildProjectBoardSettingsPayload $buildProjectBoardSettingsPayload,
private readonly DeleteBoardColumn $deleteBoardColumn,
private readonly DeleteTicketStatus $deleteTicketStatus,
private readonly PermissionService $permissionService,
private readonly StoreBoardColumn $storeBoardColumn,
private readonly StoreTicketStatus $storeTicketStatus,
private readonly UpdateBoardColumn $updateBoardColumn,
private readonly UpdateTicketStatus $updateTicketStatus,
private readonly UpdateTicketStatusTransitions $updateTicketStatusTransitions,
) {}
public function show(Request $request, Project $project): JsonResponse
{
$this->abortUnlessCanManage($request, $project);
return response()->json([
'data' => $this->buildProjectBoardSettingsPayload->handle($project),
]);
}
public function storeColumn(StoreBoardColumnRequest $request, Project $project): JsonResponse
{
$this->abortUnlessCanManage($request, $project);
$boardColumn = $this->storeBoardColumn->handle($project, $request->validated());
return BoardColumnResource::make($boardColumn->load('ticketStatuses'))
->additional([
'meta' => [
'message' => "{$boardColumn->name} was added to the board workflow.",
],
])
->response()
->setStatusCode(201);
}
public function updateColumn(
UpdateBoardColumnRequest $request,
Project $project,
BoardColumn $boardColumn,
): JsonResponse {
$this->abortUnlessCanManage($request, $project);
$boardColumn = $this->updateBoardColumn->handle($project, $boardColumn, $request->validated());
return BoardColumnResource::make($boardColumn->load('ticketStatuses'))
->additional([
'meta' => [
'message' => "{$boardColumn->name} was updated.",
],
])
->response();
}
public function destroyColumn(Request $request, Project $project, BoardColumn $boardColumn): JsonResponse
{
$this->abortUnlessCanManage($request, $project);
$this->deleteBoardColumn->handle($project, $boardColumn);
return response()->json(null, 204);
}
public function storeStatus(StoreTicketStatusRequest $request, Project $project): JsonResponse
{
$this->abortUnlessCanManage($request, $project);
$ticketStatus = $this->storeTicketStatus->handle($project, $request->validated());
return TicketStatusResource::make($ticketStatus)
->additional([
'meta' => [
'message' => "{$ticketStatus->name} was added to {$this->statusContextLabel($ticketStatus)}.",
],
])
->response()
->setStatusCode(201);
}
public function updateStatus(
UpdateTicketStatusRequest $request,
Project $project,
TicketStatus $ticketStatus,
): JsonResponse {
$this->abortUnlessCanManage($request, $project);
$ticketStatus = $this->updateTicketStatus->handle($ticketStatus, $request->validated());
return TicketStatusResource::make($ticketStatus->load('boardColumn'))
->additional([
'meta' => [
'message' => "{$ticketStatus->name} was updated.",
],
])
->response();
}
public function destroyStatus(Request $request, Project $project, TicketStatus $ticketStatus): JsonResponse
{
$this->abortUnlessCanManage($request, $project);
$this->deleteTicketStatus->handle($project, $ticketStatus);
return response()->json(null, 204);
}
public function updateStatusTransitions(
UpdateTicketStatusTransitionsRequest $request,
Project $project,
TicketStatus $ticketStatus,
): JsonResponse {
$this->abortUnlessCanManage($request, $project);
$ticketStatus = $this->updateTicketStatusTransitions->handle($ticketStatus, $request->validated());
return TicketStatusResource::make($ticketStatus->load(['allowedTargetStatuses.boardColumn', 'boardColumn']))
->additional([
'meta' => [
'message' => "{$ticketStatus->name} move targets were updated.",
],
])
->response();
}
private function abortUnlessCanManage(Request $request, Project $project): void
{
abort_unless(
$this->permissionService->allows($this->authenticatedUser($request), Permission::ProjectAdmin, $project),
403,
);
}
private function statusContextLabel(TicketStatus $ticketStatus): string
{
return $ticketStatus->boardColumn?->name ?? 'Backlog';
}
}
@@ -0,0 +1,68 @@
<?php
namespace App\Http\Controllers\Api;
use App\Actions\Permissions\PermissionService;
use App\Actions\Projects\CreateProject;
use App\Actions\Projects\DeleteProject;
use App\Actions\Projects\ListVisibleProjects;
use App\Enums\Permission;
use App\Http\Requests\DeleteProjectRequest;
use App\Http\Requests\StoreProjectRequest;
use App\Http\Resources\ProjectResource;
use App\Models\Project;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\Http\Resources\Json\AnonymousResourceCollection;
class ProjectController extends ApiController
{
public function __construct(
private readonly CreateProject $createProject,
private readonly DeleteProject $deleteProject,
private readonly ListVisibleProjects $listVisibleProjects,
private readonly PermissionService $permissionService,
) {}
public function index(Request $request): AnonymousResourceCollection
{
return ProjectResource::collection(
$this->listVisibleProjects->handle($this->authenticatedUser($request)),
);
}
public function store(StoreProjectRequest $request): JsonResponse
{
$project = $this->createProject->handle($request->validated(), $this->authenticatedUser($request));
return ProjectResource::make($project)
->additional([
'meta' => [
'message' => "{$project->name} was created.",
],
])
->response()
->setStatusCode(201);
}
public function show(Request $request, Project $project): ProjectResource
{
$user = $this->authenticatedUser($request);
abort_unless(
$this->permissionService->allows($user, Permission::ProjectRead, $project),
403,
);
return ProjectResource::make($project);
}
public function destroy(DeleteProjectRequest $request, Project $project): JsonResponse
{
$request->validated();
$this->deleteProject->handle($project);
return response()->json(null, 204);
}
}
@@ -0,0 +1,105 @@
<?php
namespace App\Http\Controllers\Api;
use App\Actions\Permissions\PermissionService;
use App\Actions\Repositories\BuildProjectRepositorySettingsPayload;
use App\Actions\Repositories\DeleteProjectRepositoryConnection;
use App\Actions\Repositories\StoreProjectRepositoryConnection;
use App\Actions\Repositories\UpdateProjectRepositoryConnection;
use App\Enums\Permission;
use App\Http\Requests\StoreRepositoryConnectionRequest;
use App\Http\Requests\UpdateRepositoryConnectionRequest;
use App\Http\Resources\RepositoryConnectionResource;
use App\Models\Project;
use App\Models\RepositoryConnection;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
class ProjectRepositorySettingsController extends ApiController
{
public function __construct(
private readonly BuildProjectRepositorySettingsPayload $buildProjectRepositorySettingsPayload,
private readonly DeleteProjectRepositoryConnection $deleteProjectRepositoryConnection,
private readonly PermissionService $permissionService,
private readonly StoreProjectRepositoryConnection $storeProjectRepositoryConnection,
private readonly UpdateProjectRepositoryConnection $updateProjectRepositoryConnection,
) {}
public function show(Request $request, Project $project): JsonResponse
{
$user = $this->authenticatedUser($request);
abort_unless(
$this->permissionService->allows($user, Permission::ProjectAdmin, $project),
403,
);
return response()->json([
'data' => $this->buildProjectRepositorySettingsPayload->handle($project, $user),
]);
}
public function store(StoreRepositoryConnectionRequest $request, Project $project): JsonResponse
{
$user = $this->authenticatedUser($request);
abort_unless(
$this->permissionService->allows($user, Permission::ProjectAdmin, $project),
403,
);
$repositoryConnection = $this->storeProjectRepositoryConnection->handle($project, $user, $request->validated());
return RepositoryConnectionResource::make($repositoryConnection)
->additional([
'meta' => [
'message' => "{$repositoryConnection->repository_full_name} was linked to {$project->name}.",
],
])
->response()
->setStatusCode(201);
}
public function update(
UpdateRepositoryConnectionRequest $request,
Project $project,
RepositoryConnection $repositoryConnection,
): JsonResponse {
$user = $this->authenticatedUser($request);
abort_unless(
$this->permissionService->allows($user, Permission::ProjectAdmin, $project),
403,
);
$repositoryConnection = $this->updateProjectRepositoryConnection->handle(
$project,
$repositoryConnection,
$user,
$request->validated(),
);
return RepositoryConnectionResource::make($repositoryConnection)
->additional([
'meta' => [
'message' => "{$repositoryConnection->repository_full_name} connection was updated.",
],
])
->response();
}
public function destroy(Request $request, Project $project, RepositoryConnection $repositoryConnection): JsonResponse
{
$user = $this->authenticatedUser($request);
abort_unless(
$this->permissionService->allows($user, Permission::ProjectAdmin, $project),
403,
);
$this->deleteProjectRepositoryConnection->handle($repositoryConnection);
return response()->json(null, 204);
}
}
@@ -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);
}
}
@@ -0,0 +1,183 @@
<?php
namespace App\Http\Controllers\Api;
use App\Actions\Permissions\PermissionService;
use App\Actions\Projects\BuildProjectTicketDetailPayload;
use App\Actions\Projects\BuildProjectTicketOptionsPayload;
use App\Actions\Projects\BuildProjectTicketStatusTargetsPayload;
use App\Actions\Tickets\CreateProjectTicket;
use App\Actions\Tickets\MoveProjectTicket;
use App\Actions\Tickets\UpdateProjectTicket;
use App\Enums\Permission;
use App\Http\Requests\Api\MoveProjectTicketRequest;
use App\Http\Requests\StoreProjectTicketRequest;
use App\Http\Requests\UpdateProjectTicketRequest;
use App\Http\Resources\TicketResource;
use App\Models\Project;
use App\Models\Ticket;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\Http\Resources\Json\AnonymousResourceCollection;
use Illuminate\Support\Arr;
class ProjectTicketController extends ApiController
{
public function __construct(
private readonly BuildProjectTicketDetailPayload $buildProjectTicketDetailPayload,
private readonly BuildProjectTicketOptionsPayload $buildProjectTicketOptionsPayload,
private readonly BuildProjectTicketStatusTargetsPayload $buildProjectTicketStatusTargetsPayload,
private readonly CreateProjectTicket $createProjectTicket,
private readonly MoveProjectTicket $moveProjectTicket,
private readonly PermissionService $permissionService,
private readonly UpdateProjectTicket $updateProjectTicket,
) {}
public function index(Request $request, Project $project): AnonymousResourceCollection
{
$user = $this->authenticatedUser($request);
abort_unless(
$this->permissionService->allows($user, Permission::ProjectRead, $project),
403,
);
return TicketResource::collection(
$project->tickets()
->with([
'ticketPriority',
'ticketStatus.allowedTargetStatuses.boardColumn',
'ticketStatus.boardColumn',
'ticketType',
])
->get(),
);
}
public function options(Request $request, Project $project): JsonResponse
{
$user = $this->authenticatedUser($request);
abort_unless(
$this->permissionService->allows($user, Permission::ProjectWrite, $project),
403,
);
return response()->json([
'data' => $this->buildProjectTicketOptionsPayload->handle(
$project,
Arr::get($request->query(), 'source') === 'board' ? 'board' : 'backlog',
),
]);
}
public function store(StoreProjectTicketRequest $request, Project $project): JsonResponse
{
$user = $this->authenticatedUser($request);
abort_unless(
$this->permissionService->allows($user, Permission::ProjectWrite, $project),
403,
);
$ticket = $this->createProjectTicket->handle($project, $request->validated(), $user);
return TicketResource::make($ticket->load(['ticketPriority', 'ticketStatus.boardColumn', 'ticketType']))
->additional([
'meta' => [
'message' => "{$ticket->ticket_key} was created.",
],
])
->response()
->setStatusCode(201);
}
public function show(Request $request, Project $project, Ticket $ticket): JsonResponse
{
$user = $this->authenticatedUser($request);
abort_unless(
$this->permissionService->allows($user, Permission::ProjectRead, $project),
403,
);
return response()->json([
'data' => $this->buildProjectTicketDetailPayload->handle($project, $ticket, $user),
]);
}
public function update(
UpdateProjectTicketRequest $request,
Project $project,
Ticket $ticket,
): JsonResponse {
$user = $this->authenticatedUser($request);
abort_unless(
$this->permissionService->allows($user, Permission::ProjectWrite, $project),
403,
);
$wasUpdated = $this->updateProjectTicket->handle($ticket, $user, $request->validated());
$statusMessage = $wasUpdated
? "{$ticket->ticket_key} was updated."
: 'No ticket changes were detected.';
return TicketResource::make($ticket->fresh()->load([
'assignee',
'author',
'fieldValues.ticketFieldDefinition',
'fieldValues.userValue',
'ticketPriority',
'ticketStatus.boardColumn',
'ticketType',
'worklogEntries.actor',
]))
->additional([
'meta' => [
'message' => $statusMessage,
],
])
->response();
}
public function statusTargets(Request $request, Project $project, Ticket $ticket): JsonResponse
{
$user = $this->authenticatedUser($request);
abort_unless(
$this->permissionService->allows($user, Permission::ProjectRead, $project),
403,
);
return response()->json([
'data' => $this->buildProjectTicketStatusTargetsPayload->handle($ticket),
]);
}
public function move(
MoveProjectTicketRequest $request,
Project $project,
Ticket $ticket,
): JsonResponse {
$user = $this->authenticatedUser($request);
abort_unless(
$this->permissionService->allows($user, Permission::ProjectWrite, $project),
403,
);
$result = $this->moveProjectTicket->handle($project, $ticket, $user, $request->validated());
$message = $result['moved']
? "{$ticket->ticket_key} moved to {$result['destination_label']}."
: "{$ticket->ticket_key} already belongs to {$result['destination_label']}.";
return TicketResource::make($ticket->fresh()->load(['ticketPriority', 'ticketStatus.boardColumn', 'ticketType']))
->additional([
'meta' => [
'message' => $message,
],
])
->response();
}
}
@@ -0,0 +1,67 @@
<?php
namespace App\Http\Controllers\Api;
use App\Actions\Permissions\PermissionService;
use App\Actions\Tickets\DeleteProjectTicketLink;
use App\Actions\Tickets\StoreProjectTicketLink;
use App\Enums\Permission;
use App\Http\Requests\StoreTicketLinkRequest;
use App\Http\Resources\TicketLinkResource;
use App\Models\Project;
use App\Models\Ticket;
use App\Models\TicketLink;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
class ProjectTicketLinkController extends ApiController
{
public function __construct(
private readonly DeleteProjectTicketLink $deleteProjectTicketLink,
private readonly PermissionService $permissionService,
private readonly StoreProjectTicketLink $storeProjectTicketLink,
) {}
public function store(
StoreTicketLinkRequest $request,
Project $project,
Ticket $ticket,
): JsonResponse {
$user = $this->authenticatedUser($request);
abort_unless(
$this->permissionService->allows($user, Permission::ProjectWrite, $project),
403,
);
$ticketLink = $this->storeProjectTicketLink->handle($project, $ticket, $user, $request->validated());
$ticketLink->setAttribute('current_ticket_id', $ticket->id);
return TicketLinkResource::make($ticketLink->load(['sourceTicket', 'targetTicket', 'ticketLinkType']))
->additional([
'meta' => [
'message' => "{$ticketLink->ticketLinkType->label} link was saved.",
],
])
->response()
->setStatusCode(201);
}
public function destroy(
Request $request,
Project $project,
Ticket $ticket,
TicketLink $ticketLink,
): JsonResponse {
$user = $this->authenticatedUser($request);
abort_unless(
$this->permissionService->allows($user, Permission::ProjectWrite, $project),
403,
);
$this->deleteProjectTicketLink->handle($ticket, $ticketLink, $user);
return response()->json(null, 204);
}
}
@@ -0,0 +1,254 @@
<?php
namespace App\Http\Controllers\Api;
use App\Actions\Permissions\PermissionService;
use App\Actions\Projects\BuildProjectTicketMetadataSettingsPayload;
use App\Actions\ProjectTicketMetadata\DeleteProjectTicketPriority;
use App\Actions\ProjectTicketMetadata\DeleteProjectTicketType;
use App\Actions\ProjectTicketMetadata\DeleteTicketFieldDefinition;
use App\Actions\ProjectTicketMetadata\DeleteTicketLinkType;
use App\Actions\ProjectTicketMetadata\StoreProjectTicketPriority;
use App\Actions\ProjectTicketMetadata\StoreProjectTicketType;
use App\Actions\ProjectTicketMetadata\StoreTicketFieldDefinition;
use App\Actions\ProjectTicketMetadata\StoreTicketLinkType;
use App\Actions\ProjectTicketMetadata\UpdateProjectTicketMetadataSettings;
use App\Actions\ProjectTicketMetadata\UpdateProjectTicketPriority;
use App\Actions\ProjectTicketMetadata\UpdateProjectTicketType;
use App\Actions\ProjectTicketMetadata\UpdateTicketFieldDefinition;
use App\Actions\ProjectTicketMetadata\UpdateTicketLinkType;
use App\Enums\Permission;
use App\Http\Requests\DestroyProjectTicketTypeRequest;
use App\Http\Requests\StoreProjectNamedSettingRequest;
use App\Http\Requests\StoreProjectTicketTypeRequest;
use App\Http\Requests\StoreTicketFieldDefinitionRequest;
use App\Http\Requests\UpdateProjectNamedSettingRequest;
use App\Http\Requests\UpdateProjectTicketMetadataSettings as UpdateProjectTicketMetadataSettingsRequest;
use App\Http\Requests\UpdateProjectTicketTypeRequest;
use App\Http\Requests\UpdateTicketFieldDefinitionRequest;
use App\Http\Resources\ProjectResource;
use App\Http\Resources\TicketFieldDefinitionResource;
use App\Http\Resources\TicketLinkTypeResource;
use App\Http\Resources\TicketPriorityResource;
use App\Http\Resources\TicketTypeResource;
use App\Models\Project;
use App\Models\TicketFieldDefinition;
use App\Models\TicketLinkType;
use App\Models\TicketPriority;
use App\Models\TicketType;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\Validation\ValidationException;
class ProjectTicketMetadataSettingsController extends ApiController
{
public function __construct(
private readonly BuildProjectTicketMetadataSettingsPayload $buildProjectTicketMetadataSettingsPayload,
private readonly DeleteProjectTicketPriority $deleteProjectTicketPriority,
private readonly DeleteProjectTicketType $deleteProjectTicketType,
private readonly DeleteTicketFieldDefinition $deleteTicketFieldDefinition,
private readonly DeleteTicketLinkType $deleteTicketLinkType,
private readonly PermissionService $permissionService,
private readonly StoreProjectTicketPriority $storeProjectTicketPriority,
private readonly StoreProjectTicketType $storeProjectTicketType,
private readonly StoreTicketFieldDefinition $storeTicketFieldDefinition,
private readonly StoreTicketLinkType $storeTicketLinkType,
private readonly UpdateProjectTicketMetadataSettings $updateProjectTicketMetadataSettings,
private readonly UpdateProjectTicketPriority $updateProjectTicketPriority,
private readonly UpdateProjectTicketType $updateProjectTicketType,
private readonly UpdateTicketFieldDefinition $updateTicketFieldDefinition,
private readonly UpdateTicketLinkType $updateTicketLinkType,
) {}
public function show(Request $request, Project $project): JsonResponse
{
$this->abortUnlessCanManage($request, $project);
return response()->json([
'data' => $this->buildProjectTicketMetadataSettingsPayload->handle($project),
]);
}
public function update(UpdateProjectTicketMetadataSettingsRequest $request, Project $project): JsonResponse
{
$this->abortUnlessCanManage($request, $project);
$project = $this->updateProjectTicketMetadataSettings->handle($project, $request->validated());
return ProjectResource::make($project)
->additional([
'meta' => [
'message' => 'Settings have been updated.',
],
])
->response();
}
public function storeType(StoreProjectTicketTypeRequest $request, Project $project): JsonResponse
{
$this->abortUnlessCanManage($request, $project);
$ticketType = $this->storeProjectTicketType->handle($project, $request->validated());
return TicketTypeResource::make($ticketType)
->additional(['meta' => ['message' => "{$ticketType->name} type was added."]])
->response()
->setStatusCode(201);
}
public function updateType(
UpdateProjectTicketTypeRequest $request,
Project $project,
TicketType $ticketType,
): JsonResponse {
$this->abortUnlessCanManage($request, $project);
$ticketType = $this->updateProjectTicketType->handle($project, $ticketType, $request->validated());
return TicketTypeResource::make($ticketType)
->additional(['meta' => ['message' => "{$ticketType->name} type was updated."]])
->response();
}
public function destroyType(
DestroyProjectTicketTypeRequest $request,
Project $project,
TicketType $ticketType,
): JsonResponse {
$this->abortUnlessCanManage($request, $project);
$result = $this->deleteProjectTicketType->handle(
$project,
$ticketType,
$this->authenticatedUser($request),
$request->validated(),
);
if (! $result['deleted']) {
throw ValidationException::withMessages([
'ticket_type_id' => $result['message'],
]);
}
return response()->json(null, 204);
}
public function storePriority(StoreProjectNamedSettingRequest $request, Project $project): JsonResponse
{
$this->abortUnlessCanManage($request, $project);
$ticketPriority = $this->storeProjectTicketPriority->handle($project, $request->validated());
return TicketPriorityResource::make($ticketPriority)
->additional(['meta' => ['message' => "{$ticketPriority->name} priority was added."]])
->response()
->setStatusCode(201);
}
public function updatePriority(
UpdateProjectNamedSettingRequest $request,
Project $project,
TicketPriority $ticketPriority,
): JsonResponse {
$this->abortUnlessCanManage($request, $project);
$ticketPriority = $this->updateProjectTicketPriority->handle($project, $ticketPriority, $request->validated());
return TicketPriorityResource::make($ticketPriority)
->additional(['meta' => ['message' => "{$ticketPriority->name} priority was updated."]])
->response();
}
public function destroyPriority(Request $request, Project $project, TicketPriority $ticketPriority): JsonResponse
{
$this->abortUnlessCanManage($request, $project);
$result = $this->deleteProjectTicketPriority->handle($project, $ticketPriority);
if (! $result['deleted']) {
throw ValidationException::withMessages([
'ticket_priority_id' => $result['message'],
]);
}
return response()->json(null, 204);
}
public function storeFieldDefinition(StoreTicketFieldDefinitionRequest $request, Project $project): JsonResponse
{
$this->abortUnlessCanManage($request, $project);
$ticketFieldDefinition = $this->storeTicketFieldDefinition->handle($project, $request->validated());
return TicketFieldDefinitionResource::make($ticketFieldDefinition)
->additional(['meta' => ['message' => "{$ticketFieldDefinition->label} field was added."]])
->response()
->setStatusCode(201);
}
public function updateFieldDefinition(
UpdateTicketFieldDefinitionRequest $request,
Project $project,
TicketFieldDefinition $ticketFieldDefinition,
): JsonResponse {
$this->abortUnlessCanManage($request, $project);
$ticketFieldDefinition = $this->updateTicketFieldDefinition->handle($project, $ticketFieldDefinition, $request->validated());
return TicketFieldDefinitionResource::make($ticketFieldDefinition)
->additional(['meta' => ['message' => "{$ticketFieldDefinition->label} field was updated."]])
->response();
}
public function destroyFieldDefinition(Request $request, Project $project, TicketFieldDefinition $ticketFieldDefinition): JsonResponse
{
$this->abortUnlessCanManage($request, $project);
$this->deleteTicketFieldDefinition->handle($project, $ticketFieldDefinition);
return response()->json(null, 204);
}
public function storeLinkType(StoreProjectNamedSettingRequest $request, Project $project): JsonResponse
{
$this->abortUnlessCanManage($request, $project);
$ticketLinkType = $this->storeTicketLinkType->handle($project, $request->validated());
return TicketLinkTypeResource::make($ticketLinkType)
->additional(['meta' => ['message' => "{$ticketLinkType->label} link type was added."]])
->response()
->setStatusCode(201);
}
public function updateLinkType(
UpdateProjectNamedSettingRequest $request,
Project $project,
TicketLinkType $ticketLinkType,
): JsonResponse {
$this->abortUnlessCanManage($request, $project);
$ticketLinkType = $this->updateTicketLinkType->handle($project, $ticketLinkType, $request->validated());
return TicketLinkTypeResource::make($ticketLinkType)
->additional(['meta' => ['message' => "{$ticketLinkType->label} link type was updated."]])
->response();
}
public function destroyLinkType(Request $request, Project $project, TicketLinkType $ticketLinkType): JsonResponse
{
$this->abortUnlessCanManage($request, $project);
$this->deleteTicketLinkType->handle($project, $ticketLinkType);
return response()->json(null, 204);
}
private function abortUnlessCanManage(Request $request, Project $project): void
{
abort_unless(
$this->permissionService->allows($this->authenticatedUser($request), Permission::ProjectAdmin, $project),
403,
);
}
}
@@ -0,0 +1,68 @@
<?php
namespace App\Http\Controllers\Api\Settings;
use App\Actions\UserGitConnections\DeleteUserGitConnection;
use App\Actions\UserGitConnections\StoreUserGitConnection;
use App\Actions\UserGitConnections\UpdateUserGitConnection;
use App\Http\Controllers\Api\ApiController;
use App\Http\Requests\Settings\StoreUserGitConnectionRequest;
use App\Http\Requests\Settings\UpdateUserGitConnectionRequest;
use App\Http\Resources\UserGitConnectionResource;
use App\Models\UserGitConnection;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\Http\Resources\Json\AnonymousResourceCollection;
class GitConnectionController extends ApiController
{
public function __construct(
private readonly DeleteUserGitConnection $deleteUserGitConnection,
private readonly StoreUserGitConnection $storeUserGitConnection,
private readonly UpdateUserGitConnection $updateUserGitConnection,
) {}
public function index(Request $request): AnonymousResourceCollection
{
return UserGitConnectionResource::collection(
$this->authenticatedUser($request)
->gitConnections()
->get(),
);
}
public function store(StoreUserGitConnectionRequest $request): JsonResponse
{
$gitConnection = $this->storeUserGitConnection->handle($this->authenticatedUser($request), $request->validated());
return UserGitConnectionResource::make($gitConnection)
->additional(['meta' => ['message' => 'Git connection was added.']])
->response()
->setStatusCode(201);
}
public function update(UpdateUserGitConnectionRequest $request, UserGitConnection $gitConnection): JsonResponse
{
$this->abortUnlessOwner($request, $gitConnection);
$gitConnection = $this->updateUserGitConnection->handle($gitConnection, $request->validated());
return UserGitConnectionResource::make($gitConnection)
->additional(['meta' => ['message' => 'Git connection was updated.']])
->response();
}
public function destroy(Request $request, UserGitConnection $gitConnection): JsonResponse
{
$this->abortUnlessOwner($request, $gitConnection);
$this->deleteUserGitConnection->handle($gitConnection);
return response()->json(null, 204);
}
private function abortUnlessOwner(Request $request, UserGitConnection $gitConnection): void
{
abort_unless($gitConnection->user_id === $this->authenticatedUser($request)->id, 403);
}
}
+12 -79
View File
@@ -3,15 +3,12 @@
namespace App\Http\Controllers;
use App\Actions\Permissions\PermissionService;
use App\Actions\Tickets\CreateTicketWorklogEntry;
use App\Actions\Projects\BuildProjectBoardPayload;
use App\Actions\Tickets\MoveProjectTicket;
use App\Enums\Permission;
use App\Enums\TicketWorklogEntryType;
use App\Http\Requests\MoveProjectTicketRequest;
use App\Http\Resources\BoardColumnResource;
use App\Http\Resources\ProjectResource;
use App\Models\Project;
use App\Models\Ticket;
use App\Models\TicketStatus;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Arr;
@@ -21,7 +18,8 @@ use Inertia\Response;
class ProjectBoardController extends Controller
{
public function __construct(
private readonly CreateTicketWorklogEntry $createTicketWorklogEntry,
private readonly BuildProjectBoardPayload $buildProjectBoardPayload,
private readonly MoveProjectTicket $moveProjectTicket,
private readonly PermissionService $permissionService,
) {}
@@ -34,28 +32,10 @@ class ProjectBoardController extends Controller
403,
);
$canManageTickets = $this->permissionService->allows($user, Permission::ProjectWrite, $project);
return Inertia::render('projects/Board', [
'boardColumns' => BoardColumnResource::collection(
$project->boardColumns()
->with([
'ticketStatuses',
'tickets' => fn ($query) => $query
->with([
'ticketPriority',
'ticketStatus.allowedTargetStatuses.boardColumn',
'ticketStatus.boardColumn',
'ticketType',
]),
])
->get(),
)->resolve(),
'canCreateTickets' => $canManageTickets,
'canEditTickets' => $canManageTickets,
'project' => ProjectResource::make($project)->resolve(),
'status' => session('status'),
]);
return Inertia::render(
'projects/Board',
$this->buildProjectBoardPayload->handle($project, $user, session('status')),
);
}
public function move(
@@ -71,65 +51,18 @@ class ProjectBoardController extends Controller
);
$validated = $request->validated();
$ticketStatusId = (int) Arr::get($validated, 'ticket_status_id');
$redirectRoute = Arr::get($validated, 'redirect_to') === 'backlog'
? 'projects.backlog.index'
: 'projects.board.index';
$destinationStatus = $project->ticketStatuses()
->with('boardColumn')
->findOrFail($ticketStatusId);
$result = $this->moveProjectTicket->handle($project, $ticket, $user, $validated);
$ticket->loadMissing('ticketStatus.boardColumn');
$originStatusId = $ticket->ticket_status_id;
$originLabel = $this->statusLabel($ticket->ticketStatus);
$destinationLabel = $this->statusLabel($destinationStatus);
if ($ticket->ticket_status_id === $ticketStatusId) {
if (! $result['moved']) {
return to_route($redirectRoute, $project)
->with('status', "{$ticket->ticket_key} already belongs to {$destinationLabel}.");
->with('status', "{$ticket->ticket_key} already belongs to {$result['destination_label']}.");
}
$ticket->update([
'ticket_status_id' => $destinationStatus->id,
]);
$this->createTicketWorklogEntry->handle(
$ticket->fresh(),
$user,
TicketWorklogEntryType::StatusChanged,
"Moved from {$originLabel} to {$destinationLabel}.",
[
'from' => [
'label' => $originLabel,
'ticket_status_id' => $originStatusId,
],
'to' => [
'label' => $destinationLabel,
'ticket_status_id' => $destinationStatus->id,
],
],
);
return to_route($redirectRoute, $project)
->with('status', "{$ticket->ticket_key} moved to {$destinationLabel}.");
}
private function statusLabel(?TicketStatus $ticketStatus): string
{
if ($ticketStatus === null) {
return 'Unknown status';
}
if ($ticketStatus->boardColumn === null) {
return $ticketStatus->name;
}
if ($ticketStatus->boardColumn->name === $ticketStatus->name) {
return $ticketStatus->name;
}
return "{$ticketStatus->boardColumn->name} / {$ticketStatus->name}";
->with('status', "{$ticket->ticket_key} moved to {$result['destination_label']}.");
}
}
@@ -3,31 +3,40 @@
namespace App\Http\Controllers;
use App\Actions\Permissions\PermissionService;
use App\Actions\ProjectBoard\DeleteBoardColumn;
use App\Actions\ProjectBoard\DeleteTicketStatus;
use App\Actions\ProjectBoard\StoreBoardColumn;
use App\Actions\ProjectBoard\StoreTicketStatus;
use App\Actions\ProjectBoard\UpdateBoardColumn;
use App\Actions\ProjectBoard\UpdateTicketStatus;
use App\Actions\ProjectBoard\UpdateTicketStatusTransitions;
use App\Actions\Projects\BuildProjectBoardSettingsPayload;
use App\Enums\Permission;
use App\Http\Requests\StoreBoardColumnRequest;
use App\Http\Requests\StoreTicketStatusRequest;
use App\Http\Requests\UpdateBoardColumnRequest;
use App\Http\Requests\UpdateTicketStatusRequest;
use App\Http\Requests\UpdateTicketStatusTransitionsRequest;
use App\Http\Resources\BoardColumnResource;
use App\Http\Resources\ProjectResource;
use App\Http\Resources\TicketStatusResource;
use App\Models\BoardColumn;
use App\Models\Project;
use App\Models\TicketStatus;
use Illuminate\Database\Eloquent\Relations\HasMany;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Arr;
use Illuminate\Support\Collection;
use Illuminate\Support\Facades\DB;
use Inertia\Inertia;
use Inertia\Response;
class ProjectBoardSettingsController extends Controller
{
public function __construct(
private readonly BuildProjectBoardSettingsPayload $buildProjectBoardSettingsPayload,
private readonly DeleteBoardColumn $deleteBoardColumn,
private readonly DeleteTicketStatus $deleteTicketStatus,
private readonly PermissionService $permissionService,
private readonly StoreBoardColumn $storeBoardColumn,
private readonly StoreTicketStatus $storeTicketStatus,
private readonly UpdateBoardColumn $updateBoardColumn,
private readonly UpdateTicketStatus $updateTicketStatus,
private readonly UpdateTicketStatusTransitions $updateTicketStatusTransitions,
) {}
public function show(Request $request, Project $project): Response
@@ -37,25 +46,10 @@ class ProjectBoardSettingsController extends Controller
403,
);
return Inertia::render('projects/settings/Board', [
'backlogTicketStatuses' => TicketStatusResource::collection(
$project->ticketStatuses()
->whereNull('board_column_id')
->get(),
)->resolve(),
'boardColumns' => BoardColumnResource::collection(
$project->boardColumns()
->with('ticketStatuses')
->get(),
)->resolve(),
'project' => ProjectResource::make($project)->resolve(),
'status' => session('status'),
'ticketStatuses' => TicketStatusResource::collection(
$project->ticketStatuses()
->with(['allowedTargetStatuses.boardColumn', 'boardColumn'])
->get(),
)->resolve(),
]);
return Inertia::render(
'projects/settings/Board',
$this->buildProjectBoardSettingsPayload->handle($project, session('status')),
);
}
public function store(
@@ -66,25 +60,7 @@ class ProjectBoardSettingsController extends Controller
$this->permissionService->allows($request->user(), Permission::ProjectAdmin, $project),
403,
);
$validated = $request->validated();
$desiredPosition = Arr::get($validated, 'position') ?? $project->boardColumns()->count() + 1;
$boardColumn = DB::transaction(function () use ($project, $validated, $desiredPosition): BoardColumn {
$boardColumn = $project->boardColumns()->create([
'name' => Arr::get($validated, 'name'),
'position' => $project->boardColumns()->count() + 1,
]);
$boardColumn->ticketStatuses()->create([
'name' => Arr::get($validated, 'name'),
'position' => 1,
'project_id' => $project->id,
]);
$this->reorderColumns($project, $boardColumn, $desiredPosition);
return $boardColumn;
});
$boardColumn = $this->storeBoardColumn->handle($project, $request->validated());
return to_route('projects.settings.board', $project)
->with('status', "{$boardColumn->name} was added to the board workflow.");
@@ -99,15 +75,7 @@ class ProjectBoardSettingsController extends Controller
$this->permissionService->allows($request->user(), Permission::ProjectAdmin, $project),
403,
);
$validated = $request->validated();
DB::transaction(function () use ($boardColumn, $project, $validated): void {
$boardColumn->update([
'name' => Arr::get($validated, 'name'),
]);
$this->reorderColumns($project, $boardColumn, Arr::get($validated, 'position'));
});
$boardColumn = $this->updateBoardColumn->handle($project, $boardColumn, $request->validated());
return to_route('projects.settings.board', $project)
->with('status', "{$boardColumn->fresh()->name} was updated.");
@@ -123,22 +91,7 @@ class ProjectBoardSettingsController extends Controller
403,
);
$deletedName = $boardColumn->name;
DB::transaction(function () use ($boardColumn, $project): void {
$boardColumn->ticketStatuses()
->get()
->each(function (TicketStatus $ticketStatus) use ($project): void {
$ticketStatus->update([
'board_column_id' => null,
'position' => $this->nextStatusPosition($project, null),
]);
});
$boardColumn->delete();
$this->normalizeColumnPositions($project);
});
$deletedName = $this->deleteBoardColumn->handle($project, $boardColumn);
return to_route('projects.settings.board', $project)
->with('status', "{$deletedName} was removed from the board workflow.");
@@ -152,19 +105,7 @@ class ProjectBoardSettingsController extends Controller
$this->permissionService->allows($request->user(), Permission::ProjectAdmin, $project),
403,
);
$validated = $request->validated();
$boardColumnId = Arr::get($validated, 'board_column_id');
$boardColumnId = $boardColumnId === null ? null : (int) $boardColumnId;
$ticketStatus = DB::transaction(function () use ($boardColumnId, $project, $validated): TicketStatus {
return $project->ticketStatuses()->create([
'board_column_id' => $boardColumnId,
'name' => Arr::get($validated, 'name'),
'position' => $this->nextStatusPosition($project, $boardColumnId),
]);
});
$ticketStatus->load('boardColumn');
$ticketStatus = $this->storeTicketStatus->handle($project, $request->validated());
return to_route('projects.settings.board', $project)
->with('status', "{$ticketStatus->name} was added to {$this->statusContextLabel($ticketStatus)}.");
@@ -179,11 +120,7 @@ class ProjectBoardSettingsController extends Controller
$this->permissionService->allows($request->user(), Permission::ProjectAdmin, $project),
403,
);
$validated = $request->validated();
$ticketStatus->update([
'name' => Arr::get($validated, 'name'),
]);
$ticketStatus = $this->updateTicketStatus->handle($ticketStatus, $request->validated());
return to_route('projects.settings.board', $project)
->with('status', "{$ticketStatus->fresh()->name} was updated.");
@@ -199,35 +136,10 @@ class ProjectBoardSettingsController extends Controller
403,
);
$ticketStatus->load('boardColumn');
$boardColumnId = $ticketStatus->board_column_id;
if ($this->statusContextQuery($project, $boardColumnId)->count() <= 1) {
return to_route('projects.settings.board', $project)
->withErrors([
'ticket_status_id' => "{$this->statusContextLabel($ticketStatus)} needs at least one ticket status.",
]);
}
$deletedName = $ticketStatus->name;
$contextLabel = $this->statusContextLabel($ticketStatus);
DB::transaction(function () use ($boardColumnId, $project, $ticketStatus): void {
$replacementStatus = $this->statusContextQuery($project, $boardColumnId)
->whereKeyNot($ticketStatus->id)
->firstOrFail();
$ticketStatus->tickets()->update([
'ticket_status_id' => $replacementStatus->id,
]);
$ticketStatus->delete();
$this->normalizeStatusPositions($project, $boardColumnId);
});
$result = $this->deleteTicketStatus->handle($project, $ticketStatus);
return to_route('projects.settings.board', $project)
->with('status', "{$deletedName} was removed from {$contextLabel}.");
->with('status', "{$result['deleted_name']} was removed from {$result['context_label']}.");
}
public function updateStatusTransitions(
@@ -239,92 +151,14 @@ class ProjectBoardSettingsController extends Controller
$this->permissionService->allows($request->user(), Permission::ProjectAdmin, $project),
403,
);
$validated = $request->validated();
$allowedTicketStatusIds = collect(Arr::get($validated, 'allowed_ticket_status_ids', []))
->map(fn (int|string $ticketStatusId): int => (int) $ticketStatusId)
->unique()
->values()
->all();
$ticketStatus->allowedTargetStatuses()->sync($allowedTicketStatusIds);
$this->updateTicketStatusTransitions->handle($ticketStatus, $request->validated());
return to_route('projects.settings.board', $project)
->with('status', "{$ticketStatus->name} move targets were updated.");
}
private function normalizeColumnPositions(Project $project): void
{
$this->persistOrderedColumns(
$project->boardColumns()
->get()
->values(),
);
}
private function reorderColumns(Project $project, BoardColumn $movingColumn, int $desiredPosition): void
{
/** @var Collection<int, BoardColumn> $columns */
$columns = $project->boardColumns()
->whereKeyNot($movingColumn->id)
->get()
->values();
$insertAt = max(0, min($desiredPosition - 1, $columns->count()));
$columns->splice($insertAt, 0, [$movingColumn]);
$this->persistOrderedColumns($columns->values());
}
/**
* @param Collection<int, BoardColumn> $columns
*/
private function persistOrderedColumns(Collection $columns): void
{
$temporaryOffset = ((int) $columns->max('position')) + $columns->count() + 1;
$columns->each(function (BoardColumn $column, int $index) use ($temporaryOffset): void {
$column->forceFill([
'position' => $temporaryOffset + $index,
])->saveQuietly();
});
$columns->each(function (BoardColumn $column, int $index): void {
$column->forceFill([
'position' => $index + 1,
])->saveQuietly();
});
}
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),
);
}
}
+15 -68
View File
@@ -3,7 +3,10 @@
namespace App\Http\Controllers;
use App\Actions\Permissions\PermissionService;
use App\Actions\ProjectTicketMetadata\InitializeProjectTicketMetadata;
use App\Actions\Projects\BuildProjectBacklogPayload;
use App\Actions\Projects\CreateProject;
use App\Actions\Projects\DeleteProject;
use App\Actions\Projects\ListVisibleProjects;
use App\Enums\Permission;
use App\Http\Requests\DeleteProjectRequest;
use App\Http\Requests\StoreProjectRequest;
@@ -11,14 +14,9 @@ use App\Http\Requests\SyncProjectPermissionsRequest;
use App\Http\Resources\PermissionOptionResource;
use App\Http\Resources\ProjectResource;
use App\Http\Resources\TeamResource;
use App\Http\Resources\TicketPriorityResource;
use App\Http\Resources\TicketResource;
use App\Http\Resources\TicketStatusResource;
use App\Http\Resources\TicketTypeResource;
use App\Http\Resources\UserResource;
use App\Models\Project;
use App\Models\Team;
use App\Models\Ticket;
use App\Models\User;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
@@ -29,7 +27,10 @@ use Inertia\Response;
class ProjectController extends Controller
{
public function __construct(
private readonly InitializeProjectTicketMetadata $initializeProjectTicketMetadata,
private readonly BuildProjectBacklogPayload $buildProjectBacklogPayload,
private readonly CreateProject $createProject,
private readonly DeleteProject $deleteProject,
private readonly ListVisibleProjects $listVisibleProjects,
private readonly PermissionService $permissionService,
) {}
@@ -37,24 +38,8 @@ class ProjectController extends Controller
{
$user = $request->user();
$projectQuery = Project::query()
->orderByDesc('id');
if (! $this->permissionService->allows($user, Permission::GlobalAdmin)) {
$viewableProjectIds = $this->permissionService->viewableProjectIds($user);
if ($viewableProjectIds === []) {
return Inertia::render('projects/Index', [
'projects' => ProjectResource::collection(collect())->resolve(),
'status' => session('status'),
]);
}
$projectQuery->whereIn('id', $viewableProjectIds);
}
return Inertia::render('projects/Index', [
'projects' => ProjectResource::collection($projectQuery->get())->resolve(),
'projects' => ProjectResource::collection($this->listVisibleProjects->handle($user))->resolve(),
'status' => session('status'),
]);
}
@@ -71,9 +56,7 @@ class ProjectController extends Controller
public function store(StoreProjectRequest $request): RedirectResponse
{
$project = Project::query()->create($request->validated());
$this->initializeProjectTicketMetadata->handle($project);
$this->permissionService->grant($request->user(), Permission::ProjectAdmin, $project);
$project = $this->createProject->handle($request->validated(), $request->user());
return to_route('projects.show', $project);
}
@@ -102,44 +85,10 @@ class ProjectController extends Controller
403,
);
$canManageTickets = $this->permissionService->allows($user, Permission::ProjectWrite, $project);
return Inertia::render('projects/Backlog', [
'backlogTicketStatuses' => TicketStatusResource::collection(
$project->ticketStatuses()
->whereNull('board_column_id')
->get(),
)->resolve(),
'canCreateTickets' => $canManageTickets,
'canEditTickets' => $canManageTickets,
'project' => ProjectResource::make($project)->resolve(),
'status' => session('status'),
'ticketStatusOptions' => TicketStatusResource::collection(
$project->ticketStatuses()
->with('boardColumn')
->get(),
)->resolve(),
'ticketPriorities' => TicketPriorityResource::collection($project->ticketPriorities()->get())->resolve(),
'ticketTypes' => TicketTypeResource::collection($project->ticketTypes()->get())->resolve(),
'tickets' => TicketResource::collection(
Ticket::query()
->with([
'ticketPriority',
'ticketStatus.allowedTargetStatuses.boardColumn',
'ticketStatus.boardColumn',
'ticketType',
])
->where('project_id', $project->id)
->whereHas('ticketStatus', fn ($query) => $query->whereNull('board_column_id'))
->orderByDesc('sequence_number')
->get(),
)->resolve(),
'users' => UserResource::collection(
User::query()
->orderBy('name')
->get(),
)->resolve(),
]);
return Inertia::render(
'projects/Backlog',
$this->buildProjectBacklogPayload->handle($project, $user, session('status')),
);
}
public function general(Request $request, Project $project): Response
@@ -223,9 +172,7 @@ class ProjectController extends Controller
{
$request->validated();
$projectName = $project->name;
$project->delete();
$projectName = $this->deleteProject->handle($project);
return to_route('projects.index')
->with('status', "Project {$projectName} was deleted.");
@@ -2,33 +2,29 @@
namespace App\Http\Controllers;
use App\Actions\Git\Data\GitRepository;
use App\Actions\Git\GitProviderManager;
use App\Actions\Permissions\PermissionService;
use App\Actions\Repositories\BuildProjectRepositorySettingsPayload;
use App\Actions\Repositories\DeleteProjectRepositoryConnection;
use App\Actions\Repositories\StoreProjectRepositoryConnection;
use App\Actions\Repositories\UpdateProjectRepositoryConnection;
use App\Enums\Permission;
use App\Http\Requests\StoreRepositoryConnectionRequest;
use App\Http\Requests\UpdateRepositoryConnectionRequest;
use App\Http\Resources\AvailableGitRepositorySourceResource;
use App\Http\Resources\ProjectResource;
use App\Http\Resources\RepositoryConnectionResource;
use App\Models\Project;
use App\Models\RepositoryConnection;
use App\Models\User;
use App\Models\UserGitConnection;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Arr;
use Illuminate\Support\Collection;
use Illuminate\Validation\ValidationException;
use Inertia\Inertia;
use Inertia\Response;
use Throwable;
class ProjectRepositorySettingsController extends Controller
{
public function __construct(
private readonly GitProviderManager $gitProviderManager,
private readonly BuildProjectRepositorySettingsPayload $buildProjectRepositorySettingsPayload,
private readonly DeleteProjectRepositoryConnection $deleteProjectRepositoryConnection,
private readonly PermissionService $permissionService,
private readonly StoreProjectRepositoryConnection $storeProjectRepositoryConnection,
private readonly UpdateProjectRepositoryConnection $updateProjectRepositoryConnection,
) {}
public function show(Request $request, Project $project): Response
@@ -39,23 +35,10 @@ class ProjectRepositorySettingsController extends Controller
403,
);
$repositoryConnections = $project->repositoryConnections()
->get()
->each(function (RepositoryConnection $repositoryConnection) use ($user): void {
$repositoryConnection->setAttribute(
'has_personal_access',
$this->hasPersonalAccess($user, $repositoryConnection),
);
});
return Inertia::render('projects/settings/Repositories', [
'availableRepositorySources' => AvailableGitRepositorySourceResource::collection(
$this->availableRepositorySources($user),
)->resolve(),
'project' => ProjectResource::make($project)->resolve(),
'repositoryConnections' => RepositoryConnectionResource::collection($repositoryConnections)->resolve(),
'status' => session('status'),
]);
return Inertia::render(
'projects/settings/Repositories',
$this->buildProjectRepositorySettingsPayload->handle($project, $user, session('status')),
);
}
public function store(
@@ -68,19 +51,7 @@ class ProjectRepositorySettingsController extends Controller
403,
);
$validated = $request->validated();
$userGitConnectionId = Arr::get($validated, 'user_git_connection_id');
$providerRepositoryId = Arr::get($validated, 'provider_repository_id');
$repositoryAttributes = $this->repositoryAttributesForSelection(
$user,
$userGitConnectionId,
$providerRepositoryId,
);
$this->ensureRepositoryConnectionIsUnique($project, $repositoryAttributes);
$repositoryConnection = $project->repositoryConnections()->create($repositoryAttributes);
$repositoryConnection = $this->storeProjectRepositoryConnection->handle($project, $user, $request->validated());
return to_route('projects.settings.repositories', $project)
->with('status', "{$repositoryConnection->repository_full_name} was linked to {$project->name}.");
@@ -98,24 +69,13 @@ class ProjectRepositorySettingsController extends Controller
403,
);
$validated = $request->validated();
$userGitConnectionId = Arr::get($validated, 'user_git_connection_id');
$providerRepositoryId = Arr::get($validated, 'provider_repository_id');
$repositoryAttributes = $this->repositoryAttributesForSelection(
$user,
$userGitConnectionId,
$providerRepositoryId,
);
$this->ensureRepositoryConnectionIsUnique(
$repositoryConnection = $this->updateProjectRepositoryConnection->handle(
$project,
$repositoryAttributes,
$repositoryConnection,
$user,
$request->validated(),
);
$repositoryConnection->update($repositoryAttributes);
return to_route('projects.settings.repositories', $project)
->with('status', "{$repositoryConnection->fresh()->repository_full_name} connection was updated.");
}
@@ -130,178 +90,9 @@ class ProjectRepositorySettingsController extends Controller
403,
);
$repositoryLabel = $repositoryConnection->repository_full_name;
$repositoryConnection->delete();
$repositoryLabel = $this->deleteProjectRepositoryConnection->handle($repositoryConnection);
return to_route('projects.settings.repositories', $project)
->with('status', "{$repositoryLabel} was removed from the project.");
}
/**
* @return array<int, array{
* account_login: string,
* account_name: string|null,
* base_url: string,
* error: string|null,
* provider: string,
* provider_label: string,
* repositories: array<int, array{
* full_name: string,
* owner_name: string,
* provider_repository_id: string,
* repository_name: string,
* repository_url: string,
* visibility_label: string
* }>,
* user_git_connection_id: int
* }>
*/
private function availableRepositorySources(User $user): array
{
/** @var Collection<int, UserGitConnection> $gitConnections */
$gitConnections = $user->gitConnections()
->get();
return $gitConnections
->map(function (UserGitConnection $gitConnection): array {
try {
$repositories = collect(
$this->gitProviderManager
->client($gitConnection->provider)
->listRepositories($gitConnection->base_url, $gitConnection->api_token),
)
->map(fn (GitRepository $repository): array => [
'full_name' => $repository->fullName,
'owner_name' => $repository->owner,
'provider_repository_id' => $repository->providerRepositoryId,
'repository_name' => $repository->name,
'repository_url' => $repository->htmlUrl,
'visibility_label' => $repository->isPrivate ? 'Private' : 'Public',
])
->sortBy('full_name')
->values()
->all();
$error = null;
} catch (Throwable) {
$repositories = [];
$error = sprintf('%s could not load repositories from this Git connection right now.', config('app.name'));
}
return [
'account_login' => $gitConnection->account_login,
'account_name' => $gitConnection->account_name,
'base_url' => $gitConnection->base_url,
'error' => $error,
'provider' => $gitConnection->provider->value,
'provider_label' => $gitConnection->provider->label(),
'repositories' => $repositories,
'user_git_connection_id' => $gitConnection->id,
];
})
->values()
->all();
}
/**
* @param array{
* base_url: string,
* owner_name: string,
* provider: string,
* provider_repository_id: string,
* repository_full_name: string,
* repository_name: string,
* repository_url: string
* } $repositoryAttributes
*/
private function ensureRepositoryConnectionIsUnique(
Project $project,
array $repositoryAttributes,
?RepositoryConnection $repositoryConnection = null,
): void {
$query = $project->repositoryConnections()
->where('provider', $repositoryAttributes['provider'])
->where('base_url', $repositoryAttributes['base_url'])
->where('provider_repository_id', $repositoryAttributes['provider_repository_id']);
if ($repositoryConnection !== null) {
$query->whereKeyNot($repositoryConnection->id);
}
if ($query->exists()) {
throw ValidationException::withMessages([
'provider_repository_id' => 'This repository is already linked to the project.',
]);
}
}
private function hasPersonalAccess(User $user, RepositoryConnection $repositoryConnection): bool
{
return $user->gitConnections()
->where('provider', $repositoryConnection->provider)
->where('base_url', $repositoryConnection->base_url)
->exists();
}
/**
* @return array{
* base_url: string,
* owner_name: string,
* provider: string,
* provider_repository_id: string,
* repository_full_name: string,
* repository_name: string,
* repository_url: string
* }
*/
private function repositoryAttributesForSelection(
User $user,
int $userGitConnectionId,
string $providerRepositoryId,
): array {
$userGitConnection = $this->ownedUserGitConnection($user, $userGitConnectionId);
$repository = $this->repositoryFromConnection(
$userGitConnection,
$providerRepositoryId,
);
if ($repository === null) {
throw ValidationException::withMessages([
'provider_repository_id' => 'The selected repository is not available through this Git connection.',
]);
}
return [
'base_url' => $userGitConnection->base_url,
'owner_name' => $repository->owner,
'provider' => $userGitConnection->provider,
'provider_repository_id' => $repository->providerRepositoryId,
'repository_full_name' => $repository->fullName,
'repository_name' => $repository->name,
'repository_url' => $repository->htmlUrl,
];
}
private function ownedUserGitConnection(User $user, int $userGitConnectionId): UserGitConnection
{
$userGitConnection = UserGitConnection::query()->findOrFail($userGitConnectionId);
abort_unless($userGitConnection->user_id === $user->id, 403);
return $userGitConnection;
}
private function repositoryFromConnection(
UserGitConnection $userGitConnection,
string $providerRepositoryId,
): ?GitRepository {
return collect(
$this->gitProviderManager
->client($userGitConnection->provider)
->listRepositories($userGitConnection->base_url, $userGitConnection->api_token),
)
->first(fn (GitRepository $repository): bool => $repository->providerRepositoryId === $providerRepositoryId);
}
}
@@ -2,29 +2,23 @@
namespace App\Http\Controllers;
use App\Actions\Git\Data\GitBranch;
use App\Actions\Git\GitProviderManager;
use App\Actions\Git\ValidateGitBranchName;
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\RepositoryConnection;
use App\Models\Ticket;
use App\Models\UserGitConnection;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\RedirectResponse;
use Illuminate\Support\Arr;
use Illuminate\Validation\ValidationException;
use Throwable;
class ProjectTicketBranchController extends Controller
{
public function __construct(
private readonly GitProviderManager $gitProviderManager,
private readonly ValidateGitBranchName $validateGitBranchName,
private readonly CreateProjectTicketBranch $createProjectTicketBranch,
private readonly PermissionService $permissionService,
private readonly ValidateProjectTicketBranch $validateProjectTicketBranch,
) {}
public function validate(
@@ -39,65 +33,9 @@ class ProjectTicketBranchController extends Controller
403,
);
$validated = $request->validated();
$repositoryConnectionId = Arr::get($validated, 'repository_connection_id');
$branchName = trim((string) Arr::get($validated, 'branch_name'));
$repositoryConnection = $this->projectRepositoryConnection(
$project,
$repositoryConnectionId,
return response()->json(
$this->validateProjectTicketBranch->handle($project, $ticket, $user, $request->validated()),
);
$userGitConnection = $this->matchingUserGitConnection(
$user->id,
$repositoryConnection,
);
if ($userGitConnection === null) {
return response()->json([
'is_valid' => false,
'message' => 'Connect a matching Git connection in your user settings first.',
]);
}
$syntaxMessage = $this->validateGitBranchName->message($branchName);
if ($syntaxMessage !== null) {
return response()->json([
'is_valid' => false,
'message' => $syntaxMessage,
]);
}
try {
$branchAlreadyExists = collect(
$this->gitProviderManager
->client($userGitConnection->provider)
->listBranches(
$userGitConnection->api_token,
$repositoryConnection->toGitRepository(),
),
)
->contains(
fn (GitBranch $branch): bool => $branch->name === $branchName,
);
} catch (Throwable) {
return response()->json([
'is_valid' => false,
'message' => sprintf('%s could not validate this branch name right now.', config('app.name')),
]);
}
if ($branchAlreadyExists) {
return response()->json([
'is_valid' => false,
'message' => 'This branch name already exists in the selected repository.',
]);
}
return response()->json([
'is_valid' => true,
'message' => "Branch name is available for {$ticket->ticket_key}.",
]);
}
public function store(
@@ -113,100 +51,12 @@ class ProjectTicketBranchController extends Controller
403,
);
$validated = $request->validated();
$repositoryConnectionId = Arr::get($validated, 'repository_connection_id');
$branchName = trim((string) Arr::get($validated, 'branch_name'));
$repositoryConnection = $this->projectRepositoryConnection(
$project,
$repositoryConnectionId,
);
$userGitConnection = $this->matchingUserGitConnection(
$user->id,
$repositoryConnection,
);
if ($userGitConnection === null) {
throw ValidationException::withMessages([
'repository_connection_id' => 'Connect a matching Git connection in your user settings first.',
]);
}
$syntaxMessage = $this->validateGitBranchName->message($branchName);
if ($syntaxMessage !== null) {
throw ValidationException::withMessages([
'branch_name' => $syntaxMessage,
]);
}
$gitProvider = $this->gitProviderManager->client($userGitConnection->provider);
try {
$branchAlreadyExists = collect(
$gitProvider->listBranches(
$userGitConnection->api_token,
$repositoryConnection->toGitRepository(),
),
)
->contains(
fn (GitBranch $branch): bool => $branch->name === $branchName,
);
} catch (Throwable) {
throw ValidationException::withMessages([
'branch_name' => sprintf('%s could not validate this branch name right now.', config('app.name')),
]);
}
if ($branchAlreadyExists) {
throw ValidationException::withMessages([
'branch_name' => 'This branch name already exists in the selected repository.',
]);
}
try {
$repository = $gitProvider->getRepository(
$userGitConnection->base_url,
$userGitConnection->api_token,
$repositoryConnection->owner_name,
$repositoryConnection->repository_name,
);
$gitProvider->createBranch(
$userGitConnection->base_url,
$userGitConnection->api_token,
$repositoryConnection->owner_name,
$repositoryConnection->repository_name,
$branchName,
$repository->defaultBranch,
);
} catch (Throwable) {
throw ValidationException::withMessages([
'branch_name' => sprintf('%s could not create this branch right now.', config('app.name')),
]);
}
$result = $this->createProjectTicketBranch->handle($project, $ticket, $user, $request->validated());
return to_route('projects.tickets.show', [$project, $ticket])
->with(
'status',
"{$branchName} was created in {$repositoryConnection->repository_full_name}.",
"{$result['branch_name']} was created in {$result['repository_full_name']}.",
);
}
private function projectRepositoryConnection(Project $project, int $repositoryConnectionId): RepositoryConnection
{
return $project->repositoryConnections()
->findOrFail($repositoryConnectionId);
}
private function matchingUserGitConnection(
int $userId,
RepositoryConnection $repositoryConnection,
): ?UserGitConnection {
return UserGitConnection::query()
->where('user_id', $userId)
->where('provider', $repositoryConnection->provider)
->where('base_url', $repositoryConnection->base_url)
->first();
}
}
+16 -130
View File
@@ -2,32 +2,16 @@
namespace App\Http\Controllers;
use App\Actions\Git\BuildSuggestedTicketBranchName;
use App\Actions\Git\ResolveTicketBranchMatches;
use App\Actions\Git\ResolveTicketPullRequestMatches;
use App\Actions\Permissions\PermissionService;
use App\Actions\Projects\BuildProjectTicketDetailPayload;
use App\Actions\Projects\BuildProjectTicketOptionsPayload;
use App\Actions\Tickets\CreateProjectTicket;
use App\Actions\Tickets\UpdateProjectTicket;
use App\Enums\Permission;
use App\Http\Requests\StoreProjectTicketRequest;
use App\Http\Requests\UpdateProjectTicketRequest;
use App\Http\Resources\ProjectResource;
use App\Http\Resources\TicketFieldDefinitionResource;
use App\Http\Resources\TicketLinkResource;
use App\Http\Resources\TicketLinkTypeResource;
use App\Http\Resources\TicketPriorityResource;
use App\Http\Resources\TicketReferenceResource;
use App\Http\Resources\TicketRepositoryBranchResource;
use App\Http\Resources\TicketRepositoryPullRequestResource;
use App\Http\Resources\TicketResource;
use App\Http\Resources\TicketStatusResource;
use App\Http\Resources\TicketTreeNodeResource;
use App\Http\Resources\TicketTypeResource;
use App\Http\Resources\UserResource;
use App\Models\Project;
use App\Models\Ticket;
use App\Models\TicketLink;
use App\Models\User;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Arr;
@@ -37,11 +21,10 @@ use Inertia\Response;
class ProjectTicketController extends Controller
{
public function __construct(
private readonly BuildSuggestedTicketBranchName $buildSuggestedTicketBranchName,
private readonly BuildProjectTicketDetailPayload $buildProjectTicketDetailPayload,
private readonly BuildProjectTicketOptionsPayload $buildProjectTicketOptionsPayload,
private readonly CreateProjectTicket $createProjectTicket,
private readonly PermissionService $permissionService,
private readonly ResolveTicketBranchMatches $resolveTicketBranchMatches,
private readonly ResolveTicketPullRequestMatches $resolveTicketPullRequestMatches,
private readonly UpdateProjectTicket $updateProjectTicket,
) {}
@@ -54,33 +37,14 @@ class ProjectTicketController extends Controller
403,
);
$source = Arr::get($request->query(), 'source') === 'board'
? 'board'
: 'backlog';
$defaultTicketStatus = $source === 'board'
? $project->ticketStatuses()->whereNotNull('board_column_id')->first()
: $project->ticketStatuses()->whereNull('board_column_id')->first();
$defaultTicketStatus ??= $project->ticketStatuses()->first();
return Inertia::render('projects/TicketCreate', [
'defaultTicketStatusId' => $defaultTicketStatus?->id,
'project' => ProjectResource::make($project)->resolve(),
'source' => $source,
'status' => session('status'),
'ticketPriorities' => TicketPriorityResource::collection($project->ticketPriorities()->get())->resolve(),
'ticketStatusOptions' => TicketStatusResource::collection(
$project->ticketStatuses()
->with('boardColumn')
->get(),
)->resolve(),
'ticketTypes' => TicketTypeResource::collection($project->ticketTypes()->get())->resolve(),
'users' => UserResource::collection(
User::query()
->orderBy('name')
->get(),
)->resolve(),
]);
return Inertia::render(
'projects/TicketCreate',
$this->buildProjectTicketOptionsPayload->handle(
$project,
Arr::get($request->query(), 'source') === 'board' ? 'board' : 'backlog',
session('status'),
),
);
}
public function store(StoreProjectTicketRequest $request, Project $project): RedirectResponse
@@ -111,88 +75,10 @@ class ProjectTicketController extends Controller
403,
);
$canEditTicket = $this->permissionService->allows($user, Permission::ProjectWrite, $project);
$canManageProject = $this->permissionService->allows($user, Permission::ProjectAdmin, $project);
$displayTicket = $ticket->load([
'assignee',
'author',
'fieldValues.ticketFieldDefinition',
'fieldValues.userValue',
'parentTicket',
'ticketPriority',
'ticketStatus.boardColumn',
'ticketType',
'worklogEntries.actor',
]);
if (! $project->show_author && ! $canManageProject) {
$displayTicket->setRelation('author', null);
$displayTicket->author_user_id = null;
}
return Inertia::render('projects/Ticket', [
'canEditTicket' => $canEditTicket,
'canManageProject' => $canManageProject,
'childTicketTree' => TicketTreeNodeResource::collection(
$ticket->childTickets()
->with('ticketType')
->get(),
)->resolve(),
'linkedTickets' => TicketLinkResource::collection(
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()
->each(fn (TicketLink $ticketLink) => $ticketLink->setAttribute('current_ticket_id', $ticket->id)),
)->resolve(),
'parentTicketOptions' => TicketReferenceResource::collection(
Ticket::query()
->where('project_id', $project->id)
->whereKeyNot($ticket->id)
->whereHas('ticketType', fn ($query) => $query->where('is_parent', true))
->orderByDesc('sequence_number')
->get(),
)->resolve(),
'project' => ProjectResource::make($project)->resolve(),
'repositoryBranches' => TicketRepositoryBranchResource::collection(
$this->resolveTicketBranchMatches->handle(
$user,
$project,
$ticket,
),
)->resolve(),
'repositoryPullRequests' => TicketRepositoryPullRequestResource::collection(
$this->resolveTicketPullRequestMatches->handle(
$user,
$project,
$ticket,
),
)->resolve(),
'status' => session('status'),
'suggestedBranchName' => $this->buildSuggestedTicketBranchName->handle($ticket),
'ticket' => TicketResource::make($displayTicket)->resolve(),
'ticketFieldDefinitions' => TicketFieldDefinitionResource::collection($project->ticketFieldDefinitions()->get())->resolve(),
'ticketLinkOptions' => TicketReferenceResource::collection(
Ticket::query()
->where('project_id', $project->id)
->whereKeyNot($ticket->id)
->orderByDesc('sequence_number')
->get(),
)->resolve(),
'ticketLinkTypes' => TicketLinkTypeResource::collection($project->ticketLinkTypes()->get())->resolve(),
'ticketPriorities' => TicketPriorityResource::collection($project->ticketPriorities()->get())->resolve(),
'ticketTypes' => TicketTypeResource::collection($project->ticketTypes()->get())->resolve(),
'users' => UserResource::collection(
User::query()
->orderBy('name')
->get(),
)->resolve(),
]);
return Inertia::render(
'projects/Ticket',
$this->buildProjectTicketDetailPayload->handle($project, $ticket, $user, session('status')),
);
}
public function update(
@@ -3,23 +3,22 @@
namespace App\Http\Controllers;
use App\Actions\Permissions\PermissionService;
use App\Actions\Tickets\CreateTicketWorklogEntry;
use App\Actions\Tickets\DeleteProjectTicketLink;
use App\Actions\Tickets\StoreProjectTicketLink;
use App\Enums\Permission;
use App\Enums\TicketWorklogEntryType;
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\Arr;
use Illuminate\Support\Facades\DB;
class ProjectTicketLinkController extends Controller
{
public function __construct(
private readonly CreateTicketWorklogEntry $createTicketWorklogEntry,
private readonly DeleteProjectTicketLink $deleteProjectTicketLink,
private readonly PermissionService $permissionService,
private readonly StoreProjectTicketLink $storeProjectTicketLink,
) {}
public function store(
@@ -34,53 +33,7 @@ class ProjectTicketLinkController extends Controller
403,
);
$validated = $request->validated();
$linkedTicketId = Arr::get($validated, 'linked_ticket_id');
$ticketLinkTypeId = Arr::get($validated, 'ticket_link_type_id');
$linkedTicket = Ticket::query()
->where('project_id', $project->id)
->findOrFail($linkedTicketId);
[$sourceTicketId, $targetTicketId] = $this->normalizeTicketPair($ticket->id, $linkedTicket->id);
$ticketLink = DB::transaction(function () use ($linkedTicket, $user, $ticketLinkTypeId, $sourceTicketId, $targetTicketId, $ticket): TicketLink {
$ticketLink = TicketLink::query()->updateOrCreate(
[
'source_ticket_id' => $sourceTicketId,
'target_ticket_id' => $targetTicketId,
],
[
'ticket_link_type_id' => $ticketLinkTypeId,
],
);
$ticketLink->load('ticketLinkType');
$this->createTicketWorklogEntry->handle(
$ticket,
$user,
TicketWorklogEntryType::LinkUpdated,
"Linked {$linkedTicket->ticket_key} as {$ticketLink->ticketLinkType->label}.",
[
'linked_ticket_key' => $linkedTicket->ticket_key,
'ticket_link_type' => $ticketLink->ticketLinkType->label,
],
);
$this->createTicketWorklogEntry->handle(
$linkedTicket,
$user,
TicketWorklogEntryType::LinkUpdated,
"Linked {$ticket->ticket_key} as {$ticketLink->ticketLinkType->label}.",
[
'linked_ticket_key' => $ticket->ticket_key,
'ticket_link_type' => $ticketLink->ticketLinkType->label,
],
);
return $ticketLink;
});
$ticketLink = $this->storeProjectTicketLink->handle($project, $ticket, $user, $request->validated());
return to_route('projects.tickets.show', [$project, $ticket])
->with('status', "{$ticketLink->ticketLinkType->label} link was saved.");
@@ -99,57 +52,9 @@ class ProjectTicketLinkController extends Controller
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, $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,
],
);
});
$label = $this->deleteProjectTicketLink->handle($ticket, $ticketLink, $user);
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),
];
}
}
@@ -3,9 +3,21 @@
namespace App\Http\Controllers;
use App\Actions\Permissions\PermissionService;
use App\Actions\Tickets\CreateTicketWorklogEntry;
use App\Actions\Projects\BuildProjectTicketMetadataSettingsPayload;
use App\Actions\ProjectTicketMetadata\DeleteProjectTicketPriority;
use App\Actions\ProjectTicketMetadata\DeleteProjectTicketType;
use App\Actions\ProjectTicketMetadata\DeleteTicketFieldDefinition;
use App\Actions\ProjectTicketMetadata\DeleteTicketLinkType;
use App\Actions\ProjectTicketMetadata\StoreProjectTicketPriority;
use App\Actions\ProjectTicketMetadata\StoreProjectTicketType;
use App\Actions\ProjectTicketMetadata\StoreTicketFieldDefinition;
use App\Actions\ProjectTicketMetadata\StoreTicketLinkType;
use App\Actions\ProjectTicketMetadata\UpdateProjectTicketMetadataSettings as UpdateProjectTicketMetadataSettingsAction;
use App\Actions\ProjectTicketMetadata\UpdateProjectTicketPriority;
use App\Actions\ProjectTicketMetadata\UpdateProjectTicketType;
use App\Actions\ProjectTicketMetadata\UpdateTicketFieldDefinition;
use App\Actions\ProjectTicketMetadata\UpdateTicketLinkType;
use App\Enums\Permission;
use App\Enums\TicketWorklogEntryType;
use App\Http\Requests\DestroyProjectTicketTypeRequest;
use App\Http\Requests\StoreProjectNamedSettingRequest;
use App\Http\Requests\StoreProjectTicketTypeRequest;
@@ -14,60 +26,51 @@ use App\Http\Requests\UpdateProjectNamedSettingRequest;
use App\Http\Requests\UpdateProjectTicketMetadataSettings;
use App\Http\Requests\UpdateProjectTicketTypeRequest;
use App\Http\Requests\UpdateTicketFieldDefinitionRequest;
use App\Http\Resources\FieldTypeOptionResource;
use App\Http\Resources\ProjectResource;
use App\Http\Resources\TicketFieldDefinitionResource;
use App\Http\Resources\TicketLinkTypeResource;
use App\Http\Resources\TicketPriorityResource;
use App\Http\Resources\TicketTypeResource;
use App\Models\Project;
use App\Models\Ticket;
use App\Models\TicketFieldDefinition;
use App\Models\TicketLinkType;
use App\Models\TicketPriority;
use App\Models\TicketType;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Arr;
use Illuminate\Support\Collection;
use Illuminate\Support\Facades\DB;
use Inertia\Inertia;
use Inertia\Response;
class ProjectTicketMetadataSettingsController extends Controller
{
public function __construct(
private readonly CreateTicketWorklogEntry $createTicketWorklogEntry,
private readonly BuildProjectTicketMetadataSettingsPayload $buildProjectTicketMetadataSettingsPayload,
private readonly DeleteProjectTicketPriority $deleteProjectTicketPriority,
private readonly DeleteProjectTicketType $deleteProjectTicketType,
private readonly DeleteTicketFieldDefinition $deleteTicketFieldDefinition,
private readonly DeleteTicketLinkType $deleteTicketLinkType,
private readonly PermissionService $permissionService,
private readonly StoreProjectTicketPriority $storeProjectTicketPriority,
private readonly StoreProjectTicketType $storeProjectTicketType,
private readonly StoreTicketFieldDefinition $storeTicketFieldDefinition,
private readonly StoreTicketLinkType $storeTicketLinkType,
private readonly UpdateProjectTicketMetadataSettingsAction $updateProjectTicketMetadataSettings,
private readonly UpdateProjectTicketPriority $updateProjectTicketPriority,
private readonly UpdateProjectTicketType $updateProjectTicketType,
private readonly UpdateTicketFieldDefinition $updateTicketFieldDefinition,
private readonly UpdateTicketLinkType $updateTicketLinkType,
) {}
public function show(Request $request, Project $project): Response
{
$this->abortUnlessCanManage($request, $project);
return Inertia::render('projects/settings/Metadata', [
'fieldTypeOptions' => FieldTypeOptionResource::collection(collect(TicketFieldDefinition::FIELD_TYPES))->resolve(),
'project' => ProjectResource::make($project)->resolve(),
'error' => session('error'),
'status' => session('status'),
'ticketFieldDefinitions' => TicketFieldDefinitionResource::collection($project->ticketFieldDefinitions()->get())->resolve(),
'ticketLinkTypes' => TicketLinkTypeResource::collection($project->ticketLinkTypes()->get())->resolve(),
'ticketPriorities' => TicketPriorityResource::collection($project->ticketPriorities()->get())->resolve(),
'ticketTypes' => TicketTypeResource::collection($project->ticketTypes()->withCount('tickets')->get())->resolve(),
]);
return Inertia::render(
'projects/settings/Metadata',
$this->buildProjectTicketMetadataSettingsPayload->handle($project, session('status'), session('error')),
);
}
public function update(UpdateProjectTicketMetadataSettings $request, Project $project): RedirectResponse
{
$this->abortUnlessCanManage($request, $project);
$validated = $request->validated();
$project->update([
'show_author' => Arr::get($validated, 'show_author', false),
'show_story_points' => Arr::get($validated, 'show_story_points', false),
]);
$this->updateProjectTicketMetadataSettings->handle($project, $request->validated());
return to_route('projects.settings.metadata', $project)
->with('status', 'Settings have been updated.');
@@ -77,23 +80,7 @@ class ProjectTicketMetadataSettingsController extends Controller
{
$this->abortUnlessCanManage($request, $project);
$validated = $request->validated();
$ticketType = DB::transaction(function () use ($project, $validated): TicketType {
$ticketType = $project->ticketTypes()->create([
'name' => Arr::get($validated, 'name'),
'position' => $project->ticketTypes()->count() + 1,
'is_parent' => Arr::get($validated, 'is_parent', false),
]);
$this->reorderModels(
$project->ticketTypes()->whereKeyNot($ticketType->id)->get()->values(),
$ticketType,
Arr::get($validated, 'position') ?? $project->ticketTypes()->count(),
);
return $ticketType;
});
$ticketType = $this->storeProjectTicketType->handle($project, $request->validated());
return to_route('projects.settings.metadata', $project)
->with('status', "{$ticketType->name} type was added.");
@@ -106,19 +93,7 @@ class ProjectTicketMetadataSettingsController extends Controller
): RedirectResponse {
$this->abortUnlessCanManage($request, $project);
$validated = $request->validated();
DB::transaction(function () use ($project, $validated, $ticketType): void {
$ticketType->update([
'name' => Arr::get($validated, 'name'),
]);
$this->reorderModels(
$project->ticketTypes()->whereKeyNot($ticketType->id)->get()->values(),
$ticketType,
Arr::get($validated, 'position'),
);
});
$ticketType = $this->updateProjectTicketType->handle($project, $ticketType, $request->validated());
return to_route('projects.settings.metadata', $project)
->with('status', "{$ticketType->fresh()->name} type was updated.");
@@ -131,78 +106,28 @@ class ProjectTicketMetadataSettingsController extends Controller
): RedirectResponse {
$this->abortUnlessCanManage($request, $project);
if ($project->ticketTypes()->count() === 1) {
$result = $this->deleteProjectTicketType->handle(
$project,
$ticketType,
$request->user(),
$request->validated(),
);
if (! $result['deleted']) {
return to_route('projects.settings.metadata', $project)
->with('error', true)
->with('status', 'The last ticket type cannot be deleted.');
->with('status', $result['message']);
}
$deletedName = $ticketType->name;
$validated = $request->validated();
DB::transaction(function () use ($deletedName, $project, $request, $ticketType, $validated): void {
$replacementTicketTypeId = Arr::get($validated, 'replacement_ticket_type_id');
if ($replacementTicketTypeId !== null) {
$replacementTicketType = $project->ticketTypes()
->findOrFail($replacementTicketTypeId);
Ticket::query()
->where('project_id', $project->id)
->where('ticket_type_id', $ticketType->id)
->with(['ticketType'])
->get()
->each(function (Ticket $ticket) use ($deletedName, $replacementTicketType, $request): void {
$ticket->update([
'ticket_type_id' => $replacementTicketType->id,
]);
$this->createTicketWorklogEntry->handle(
$ticket->fresh(),
$request->user(),
TicketWorklogEntryType::Updated,
"Updated type because {$deletedName} type was deleted.",
[
'ticket_type' => [
'from' => $deletedName,
'to' => $replacementTicketType->name,
],
],
);
});
}
$ticketType->delete();
$this->persistOrderedModels($project->ticketTypes()->get()->values());
});
return to_route('projects.settings.metadata', $project)
->with('status', "{$deletedName} type was removed.");
->with('status', $result['message']);
}
public function storePriority(StoreProjectNamedSettingRequest $request, Project $project): RedirectResponse
{
$this->abortUnlessCanManage($request, $project);
$validated = $request->validated();
$name = Arr::get($validated, 'name');
$position = Arr::get($validated, 'position');
$ticketPriority = DB::transaction(function () use ($project, $name, $position): TicketPriority {
$ticketPriority = $project->ticketPriorities()->create([
'name' => $name,
'position' => $project->ticketPriorities()->count() + 1,
]);
$this->reorderModels(
$project->ticketPriorities()->whereKeyNot($ticketPriority->id)->get()->values(),
$ticketPriority,
$position ?? $project->ticketPriorities()->count(),
);
return $ticketPriority;
});
$ticketPriority = $this->storeProjectTicketPriority->handle($project, $request->validated());
return to_route('projects.settings.metadata', $project)
->with('status', "{$ticketPriority->name} priority was added.");
@@ -215,21 +140,7 @@ class ProjectTicketMetadataSettingsController extends Controller
): RedirectResponse {
$this->abortUnlessCanManage($request, $project);
$validated = $request->validated();
$name = Arr::get($validated, 'name');
$position = Arr::get($validated, 'position');
DB::transaction(function () use ($project, $name, $position, $ticketPriority): void {
$ticketPriority->update([
'name' => $name,
]);
$this->reorderModels(
$project->ticketPriorities()->whereKeyNot($ticketPriority->id)->get()->values(),
$ticketPriority,
$position,
);
});
$ticketPriority = $this->updateProjectTicketPriority->handle($project, $ticketPriority, $request->validated());
return to_route('projects.settings.metadata', $project)
->with('status', "{$ticketPriority->fresh()->name} priority was updated.");
@@ -242,22 +153,16 @@ class ProjectTicketMetadataSettingsController extends Controller
): RedirectResponse {
$this->abortUnlessCanManage($request, $project);
if ($project->ticketPriorities()->count() === 1) {
$result = $this->deleteProjectTicketPriority->handle($project, $ticketPriority);
if (! $result['deleted']) {
return to_route('projects.settings.metadata', $project)
->with('error', true)
->with('status', 'The last ticket priority cannot be deleted.');
->with('status', $result['message']);
}
$deletedName = $ticketPriority->name;
DB::transaction(function () use ($project, $ticketPriority): void {
$ticketPriority->delete();
$this->persistOrderedModels($project->ticketPriorities()->get()->values());
});
return to_route('projects.settings.metadata', $project)
->with('status', "{$deletedName} priority was removed.");
->with('status', $result['message']);
}
public function storeFieldDefinition(
@@ -266,23 +171,7 @@ class ProjectTicketMetadataSettingsController extends Controller
): RedirectResponse {
$this->abortUnlessCanManage($request, $project);
$validated = $request->validated();
$ticketFieldDefinition = DB::transaction(function () use ($project, $validated): TicketFieldDefinition {
$ticketFieldDefinition = $project->ticketFieldDefinitions()->create([
'field_type' => Arr::get($validated, 'field_type'),
'label' => Arr::get($validated, 'label'),
'position' => $project->ticketFieldDefinitions()->count() + 1,
]);
$this->reorderModels(
$project->ticketFieldDefinitions()->whereKeyNot($ticketFieldDefinition->id)->get()->values(),
$ticketFieldDefinition,
Arr::get($validated, 'position') ?? $project->ticketFieldDefinitions()->count(),
);
return $ticketFieldDefinition;
});
$ticketFieldDefinition = $this->storeTicketFieldDefinition->handle($project, $request->validated());
return to_route('projects.settings.metadata', $project)
->with('status', "{$ticketFieldDefinition->label} field was added.");
@@ -295,20 +184,7 @@ class ProjectTicketMetadataSettingsController extends Controller
): RedirectResponse {
$this->abortUnlessCanManage($request, $project);
$validated = $request->validated();
DB::transaction(function () use ($project, $ticketFieldDefinition, $validated): void {
$ticketFieldDefinition->update([
'field_type' => Arr::get($validated, 'field_type'),
'label' => Arr::get($validated, 'label'),
]);
$this->reorderModels(
$project->ticketFieldDefinitions()->whereKeyNot($ticketFieldDefinition->id)->get()->values(),
$ticketFieldDefinition,
Arr::get($validated, 'position'),
);
});
$ticketFieldDefinition = $this->updateTicketFieldDefinition->handle($project, $ticketFieldDefinition, $request->validated());
return to_route('projects.settings.metadata', $project)
->with('status', "{$ticketFieldDefinition->fresh()->label} field was updated.");
@@ -321,13 +197,7 @@ class ProjectTicketMetadataSettingsController extends Controller
): RedirectResponse {
$this->abortUnlessCanManage($request, $project);
$deletedLabel = $ticketFieldDefinition->label;
DB::transaction(function () use ($project, $ticketFieldDefinition): void {
$ticketFieldDefinition->delete();
$this->persistOrderedModels($project->ticketFieldDefinitions()->get()->values());
});
$deletedLabel = $this->deleteTicketFieldDefinition->handle($project, $ticketFieldDefinition);
return to_route('projects.settings.metadata', $project)
->with('status', "{$deletedLabel} field was removed.");
@@ -335,26 +205,9 @@ class ProjectTicketMetadataSettingsController extends Controller
public function storeLinkType(StoreProjectNamedSettingRequest $request, Project $project): RedirectResponse
{
$validated = $request->validated();
$name = Arr::get($validated, 'name');
$position = Arr::get($validated, 'position');
$this->abortUnlessCanManage($request, $project);
$ticketLinkType = DB::transaction(function () use ($project, $position, $name): TicketLinkType {
$ticketLinkType = $project->ticketLinkTypes()->create([
'label' => $name,
'position' => $project->ticketLinkTypes()->count() + 1,
]);
$this->reorderModels(
$project->ticketLinkTypes()->whereKeyNot($ticketLinkType->id)->get()->values(),
$ticketLinkType,
$position ?? $project->ticketLinkTypes()->count(),
);
return $ticketLinkType;
});
$ticketLinkType = $this->storeTicketLinkType->handle($project, $request->validated());
return to_route('projects.settings.metadata', $project)
->with('status', "{$ticketLinkType->label} link type was added.");
@@ -366,23 +219,9 @@ class ProjectTicketMetadataSettingsController extends Controller
TicketLinkType $ticketLinkType,
): RedirectResponse {
$validated = $request->validated();
$name = Arr::get($validated, 'name');
$position = Arr::get($validated, 'position');
$this->abortUnlessCanManage($request, $project);
DB::transaction(function () use ($project, $name, $position, $ticketLinkType): void {
$ticketLinkType->update([
'label' => $name,
]);
$this->reorderModels(
$project->ticketLinkTypes()->whereKeyNot($ticketLinkType->id)->get()->values(),
$ticketLinkType,
$position,
);
});
$ticketLinkType = $this->updateTicketLinkType->handle($project, $ticketLinkType, $request->validated());
return to_route('projects.settings.metadata', $project)
->with('status', "{$ticketLinkType->fresh()->label} link type was updated.");
@@ -395,13 +234,7 @@ class ProjectTicketMetadataSettingsController extends Controller
): RedirectResponse {
$this->abortUnlessCanManage($request, $project);
$deletedLabel = $ticketLinkType->label;
DB::transaction(function () use ($project, $ticketLinkType): void {
$ticketLinkType->delete();
$this->persistOrderedModels($project->ticketLinkTypes()->get()->values());
});
$deletedLabel = $this->deleteTicketLinkType->handle($project, $ticketLinkType);
return to_route('projects.settings.metadata', $project)
->with('status', "{$deletedLabel} link type was removed.");
@@ -414,36 +247,4 @@ class ProjectTicketMetadataSettingsController extends Controller
403,
);
}
/**
* @param Collection<int, Model> $models
*/
private function persistOrderedModels(Collection $models): void
{
$temporaryOffset = ((int) $models->max('position')) + $models->count() + 1;
$models->each(function (Model $model, int $index) use ($temporaryOffset): void {
$model->forceFill([
'position' => $temporaryOffset + $index,
])->saveQuietly();
});
$models->each(function (Model $model, int $index): void {
$model->forceFill([
'position' => $index + 1,
])->saveQuietly();
});
}
/**
* @param Collection<int, Model> $existingModels
*/
private function reorderModels(Collection $existingModels, Model $movingModel, int $desiredPosition): void
{
$insertAt = max(0, min($desiredPosition - 1, $existingModels->count()));
$existingModels->splice($insertAt, 0, [$movingModel]);
$this->persistOrderedModels($existingModels->values());
}
}
@@ -2,8 +2,9 @@
namespace App\Http\Controllers\Settings;
use App\Actions\Git\GitProviderKey;
use App\Actions\Git\GitProviderManager;
use App\Actions\UserGitConnections\DeleteUserGitConnection;
use App\Actions\UserGitConnections\StoreUserGitConnection;
use App\Actions\UserGitConnections\UpdateUserGitConnection;
use App\Http\Controllers\Controller;
use App\Http\Requests\Settings\StoreUserGitConnectionRequest;
use App\Http\Requests\Settings\UpdateUserGitConnectionRequest;
@@ -11,15 +12,15 @@ use App\Http\Resources\UserGitConnectionResource;
use App\Models\UserGitConnection;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Arr;
use Inertia\Inertia;
use Inertia\Response;
use Throwable;
class GitConnectionController extends Controller
{
public function __construct(
private readonly GitProviderManager $gitProviderManager,
private readonly DeleteUserGitConnection $deleteUserGitConnection,
private readonly StoreUserGitConnection $storeUserGitConnection,
private readonly UpdateUserGitConnection $updateUserGitConnection,
) {}
public function edit(Request $request): Response
@@ -33,35 +34,7 @@ class GitConnectionController extends Controller
public function store(StoreUserGitConnectionRequest $request): RedirectResponse
{
$validated = $request->validated();
$apiToken = Arr::get($validated, 'api_token');
$baseUrl = Arr::get($validated, 'base_url');
$provider = GitProviderKey::from(Arr::get($validated, 'provider'));
$user = $request->user();
try {
$gitProvider = $this->gitProviderManager->client($provider);
$authenticatedUser = $gitProvider->getAuthenticatedUser(
$baseUrl,
$apiToken,
);
} catch (Throwable) {
return back()
->withErrors([
'api_token' => sprintf('%s could not authenticate against Gitea with this base URL and token.', config('app.name')),
]);
}
UserGitConnection::query()->create([
'account_login' => $authenticatedUser->login,
'account_name' => $authenticatedUser->name,
'api_token' => $apiToken,
'base_url' => $baseUrl,
'provider' => $provider,
'provider_user_id' => $authenticatedUser->providerUserId,
'user_id' => $user->id,
]);
$this->storeUserGitConnection->handle($request->user(), $request->validated());
return to_route('git-connections.edit')
->with('status', 'Git connection was added.');
@@ -73,32 +46,7 @@ class GitConnectionController extends Controller
): RedirectResponse {
$this->abortUnlessOwner($request, $gitConnection);
$validated = $request->validated();
$apiToken = Arr::get($validated, 'api_token');
$baseUrl = Arr::get($validated, 'base_url');
$provider = GitProviderKey::from(Arr::get($validated, 'provider'));
try {
$gitProvider = $this->gitProviderManager->client($provider);
$authenticatedUser = $gitProvider->getAuthenticatedUser(
$baseUrl,
$apiToken,
);
} catch (Throwable) {
return back()
->withErrors([
'api_token' => sprintf('%s could not authenticate against Gitea with this base URL and token.', config('app.name')),
]);
}
$gitConnection->update([
'account_login' => $authenticatedUser->login,
'account_name' => $authenticatedUser->name,
'api_token' => $apiToken,
'base_url' => $baseUrl,
'provider' => $provider,
'provider_user_id' => $authenticatedUser->providerUserId,
]);
$this->updateUserGitConnection->handle($gitConnection, $request->validated());
return to_route('git-connections.edit')
->with('status', 'Git connection was updated.');
@@ -108,9 +56,7 @@ class GitConnectionController extends Controller
{
$this->abortUnlessOwner($request, $gitConnection);
$label = "{$gitConnection->account_login} @ {$gitConnection->base_url}";
$gitConnection->delete();
$label = $this->deleteUserGitConnection->handle($gitConnection);
return to_route('git-connections.edit')
->with('status', "{$label} was removed.");