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 및 복원
This commit is contained in:
2025-11-28 08:49:30 +09:00
parent fe902472c1
commit e2475d0d9f
30 changed files with 5131 additions and 1 deletions

View File

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

View File

@@ -0,0 +1,256 @@
<?php
namespace App\Http\Controllers\Api\Admin\ProjectManagement;
use App\Http\Controllers\Controller;
use App\Http\Requests\ProjectManagement\BulkActionRequest;
use App\Http\Requests\ProjectManagement\StoreIssueRequest;
use App\Http\Requests\ProjectManagement\UpdateIssueRequest;
use App\Models\Admin\AdminPmIssue;
use App\Services\ProjectManagement\IssueService;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\View\View;
class IssueController extends Controller
{
public function __construct(
private readonly IssueService $issueService
) {}
/**
* 이슈 목록 (HTMX용)
*/
public function index(Request $request): View|JsonResponse
{
$filters = $request->only([
'project_id', 'task_id', 'search', 'type',
'status', 'open_only', 'trashed', 'sort_by', 'sort_direction',
]);
$issues = $this->issueService->getIssues($filters, 15);
$types = AdminPmIssue::getTypes();
$statuses = AdminPmIssue::getStatuses();
// HTMX 요청이면 HTML 파셜 반환
if ($request->header('HX-Request')) {
return view('project-management.issues.partials.table', compact('issues', 'types', 'statuses'));
}
return response()->json([
'success' => true,
'data' => $issues,
]);
}
/**
* 프로젝트별 이슈 목록
*/
public function byProject(int $projectId, Request $request): View|JsonResponse
{
$issues = $this->issueService->getIssuesByProject($projectId);
$types = AdminPmIssue::getTypes();
$statuses = AdminPmIssue::getStatuses();
// HTMX 요청이면 HTML 파셜 반환
if ($request->header('HX-Request')) {
return view('project-management.issues.partials.list', compact('issues', 'types', 'statuses'));
}
return response()->json([
'success' => true,
'data' => $issues,
]);
}
/**
* 작업별 이슈 목록
*/
public function byTask(int $taskId, Request $request): View|JsonResponse
{
$issues = $this->issueService->getIssuesByTask($taskId);
$types = AdminPmIssue::getTypes();
$statuses = AdminPmIssue::getStatuses();
// HTMX 요청이면 HTML 파셜 반환
if ($request->header('HX-Request')) {
return view('project-management.issues.partials.list', compact('issues', 'types', 'statuses'));
}
return response()->json([
'success' => true,
'data' => $issues,
]);
}
/**
* 열린 이슈 목록 (대시보드용)
*/
public function open(Request $request): JsonResponse
{
$projectId = $request->input('project_id');
$limit = $request->input('limit', 10);
$issues = $this->issueService->getOpenIssues($projectId, $limit);
return response()->json([
'success' => true,
'data' => $issues,
]);
}
/**
* 이슈 통계
*/
public function stats(Request $request): JsonResponse
{
$projectId = $request->input('project_id');
if ($projectId) {
$stats = $this->issueService->getIssueStatsByProject($projectId);
} else {
$stats = $this->issueService->getIssueStats();
}
return response()->json([
'success' => true,
'data' => $stats,
]);
}
/**
* 이슈 상세 조회
*/
public function show(int $id): JsonResponse
{
$issue = $this->issueService->getIssueById($id, true);
if (! $issue) {
return response()->json([
'success' => false,
'message' => '이슈를 찾을 수 없습니다.',
], 404);
}
return response()->json([
'success' => true,
'data' => $issue,
]);
}
/**
* 이슈 생성
*/
public function store(StoreIssueRequest $request): JsonResponse
{
$issue = $this->issueService->createIssue($request->validated());
return response()->json([
'success' => true,
'message' => '이슈가 생성되었습니다.',
'data' => $issue,
]);
}
/**
* 이슈 수정
*/
public function update(UpdateIssueRequest $request, int $id): JsonResponse
{
$this->issueService->updateIssue($id, $request->validated());
return response()->json([
'success' => true,
'message' => '이슈가 수정되었습니다.',
]);
}
/**
* 이슈 삭제 (Soft Delete)
*/
public function destroy(int $id): JsonResponse
{
$this->issueService->deleteIssue($id);
return response()->json([
'success' => true,
'message' => '이슈가 삭제되었습니다.',
]);
}
/**
* 이슈 복원
*/
public function restore(int $id): JsonResponse
{
$this->issueService->restoreIssue($id);
return response()->json([
'success' => true,
'message' => '이슈가 복원되었습니다.',
]);
}
/**
* 이슈 영구 삭제
*/
public function forceDestroy(int $id): JsonResponse
{
$this->issueService->forceDeleteIssue($id);
return response()->json([
'success' => true,
'message' => '이슈가 영구 삭제되었습니다.',
]);
}
/**
* 이슈 상태 변경
*/
public function changeStatus(Request $request, int $id): JsonResponse
{
$validated = $request->validate([
'status' => 'required|in:open,in_progress,resolved,closed',
]);
$issue = $this->issueService->changeStatus($id, $validated['status']);
return response()->json([
'success' => true,
'message' => '이슈 상태가 변경되었습니다.',
'data' => $issue,
]);
}
/**
* 이슈 일괄 처리
*/
public function bulk(BulkActionRequest $request): JsonResponse
{
$data = $request->validated();
$ids = $data['ids'];
$action = $data['action'];
$value = $data['value'] ?? null;
$count = match ($action) {
'change_status' => $this->issueService->bulkChangeStatus($ids, $value),
'change_type' => $this->issueService->bulkChangeType($ids, $value),
'link_task' => $this->issueService->bulkLinkToTask($ids, $value),
'delete' => $this->issueService->bulkDelete($ids),
'restore' => $this->issueService->bulkRestore($ids),
default => 0,
};
$messages = [
'change_status' => '상태가 변경되었습니다.',
'change_type' => '타입이 변경되었습니다.',
'link_task' => '작업 연결이 변경되었습니다.',
'delete' => '삭제되었습니다.',
'restore' => '복원되었습니다.',
];
return response()->json([
'success' => true,
'message' => "{$count}개 이슈가 ".$messages[$action],
'data' => ['affected' => $count],
]);
}
}

