feat: [pm] 프로젝트 진행 관리 시스템 구현

- Models: AdminPmProject, AdminPmTask, AdminPmIssue - Services: ProjectService, TaskService, IssueService, ImportService - API Controllers: ProjectController, TaskController, IssueController, ImportController - FormRequests: Store/Update/BulkAction 요청 검증 - Views: 대시보드, 프로젝트 CRUD, JSON Import 화면 - Routes: API 42개 + Web 6개 엔드포인트 주요 기능: - 프로젝트/작업/이슈 계층 구조 관리 - 상태 변경, 우선순위, 마감일 추적 - 작업 순서 드래그앤드롭 (reorder API) - JSON Import로 일괄 등록 - Soft Delete 및 복원
2025-11-28 08:49:30 +09:00
parent fe902472c1
commit e2475d0d9f
30 changed files with 5131 additions and 1 deletions
--- a/app/Http/Controllers/Api/Admin/ProjectManagement/ImportController.php
+++ b/app/Http/Controllers/Api/Admin/ProjectManagement/ImportController.php
@@ -0,0 +1,110 @@
+<?php
+
+namespace App\Http\Controllers\Api\Admin\ProjectManagement;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\ProjectManagement\ImportProjectRequest;
+use App\Services\ProjectManagement\ImportService;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class ImportController extends Controller
+{
+    public function __construct(
+        private readonly ImportService $importService
+    ) {}
+
+    /**
+     * JSON으로 프로젝트 일괄 등록
+     */
+    public function import(ImportProjectRequest $request): JsonResponse
+    {
+        try {
+            $result = $this->importService->importFromJson($request->validated());
+
+            return response()->json([
+                'success' => true,
+                'message' => "프로젝트가 생성되었습니다. (작업: {$result['tasks_count']}개, 이슈: {$result['issues_count']}개)",
+                'data' => [
+                    'project_id' => $result['project']->id,
+                    'project_name' => $result['project']->name,
+                    'tasks_count' => $result['tasks_count'],
+                    'issues_count' => $result['issues_count'],
+                ],
+            ]);
+        } catch (\Exception $e) {
+            return response()->json([
+                'success' => false,
+                'message' => '가져오기 실패: '.$e->getMessage(),
+            ], 500);
+        }
+    }
+
+    /**
+     * 기존 프로젝트에 작업/이슈 추가
+     */
+    public function importTasks(Request $request, int $projectId): JsonResponse
+    {
+        $validated = $request->validate([
+            'tasks' => 'required|array|min:1',
+            'tasks.*.title' => 'required|string|max:255',
+            'tasks.*.description' => 'nullable|string',
+            'tasks.*.status' => 'nullable|in:todo,in_progress,done',
+            'tasks.*.priority' => 'nullable|in:low,medium,high',
+            'tasks.*.due_date' => 'nullable|date',
+            'tasks.*.issues' => 'nullable|array',
+            'tasks.*.issues.*.title' => 'required|string|max:255',
+            'tasks.*.issues.*.description' => 'nullable|string',
+            'tasks.*.issues.*.type' => 'nullable|in:bug,feature,improvement',
+            'tasks.*.issues.*.status' => 'nullable|in:open,in_progress,resolved,closed',
+        ]);
+
+        try {
+            $result = $this->importService->importTasksToProject($projectId, $validated['tasks']);
+
+            return response()->json([
+                'success' => true,
+                'message' => "작업이 추가되었습니다. (작업: {$result['tasks_count']}개, 이슈: {$result['issues_count']}개)",
+                'data' => $result,
+            ]);
+        } catch (\Exception $e) {
+            return response()->json([
+                'success' => false,
+                'message' => '가져오기 실패: '.$e->getMessage(),
+            ], 500);
+        }
+    }
+
+    /**
+     * JSON 구조 사전 검증
+     */
+    public function validate(Request $request): JsonResponse
+    {
+        $data = $request->all();
+        $errors = $this->importService->validateJsonStructure($data);
+
+        if (! empty($errors)) {
+            return response()->json([
+                'success' => false,
+                'message' => 'JSON 구조가 올바르지 않습니다.',
+                'errors' => $errors,
+            ], 422);
+        }
+
+        return response()->json([
+            'success' => true,
+            'message' => 'JSON 구조가 유효합니다.',
+        ]);
+    }
+
+    /**
+     * 샘플 JSON 템플릿 반환
+     */
+    public function template(): JsonResponse
+    {
+        return response()->json([
+            'success' => true,
+            'data' => $this->importService->getSampleTemplate(),
+        ]);
+    }
+}