users menu listing

Modules/UserManagement/Http/Controllers/UserController.php

@@ -0,0 +1,115 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Modules\UserManagement\Http\Controllers;
+
+use App\Models\User;
+use Illuminate\Contracts\View\View;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Illuminate\Routing\Controller;
+use Illuminate\Support\Facades\Hash;
+use Illuminate\Validation\Rule;
+
+final class UserController extends Controller
+{
+    public function index(Request $request): View
+    {
+        $search = trim((string) $request->query('search', ''));
+
+        $users = User::query()
+            ->when($search !== '', static function ($query) use ($search): void {
+                $query->where(static function ($query) use ($search): void {
+                    $query->where('name', 'like', '%'.$search.'%')
+                        ->orWhere('email', 'like', '%'.$search.'%');
+                });
+            })
+            ->orderBy('name')
+            ->paginate(20)
+            ->withQueryString();
+
+        return view('modules.user-management.index', compact('users', 'search'));
+    }
+
+    public function create(): View
+    {
+        return view('modules.user-management.create');
+    }
+
+    public function store(Request $request): RedirectResponse
+    {
+        $data = $request->validate([
+            'name' => ['required', 'string', 'max:255'],
+            'email' => ['required', 'email', 'max:255', 'unique:users,email'],
+            'password' => ['required', 'string', 'min:8', 'confirmed'],
+            'helpdesk_agent' => ['sometimes', 'boolean'],
+            'helpdesk_admin' => ['sometimes', 'boolean'],
+        ]);
+
+        $user = User::query()->create([
+            'name' => $data['name'],
+            'email' => $data['email'],
+            'password' => Hash::make($data['password']),
+            'email_verified_at' => now(),
+            'helpdesk_agent' => $request->boolean('helpdesk_agent') || $request->boolean('helpdesk_admin'),
+            'helpdesk_admin' => $request->boolean('helpdesk_admin'),
+        ]);
+
+        return redirect()->route('user-management.edit', $user)
+            ->with('status', 'User created successfully.');
+    }
+
+    public function edit(User $user): View
+    {
+        return view('modules.user-management.edit', compact('user'));
+    }
+
+    public function update(Request $request, User $user): RedirectResponse
+    {
+        $data = $request->validate([
+            'name' => ['required', 'string', 'max:255'],
+            'email' => ['required', 'email', 'max:255', Rule::unique('users', 'email')->ignore($user->id)],
+            'password' => ['nullable', 'string', 'min:8', 'confirmed'],
+            'helpdesk_agent' => ['sometimes', 'boolean'],
+            'helpdesk_admin' => ['sometimes', 'boolean'],
+        ]);
+
+        $user->name = $data['name'];
+        $user->email = $data['email'];
+        $user->helpdesk_admin = $request->boolean('helpdesk_admin');
+        $user->helpdesk_agent = $user->helpdesk_admin || $request->boolean('helpdesk_agent');
+
+        if (filled($data['password'] ?? null)) {
+            $user->password = Hash::make($data['password']);
+        }
+
+        $user->save();
+
+        return back()->with('status', 'User updated successfully.');
+    }
+
+    public function destroy(Request $request, User $user): RedirectResponse
+    {
+        abort_if((int) $request->user()->id === (int) $user->id, 422, 'You cannot delete your own account.');
+
+        if ($user->isHelpdeskAdmin() && User::query()->where('helpdesk_admin', true)->count() <= 1) {
+            return back()->withErrors(['user' => 'The last Helpdesk administrator cannot be deleted.']);
+        }
+
+        $user->delete();
+
+        return redirect()->route('user-management.index')->with('status', 'User deleted.');
+    }
+
+    public function roles(): View
+    {
+        $counts = [
+            'admins' => User::query()->where('helpdesk_admin', true)->count(),
+            'agents' => User::query()->where('helpdesk_agent', true)->count(),
+            'users' => User::query()->count(),
+        ];
+
+        return view('modules.user-management.roles', compact('counts'));
+    }
+}

Modules/UserManagement/Http/Middleware/EnsureUserManagementAdmin.php

@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Modules\UserManagement\Http\Middleware;
+
+use Closure;
+use Illuminate\Http\Request;
+use Symfony\Component\HttpFoundation\Response;
+
+final class EnsureUserManagementAdmin
+{
+    public function handle(Request $request, Closure $next): Response
+    {
+        $user = $request->user();
+
+        $allowed = $user !== null && (
+            (method_exists($user, 'isHelpdeskAdmin') && $user->isHelpdeskAdmin())
+            || (method_exists($user, 'isAdmin') && $user->isAdmin())
+            || (bool) ($user->helpdesk_admin ?? false)
+        );
+
+        abort_unless($allowed, 403);
+
+        return $next($request);
+    }
+}

Modules/UserManagement/Providers/RouteServiceProvider.php

@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Modules\UserManagement\Providers;
+
+use Illuminate\Foundation\Support\Providers\RouteServiceProvider as ServiceProvider;
+use Illuminate\Support\Facades\Route;
+use Modules\UserManagement\Http\Middleware\EnsureUserManagementAdmin;
+
+final class RouteServiceProvider extends ServiceProvider
+{
+    public function boot(): void
+    {
+        parent::boot();
+
+        Route::middleware(['web', 'auth', EnsureUserManagementAdmin::class])
+            ->prefix('admin/users')
+            ->name('user-management.')
+            ->group(module_path('UserManagement', 'Routes/web.php'));
+    }
+}

Modules/UserManagement/Providers/UserManagementServiceProvider.php

@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Modules\UserManagement\Providers;
+
+use Illuminate\Support\ServiceProvider;
+
+final class UserManagementServiceProvider extends ServiceProvider
+{
+    public function register(): void
+    {
+        $this->app->register(RouteServiceProvider::class);
+    }
+}

Modules/UserManagement/Routes/web.php

@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+use Illuminate\Support\Facades\Route;
+use Modules\UserManagement\Http\Controllers\UserController;
+
+Route::get('/', [UserController::class, 'index'])->name('index');
+Route::get('/create', [UserController::class, 'create'])->name('create');
+Route::post('/', [UserController::class, 'store'])->name('store');
+Route::get('/roles', [UserController::class, 'roles'])->name('roles');
+Route::get('/{user}/edit', [UserController::class, 'edit'])->name('edit');
+Route::put('/{user}', [UserController::class, 'update'])->name('update');
+Route::delete('/{user}', [UserController::class, 'destroy'])->name('destroy');

Modules/UserManagement/composer.json

@@ -0,0 +1,9 @@
+{
+    "name": "modules/user-management",
+    "description": "Helpdesk user management module",
+    "autoload": {
+        "psr-4": {
+            "Modules\\UserManagement\\": ""
+        }
+    }
+}

Modules/UserManagement/module.json

@@ -0,0 +1,12 @@
+{
+    "name": "UserManagement",
+    "alias": "user-management",
+    "version": "1.0.0",
+    "description": "Administrator-only user, Helpdesk role and permission management.",
+    "keywords": ["users", "administration", "roles", "permissions"],
+    "priority": 0,
+    "providers": ["Modules\\UserManagement\\Providers\\UserManagementServiceProvider"],
+    "aliases": {},
+    "files": [],
+    "requires": []
+}