Files
Gnuboard7/modules/_bundled/sirsoft-board/tests/Feature/Admin/BoardSettingsControllerTest.php
T
HeuJung 85e266d361 fix(core,extensions): 확장 쓰기 경로 공통화 · HTMLPurifier 정의 캐시 storage 이전
https://github.com/gnuboard/g7/issues/125 — 상품 상세설명을 HTML 로 저장할 때
HTMLPurifier 가 모듈 vendor 폴더 안에 정의 캐시를 만들려다 실패해 저장이 매번 500 으로
끝나던 문제를 고친다. vendor 를 읽기 전용으로 두는 표준 배포에서 그 쓰기는 예외가 아니라
PHP 경고로 나오고 Laravel 이 이를 ErrorException 으로 승격시킨다. 캐시는 설정 해시당 1회만
기록되므로 캐시가 영영 생기지 않아 재시도해도 같은 결과였다.

캐시 경로를 storage 아래로 옮기고, 그 경로마저 확보하지 못하면 캐시만 끄고 정화는 그대로
수행한다 — 캐시는 성능 장치이고 정화는 보안 장치라, 전자의 실패가 후자를 건너뛰게 만들면
안 된다. 저장은 성공하므로 운영자에게 도달하는 흔적이 로그 하나뿐이라 error 수준으로 남긴다
(출하 기본 로그 수준이 error 라 warning 은 기본 설치 상태에서 파일에 남지 않는다).

그 과정에서 갈라져 있던 두 축을 코어 한 곳으로 모은다.

- 쓰기 디렉토리 확보: 억제 생성·chmod·setgid·소유권 상속·쓰기 판정 절차가 정적 게시와
 정의 캐시 두 곳에 서로 다른 하드닝으로 복제돼 있었다(억제 mkdir·setgid·clearstatcache 가
 사본마다 한쪽씩 빠져 있었다). FilePermissionHelper 의 ensureWritableDirectory 와
 hardenDirectory 로 통합하고, 실패 사유는 out 파라미터로 올려 정책(조용한 성능 저하 대
 시끄러운 실패)은 호출부가 정하게 둔다.

- 확장 저장 경로: storage_path('app/modules/…') 손조립이 30곳에 흩어져 있어 테스트 격리
 분기를 넣으려면 사본마다 복제해야 했고, 한 곳만 빠뜨려도 그 확장의 테스트가 운영 설정
 파일을 덮어쓴다. 디스크 root 를 단일 출처로 읽는 ExtensionStoragePath 로 전환하고 테스트
 분기는 config/filesystems.php 한 줄에서 끝낸다.

함께 고친 것

- 테스트가 운영 라우트 캐시로 부팅해 확장 allowlist 가 라우트 축에서 통째로 무력화되던
 문제. 삭제가 아니라 경로를 돌린다 — 라우트 캐시는 확장 작업 전까지 재생성되지 않아,
 삭제하면 운영 사이트가 그때까지 라우트 파일 스캔 경로로 떨어진다.
- PHPUnit 프로세스가 확장 vendor 의 제3자 composer 패키지를 오토로드하지 않아 그 패키지를
 쓰는 코드 경로가 통째로 테스트 불가였던 문제. 확장 자신의 오토로더를 그대로 쓰면 활성
 디렉토리가 _bundled 를 이기고 base path 유추까지 깨지므로, 생성된 맵에서 제3자 항목만
 골라 별도 로더로 등록한다.
- 게시 폴더가 setgid 를 갖지 않아, 명령줄과 웹이 번갈아 만든 하위 폴더를 다른 쪽이 쓰지
 못하던 문제.
- 관리자 템플릿이 HTML 정화 라이브러리를 직접 지정하지 않아 전이 의존으로 딸려온 구버전이
 쓰이던 문제.

동반 산출물

- 규정 표(·AGENTS.md) 6행 + storage-driver/service-repository/testing-guide 문서
- audit 룰 2종 + coverage 6항목. 저장소가 이미 전량 전환돼 전수 실행이 공허 통과하므로
 판정식은 픽스처 36건이 잠근다
- INSTALL.md 에 설치 후 파일 권한 절 추가 (vendor 쓰기 권한 불요를 명시)
2026-08-28 15:22:22 +09:00

813 lines
30 KiB
PHP

