Gnuboard7/app/Seo/TemplateRouteResolver.php

<?php

namespace App\Seo;

use App\Contracts\Extension\ModuleManagerInterface;
use App\Contracts\Extension\PluginManagerInterface;
use App\Contracts\Extension\TemplateManagerInterface;
use App\Services\TemplateService;

class TemplateRouteResolver
{
    /**
     * 템플릿 routes.json 이 아닌 **코어가 직접 소유하는** admin 경로 접두사.
     *
     * 레이아웃 편집기는 코어 기능이라 어느 템플릿의 routes.json 에도 선언되지 않는다.
     * 템플릿 라우트만 보고 판정하면 실제로 동작하는 화면이 HTTP 404 로 서빙되므로
     * (본문은 SPA 셸이라 화면은 뜨지만 상태 코드만 404), 존재하는 경로로 인정한다.
     *
     * @var array<string>
     */
    private const CORE_ADMIN_ROUTE_PREFIXES = [
        '/admin/layout-editor',
    ];

    public function __construct(
        private readonly TemplateService $templateService,
        private readonly TemplateManagerInterface $templateManager,
        private readonly ModuleManagerInterface $moduleManager,
        private readonly PluginManagerInterface $pluginManager,
    ) {}

    /**
     * URL을 템플릿 레이아웃으로 매핑합니다.
     *
     * @param  string  $url  요청 URL 경로
     * @return array|null { templateIdentifier, layoutName, routeParams, moduleIdentifier? } 또는 null
     */
    public function resolve(string $url): ?array
    {
        $loaded = $this->loadActiveRoutes('user');
        if ($loaded === null) {
            return null;
        }

        [$templateIdentifier, $routes] = $loaded;

        foreach ($routes as $route) {
            // auth_required 라우트 제외
            if ($route['auth_required'] ?? false) {
                continue;
            }

            // guest_only 라우트 제외
            if ($route['guest_only'] ?? false) {
                continue;
            }

            $routePath = $route['path'] ?? '';
            $routePath = $this->resolveRoutePath($routePath);

            $params = $this->matchRoute($routePath, $url);
            if ($params !== null) {
                $layoutName = $route['layout'] ?? '';

                // 확장 식별자 추출 (레이아웃명에 '.' 포함 시)
                $moduleIdentifier = null;
                $pluginIdentifier = null;
                if (str_contains($layoutName, '.')) {
                    [$extensionId, $layoutName] = explode('.', $layoutName, 2);

                    // 모듈/플러그인 판별
                    if ($this->moduleManager->getModule($extensionId) !== null) {
                        $moduleIdentifier = $extensionId;
                    } elseif ($this->pluginManager->getPlugin($extensionId) !== null) {
                        $pluginIdentifier = $extensionId;
                    } else {
                        // fallback: 기존 동작 유지 (모듈로 간주)
                        $moduleIdentifier = $extensionId;
                    }
                }

                return [
                    'templateIdentifier' => $templateIdentifier,
                    'layoutName' => $layoutName,
                    'routeParams' => $params,
                    'moduleIdentifier' => $moduleIdentifier,
                    'pluginIdentifier' => $pluginIdentifier,
                    'routeMeta' => $route['meta'] ?? [],
                ];
            }
        }

        return null;
    }

    /**
     * URL이 활성 템플릿(+모듈/플러그인 병합)의 등록된 라우트에 존재하는지 판별합니다.
     *
     * resolve()와 달리 auth_required/guest_only 라우트도 "존재"로 인정합니다.
     * 미등록 경로 catch-all 의 404 판별에 사용합니다 (공개#47).
     *
     * @param  string  $url  요청 URL 경로 (선행 '/' 포함)
     * @param  string  $type  템플릿 타입 ('user' | 'admin')
     * @return bool 등록 라우트면 true, 미등록이면 false. 템플릿 미설치/로드 실패 시 true(404 억제, 안전측).
     */
    public function routeExists(string $url, string $type = 'user'): bool
    {
        // 코어 소유 admin 경로는 템플릿 routes.json 에 없어도 존재하는 경로다.
        if ($type === 'admin' && $this->isCoreAdminRoute($url)) {
            return true;
        }

        $loaded = $this->loadActiveRoutes($type);
        // 템플릿 미설치/로드 실패 시 전 경로 404 차단 — 안전측 폴백 (D-47-3).
        if ($loaded === null) {
            return true;
        }

        [, $routes] = $loaded;

        foreach ($routes as $route) {
            // auth_required/guest_only 검사 없이 path 만 매칭 (resolve()와 차이 — 핵심).
            $routePath = $this->resolveRoutePath($route['path'] ?? '');

            if ($this->matchRoute($routePath, $url) !== null) {
                return true;
            }
        }

        return false;
    }

