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:
241
app/Services/ProjectManagement/ProjectService.php
Normal file
241
app/Services/ProjectManagement/ProjectService.php
Normal file
@@ -0,0 +1,241 @@
|
||||
<?php
|
||||
|
||||
namespace App\Services\ProjectManagement;
|
||||
|
||||
use App\Models\Admin\AdminPmIssue;
|
||||
use App\Models\Admin\AdminPmProject;
|
||||
use App\Models\Admin\AdminPmTask;
|
||||
use Illuminate\Contracts\Pagination\LengthAwarePaginator;
|
||||
use Illuminate\Database\Eloquent\Collection;
|
||||
|
||||
class ProjectService
|
||||
{
|
||||
/**
|
||||
* 프로젝트 목록 조회 (페이지네이션)
|
||||
*/
|
||||
public function getProjects(array $filters = [], int $perPage = 15): LengthAwarePaginator
|
||||
{
|
||||
$query = AdminPmProject::query()
|
||||
->withCount(['tasks', 'issues'])
|
||||
->withTrashed();
|
||||
|
||||
// 검색 필터
|
||||
if (! empty($filters['search'])) {
|
||||
$search = $filters['search'];
|
||||
$query->where(function ($q) use ($search) {
|
||||
$q->where('name', 'like', "%{$search}%")
|
||||
->orWhere('description', 'like', "%{$search}%");
|
||||
});
|
||||
}
|
||||
|
||||
// 상태 필터
|
||||
if (! empty($filters['status'])) {
|
||||
$query->where('status', $filters['status']);
|
||||
}
|
||||
|
||||
// Soft Delete 필터
|
||||
if (isset($filters['trashed'])) {
|
||||
if ($filters['trashed'] === 'only') {
|
||||
$query->onlyTrashed();
|
||||
} elseif ($filters['trashed'] === 'with') {
|
||||
$query->withTrashed();
|
||||
}
|
||||
}
|
||||
|
||||
// 정렬
|
||||
$sortBy = $filters['sort_by'] ?? 'id';
|
||||
$sortDirection = $filters['sort_direction'] ?? 'desc';
|
||||
$query->orderBy($sortBy, $sortDirection);
|
||||
|
||||
return $query->paginate($perPage);
|
||||
}
|
||||
|
||||
/**
|
||||
* 활성 프로젝트 목록 (드롭다운용)
|
||||
*/
|
||||
public function getActiveProjects(): Collection
|
||||
{
|
||||
return AdminPmProject::query()
|
||||
->active()
|
||||
->orderBy('name')
|
||||
->get(['id', 'name', 'status']);
|
||||
}
|
||||
|
||||
/**
|
||||
* 특정 프로젝트 조회
|
||||
*/
|
||||
public function getProjectById(int $id, bool $withTrashed = false): ?AdminPmProject
|
||||
{
|
||||
$query = AdminPmProject::query()
|
||||
->with(['tasks' => function ($q) {
|
||||
$q->orderBy('sort_order')->orderBy('id');
|
||||
}, 'issues' => function ($q) {
|
||||
$q->latest();
|
||||
}])
|
||||
->withCount(['tasks', 'issues']);
|
||||
|
||||
if ($withTrashed) {
|
||||
$query->withTrashed();
|
||||
}
|
||||
|
||||
return $query->find($id);
|
||||
}
|
||||
|
||||
/**
|
||||
* 프로젝트 생성
|
||||
*/
|
||||
public function createProject(array $data): AdminPmProject
|
||||
{
|
||||
$data['created_by'] = auth()->id();
|
||||
|
||||
return AdminPmProject::create($data);
|
||||
}
|
||||
|
||||
/**
|
||||
* 프로젝트 수정
|
||||
*/
|
||||
public function updateProject(int $id, array $data): bool
|
||||
{
|
||||
$project = AdminPmProject::findOrFail($id);
|
||||
|
||||
$data['updated_by'] = auth()->id();
|
||||
|
||||
return $project->update($data);
|
||||
}
|
||||
|
||||
/**
|
||||
* 프로젝트 삭제 (Soft Delete)
|
||||
*/
|
||||
public function deleteProject(int $id): bool
|
||||
{
|
||||
$project = AdminPmProject::findOrFail($id);
|
||||
|
||||
$project->deleted_by = auth()->id();
|
||||
$project->save();
|
||||
|
||||
return $project->delete();
|
||||
}
|
||||
|
||||
/**
|
||||
* 프로젝트 복원
|
||||
*/
|
||||
public function restoreProject(int $id): bool
|
||||
{
|
||||
$project = AdminPmProject::onlyTrashed()->findOrFail($id);
|
||||
|
||||
$project->deleted_by = null;
|
||||
|
||||
return $project->restore();
|
||||
}
|
||||
|
||||
/**
|
||||
* 프로젝트 영구 삭제
|
||||
*/
|
||||
public function forceDeleteProject(int $id): bool
|
||||
{
|
||||
$project = AdminPmProject::withTrashed()->findOrFail($id);
|
||||
|
||||
// 관련 작업/이슈 삭제 (cascade 설정됨)
|
||||
return $project->forceDelete();
|
||||
}
|
||||
|
||||
/**
|
||||
* 프로젝트 통계
|
||||
*/
|
||||
public function getProjectStats(): array
|
||||
{
|
||||
return [
|
||||
'total' => AdminPmProject::count(),
|
||||
'active' => AdminPmProject::where('status', AdminPmProject::STATUS_ACTIVE)->count(),
|
||||
'completed' => AdminPmProject::where('status', AdminPmProject::STATUS_COMPLETED)->count(),
|
||||
'on_hold' => AdminPmProject::where('status', AdminPmProject::STATUS_ON_HOLD)->count(),
|
||||
'trashed' => AdminPmProject::onlyTrashed()->count(),
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* 대시보드용 프로젝트 요약
|
||||
*/
|
||||
public function getDashboardSummary(): array
|
||||
{
|
||||
$activeProjects = AdminPmProject::active()
|
||||
->withCount(['tasks', 'issues'])
|
||||
->with(['tasks' => function ($q) {
|
||||
$q->select('id', 'project_id', 'status');
|
||||
}, 'issues' => function ($q) {
|
||||
$q->whereIn('status', [AdminPmIssue::STATUS_OPEN, AdminPmIssue::STATUS_IN_PROGRESS]);
|
||||
}])
|
||||
->get();
|
||||
|
||||
$taskStats = [
|
||||
'total' => AdminPmTask::count(),
|
||||
'todo' => AdminPmTask::status(AdminPmTask::STATUS_TODO)->count(),
|
||||
'in_progress' => AdminPmTask::status(AdminPmTask::STATUS_IN_PROGRESS)->count(),
|
||||
'done' => AdminPmTask::status(AdminPmTask::STATUS_DONE)->count(),
|
||||
'overdue' => AdminPmTask::overdue()->count(),
|
||||
'due_soon' => AdminPmTask::dueSoon()->count(),
|
||||
];
|
||||
|
||||
$issueStats = [
|
||||
'total' => AdminPmIssue::count(),
|
||||
'open' => AdminPmIssue::status(AdminPmIssue::STATUS_OPEN)->count(),
|
||||
'in_progress' => AdminPmIssue::status(AdminPmIssue::STATUS_IN_PROGRESS)->count(),
|
||||
'resolved' => AdminPmIssue::status(AdminPmIssue::STATUS_RESOLVED)->count(),
|
||||
'closed' => AdminPmIssue::status(AdminPmIssue::STATUS_CLOSED)->count(),
|
||||
];
|
||||
|
||||
return [
|
||||
'projects' => $activeProjects,
|
||||
'project_stats' => $this->getProjectStats(),
|
||||
'task_stats' => $taskStats,
|
||||
'issue_stats' => $issueStats,
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* 프로젝트 상태 변경
|
||||
*/
|
||||
public function changeStatus(int $id, string $status): AdminPmProject
|
||||
{
|
||||
$project = AdminPmProject::findOrFail($id);
|
||||
|
||||
$project->status = $status;
|
||||
$project->updated_by = auth()->id();
|
||||
$project->save();
|
||||
|
||||
return $project;
|
||||
}
|
||||
|
||||
/**
|
||||
* 프로젝트 복제
|
||||
*/
|
||||
public function duplicateProject(int $id, ?string $newName = null): AdminPmProject
|
||||
{
|
||||
$original = AdminPmProject::with('tasks')->findOrFail($id);
|
||||
|
||||
$newProject = $original->replicate();
|
||||
$newProject->name = $newName ?? $original->name.' (복사본)';
|
||||
$newProject->status = AdminPmProject::STATUS_ACTIVE;
|
||||
$newProject->created_by = auth()->id();
|
||||
$newProject->updated_by = null;
|
||||
$newProject->deleted_by = null;
|
||||
$newProject->created_at = now();
|
||||
$newProject->updated_at = now();
|
||||
$newProject->save();
|
||||
|
||||
// 작업 복제
|
||||
foreach ($original->tasks as $task) {
|
||||
$newTask = $task->replicate();
|
||||
$newTask->project_id = $newProject->id;
|
||||
$newTask->status = AdminPmTask::STATUS_TODO;
|
||||
$newTask->created_by = auth()->id();
|
||||
$newTask->updated_by = null;
|
||||
$newTask->deleted_by = null;
|
||||
$newTask->created_at = now();
|
||||
$newTask->updated_at = now();
|
||||
$newTask->save();
|
||||
}
|
||||
|
||||
return $newProject->load('tasks');
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user