<?php
namespace Modules\Sirsoft\Board\Tests\Feature\Admin;
// ModuleTestCase를 수동으로 require (autoload 전에 로드 필요)
require_once __DIR__.'/../../ModuleTestCase.php';
use App\Models\User;
use App\Support\ExtensionStoragePath;
use Illuminate\Support\Facades\Config;
use Illuminate\Support\Facades\File;
use Modules\Sirsoft\Board\Models\Board;
use Modules\Sirsoft\Board\Repositories\Contracts\BoardRepositoryInterface;
use Modules\Sirsoft\Board\Services\BoardPermissionService;
use Modules\Sirsoft\Board\Tests\ModuleTestCase;
/**
* 게시판 환경설정 API 테스트
*
* BoardSettingsController의 CRUD + bulkApply + clearCache를 검증합니다.
*/
class BoardSettingsControllerTest extends ModuleTestCase
{
protected User $adminUser;
protected User $normalUser;
private string $settingsStoragePath;
/**
* 테스트 환경 설정
*/
protected function setUp(): void
{
parent::setUp();
// 관리자 사용자 생성 (환경설정 권한 포함)
$this->adminUser = $this->createAdminUser([
'sirsoft-board.settings.read',
'sirsoft-board.settings.update',
]);
// 일반 사용자 생성 (권한 없음)
$this->normalUser = $this->createUser();
$this->settingsStoragePath = ExtensionStoragePath::module('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);
// 저장 결과는 조회 API 로 확인한다 — settings 디스크는 테스트 하네스가 페이크로
// 대체하므로 실제 storage 경로를 직접 읽으면 저장 성공에도 파일이 없다.
$saved = $this->actingAs($this->adminUser)
->getJson('/api/modules/sirsoft-board/admin/settings/basic_defaults');
$saved->assertStatus(200);
$this->assertEquals(30, $saved->json('data.settings.per_page'));
$this->assertEquals(10, $saved->json('data.settings.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);
// 저장 결과는 조회 API 로 확인한다 (settings 디스크 페이크 — 위 주석 참조).
$saved = $this->actingAs($this->adminUser)
->getJson('/api/modules/sirsoft-board/admin/settings/notifications');
$saved->assertStatus(200);
$this->assertIsArray($saved->json('data.settings.channels'));
$this->assertEquals('mail', $saved->json('data.settings.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);
}
/**
* override_values 의 컬럼 값도 Store/Update 와 동일한 범위 제한(ReadsBoardLimits SSoT)을 받는다.
*
* 회귀: 일괄 적용 경로는 override_values 를 무검증(`['sometimes','array']`)으로 통과시켜
* boards 컬럼에 직접 기록했다. Store/Update 가 config/board.php SSoT 로 강제하는 바로 그 컬럼을
* 일괄 적용만 우회할 수 있어, new_display_hours=99999(상한 720) 같은 값이 저장됐다.
*/
public function test_bulk_apply_rejects_out_of_range_override_new_display_hours(): void
{
$response = $this->actingAs($this->adminUser)
->postJson('/api/modules/sirsoft-board/admin/settings/bulk-apply', [
'fields' => ['new_display_hours'],
'apply_all' => true,
'override_values' => ['new_display_hours' => 99999], // 상한 720 초과
]);
$response->assertStatus(422)
->assertJsonValidationErrors(['override_values.new_display_hours']);
}
/**
* override_values 의 길이 제한 컬럼(min_title_length 등)도 상한을 넘으면 거부한다.
*/
public function test_bulk_apply_rejects_out_of_range_override_min_title_length(): void
{
$response = $this->actingAs($this->adminUser)
->postJson('/api/modules/sirsoft-board/admin/settings/bulk-apply', [
'fields' => ['min_title_length'],
'apply_all' => true,
'override_values' => ['min_title_length' => 999999], // 상한 200 초과
]);
$response->assertStatus(422)
->assertJsonValidationErrors(['override_values.min_title_length']);
}
/**
* 범위 안의 override_values 는 정상 통과한다(정정이 유효값까지 막지 않음).
*/
public function test_bulk_apply_accepts_in_range_override_values(): void
{
$board = Board::create([
'name' => ['ko' => '테스트', 'en' => 'Test'],
'slug' => 'settings-ov-'.substr(md5(microtime()), 0, 8),
'type' => 'gallery',
'new_display_hours' => 24,
]);
$response = $this->actingAs($this->adminUser)
->postJson('/api/modules/sirsoft-board/admin/settings/bulk-apply', [
'fields' => ['new_display_hours'],
'apply_all' => true,
'override_values' => ['new_display_hours' => 48], // 상한 720 이내
]);
$response->assertStatus(200);
$board->refresh();
$this->assertEquals(48, $board->new_display_hours);
}
// ========================================
// 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']);
}
/**
* basic_defaults.max_file_count 는 config max_file_count_max(20)까지 허용 (#493 B2)
*/
public function test_settings_request_max_file_count_allows_config_max(): void
{
$response = $this->actingAs($this->adminUser)
->putJson('/api/modules/sirsoft-board/admin/settings', [
'basic_defaults' => ['max_file_count' => 20],
]);
$response->assertStatus(200);
}
/**
* basic_defaults.max_file_count 가 config max(20) 초과 시 422 (#493 B2)
*/
public function test_settings_request_max_file_count_rejects_above_config_max(): void
{
$response = $this->actingAs($this->adminUser)
->putJson('/api/modules/sirsoft-board/admin/settings', [
'basic_defaults' => ['max_file_count' => 21],
]);
$response->assertStatus(422)
->assertJsonValidationErrors(['basic_defaults.max_file_count']);
}
/**
* 제한값 설정을 바꾸면 저장 규칙이 따라오는지 확인 (#493 B2 — config 가 SSoT)
*
* 규칙이 리터럴로 되돌아가면 설정을 바꿔도 경계가 그대로라 이 테스트가 먼저 깨진다.
*/
public function test_settings_request_bounds_follow_config(): void
{
config(['sirsoft-board.limits.max_file_count_max' => 3]);
$this->actingAs($this->adminUser)
->putJson('/api/modules/sirsoft-board/admin/settings', [
'basic_defaults' => ['max_file_count' => 3],
])
->assertStatus(200);
$this->actingAs($this->adminUser)
->putJson('/api/modules/sirsoft-board/admin/settings', [
'basic_defaults' => ['max_file_count' => 4],
])
->assertStatus(422)
->assertJsonValidationErrors(['basic_defaults.max_file_count']);
}
/**
* report_policy.auto_hide_threshold 는 0(자동 숨김 비활성)을 저장할 수 있다 (#493 B4)
*
* 화면 안내가 "0=비활성" 이므로 서버가 0 을 거부하면 비활성으로 되돌릴 방법이 없다.
*/
public function test_settings_request_auto_hide_threshold_allows_zero(): void
{
$response = $this->actingAs($this->adminUser)
->putJson('/api/modules/sirsoft-board/admin/settings', [
'report_policy' => ['auto_hide_threshold' => 0],
]);
$response->assertStatus(200);
$saved = $this->actingAs($this->adminUser)
->getJson('/api/modules/sirsoft-board/admin/settings/report_policy');
$saved->assertStatus(200);
$this->assertSame(0, (int) $saved->json('data.settings.auto_hide_threshold'));
}
/**
* report_policy.auto_hide_threshold 가 config max(100) 초과 시 422 (#493 B4)
*/
public function test_settings_request_auto_hide_threshold_rejects_above_config_max(): void
{
$response = $this->actingAs($this->adminUser)
->putJson('/api/modules/sirsoft-board/admin/settings', [
'report_policy' => ['auto_hide_threshold' => 101],
]);
$response->assertStatus(422)
->assertJsonValidationErrors(['report_policy.auto_hide_threshold']);
}
// ========================================
// 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);
}
/**
* 첨부 정리 설정이 general 탭 저장으로 실제 반영되는지 확인 (회귀)
*
* 화면은 general 탭에서 이 카테고리를 함께 제출한다. 서버가 카테고리를 허용하지 않으면
* 저장은 200 인데 값만 사라져, 운영자가 토글을 켜도 정리가 영원히 꺼진 상태로 남는다.
*/
public function test_attachment_cleanup_settings_are_saved_on_general_tab(): void
{
$response = $this->actingAs($this->adminUser)
->putJson('/api/modules/sirsoft-board/admin/settings', [
'_tab' => 'general',
'display' => ['date_display_format' => 'standard'],
'attachment_settings' => [
'purge_enabled' => true,
'purge_retention_days' => 15,
],
]);
$response->assertStatus(200);
$followUp = $this->actingAs($this->adminUser)
->getJson('/api/modules/sirsoft-board/admin/settings/attachment_settings');
$followUp->assertStatus(200);
$this->assertTrue($followUp->json('data.settings.purge_enabled'));
$this->assertSame(15, $followUp->json('data.settings.purge_retention_days'));
}
/**
* 보존기간 하한(1일) 미만은 거부되는지 확인 — 사용자 파일을 파기하는 설정이므로.
*/
public function test_attachment_purge_retention_days_below_minimum_is_rejected(): void
{
$response = $this->actingAs($this->adminUser)
->putJson('/api/modules/sirsoft-board/admin/settings', [
'_tab' => 'general',
'attachment_settings' => [
'purge_enabled' => true,
'purge_retention_days' => 0,
],
]);
$response->assertStatus(422);
}
}