admin = $this->createAdminUser(); $this->token = $this->admin->createToken('test-token')->plainTextToken; } /** * 관리자 역할 생성 및 할당 * * @param array $permissions 사용자에게 부여할 권한 식별자 목록 * @return User 생성된 관리자 사용자 */ private function createAdminUser(array $permissions = ['core.settings.read', 'core.settings.update']): User { $user = User::factory()->create([ 'password' => Hash::make('password123'), ]); // 권한 생성 $permissionIds = []; foreach ($permissions as $permIdentifier) { $permission = Permission::firstOrCreate( ['identifier' => $permIdentifier], [ 'name' => json_encode(['ko' => $permIdentifier, 'en' => $permIdentifier]), 'description' => json_encode(['ko' => $permIdentifier.' 권한', 'en' => $permIdentifier.' Permission']), 'extension_type' => ExtensionOwnerType::Core, 'extension_identifier' => 'core', 'type' => 'admin', ] ); $permissionIds[] = $permission->id; } // 고유한 식별자로 역할 생성 (테스트별 격리를 위해) $roleIdentifier = 'admin_test_'.uniqid(); $adminRole = Role::create([ 'identifier' => $roleIdentifier, 'name' => json_encode(['ko' => '테스트 관리자', 'en' => 'Test Administrator']), 'description' => json_encode(['ko' => '테스트 관리자', 'en' => 'Test Administrator']), 'is_active' => true, ]); // admin 역할도 추가 (admin 미들웨어 통과용) $adminBaseRole = Role::firstOrCreate( ['identifier' => 'admin'], [ 'name' => json_encode(['ko' => '관리자', 'en' => 'Administrator']), 'description' => json_encode(['ko' => '시스템 관리자', 'en' => 'System Administrator']), 'extension_type' => ExtensionOwnerType::Core, 'extension_identifier' => 'core', 'is_active' => true, ] ); // 테스트용 역할에 권한 할당 $adminRole->permissions()->sync($permissionIds); // 사용자에게 admin 역할과 테스트용 역할 모두 할당 $user->roles()->attach($adminBaseRole->id, [ 'assigned_at' => now(), 'assigned_by' => null, ]); $user->roles()->attach($adminRole->id, [ 'assigned_at' => now(), 'assigned_by' => null, ]); return $user->fresh(); } // ======================================================================== // 인증/권한 테스트 // ======================================================================== /** * 인증 없이 SEO 캐시 통계 조회 시 401 반환 */ public function test_stats_returns_401_without_authentication(): void { $response = $this->getJson('/api/admin/seo/stats'); $response->assertStatus(401); } /** * 권한 없이 SEO 캐시 통계 조회 시 403 반환 */ public function test_stats_returns_403_without_permission(): void { // 권한 없는 관리자 생성 $user = User::factory()->create(); $adminRole = Role::firstOrCreate( ['identifier' => 'admin'], [ 'name' => json_encode(['ko' => '관리자', 'en' => 'Administrator']), 'description' => json_encode(['ko' => '시스템 관리자', 'en' => 'System Administrator']), 'extension_type' => ExtensionOwnerType::Core, 'extension_identifier' => 'core', 'is_active' => true, ] ); $user->roles()->attach($adminRole->id, [ 'assigned_at' => now(), 'assigned_by' => null, ]); $token = $user->createToken('test-token')->plainTextToken; $response = $this->withToken($token)->getJson('/api/admin/seo/stats'); $response->assertStatus(403); } /** * read 권한만 있는 관리자가 POST 엔드포인트 호출 시 403 반환 */ public function test_clear_cache_returns_403_without_update_permission(): void { // read 권한만 있는 관리자 생성 $user = $this->createAdminUser(['core.settings.read']); $token = $user->createToken('test-token')->plainTextToken; $response = $this->withToken($token)->postJson('/api/admin/seo/clear-cache'); $response->assertStatus(403); } // ======================================================================== // 통계 조회 테스트 (stats) // ======================================================================== /** * SEO 캐시 통계 조회 성공 */ public function test_stats_returns_200_with_stats_data(): void { // 테스트용 통계 데이터 생성 SeoCacheStat::create([ 'url' => '/', 'locale' => 'ko', 'layout_name' => 'home', 'module_identifier' => null, 'type' => 'hit', ]); SeoCacheStat::create([ 'url' => '/shop/products', 'locale' => 'ko', 'layout_name' => 'products', 'module_identifier' => 'sirsoft-ecommerce', 'type' => 'miss', 'response_time_ms' => 150, ]); $response = $this->withToken($this->token)->getJson('/api/admin/seo/stats'); $response->assertStatus(200) ->assertJson(['success' => true]) ->assertJsonStructure([ 'success', 'message', 'data' => [ 'overall' => [ 'total_entries', 'hits', 'misses', 'hit_rate', 'avg_response_time_ms', ], 'by_layout', 'by_module', ], ]); } /** * 통계 데이터가 없을 때도 정상 응답 */ public function test_stats_returns_200_with_empty_data(): void { $response = $this->withToken($this->token)->getJson('/api/admin/seo/stats'); $response->assertStatus(200) ->assertJson([ 'success' => true, 'data' => [ 'overall' => [ 'total_entries' => 0, 'hits' => 0, 'misses' => 0, 'hit_rate' => 0.0, ], 'by_layout' => [], 'by_module' => [], ], ]); } // ======================================================================== // 캐시 삭제 테스트 (clearCache) // ======================================================================== /** * 파라미터 없이 전체 캐시 삭제 성공 */ public function test_clear_cache_clears_all_without_params(): void { $mock = Mockery::mock(SeoCacheManagerInterface::class); $mock->shouldReceive('clearAll')->once(); $this->app->instance(SeoCacheManagerInterface::class, $mock); $response = $this->withToken($this->token)->postJson('/api/admin/seo/clear-cache'); $response->assertStatus(200) ->assertJson([ 'success' => true, 'data' => [ 'cleared' => 'all', ], ]); } /** * layout 파라미터 지정 시 해당 레이아웃 캐시만 삭제 성공 */ public function test_clear_cache_clears_specific_layout(): void { $mock = Mockery::mock(SeoCacheManagerInterface::class); $mock->shouldReceive('invalidateByLayout') ->with('home') ->once() ->andReturn(5); $this->app->instance(SeoCacheManagerInterface::class, $mock); $response = $this->withToken($this->token)->postJson('/api/admin/seo/clear-cache', [ 'layout' => 'home', ]); $response->assertStatus(200) ->assertJson([ 'success' => true, 'data' => [ 'cleared' => 5, ], ]); } // ======================================================================== // 캐시 워밍업 테스트 (warmup) // ======================================================================== /** * 캐시 워밍업 요청 시 dispatched 상태 반환 */ public function test_warmup_returns_dispatched_status(): void { $response = $this->withToken($this->token)->postJson('/api/admin/seo/warmup'); $response->assertStatus(200) ->assertJson([ 'success' => true, 'data' => [ 'status' => 'dispatched', ], ]); } /** * 인증 없이 워밍업 요청 시 401 반환 */ public function test_warmup_returns_401_without_authentication(): void { $response = $this->postJson('/api/admin/seo/warmup'); $response->assertStatus(401); } // ======================================================================== // 캐시된 URL 목록 테스트 (cachedUrls) // ======================================================================== /** * 캐시된 URL 목록 조회 성공 */ public function test_cached_urls_returns_url_list(): void { $expectedUrls = ['/', '/shop/products', '/about']; $mock = Mockery::mock(SeoCacheManagerInterface::class); $mock->shouldReceive('getCachedUrls') ->once() ->andReturn($expectedUrls); $this->app->instance(SeoCacheManagerInterface::class, $mock); $response = $this->withToken($this->token)->getJson('/api/admin/seo/cached-urls'); $response->assertStatus(200) ->assertJson([ 'success' => true, 'data' => [ 'urls' => $expectedUrls, 'count' => 3, ], ]); } /** * 캐시된 URL이 없을 때 빈 목록 반환 */ public function test_cached_urls_returns_empty_list(): void { $mock = Mockery::mock(SeoCacheManagerInterface::class); $mock->shouldReceive('getCachedUrls') ->once() ->andReturn([]); $this->app->instance(SeoCacheManagerInterface::class, $mock); $response = $this->withToken($this->token)->getJson('/api/admin/seo/cached-urls'); $response->assertStatus(200) ->assertJson([ 'success' => true, 'data' => [ 'urls' => [], 'count' => 0, ], ]); } /** * 인증 없이 캐시된 URL 목록 조회 시 401 반환 */ public function test_cached_urls_returns_401_without_authentication(): void { $response = $this->getJson('/api/admin/seo/cached-urls'); $response->assertStatus(401); } // ======================================================================== // Sitemap 수동 재생성 (regenerateSitemap) // ======================================================================== /** * 인증 없이 sitemap 재생성 호출 시 401 반환 */ public function test_regenerate_sitemap_returns_401_without_authentication(): void { $response = $this->postJson('/api/admin/seo/sitemap/regenerate'); $response->assertStatus(401); } /** * 정상 재생성 시 200 + last_updated_at 데이터 반환 */ public function test_regenerate_sitemap_returns_200_with_data(): void { $mock = Mockery::mock(SitemapManager::class); $mock->shouldReceive('regenerate') ->once() ->andReturn([ 'success' => true, 'status' => 'updated', 'message' => 'Sitemap 생성이 완료되었습니다.', 'data' => [ 'last_updated_at' => '2026-04-29T10:00:00+00:00', 'size_bytes' => 1234, 'ttl' => 86400, ], ]); $this->app->instance(SitemapManager::class, $mock); $response = $this->withHeader('Authorization', 'Bearer '.$this->token) ->postJson('/api/admin/seo/sitemap/regenerate'); $response->assertStatus(200); $this->assertTrue($response->json('success')); $this->assertSame('2026-04-29T10:00:00+00:00', $response->json('data.last_updated_at')); $this->assertSame(1234, $response->json('data.size_bytes')); } /** * Sitemap 비활성 상태 시 400 반환 */ public function test_regenerate_sitemap_returns_400_when_disabled(): void { $mock = Mockery::mock(SitemapManager::class); $mock->shouldReceive('regenerate') ->once() ->andReturn([ 'success' => false, 'status' => 'disabled', 'message' => 'Sitemap 생성이 비활성화되어 있습니다.', ]); $this->app->instance(SitemapManager::class, $mock); $response = $this->withHeader('Authorization', 'Bearer '.$this->token) ->postJson('/api/admin/seo/sitemap/regenerate'); $response->assertStatus(400); $this->assertFalse($response->json('success')); } /** * 내부 실패 시 500 반환 */ public function test_regenerate_sitemap_returns_500_on_failure(): void { $mock = Mockery::mock(SitemapManager::class); $mock->shouldReceive('regenerate') ->once() ->andReturn([ 'success' => false, 'status' => 'failed', 'message' => 'Sitemap 생성에 실패했습니다: contributor crashed', ]); $this->app->instance(SitemapManager::class, $mock); $response = $this->withHeader('Authorization', 'Bearer '.$this->token) ->postJson('/api/admin/seo/sitemap/regenerate'); $response->assertStatus(500); $this->assertFalse($response->json('success')); } protected function tearDown(): void { Mockery::close(); parent::tearDown(); } }