View File

@@ -0,0 +1,198 @@
<?php
namespace App\Http\Controllers\Api\Admin\ProjectManagement;
use App\Http\Controllers\Controller;
use App\Http\Requests\ProjectManagement\StoreProjectRequest;
use App\Http\Requests\ProjectManagement\UpdateProjectRequest;
use App\Services\ProjectManagement\ProjectService;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\View\View;
class ProjectController extends Controller
{
public function __construct(
private readonly ProjectService $projectService
) {}
/**
* 프로젝트 목록 (HTMX용)
*/
public function index(Request $request): View|JsonResponse
{
$filters = $request->only(['search', 'status', 'trashed', 'sort_by', 'sort_direction']);
$projects = $this->projectService->getProjects($filters, 15);
// HTMX 요청이면 HTML 파셜 반환
if ($request->header('HX-Request')) {
return view('project-management.projects.partials.table', compact('projects'));
}
return response()->json([
'success' => true,
'data' => $projects,
]);
}
/**
* 활성 프로젝트 목록 (드롭다운용)
*/
public function dropdown(): JsonResponse
{
$projects = $this->projectService->getActiveProjects();
return response()->json([
'success' => true,
'data' => $projects,
]);
}
/**
* 프로젝트 통계
*/
public function stats(): JsonResponse
{
$stats = $this->projectService->getProjectStats();
return response()->json([
'success' => true,
'data' => $stats,
]);
}
/**
* 대시보드 요약
*/
public function dashboard(): JsonResponse
{
$summary = $this->projectService->getDashboardSummary();
return response()->json([
'success' => true,
'data' => $summary,
]);
}
/**
* 프로젝트 상세 조회
*/
public function show(int $id): JsonResponse
{
$project = $this->projectService->getProjectById($id, true);
if (! $project) {
return response()->json([
'success' => false,
'message' => '프로젝트를 찾을 수 없습니다.',
], 404);
}
return response()->json([
'success' => true,
'data' => $project,
]);
}
/**
* 프로젝트 생성
*/
public function store(StoreProjectRequest $request): JsonResponse
{
$project = $this->projectService->createProject($request->validated());
return response()->json([
'success' => true,
'message' => '프로젝트가 생성되었습니다.',
'data' => $project,
]);
}
/**
* 프로젝트 수정
*/
public function update(UpdateProjectRequest $request, int $id): JsonResponse
{
$this->projectService->updateProject($id, $request->validated());
return response()->json([
'success' => true,
'message' => '프로젝트가 수정되었습니다.',
]);
}
/**
* 프로젝트 삭제 (Soft Delete)
*/
public function destroy(int $id): JsonResponse
{
$this->projectService->deleteProject($id);
return response()->json([
'success' => true,
'message' => '프로젝트가 삭제되었습니다.',
]);
}
/**
* 프로젝트 복원
*/
public function restore(int $id): JsonResponse
{
$this->projectService->restoreProject($id);
return response()->json([
'success' => true,
'message' => '프로젝트가 복원되었습니다.',
]);
}
/**
* 프로젝트 영구 삭제
*/
public function forceDestroy(int $id): JsonResponse
{
$this->projectService->forceDeleteProject($id);
return response()->json([
'success' => true,
'message' => '프로젝트가 영구 삭제되었습니다.',
]);
}
/**
* 프로젝트 상태 변경
*/
public function changeStatus(Request $request, int $id): JsonResponse
{
$validated = $request->validate([
'status' => 'required|in:active,completed,on_hold',
]);
$project = $this->projectService->changeStatus($id, $validated['status']);
return response()->json([
'success' => true,
'message' => '프로젝트 상태가 변경되었습니다.',
'data' => $project,
]);
}
/**
* 프로젝트 복제
*/
public function duplicate(Request $request, int $id): JsonResponse
{
$validated = $request->validate([
'name' => 'nullable|string|max:100',
]);
$project = $this->projectService->duplicateProject($id, $validated['name'] ?? null);
return response()->json([
'success' => true,
'message' => '프로젝트가 복제되었습니다.',
'data' => $project,
]);
}
}