    /**
     * URL 이 코어가 직접 소유하는 admin 경로인지 판정합니다.
     *
     * 접두사 뒤에는 경로 구분자(`/`) 또는 문자열 끝만 허용한다 — `/admin/layout-editorX`
     * 같은 유사 경로가 통과하지 않도록 한다.
     *
     * @param  string  $url  요청 URL 경로
     * @return bool 코어 소유 경로면 true
     */
    private function isCoreAdminRoute(string $url): bool
    {
        $path = '/'.trim(parse_url($url, PHP_URL_PATH) ?? $url, '/');

        foreach (self::CORE_ADMIN_ROUTE_PREFIXES as $prefix) {
            if ($path === $prefix || str_starts_with($path, $prefix.'/')) {
                return true;
            }
        }

        return false;
    }

    /**
     * 활성 템플릿($type)의 병합 routes 배열을 로드합니다.
     *
     * @param  string  $type  템플릿 타입 ('user' | 'admin')
     * @return array{0: string, 1: array}|null [templateIdentifier, routes] 또는 실패 시 null
     */
    private function loadActiveRoutes(string $type): ?array
    {
        $activeTemplate = $this->templateManager->getActiveTemplate($type);
        if (! $activeTemplate) {
            return null;
        }

        $templateIdentifier = $activeTemplate['identifier'] ?? null;
        if (! $templateIdentifier) {
            return null;
        }

        $routesResult = $this->templateService->getRoutesDataWithModules($templateIdentifier);
        if (! ($routesResult['success'] ?? false) || empty($routesResult['data']['routes'])) {
            return null;
        }

        return [$templateIdentifier, $routesResult['data']['routes']];
    }

    /**
     * 라우트 경로의 동적 표현식을 해석합니다.
     *
     * @param  string  $routePath  라우트 경로
     * @return string 해석된 경로
     */
    private function resolveRoutePath(string $routePath): string
    {
        // 와일드카드 '*' 제거 (prefix 표시용)
        $routePath = ltrim($routePath, '*/');
        if (! str_starts_with($routePath, '/')) {
            $routePath = '/'.$routePath;
        }

        // 템플릿 표현식 해석: {{_global.modules?.['sirsoft-ecommerce']?.basic_info?.route_path ?? 'shop'}}
        $routePath = (string) preg_replace_callback('/\{\{(.+?)\}\}/', function ($matches) {
            $expr = trim($matches[1]);

            return $this->resolveRouteExpression($expr);
        }, $routePath);

        // 이중 슬래시 정규화 (빈 표현식 결과 시 발생)
        $routePath = preg_replace('#/+#', '/', $routePath);

        return $routePath;
    }

    /**
     * 라우트 경로 내 표현식을 해석합니다.
     *
     * @param  string  $expr  표현식
     * @return string 해석된 값
     */
    private function resolveRouteExpression(string $expr): string
    {
        // 삼항 연산자 패턴: condition ? '' : (modules?.['id']?.key ?? 'default')
        // no_route 플래그가 true면 빈 문자열, 아니면 route_path 또는 기본값 반환
        if (preg_match("/\.no_route\s*\?/", $expr)) {
            // 삼항 else 절(: 이후)에서 모듈 설정 추출
            $elseClause = preg_match("/:\s*(.+)$/", $expr, $elseMatch) ? $elseMatch[1] : '';
            if ($elseClause !== '' && preg_match("/modules\?\.\['([^']+)'\]\?\.([\\w?.]+)\s*\?\?\s*'(.+?)'/", $elseClause, $matches)) {
                $moduleId = $matches[1];
                // optional chaining 제거: basic_info?.route_path → basic_info.route_path
                $settingKey = str_replace('?.', '.', $matches[2]);
                $default = $matches[3];

                // no_route 설정 확인
                $noRoute = g7_module_settings($moduleId, 'basic_info.no_route');
                if ($noRoute) {
                    return '';
                }

                return g7_module_settings($moduleId, $settingKey) ?? $default;
            }
        }

        // _global.modules?.['module-id']?.key ?? 'default' 패턴 처리 (optional chaining 포함)
        if (preg_match("/modules\?\.\['([^']+)'\]\?\.([\\w?.]+)\s*\?\?\s*'(.+?)'/", $expr, $matches)) {
            $moduleId = $matches[1];
            $settingKey = str_replace('?.', '.', $matches[2]);
            $default = $matches[3];

            return g7_module_settings($moduleId, $settingKey) ?? $default;
        }

        // 단순 null coalescing
        if (str_contains($expr, '??')) {
            $parts = array_map('trim', explode('??', $expr, 2));

            return trim($parts[1], " '\"()");
        }

        return $expr;
    }

    /**
     * URL이 라우트 패턴에 매칭되는지 확인합니다.
     *
     * @param  string  $routePath  라우트 패턴 (예: /shop/products/:id)
     * @param  string  $url  실제 URL (예: /shop/products/123)
     * @return array|null 매칭된 파라미터 또는 null
     */
    private function matchRoute(string $routePath, string $url): ?array
    {
        // 정규식으로 변환
        $pattern = preg_replace('/:(\w+)/', '(?P<$1>[^/]+)', $routePath);
        $pattern = '#^'.$pattern.'$#';

        if (preg_match($pattern, $url, $matches)) {
            $params = [];
            foreach ($matches as $key => $value) {
                if (is_string($key)) {
                    $params[$key] = $value;
                }
            }

            return $params;
        }

        return null;
    }
}