validated(); $filters = [ 'search' => $validated['search'] ?? null, 'filters' => $validated['filters'] ?? [], 'status' => $validated['status'] ?? null, 'type' => $validated['type'] ?? null, ]; $perPage = (int) ($validated['per_page'] ?? 12); $page = (int) ($validated['page'] ?? 1); $result = $this->templateService->getPaginatedTemplates($filters, $perPage, $page); $collection = new TemplateCollection(collect($result['data'])); return $this->success('templates.fetch_success', [ 'data' => $collection->toArray($request)['data'], 'pagination' => [ 'total' => $result['total'], 'current_page' => $result['current_page'], 'last_page' => $result['last_page'], 'per_page' => $result['per_page'], ], 'meta' => $collection->with($request)['meta'], 'abilities' => [ 'can_install' => PermissionHelper::check('core.templates.install', $request->user()), 'can_activate' => PermissionHelper::check('core.templates.activate', $request->user()), 'can_uninstall' => PermissionHelper::check('core.templates.uninstall', $request->user()), ], ]); } catch (\Exception $e) { return $this->error('templates.fetch_failed', 500, $e->getMessage()); } } /** * 특정 템플릿의 상세 정보를 조회합니다. * * @param string $templateName 템플릿 식별자 * @return JsonResponse 템플릿 정보를 포함한 JSON 응답 */ public function show(string $templateName): JsonResponse { try { $templateInfo = $this->templateService->getTemplateInfo($templateName); if (! $templateInfo) { return $this->error('templates.not_found', 404, null, ['template' => $templateName]); } // 상세 정보는 toDetailArray() 메서드 사용 $resource = new TemplateResource($templateInfo); return $this->success('templates.fetch_success', $resource->toDetailArray()); } catch (\Exception $e) { return $this->error('templates.fetch_failed', 500, $e->getMessage()); } } /** * 템플릿을 시스템에 설치합니다. * * @param InstallTemplateRequest $request 템플릿 설치 요청 데이터 * @return JsonResponse 설치된 템플릿 정보를 포함한 JSON 응답 */ public function install(InstallTemplateRequest $request): JsonResponse { try { $templateName = $request->validated()['template_name']; $template = $this->templateService->installTemplate($templateName); if ($template) { return $this->successWithResource( 'templates.install_success', new TemplateResource($template), 201 ); } else { return $this->error('templates.install_failed'); } } catch (ValidationException $e) { // Service에서 이미 번역된 메시지를 errors에 포함하므로 // 첫 번째 에러를 top-level message로 직접 사용 (이중 래핑 방지) $firstError = collect($e->errors())->flatten()->first() ?? __('templates.install_failed'); return $this->validationError($e->errors(), $firstError); } catch (\Exception $e) { return $this->error('templates.errors.installation_failed', 500, $e->getMessage(), [ 'error' => $e->getMessage(), ]); } } /** * 템플릿을 활성화합니다. * * force 파라미터가 없고 필요한 의존성이 충족되지 않은 경우 경고를 반환합니다. * * @param ActivateTemplateRequest $request 템플릿 활성화 요청 데이터 * @return JsonResponse 활성화된 템플릿 정보를 포함한 JSON 응답 */ public function activate(ActivateTemplateRequest $request): JsonResponse { try { $validated = $request->validated(); $templateName = $validated['template_name']; $force = $validated['force'] ?? false; $result = $this->templateService->activateTemplate($templateName, $force); // 경고 응답인 경우 (필요 의존성 미충족) - 활성화 실패로 처리 if (isset($result['warning']) && $result['warning'] === true) { return $this->error('templates.activate_warning', 409, [ 'warning' => true, 'missing_modules' => $result['missing_modules'] ?? [], 'missing_plugins' => $result['missing_plugins'] ?? [], 'message' => $result['message'], ]); } if ($result['success']) { $templateInfo = $result['template_info'] ?? null; if ($templateInfo) { return $this->successWithResource( 'templates.activate_success', new TemplateResource($templateInfo) ); } return $this->success('templates.activate_success', $result); } else { return $this->error('templates.activate_failed'); } } catch (ValidationException $e) { return $this->error('templates.activate_failed', 422, $e->errors()); } catch (\Exception $e) { return $this->error('templates.activate_failed', 500, $e->getMessage()); } } /** * 템플릿을 비활성화합니다. * * @param DeactivateTemplateRequest $request 템플릿 비활성화 요청 데이터 * @return JsonResponse 비활성화된 템플릿 정보를 포함한 JSON 응답 */ public function deactivate(DeactivateTemplateRequest $request): JsonResponse { try { $templateName = $request->validated()['template_name']; $template = $this->templateService->deactivateTemplate($templateName); if ($template) { return $this->successWithResource( 'templates.deactivate_success', new TemplateResource($template) ); } else { return $this->error('templates.deactivate_failed'); } } catch (ValidationException $e) { return $this->error('templates.deactivate_failed', 422, $e->errors()); } catch (\Exception $e) { return $this->error('templates.deactivate_failed', 500, $e->getMessage()); } } /** * 템플릿을 시스템에서 제거합니다. * * @param UninstallTemplateRequest $request 템플릿 제거 요청 데이터 * @return JsonResponse 제거 결과 JSON 응답 */ public function uninstall(UninstallTemplateRequest $request): JsonResponse { try { $validated = $request->validated(); $templateName = $validated['template_name']; $deleteData = $validated['delete_data'] ?? false; $result = $this->templateService->uninstallTemplate($templateName, $deleteData); if ($result) { return $this->success('templates.uninstall_success'); } else { return $this->error('templates.uninstall_failed'); } } catch (ValidationException $e) { return $this->error('templates.uninstall_failed', 422, $e->errors()); } catch (\Exception $e) { return $this->error('templates.uninstall_failed', 500, $e->getMessage()); } } /** * 템플릿 삭제 시 삭제될 데이터 정보를 조회합니다. * * @param string $templateName 템플릿명 * @return JsonResponse 삭제 정보를 포함한 JSON 응답 */ public function uninstallInfo(string $templateName): JsonResponse { try { $uninstallInfo = $this->templateService->getTemplateUninstallInfo($templateName); if (! $uninstallInfo) { return $this->error('templates.not_found', 404, null, ['template' => $templateName]); } return $this->success('templates.uninstall_info_success', $uninstallInfo); } catch (\Exception $e) { return $this->error('templates.uninstall_info_failed', 500, $e->getMessage()); } } /** * ZIP 파일에서 템플릿을 설치합니다. * * @param InstallTemplateFromFileRequest $request 파일 설치 요청 데이터 * @return JsonResponse 설치된 템플릿 정보를 포함한 JSON 응답 */ public function installFromFile(InstallTemplateFromFileRequest $request): JsonResponse { try { $file = $request->file('file'); $template = $this->templateService->installFromZipFile($file); return $this->successWithResource( 'templates.install_success', new TemplateResource($template), 201 ); } catch (\RuntimeException $e) { return $this->error($e->getMessage(), 422); } catch (\Exception $e) { return $this->error('templates.install_failed', 500, ['error' => $e->getMessage()]); } } /** * GitHub 저장소에서 템플릿을 설치합니다. * * @param InstallTemplateFromGithubRequest $request GitHub 설치 요청 데이터 * @return JsonResponse 설치된 템플릿 정보를 포함한 JSON 응답 */ public function installFromGithub(InstallTemplateFromGithubRequest $request): JsonResponse { try { $githubUrl = $request->validated()['github_url']; $template = $this->templateService->installFromGithub($githubUrl); return $this->successWithResource( 'templates.install_success', new TemplateResource($template), 201 ); } catch (\RuntimeException $e) { return $this->error($e->getMessage(), 422); } catch (\Exception $e) { return $this->error('templates.install_failed', 500, ['error' => $e->getMessage()]); } } /** * 템플릿의 레이아웃을 파일에서 다시 읽어 갱신합니다. * * @param RefreshTemplateLayoutsRequest $request 레이아웃 갱신 요청 데이터 * @return JsonResponse 갱신된 템플릿 정보를 포함한 JSON 응답 */ public function refreshLayouts(RefreshTemplateLayoutsRequest $request): JsonResponse { try { $templateName = $request->validated()['template_name']; $template = $this->templateService->refreshTemplateLayouts($templateName); if ($template) { return $this->successWithResource( 'templates.refresh_layouts_success', new TemplateResource($template) ); } else { return $this->error('templates.refresh_layouts_failed'); } } catch (ValidationException $e) { return $this->error('templates.refresh_layouts_failed', 422, $e->errors()); } catch (\Exception $e) { return $this->error('templates.refresh_layouts_failed', 500, $e->getMessage()); } } /** * 설치된 모든 템플릿의 업데이트를 확인합니다. * * @return JsonResponse 업데이트 확인 결과 JSON 응답 */ public function checkUpdates(): JsonResponse { try { $result = $this->templateService->checkForUpdates(); return $this->success('templates.check_updates_success', $result); } catch (ValidationException $e) { return $this->error('templates.check_updates_failed', 422, $e->errors()); } catch (\Exception $e) { return $this->error('templates.check_updates_failed', 500, $e->getMessage()); } } /** * 특정 템플릿의 수정된 레이아웃을 확인합니다. * * 업데이트 전 사용자가 수정한 레이아웃이 있는지 확인하여 * 레이아웃 전략(overwrite/keep) 선택에 참고할 수 있도록 합니다. * * @param string $templateName 템플릿 식별자 * @return JsonResponse 수정된 레이아웃 정보를 포함한 JSON 응답 */ public function checkModifiedLayouts(string $templateName): JsonResponse { try { $result = $this->templateService->checkModifiedLayouts($templateName); return $this->success('templates.check_modified_layouts_success', $result); } catch (ValidationException $e) { return $this->error('templates.check_modified_layouts_failed', 422, $e->errors()); } catch (\Exception $e) { return $this->error('templates.check_modified_layouts_failed', 500, $e->getMessage()); } } /** * 특정 템플릿을 업데이트합니다. * * layout_strategy 파라미터로 레이아웃 처리 방식을 결정합니다: * - overwrite: 모든 레이아웃을 새 버전으로 교체 * - keep: 사용자가 수정한 레이아웃을 유지 * * @param PerformTemplateUpdateRequest $request 업데이트 요청 데이터 * @param string $templateName 업데이트할 템플릿 identifier * @return JsonResponse 업데이트 결과 JSON 응답 */ public function performUpdate(PerformTemplateUpdateRequest $request, string $templateName): JsonResponse { try { $layoutStrategy = $request->validated()['layout_strategy'] ?? 'overwrite'; $result = $this->templateService->performVersionUpdate($templateName, $layoutStrategy); $templateInfo = $result['template_info'] ?? null; if ($templateInfo) { return $this->successWithResource( 'templates.update_success', new TemplateResource($templateInfo) ); } return $this->success('templates.update_success', $result); } catch (ValidationException $e) { // Service/Manager에서 이미 번역된 메시지를 errors에 포함하므로 // 첫 번째 에러를 top-level message로 직접 사용 (이중 래핑 방지) $firstError = collect($e->errors())->flatten()->first() ?? __('templates.errors.update_failed', ['template' => $templateName, 'error' => '']); return $this->validationError($e->errors(), $firstError); } catch (\Exception $e) { return $this->error('templates.errors.update_failed', 500, $e->getMessage(), [ 'template' => $templateName, 'error' => $e->getMessage(), ]); } } /** * 특정 템플릿의 변경 내역(changelog)을 조회합니다. * * @param Request $request HTTP 요청 * @param string $identifier 템플릿 식별자 * @return JsonResponse 변경 내역을 포함한 JSON 응답 */ public function changelog(ChangelogRequest $request, string $identifier): JsonResponse { try { $validated = $request->validated(); $changelog = $this->templateService->getTemplateChangelog( $identifier, $validated['source'] ?? null, $validated['from_version'] ?? null, $validated['to_version'] ?? null, ); return $this->success('template.fetch_success', ['changelog' => $changelog]); } catch (\Exception $e) { return $this->error('template.fetch_failed', 500, $e->getMessage()); } } /** * 템플릿의 라이선스 파일 내용을 반환합니다. * * @param string $identifier 템플릿 식별자 * @return JsonResponse */ public function license(string $identifier): JsonResponse { if (! preg_match('/^[a-z0-9][a-z0-9_-]*$/', $identifier)) { return $this->error('templates.license_not_found', 404); } $content = $this->licenseService->getExtensionLicense('templates', $identifier); if ($content === null) { return $this->error('templates.license_not_found', 404); } return $this->success('templates.fetch_success', [ 'content' => $content, ]); } }