adminUser = $this->createAdminUser([ 'sirsoft-board.settings.read', 'sirsoft-board.settings.update', ]); // 일반 사용자 생성 (권한 없음) $this->normalUser = $this->createUser(); $this->settingsStoragePath = storage_path('app/modules/sirsoft-board/settings'); // 테스트 전 저장소 정리 if (File::isDirectory($this->settingsStoragePath)) { File::deleteDirectory($this->settingsStoragePath); } // g7_settings는 ServiceProvider 부트 시 Config에 캐싱되므로 // 테스트 환경에서 저장 파일 없이도 기본값이 정확히 반영되도록 명시적 주입 Config::set('g7_settings.modules.sirsoft-board.basic_defaults.per_page', 20); Config::set('g7_settings.modules.sirsoft-board.basic_defaults.type', 'basic'); } /** * 테스트 정리 */ protected function tearDown(): void { // 테스트 후 저장소 정리 if (File::isDirectory($this->settingsStoragePath)) { File::deleteDirectory($this->settingsStoragePath); } // 테스트에서 생성한 게시판 삭제 Board::where('slug', 'like', 'settings-test-%')->delete(); parent::tearDown(); } // ======================================== // index (전체 설정 조회) 테스트 // ======================================== /** * 관리자가 전체 설정을 조회할 수 있는지 확인 */ public function test_admin_can_fetch_all_settings(): void { $response = $this->actingAs($this->adminUser) ->getJson('/api/modules/sirsoft-board/admin/settings'); $response->assertStatus(200) ->assertJsonStructure([ 'data' => [ 'basic_defaults', 'report_policy', 'spam_security', ], ]); } /** * 비인증 사용자는 설정을 조회할 수 없음 */ public function test_unauthenticated_user_cannot_fetch_settings(): void { $response = $this->getJson('/api/modules/sirsoft-board/admin/settings'); $response->assertStatus(401); } // ======================================== // show (카테고리별 설정 조회) 테스트 // ======================================== /** * 관리자가 특정 카테고리 설정을 조회할 수 있는지 확인 */ public function test_admin_can_fetch_category_settings(): void { $response = $this->actingAs($this->adminUser) ->getJson('/api/modules/sirsoft-board/admin/settings/basic_defaults'); $response->assertStatus(200) ->assertJsonStructure([ 'data' => [ 'category', 'settings', ], ]) ->assertJsonPath('data.category', 'basic_defaults'); } // ======================================== // store (설정 저장) 테스트 // ======================================== /** * 관리자가 설정을 저장할 수 있는지 확인 */ public function test_admin_can_save_settings(): void { $response = $this->actingAs($this->adminUser) ->putJson('/api/modules/sirsoft-board/admin/settings', [ 'basic_defaults' => [ 'per_page' => 30, 'per_page_mobile' => 10, ], ]); $response->assertStatus(200); // 저장된 값이 파일에 반영되었는지 확인 $filePath = $this->settingsStoragePath.'/basic_defaults.json'; $this->assertFileExists($filePath); $content = json_decode(File::get($filePath), true); $this->assertEquals(30, $content['per_page']); $this->assertEquals(10, $content['per_page_mobile']); } /** * 관리자가 notifications 카테고리에서 채널 설정을 저장할 수 있는지 확인 */ public function test_admin_can_save_notification_channels(): void { $response = $this->actingAs($this->adminUser) ->putJson('/api/modules/sirsoft-board/admin/settings', [ 'notifications' => [ 'channels' => [ ['id' => 'mail', 'is_active' => true, 'sort_order' => 1], ['id' => 'database', 'is_active' => true, 'sort_order' => 2], ], ], ]); $response->assertStatus(200); // 저장된 값이 파일에 반영되었는지 확인 $filePath = $this->settingsStoragePath.'/notifications.json'; $this->assertFileExists($filePath); $content = json_decode(File::get($filePath), true); $this->assertIsArray($content['channels']); $this->assertEquals('mail', $content['channels'][0]['id']); } /** * notifications.channels 설정이 응답에 포함되는지 확인 */ public function test_notification_channels_included_in_settings_response(): void { $response = $this->actingAs($this->adminUser) ->getJson('/api/modules/sirsoft-board/admin/settings'); $response->assertStatus(200); $this->assertTrue($response->json('success')); } /** * 신고 알림 활성화 토글 제거 후, 저장 시 두 활성화 값이 항상 true 로 강제되는지 확인 * * 활성화 토글(notify_admin_on_report / notify_author_on_report_action)을 화면에서 제거하면서, * 발송 게이트(BoardNotificationDataListener)가 false 로 막히지 않도록 백엔드에서 항상 true 강제 저장한다. * 회귀 방지: 사용자가 false 를 보내거나 키를 누락해도 저장값은 true 여야 한다. */ public function test_report_notification_enable_flags_are_forced_true_on_save(): void { // 사용자가 의도적으로 false 를 보내는 시나리오 (또는 키 누락) $response = $this->actingAs($this->adminUser) ->putJson('/api/modules/sirsoft-board/admin/settings', [ '_tab' => 'report_policy', 'report_policy' => [ 'notify_admin_on_report' => false, 'notify_admin_on_report_scope' => 'per_case', 'notify_author_on_report_action' => false, ], ]); $response->assertStatus(200); $this->assertTrue($response->json('success')); // PUT 응답에서 두 값이 true 로 강제되었는지 확인 $this->assertTrue($response->json('data.report_policy.notify_admin_on_report')); $this->assertTrue($response->json('data.report_policy.notify_author_on_report_action')); // 후속 GET 요청에서도 영구적으로 true 저장 확인 $followUp = $this->actingAs($this->adminUser) ->getJson('/api/modules/sirsoft-board/admin/settings/report_policy'); $followUp->assertStatus(200); $this->assertTrue($followUp->json('data.settings.notify_admin_on_report')); $this->assertTrue($followUp->json('data.settings.notify_author_on_report_action')); } /** * 채널 검증 — 허용되지 않는 값은 거부되는지 확인 */ public function test_save_rejects_invalid_notification_channel(): void { $response = $this->actingAs($this->adminUser) ->putJson('/api/modules/sirsoft-board/admin/settings', [ '_tab' => 'report_policy', 'report_policy' => [ 'notify_admin_on_report_channels' => ['mail', 'sms'], // sms 는 미허용 ], ]); $response->assertStatus(422); } /** * 유효하지 않은 카테고리는 무시되는지 확인 */ public function test_store_ignores_invalid_categories(): void { $response = $this->actingAs($this->adminUser) ->putJson('/api/modules/sirsoft-board/admin/settings', [ 'invalid_category' => [ 'some_key' => 'some_value', ], ]); // validatedSettings()에서 유효 카테고리만 필터링 $response->assertStatus(200); // invalid_category 파일이 생성되지 않아야 함 $this->assertFileDoesNotExist($this->settingsStoragePath.'/invalid_category.json'); } /** * 비인증 사용자는 설정을 저장할 수 없음 */ public function test_unauthenticated_user_cannot_save_settings(): void { $response = $this->putJson('/api/modules/sirsoft-board/admin/settings', [ 'basic_defaults' => ['per_page' => 30], ]); $response->assertStatus(401); } // ======================================== // bulkApply (일괄 적용) 테스트 // ======================================== /** * 관리자가 설정을 전체 게시판에 일괄 적용할 수 있는지 확인 */ public function test_admin_can_bulk_apply_settings_to_all_boards(): void { // 테스트용 게시판 생성 $board = Board::create([ 'name' => ['ko' => '테스트', 'en' => 'Test'], 'slug' => 'settings-test-'.substr(md5(microtime()), 0, 8), 'type' => 'gallery', 'per_page' => 10, ]); $response = $this->actingAs($this->adminUser) ->postJson('/api/modules/sirsoft-board/admin/settings/bulk-apply', [ 'fields' => ['per_page', 'type'], 'apply_all' => true, ]); $response->assertStatus(200) ->assertJsonStructure([ 'data' => ['updated_count'], ]); // 게시판의 값이 환경설정 기본값으로 변경되었는지 확인 $board->refresh(); $this->assertEquals(20, $board->per_page); // defaults.json 기본값 $this->assertEquals('basic', $board->type); // defaults.json 기본값 } /** * 관리자가 설정을 특정 게시판에만 일괄 적용할 수 있는지 확인 */ public function test_admin_can_bulk_apply_settings_to_specific_boards(): void { // 테스트용 게시판 2개 생성 $board1 = Board::create([ 'name' => ['ko' => '테스트1', 'en' => 'Test1'], 'slug' => 'settings-test-'.substr(md5(microtime().'1'), 0, 8), 'type' => 'gallery', 'per_page' => 10, ]); $board2 = Board::create([ 'name' => ['ko' => '테스트2', 'en' => 'Test2'], 'slug' => 'settings-test-'.substr(md5(microtime().'2'), 0, 8), 'type' => 'gallery', 'per_page' => 10, ]); $response = $this->actingAs($this->adminUser) ->postJson('/api/modules/sirsoft-board/admin/settings/bulk-apply', [ 'fields' => ['per_page'], 'apply_all' => false, 'board_ids' => [$board1->id], ]); $response->assertStatus(200); // board1은 변경, board2는 변경 안 됨 $board1->refresh(); $board2->refresh(); $this->assertEquals(20, $board1->per_page); // 변경됨 $this->assertEquals(10, $board2->per_page); // 변경 안 됨 } /** * 필드 미선택 시 유효성 검증 실패 */ public function test_bulk_apply_requires_fields(): void { $response = $this->actingAs($this->adminUser) ->postJson('/api/modules/sirsoft-board/admin/settings/bulk-apply', [ 'fields' => [], 'apply_all' => true, ]); $response->assertStatus(422) ->assertJsonValidationErrors(['fields']); } /** * apply_all=false일 때 board_ids 필수 */ public function test_bulk_apply_requires_board_ids_when_not_apply_all(): void { $response = $this->actingAs($this->adminUser) ->postJson('/api/modules/sirsoft-board/admin/settings/bulk-apply', [ 'fields' => ['per_page'], 'apply_all' => false, ]); $response->assertStatus(422) ->assertJsonValidationErrors(['board_ids']); } /** * 허용되지 않은 필드는 유효성 검증 실패 */ public function test_bulk_apply_rejects_invalid_fields(): void { $response = $this->actingAs($this->adminUser) ->postJson('/api/modules/sirsoft-board/admin/settings/bulk-apply', [ 'fields' => ['invalid_field'], 'apply_all' => true, ]); $response->assertStatus(422) ->assertJsonValidationErrors(['fields.0']); } /** * 점이 없는 권한 키(manager)도 일괄 적용 허용 * * default_board_permissions의 manager 키는 점(.)이 없어 * 기존 검증에서 허용 목록에 없어 거부되던 버그 수정 */ public function test_bulk_apply_allows_manager_permission_field(): void { $response = $this->actingAs($this->adminUser) ->postJson('/api/modules/sirsoft-board/admin/settings/bulk-apply', [ 'fields' => ['manager'], 'apply_all' => true, ]); $response->assertStatus(200); } /** * 점이 포함된 권한 키(posts.read 등)도 일괄 적용 허용 */ public function test_bulk_apply_allows_dotted_permission_fields(): void { $response = $this->actingAs($this->adminUser) ->postJson('/api/modules/sirsoft-board/admin/settings/bulk-apply', [ 'fields' => ['posts.read', 'admin.manage', 'manager'], 'apply_all' => true, ]); $response->assertStatus(200); } // ======================================== // StoreBoardSettingsRequest 검증 경계값 테스트 (회귀: issue#413) // ======================================== /** * basic_defaults.max_reply_depth 는 config max_reply_depth_max(10)까지 허용 (회귀: issue#413) */ public function test_settings_request_max_reply_depth_allows_up_to_config_max(): void { $response = $this->actingAs($this->adminUser) ->putJson('/api/modules/sirsoft-board/admin/settings', [ 'basic_defaults' => ['max_reply_depth' => 10], ]); $response->assertStatus(200); } /** * basic_defaults.max_reply_depth 가 config max(10) 초과 시 422 (회귀: issue#413) */ public function test_settings_request_max_reply_depth_rejects_above_config_max(): void { $response = $this->actingAs($this->adminUser) ->putJson('/api/modules/sirsoft-board/admin/settings', [ 'basic_defaults' => ['max_reply_depth' => 11], ]); $response->assertStatus(422) ->assertJsonValidationErrors(['basic_defaults.max_reply_depth']); } /** * basic_defaults.per_page 는 config per_page_min(5) 미만 시 422 (회귀: issue#413) */ public function test_settings_request_per_page_rejects_below_config_min(): void { $response = $this->actingAs($this->adminUser) ->putJson('/api/modules/sirsoft-board/admin/settings', [ 'basic_defaults' => ['per_page' => 4], ]); $response->assertStatus(422) ->assertJsonValidationErrors(['basic_defaults.per_page']); } /** * basic_defaults.per_page 는 config per_page_min(5) 이상 허용 (회귀: issue#413) */ public function test_settings_request_per_page_allows_config_min(): void { $response = $this->actingAs($this->adminUser) ->putJson('/api/modules/sirsoft-board/admin/settings', [ 'basic_defaults' => ['per_page' => 5], ]); $response->assertStatus(200); } /** * basic_defaults.per_page_mobile 는 config per_page_min(5) 미만 시 422 (회귀: issue#413) */ public function test_settings_request_per_page_mobile_rejects_below_config_min(): void { $response = $this->actingAs($this->adminUser) ->putJson('/api/modules/sirsoft-board/admin/settings', [ 'basic_defaults' => ['per_page_mobile' => 4], ]); $response->assertStatus(422) ->assertJsonValidationErrors(['basic_defaults.per_page_mobile']); } // ======================================== // clearCache (캐시 초기화) 테스트 // ======================================== /** * 관리자가 캐시를 초기화할 수 있는지 확인 */ public function test_admin_can_clear_cache(): void { $response = $this->actingAs($this->adminUser) ->postJson('/api/modules/sirsoft-board/admin/settings/clear-cache'); $response->assertStatus(200) ->assertJsonPath('data.cleared', true); } /** * 비인증 사용자는 캐시를 초기화할 수 없음 */ public function test_unauthenticated_user_cannot_clear_cache(): void { $response = $this->postJson('/api/modules/sirsoft-board/admin/settings/clear-cache'); $response->assertStatus(401); } // ======================================== // bulkApply 원자적 롤백 (회귀: issue#413-26) // ======================================== /** * 권한 적용이 중간 게시판에서 실패하면 전체 변경이 롤백되는지 확인 (회귀: issue#413-26) * * 3개 게시판 중 2번째에서 권한 적용 실패를 강제하면: * - 응답은 HTTP 200 + data.rolled_back=true + board(실패 게시판) 포함 * - 이미 적용됐어야 할 1번 게시판도 원복 (원자성) * - 3번 게시판은 미적용 * - 컬럼 업데이트(혼합 경로)도 원복 */ public function test_bulk_apply_rolls_back_all_when_permission_fails_midway(): void { $boards = []; foreach (['a', 'b', 'c'] as $suffix) { $boards[$suffix] = Board::create([ 'name' => ['ko' => "롤백테스트{$suffix}", 'en' => "Rollback {$suffix}"], 'slug' => 'settings-test-rollback-'.$suffix, 'type' => 'gallery', 'per_page' => 10, ]); } // 2번째(b) 게시판에서 권한 적용 시 예외를 던지도록 mock $this->mock(BoardPermissionService::class, function ($mock) use ($boards) { $mock->shouldReceive('updateBoardPermissions') ->andReturnUsing(function (Board $board) use ($boards) { if ($board->id === $boards['b']->id) { throw new \RuntimeException('강제 권한 적용 실패'); } }); }); $response = $this->actingAs($this->adminUser) ->postJson('/api/modules/sirsoft-board/admin/settings/bulk-apply', [ 'fields' => ['per_page', 'manager'], 'apply_all' => false, 'board_ids' => [$boards['a']->id, $boards['b']->id, $boards['c']->id], // 테스트 DB 에는 모듈 settings 가 시드되지 않으므로 권한 기본값을 직접 주입 // (권한 루프가 실행되어 mock 예외가 중간에 발생하도록) 'override_values' => [ 'default_board_permissions' => ['manager' => ['admin']], ], ]); // 롤백도 의도된 정상 동작 → HTTP 200 + rolled_back 플래그 $response->assertStatus(200) ->assertJsonPath('data.rolled_back', true) ->assertJsonPath('data.board.board_id', $boards['b']->id); // 원자성: 컬럼(per_page)이 전부 원복 (1번 게시판도 변경 전 값 유지) foreach ($boards as $board) { $board->refresh(); $this->assertEquals(10, $board->per_page, "{$board->slug} per_page 가 롤백되지 않음"); } } /** * 컬럼 일괄 업데이트가 실패하면 전체 롤백되고 generic 안내가 반환되는지 확인 (회귀: issue#413-26) * * 컬럼 업데이트(bulkUpdate)는 단일 쿼리라 특정 게시판을 짚을 수 없음: * - 응답은 HTTP 200 + data.rolled_back=true + board=null * - 권한도 미적용(원복) */ public function test_bulk_apply_rolls_back_with_generic_when_column_update_fails(): void { $board = Board::create([ 'name' => ['ko' => '컬럼롤백', 'en' => 'Column Rollback'], 'slug' => 'settings-test-column-rollback', 'type' => 'gallery', 'per_page' => 10, ]); // 컬럼 일괄 업데이트(bulkUpdate)에서 예외를 던지도록 mock $this->mock(BoardRepositoryInterface::class, function ($mock) { $mock->shouldReceive('bulkUpdate') ->andThrow(new \RuntimeException('강제 컬럼 업데이트 실패')); // 그 외 메서드는 통과 (query 등) $mock->shouldReceive('query')->andReturnUsing(fn () => Board::query()); }); $response = $this->actingAs($this->adminUser) ->postJson('/api/modules/sirsoft-board/admin/settings/bulk-apply', [ 'fields' => ['per_page'], 'apply_all' => false, 'board_ids' => [$board->id], ]); $response->assertStatus(200) ->assertJsonPath('data.rolled_back', true) ->assertJsonPath('data.board', null); // 컬럼 값 원복 확인 $board->refresh(); $this->assertEquals(10, $board->per_page); } }