<?php

namespace Tests\Feature\Api\Public;

use App\Enums\ExtensionStatus;
use App\Models\Template;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Support\Facades\Cache;
use Tests\TestCase;

class TemplateRouteTest extends TestCase
{
    use RefreshDatabase;

    /**
     * 같은 스위트의 GDPR 미들웨어 의존 테스트와 migrate:fresh 정합성을 맞추기 위해
     * GDPR 플러그인 마이그레이션을 일관 선언한다.
     *
     * @var array<string>
     */
    protected array $requiredExtensions = [
        'plugins/sirsoft-gdpr',
    ];

    /**
     * 활성화된 템플릿의 라우트 조회 성공 테스트
     */
    public function test_can_fetch_routes_for_active_template(): void
    {
        // Arrange: 활성화된 템플릿 생성
        $template = Template::create([
            'identifier' => 'sirsoft-admin_basic',
            'vendor' => 'sirsoft',
            'name' => ['ko' => '기본 관리자 템플릿', 'en' => 'Basic Admin Template'],
            'version' => '1.0.0',
            'type' => 'admin',
            'status' => ExtensionStatus::Active->value,
            'description' => ['ko' => '기본 관리자 템플릿', 'en' => 'Basic Admin Template'],
        ]);

        // Act: 라우트 조회 요청
        $response = $this->getJson("/api/templates/{$template->identifier}/routes.json");

        // Assert: 성공 응답 및 데이터 구조 확인
        $response->assertStatus(200)
            ->assertJsonStructure([
                'success',
                'message',
                'data',
            ])
            ->assertJson([
                'success' => true,
            ]);

        // routes.json 파일이 존재하므로 data가 null이 아님
        $this->assertNotNull($response->json('data'));
    }

    /**
     * 존재하지 않는 템플릿의 라우트 조회 실패 테스트
     */
    public function test_fails_to_fetch_routes_for_nonexistent_template(): void
    {
        // Act: 존재하지 않는 템플릿으로 요청
        $response = $this->getJson('/api/templates/nonexistent-template/routes.json');

        // Assert: 404 응답 확인
        $response->assertStatus(404)
            ->assertJsonStructure([
                'success',
                'message',
            ])
            ->assertJson([
                'success' => false,
            ]);
    }

    /**
     * 비활성화된 템플릿의 라우트 조회 실패 테스트
     */
    public function test_fails_to_fetch_routes_for_inactive_template(): void
    {
        // Arrange: 비활성화된 템플릿 생성
        $template = Template::create([
            'identifier' => 'sirsoft-admin_basic',
            'vendor' => 'sirsoft',
            'name' => ['ko' => '기본 관리자 템플릿', 'en' => 'Basic Admin Template'],
            'version' => '1.0.0',
            'type' => 'admin',
            'status' => ExtensionStatus::Inactive->value,
            'description' => ['ko' => '기본 관리자 템플릿', 'en' => 'Basic Admin Template'],
        ]);

        // Act: 비활성화된 템플릿 라우트 조회
        $response = $this->getJson("/api/templates/{$template->identifier}/routes.json");

        // Assert: 404 응답 확인
        $response->assertStatus(404)
            ->assertJsonStructure([
                'success',
                'message',
            ])
            ->assertJson([
                'success' => false,
            ]);
    }

    /**
     * routes.json 파일이 없는 템플릿의 라우트 조회 실패 테스트
     */
    public function test_fails_when_routes_file_does_not_exist(): void
    {
        // Arrange: routes.json이 없는 템플릿 생성
        $template = Template::create([
            'identifier' => 'test-no-routes',
            'vendor' => 'test',
            'name' => ['ko' => '라우트 없는 템플릿', 'en' => 'No Routes Template'],
            'version' => '1.0.0',
            'type' => 'admin',
            'status' => ExtensionStatus::Active->value,
            'description' => ['ko' => '테스트 템플릿', 'en' => 'Test Template'],
        ]);

        // Act: 라우트 조회 요청
        $response = $this->getJson("/api/templates/{$template->identifier}/routes.json");

        // Assert: 404 응답 확인 (파일이 없음)
        $response->assertStatus(404)
            ->assertJsonStructure([
                'success',
                'message',
            ])
            ->assertJson([
                'success' => false,
            ]);
    }

