feat: inisialisasi project kit v2

app/Http/Controllers/Api/V1/UserController.php

@@ -0,0 +1,115 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1;
+
+use App\Actions\Users\CreateUserAction;
+use App\Http\Controllers\Controller;
+use App\Http\Resources\UserResource;
+use App\Models\User;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\AnonymousResourceCollection;
+
+/**
+ * @group User Management
+ * 
+ * APIs for managing users
+ */
+class UserController extends Controller
+{
+    /**
+     * List Users
+     * 
+     * Get a paginated list of users.
+     */
+    public function index(Request $request): AnonymousResourceCollection
+    {
+        $this->authorize('user.view');
+
+        $users = User::query()
+            ->when($request->search, function ($query, $search) {
+                $query->where('first_name', 'like', "%{$search}%")
+                    ->orWhere('last_name', 'like', "%{$search}%")
+                    ->orWhere('email', 'like', "%{$search}%");
+            })
+            ->paginate($request->perPage ?? 15);
+
+        return UserResource::collection($users);
+    }
+
+    /**
+     * Create User
+     * 
+     * Create a new user with roles.
+     */
+    public function store(Request $request, CreateUserAction $action): UserResource
+    {
+        $this->authorize('user.create');
+
+        $validated = $request->validate([
+            'firstName' => 'required|string|max:100',
+            'lastName' => 'required|string|max:100',
+            'email' => 'required|email|unique:users,email',
+            'password' => 'required|min:8',
+            'status' => 'string|in:active,inactive,suspended',
+            'roles' => 'array',
+        ]);
+
+        $user = $action->execute($validated);
+
+        return new UserResource($user);
+    }
+
+    /**
+     * Get User
+     * 
+     * Get details of a specific user.
+     */
+    public function show(User $user): UserResource
+    {
+        $this->authorize('user.view');
+
+        return new UserResource($user);
+    }
+
+    /**
+     * Update User
+     * 
+     * Update a user's details.
+     */
+    public function update(Request $request, User $user): UserResource
+    {
+        $this->authorize('user.edit');
+
+        $validated = $request->validate([
+            'firstName' => 'string|max:100',
+            'lastName' => 'string|max:100',
+            'email' => 'email|unique:users,email,' . $user->id,
+            'status' => 'string|in:active,inactive,suspended',
+        ]);
+
+        // Mapping camelCase to snake_case for DB
+        if (isset($validated['firstName'])) $user->first_name = $validated['firstName'];
+        if (isset($validated['lastName'])) $user->last_name = $validated['lastName'];
+        if (isset($validated['email'])) $user->email = $validated['email'];
+        if (isset($validated['status'])) $user->status = $validated['status'];
+
+        $user->save();
+
+        return new UserResource($user);
+    }
+
+    /**
+     * Delete User
+     * 
+     * Soft delete a user.
+     */
+    public function destroy(User $user): JsonResponse
+    {
+        $this->authorize('user.delete');
+
+        $user->delete();
+
+        return response()->json(['message' => 'User deleted successfully']);
+    }
+}