KanbanGit/app/Http/Controllers/ProjectBoardSettingsController.php

<?php

namespace App\Http\Controllers;

use App\Actions\Permissions\PermissionService;
use App\Enums\Permission;
use App\Http\Requests\StoreBoardColumnRequest;
use App\Http\Requests\UpdateBoardColumnRequest;
use App\Models\BoardColumn;
use App\Models\Project;
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 PermissionService $permissionService,
    ) {}

    public function show(Request $request, Project $project): Response
    {
        abort_unless(
            $this->permissionService->allows($request->user(), Permission::ProjectAdmin, $project),
            403,
        );

        return Inertia::render('projects/settings/Board', [
            'boardColumns' => $project->boardColumns()->get(),
            'project' => $project,
            'status' => session('status'),
        ]);
    }

    public function store(
        StoreBoardColumnRequest $request,
        Project $project,
    ): RedirectResponse {
        abort_unless(
            $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,
            ]);

            $this->reorderColumns($project, $boardColumn, $desiredPosition);

            return $boardColumn;
        });

        return to_route('projects.settings.board', $project)
            ->with('status', "{$boardColumn->name} was added to the board workflow.");
    }

    public function update(
        UpdateBoardColumnRequest $request,
        Project $project,
        BoardColumn $boardColumn,
    ): RedirectResponse {
        abort_unless(
            $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'));
        });

        return to_route('projects.settings.board', $project)
            ->with('status', "{$boardColumn->fresh()->name} was updated.");
    }

    public function destroy(
        Request $request,
        Project $project,
        BoardColumn $boardColumn,
    ): RedirectResponse {
        abort_unless(
            $this->permissionService->allows($request->user(), Permission::ProjectAdmin, $project),
            403,
        );

        $deletedName = $boardColumn->name;

        DB::transaction(function () use ($boardColumn, $project): void {
            $boardColumn->delete();

            $this->normalizeColumnPositions($project);
        });

        return to_route('projects.settings.board', $project)
            ->with('status', "{$deletedName} was removed from the board workflow.");
    }

    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();
        });
    }
}