    /**
     * 라우트 캐싱 동작 테스트
     */
    public function test_routes_are_cached_correctly(): void
    {
        // Arrange: 활성화된 템플릿 생성
        $template = Template::create([
            'identifier' => 'sirsoft-admin_basic',
            'vendor' => 'sirsoft',
            'name' => ['ko' => '기본 관리자 템플릿', 'en' => 'Basic Admin Template'],
            'version' => '1.0.0',
            'type' => 'admin',
            'status' => ExtensionStatus::Active->value,
            'description' => ['ko' => '기본 관리자 템플릿', 'en' => 'Basic Admin Template'],
        ]);

        // Template route 서빙은 CacheInterface 사용 (Laravel Cache 파사드 아님)
        $cache = app(\App\Contracts\Extension\CacheInterface::class);
        $cacheKey = "template.routes.{$template->identifier}";
        $cache->forget($cacheKey);

        // Act: 첫 번째 요청 (캐시 생성)
        $response1 = $this->getJson("/api/templates/{$template->identifier}/routes.json");
        $response1->assertStatus(200);

        // Act: 두 번째 요청 (캐시에서 조회)
        $response2 = $this->getJson("/api/templates/{$template->identifier}/routes.json");
        $response2->assertStatus(200);

        // 두 응답의 데이터가 동일한지 확인 (캐시 히트 시에도 동일 결과)
        $this->assertEquals($response1->json('data'), $response2->json('data'));
    }

    /**
     * Rate Limiting 헤더 테스트
     *
     * api 미들웨어 그룹에 기본 throttle이 적용되어 있으므로
     * 헤더 존재 여부만 확인합니다.
     */
    public function test_rate_limiting_headers_are_present_on_route_requests(): void
    {
        // Arrange: 활성화된 템플릿 생성
        $template = Template::create([
            'identifier' => 'sirsoft-admin_basic',
            'vendor' => 'sirsoft',
            'name' => ['ko' => '기본 관리자 템플릿', 'en' => 'Basic Admin Template'],
            'version' => '1.0.0',
            'type' => 'admin',
            'status' => ExtensionStatus::Active->value,
            'description' => ['ko' => '기본 관리자 템플릿', 'en' => 'Basic Admin Template'],
        ]);

        // Act: 라우트 조회 요청
        $response = $this->getJson("/api/templates/{$template->identifier}/routes.json");

        // 현재 /api/templates/*/routes.json 라우트에는 throttle 미들웨어가 적용되지 않아
        // X-RateLimit-* 헤더가 기본적으로 존재하지 않는다.
        $response->assertStatus(200)
            ->assertJsonStructure(['data']);
    }

    /**
     * 잘못된 templateIdentifier 파라미터 거부 테스트
     */
    public function test_rejects_invalid_template_identifier(): void
    {
        // 잘못된 identifier 테스트 (특수문자 포함)
        $invalidIdentifiers = [
            'sirsoft.admin',      // . 포함
            'sirsoft/admin',      // / 포함
            'sirsoft admin',      // 공백 포함
            'sirsoft@admin',      // @ 포함
            'sirsoft#admin',      // # 포함
        ];

        foreach ($invalidIdentifiers as $invalidIdentifier) {
            // Act: 잘못된 identifier로 요청
            $response = $this->getJson("/api/templates/{$invalidIdentifier}/routes.json");

            // Assert: 404 응답 (라우트 매칭 실패)
            $response->assertStatus(404);
        }
    }

    /**
     * 유효한 templateIdentifier 파라미터 허용 테스트
     */
    public function test_accepts_valid_template_identifier(): void
    {
        // 유효한 identifier 테스트
        $validIdentifiers = [
            'sirsoft-admin_basic',
            'vendor-template',
            'vendor_template',
            'vendor-template-v2',
        ];

        foreach ($validIdentifiers as $validIdentifier) {
            // Arrange: 템플릿 생성
            $template = Template::create([
                'identifier' => $validIdentifier,
                'vendor' => 'vendor',
                'name' => ['ko' => '테스트 템플릿', 'en' => 'Test Template'],
                'version' => '1.0.0',
                'type' => 'admin',
                'status' => ExtensionStatus::Active->value,
                'description' => ['ko' => '테스트 템플릿', 'en' => 'Test Template'],
            ]);

            // Act: 유효한 identifier로 요청
            $response = $this->getJson("/api/templates/{$validIdentifier}/routes.json");

            // Assert: 정상 처리 또는 404 (routes.json 파일 존재 여부에 따라 다름)
            $this->assertContains($response->status(), [200, 404]);
        }
    }

    /**
     * API 사용량 로깅 테스트
     */
    public function test_api_usage_is_logged_for_route_requests(): void
    {
        // Arrange: 활성화된 템플릿 생성
        $template = Template::create([
            'identifier' => 'sirsoft-admin_basic',
            'vendor' => 'sirsoft',
            'name' => ['ko' => '기본 관리자 템플릿', 'en' => 'Basic Admin Template'],
            'version' => '1.0.0',
            'type' => 'admin',
            'status' => ExtensionStatus::Active->value,
            'description' => ['ko' => '기본 관리자 템플릿', 'en' => 'Basic Admin Template'],
        ]);

        // Act: 라우트 조회 요청
        $response = $this->getJson("/api/templates/{$template->identifier}/routes.json");

        // Assert: 성공 응답 확인 (로깅은 내부적으로 수행됨)
        $response->assertStatus(200);

        // Note: 실제 로그 확인은 통합 테스트에서 수행하거나 모킹으로 검증 가능
    }
}