v7.0.0 release

app/Http/Controllers/Api/Admin/SeoBotPreviewController.php

@@ -0,0 +1,62 @@
+<?php
+
+namespace App\Http\Controllers\Api\Admin;
+
+use App\Http\Controllers\Api\Base\AdminBaseController;
+use App\Http\Requests\Admin\SeoBotPreviewRequest;
+use App\Seo\Editor\SeoBotPreviewService;
+use Illuminate\Http\JsonResponse;
+
+/**
+ * 봇 HTML 실시간 미리보기 엔드포인트 — 편집기 [검색엔진] 탭.
+ *
+ * 편집기 전용 가드(`core.templates.layouts.edit`) 하에서만 노출(Bearer fetch). dirty 레이아웃
+ * + 편집기 샘플 데이터로 운영과 동일 코드 경로(`renderFromResolved`)를 거쳐 완성 HTML 을
+ * 반환한다(SEO 캐시 우회). 설정 변경 디바운스 후 재호출로 실시간 갱신된다.
+ */
+class SeoBotPreviewController extends AdminBaseController
+{
+    public function __construct(
+        private readonly SeoBotPreviewService $previewService,
+    ) {
+        parent::__construct();
+    }
+
+    /**
+     * dirty 레이아웃 + 샘플로 봇 HTML 미리보기를 반환합니다.
+     *
+     * @param  SeoBotPreviewRequest  $request  dirty 레이아웃·샘플·route·locale 검증된 입력
+     * @param  string  $identifier  템플릿 식별자
+     * @return JsonResponse 완성 HTML 또는 SEO 미노출 안내
+     */
+    public function show(SeoBotPreviewRequest $request, string $identifier): JsonResponse
+    {
+        $validated = $request->validated();
+
+        $html = $this->previewService->render(
+            $validated['layout'],
+            $validated['route_params'] ?? [],
+            $validated['url'] ?? '/',
+            $validated['locale'] ?? app()->getLocale(),
+            $identifier,
+            $validated['module_id'] ?? null,
+            $validated['plugin_id'] ?? null,
+            $validated['seed_context'] ?? [],
+        );
+
+        // JSON 직렬화 경계 — 미리보기 HTML 에 유효하지 않은 UTF-8 바이트가 있으면 JsonResponse 가
+        // "Malformed UTF-8" 로 500 을 던진다(샘플 데이터/표현식 평가 잔여로 잘린 멀티바이트 가능).
+        // 응답 직전 한 번 정화해 직렬화를 보장한다(산출물 내용 불변 — 깨진 바이트만 제거).
+        if (is_string($html)) {
+            $clean = @iconv('UTF-8', 'UTF-8//IGNORE', $html);
+            $html = $clean === false ? mb_convert_encoding($html, 'UTF-8', 'UTF-8') : $clean;
+        }
+
+        return $this->success('common.success', [
+            'identifier' => $identifier,
+            // null = meta.seo.enabled=false 또는 미렌더 → 편집기 "검색엔진 미노출" 안내.
+            'enabled' => $html !== null,
+            'html' => $html,
+        ]);
+    }
+}