feat: 사용자 관리 기능 및 MNG 문서 추가

- MNG_CRITICAL_RULES.md: DB 마이그레이션 금지 등 핵심 규칙 - UserController: 사용자 CRUD API 엔드포인트 - StoreUserRequest, UpdateUserRequest: 사용자 검증 - 사용자 관리 뷰: index, create, edit, table - 시스템 관리 메뉴 UI 개선 (테이블 헤더 스타일) - docs/INDEX.md: CRITICAL_RULES 링크 추가
2025-11-24 18:49:02 +09:00
parent 74ee0f5f5a
commit 0c86b390ad
16 changed files with 1141 additions and 26 deletions
--- a/app/Http/Controllers/Api/Admin/UserController.php
+++ b/app/Http/Controllers/Api/Admin/UserController.php
@@ -0,0 +1,143 @@
+<?php
+
+namespace App\Http\Controllers\Api\Admin;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\StoreUserRequest;
+use App\Http\Requests\UpdateUserRequest;
+use App\Services\UserService;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class UserController extends Controller
+{
+    public function __construct(
+        private readonly UserService $userService
+    ) {}
+
+    /**
+     * 사용자 목록 조회
+     */
+    public function index(Request $request): JsonResponse
+    {
+        $users = $this->userService->getUsers(
+            $request->all(),
+            $request->integer('per_page', 15)
+        );
+
+        // HTMX 요청인 경우 HTML 반환
+        if ($request->header('HX-Request')) {
+            $html = view('users.partials.table', compact('users'))->render();
+            return response()->json(['html' => $html]);
+        }
+
+        // 일반 API 요청인 경우 JSON 반환
+        return response()->json([
+            'success' => true,
+            'data' => $users->items(),
+            'meta' => [
+                'current_page' => $users->currentPage(),
+                'last_page' => $users->lastPage(),
+                'per_page' => $users->perPage(),
+                'total' => $users->total(),
+            ],
+        ]);
+    }
+
+    /**
+     * 사용자 상세 조회
+     */
+    public function show(int $id): JsonResponse
+    {
+        $user = $this->userService->getUserById($id);
+
+        if (!$user) {
+            return response()->json([
+                'success' => false,
+                'message' => '사용자를 찾을 수 없습니다.',
+            ], 404);
+        }
+
+        return response()->json([
+            'success' => true,
+            'data' => $user,
+        ]);
+    }
+
+    /**
+     * 사용자 생성
+     */
+    public function store(StoreUserRequest $request): JsonResponse
+    {
+        try {
+            $user = $this->userService->createUser($request->validated());
+
+            return response()->json([
+                'success' => true,
+                'message' => '사용자가 생성되었습니다.',
+                'data' => $user,
+                'redirect' => route('users.index'),
+            ], 201);
+        } catch (\Exception $e) {
+            return response()->json([
+                'success' => false,
+                'message' => '사용자 생성에 실패했습니다: ' . $e->getMessage(),
+            ], 500);
+        }
+    }
+
+    /**
+     * 사용자 수정
+     */
+    public function update(UpdateUserRequest $request, int $id): JsonResponse
+    {
+        try {
+            $result = $this->userService->updateUser($id, $request->validated());
+
+            if (!$result) {
+                return response()->json([
+                    'success' => false,
+                    'message' => '사용자를 찾을 수 없습니다.',
+                ], 404);
+            }
+
+            return response()->json([
+                'success' => true,
+                'message' => '사용자가 수정되었습니다.',
+                'redirect' => route('users.index'),
+            ]);
+        } catch (\Exception $e) {
+            return response()->json([
+                'success' => false,
+                'message' => '사용자 수정에 실패했습니다: ' . $e->getMessage(),
+            ], 500);
+        }
+    }
+
+    /**
+     * 사용자 삭제
+     */
+    public function destroy(int $id): JsonResponse
+    {
+        try {
+            $result = $this->userService->deleteUser($id);
+
+            if (!$result) {
+                return response()->json([
+                    'success' => false,
+                    'message' => '사용자를 찾을 수 없습니다.',
+                ], 404);
+            }
+
+            return response()->json([
+                'success' => true,
+                'message' => '사용자가 삭제되었습니다.',
+            ]);
+        } catch (\Exception $e) {
+            return response()->json([
+                'success' => false,
+                'message' => '사용자 삭제에 실패했습니다: ' . $e->getMessage(),
+            ], 500);
+        }
+    }
+}