View File

@@ -0,0 +1,242 @@
<?php
namespace App\Http\Controllers\Api\Admin\ProjectManagement;
use App\Http\Controllers\Controller;
use App\Http\Requests\ProjectManagement\BulkActionRequest;
use App\Http\Requests\ProjectManagement\StoreTaskRequest;
use App\Http\Requests\ProjectManagement\UpdateTaskRequest;
use App\Services\ProjectManagement\TaskService;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\View\View;
class TaskController extends Controller
{
public function __construct(
private readonly TaskService $taskService
) {}
/**
* 작업 목록 (HTMX용)
*/
public function index(Request $request): View|JsonResponse
{
$filters = $request->only([
'project_id', 'search', 'status', 'priority',
'assignee_id', 'due_status', 'trashed', 'sort_by', 'sort_direction',
]);
$tasks = $this->taskService->getTasks($filters, 15);
// HTMX 요청이면 HTML 파셜 반환
if ($request->header('HX-Request')) {
return view('project-management.tasks.partials.table', compact('tasks'));
}
return response()->json([
'success' => true,
'data' => $tasks,
]);
}
/**
* 프로젝트별 작업 목록 (칸반보드용)
*/
public function byProject(int $projectId, Request $request): View|JsonResponse
{
$tasks = $this->taskService->getTasksByProject($projectId);
// HTMX 요청이면 HTML 파셜 반환
if ($request->header('HX-Request')) {
return view('project-management.tasks.partials.kanban', compact('tasks'));
}
return response()->json([
'success' => true,
'data' => $tasks,
]);
}
/**
* 마감 임박/지연 작업 목록
*/
public function urgent(Request $request): JsonResponse
{
$projectId = $request->input('project_id');
$urgentTasks = $this->taskService->getUrgentTasks($projectId);
return response()->json([
'success' => true,
'data' => $urgentTasks,
]);
}
/**
* 작업 상세 조회
*/
public function show(int $id): JsonResponse
{
$task = $this->taskService->getTaskById($id, true);
if (! $task) {
return response()->json([
'success' => false,
'message' => '작업을 찾을 수 없습니다.',
], 404);
}
return response()->json([
'success' => true,
'data' => $task,
]);
}
/**
* 작업 생성
*/
public function store(StoreTaskRequest $request): JsonResponse
{
$task = $this->taskService->createTask($request->validated());
return response()->json([
'success' => true,
'message' => '작업이 생성되었습니다.',
'data' => $task,
]);
}
/**
* 작업 수정
*/
public function update(UpdateTaskRequest $request, int $id): JsonResponse
{
$this->taskService->updateTask($id, $request->validated());
return response()->json([
'success' => true,
'message' => '작업이 수정되었습니다.',
]);
}
/**
* 작업 삭제 (Soft Delete)
*/
public function destroy(int $id): JsonResponse
{
$this->taskService->deleteTask($id);
return response()->json([
'success' => true,
'message' => '작업이 삭제되었습니다.',
]);
}
/**
* 작업 복원
*/
public function restore(int $id): JsonResponse
{
$this->taskService->restoreTask($id);
return response()->json([
'success' => true,
'message' => '작업이 복원되었습니다.',
]);
}
/**
* 작업 영구 삭제
*/
public function forceDestroy(int $id): JsonResponse
{
$this->taskService->forceDeleteTask($id);
return response()->json([
'success' => true,
'message' => '작업이 영구 삭제되었습니다.',
]);
}
/**
* 작업 상태 변경
*/
public function changeStatus(Request $request, int $id): JsonResponse
{
$validated = $request->validate([
'status' => 'required|in:todo,in_progress,done',
]);
$task = $this->taskService->changeStatus($id, $validated['status']);
return response()->json([
'success' => true,
'message' => '작업 상태가 변경되었습니다.',
'data' => $task,
]);
}
/**
* 작업 순서 변경 (드래그앤드롭)
*/
public function reorder(Request $request, int $projectId): JsonResponse
{
$validated = $request->validate([
'task_ids' => 'required|array',
'task_ids.*' => 'integer',
]);
$this->taskService->reorderTasks($projectId, $validated['task_ids']);
return response()->json([
'success' => true,
'message' => '작업 순서가 변경되었습니다.',
]);
}
/**
* 작업 일괄 처리
*/
public function bulk(BulkActionRequest $request): JsonResponse
{
$data = $request->validated();
$ids = $data['ids'];
$action = $data['action'];
$value = $data['value'] ?? null;
$count = match ($action) {
'change_status' => $this->taskService->bulkChangeStatus($ids, $value),
'change_priority' => $this->taskService->bulkChangePriority($ids, $value),
'change_assignee' => $this->taskService->bulkChangeAssignee($ids, $value),
'delete' => $this->taskService->bulkDelete($ids),
'restore' => $this->taskService->bulkRestore($ids),
default => 0,
};
$messages = [
'change_status' => '상태가 변경되었습니다.',
'change_priority' => '우선순위가 변경되었습니다.',
'change_assignee' => '담당자가 변경되었습니다.',
'delete' => '삭제되었습니다.',
'restore' => '복원되었습니다.',
];
return response()->json([
'success' => true,
'message' => "{$count}개 작업이 ".$messages[$action],
'data' => ['affected' => $count],
]);
}
/**
* 프로젝트별 작업 통계
*/
public function stats(int $projectId): JsonResponse
{
$stats = $this->taskService->getTaskStatsByProject($projectId);
return response()->json([
'success' => true,
'data' => $stats,
]);
}
}