Files
Gnuboard7/app/Services/LayoutPreviewService.php
T
2026-05-11 11:29:41 +09:00

140 lines
4.7 KiB
PHP

<?php
namespace App\Services;
use App\Contracts\Repositories\LayoutPreviewRepositoryInterface;
use App\Contracts\Repositories\TemplateRepositoryInterface;
use App\Extension\HookManager;
use App\Models\TemplateLayoutPreview;
use Illuminate\Support\Str;
/**
* 레이아웃 미리보기 서비스
*/
class LayoutPreviewService
{
/**
* 미리보기 기본 만료 시간 (분)
*/
private const DEFAULT_TTL_MINUTES = 30;
/**
* @param LayoutPreviewRepositoryInterface $previewRepository 미리보기 리포지토리
* @param LayoutService $layoutService 레이아웃 서비스
* @param LayoutExtensionService $layoutExtensionService 레이아웃 확장 서비스
* @param TemplateRepositoryInterface $templateRepository 템플릿 리포지토리
*/
public function __construct(
private readonly LayoutPreviewRepositoryInterface $previewRepository,
private readonly LayoutService $layoutService,
private readonly LayoutExtensionService $layoutExtensionService,
private readonly TemplateRepositoryInterface $templateRepository,
) {}
/**
* 미리보기를 생성합니다.
*
* @param int $templateId 템플릿 ID
* @param string $layoutName 레이아웃 이름
* @param array $content 편집 중인 레이아웃 JSON
* @param int $adminId 관리자 ID
* @return TemplateLayoutPreview 생성된 미리보기 모델
*/
public function createPreview(int $templateId, string $layoutName, array $content, int $adminId): TemplateLayoutPreview
{
// 훅: 미리보기 생성 전 (IDV 정책 가드 지점)
HookManager::doAction('core.layout_preview.before_generate', $templateId, $layoutName, $content, $adminId);
// 기존 동일 조합의 미리보기 삭제
$this->previewRepository->deleteByLayoutAndAdmin($templateId, $layoutName, $adminId);
$preview = $this->previewRepository->create([
'token' => (string) Str::uuid(),
'template_id' => $templateId,
'layout_name' => $layoutName,
'content' => $content,
'admin_id' => $adminId,
'expires_at' => now()->addMinutes(self::DEFAULT_TTL_MINUTES),
]);
HookManager::doAction('core.layout_preview.after_generate', $preview);
return $preview;
}
/**
* 토큰으로 미리보기 레이아웃을 조회하고 병합합니다.
*
* 편집 중인 content에 extends가 있으면 부모 레이아웃과 병합하고,
* 모듈/플러그인 extension도 적용합니다.
*
* @param string $token 미리보기 토큰
* @return array|null 병합된 레이아웃 데이터 또는 null
*/
public function getPreviewLayout(string $token): ?array
{
$preview = $this->previewRepository->findByToken($token);
if (! $preview) {
return null;
}
$layoutData = $preview->content;
$templateId = $preview->template_id;
// extends 상속 병합
if (isset($layoutData['extends'])) {
$parentLayoutName = $layoutData['extends'];
$parentLayout = $this->layoutService->loadAndMergeLayout($templateId, $parentLayoutName);
$layoutData = $this->layoutService->mergeLayouts($parentLayout, $layoutData);
}
// 모듈/플러그인 Extension 적용
$layoutData = $this->layoutExtensionService->applyExtensions($layoutData, $templateId);
return $layoutData;
}
/**
* 토큰으로 미리보기의 템플릿 식별자를 조회합니다.
*
* @param string $token 미리보기 토큰
* @return string|null 템플릿 식별자 또는 null
*/
public function getTemplateIdentifierByToken(string $token): ?string
{
$preview = $this->previewRepository->findByToken($token);
if (! $preview) {
return null;
}
$template = $this->templateRepository->findById($preview->template_id);
return $template?->identifier;
}
/**
* 만료된 미리보기를 삭제합니다.
*
* @return int 삭제된 행 수
*/
public function cleanupExpired(): int
{
return $this->previewRepository->deleteExpired();
}
/**
* 특정 관리자의 특정 레이아웃 미리보기를 삭제합니다.
*
* @param int $templateId 템플릿 ID
* @param string $layoutName 레이아웃 이름
* @param int $adminId 관리자 ID
* @return int 삭제된 행 수
*/
public function deleteByLayoutAndAdmin(int $templateId, string $layoutName, int $adminId): int
{
return $this->previewRepository->deleteByLayoutAndAdmin($templateId, $layoutName, $adminId);
}
}