HeuJung
d970117149
확장이 훅으로 등록한 카탈로그에서 고른 값은 그 확장이 사라져도 저장값으로 남는다. 그 상태에서 값만 보고 판정하면 이미 제공 불가한 항목이 사용자 화면에 그대로 노출된다. 예외도 경고도 로그도 남지 않아 관리자 화면과 나란히 보지 않으면 드러나지 않는다. - 결제수단에 지정한 PG, 현금영수증 발급사, 검색엔진 드라이버 세 축에 같은 판정을 적용. 공개 응답에서는 제거하고 관리자 응답에는 표시를 남긴다 — 운영자가 고쳐야 할 대상이라 감추면 복구 경로가 사라진다. 서버 검증도 같은 판정을 공유해 화면 우회 제출을 막는다. - 설정 단건 저장이 벌크 저장과 다른 경로를 타던 문제를 코어·이커머스·게시판에서 정리. 저장은 성공하고 파생 값만 갱신되지 않아 어느 화면에서 저장했느냐로 결과가 갈렸다. - 단건 저장의 값 형태 계약 신설. 빈 값으로 되돌릴 수 있게 하고, 타입은 defaults.json 의 기본값을 SSoT 로 삼는다. 해석 불가한 입력은 조용히 캐스팅하지 않고 거절한다. - 드라이버 셀렉트를 서버 카탈로그에 바인딩하고, 저장값이 카탈로그에 없으면 그 값을 드러내는 안내를 8곳 전수에 붙인다. 종전에는 빈 칸으로만 보여 무엇이 저장됐는지 알 수 없었다. 시나리오 매니페스트 8종을 면제 없이 신설했다. `audit:allow` 는 cross product 와 effects 검사를 함께 끄므로, 면제가 걸린 매니페스트에 선언을 추가하면 검증이 회복되지 않는다. 그 아래에서 대응 테스트가 없는 effect 이름 2건이 살아남아 있었고, 함께 정리했다.
357 lines
12 KiB
PHP
357 lines
12 KiB
PHP
<?php
|
|
|
|
namespace Tests\Feature\Api\Admin;
|
|
|
|
use App\Enums\ExtensionOwnerType;
|
|
use App\Extension\HookManager;
|
|
use App\Models\Permission;
|
|
use App\Models\Role;
|
|
use App\Models\User;
|
|
use App\Providers\SettingsServiceProvider;
|
|
use App\Repositories\JsonConfigRepository;
|
|
use Illuminate\Foundation\Testing\RefreshDatabase;
|
|
use Illuminate\Support\Facades\Hash;
|
|
use PHPUnit\Framework\Attributes\Test;
|
|
use Tests\TestCase;
|
|
|
|
/**
|
|
* Settings API에서 available_drivers 필드 포함 검증
|
|
*
|
|
* DriverRegistryService를 통해 코어 + 플러그인 드라이버 목록이
|
|
* settings API 응답에 포함되는지 검증합니다.
|
|
*/
|
|
class SettingsControllerDriverOptionsTest extends TestCase
|
|
{
|
|
use RefreshDatabase;
|
|
|
|
private User $admin;
|
|
|
|
private string $token;
|
|
|
|
protected function setUp(): void
|
|
{
|
|
parent::setUp();
|
|
|
|
$this->admin = $this->createAdminUser();
|
|
$this->token = $this->admin->createToken('test-token')->plainTextToken;
|
|
}
|
|
|
|
/**
|
|
* 관리자 사용자 생성
|
|
*/
|
|
private function createAdminUser(): User
|
|
{
|
|
$user = User::factory()->create([
|
|
'password' => Hash::make('password123'),
|
|
]);
|
|
|
|
$permissionIds = [];
|
|
foreach (['core.settings.read', 'core.settings.update'] as $permIdentifier) {
|
|
$permission = Permission::firstOrCreate(
|
|
['identifier' => $permIdentifier],
|
|
[
|
|
'name' => json_encode(['ko' => $permIdentifier, 'en' => $permIdentifier]),
|
|
'description' => json_encode(['ko' => $permIdentifier, 'en' => $permIdentifier]),
|
|
'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 Admin']),
|
|
'description' => json_encode(['ko' => '테스트', 'en' => 'Test']),
|
|
'is_active' => true,
|
|
]);
|
|
|
|
$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);
|
|
|
|
$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();
|
|
}
|
|
|
|
/**
|
|
* 인증된 요청 헬퍼 메서드
|
|
*/
|
|
private function authRequest(): static
|
|
{
|
|
return $this->withHeaders([
|
|
'Authorization' => 'Bearer '.$this->token,
|
|
'Accept' => 'application/json',
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* settings index 응답에 available_drivers가 포함되는지 검증합니다.
|
|
*/
|
|
#[Test]
|
|
public function index_response_includes_available_drivers(): void
|
|
{
|
|
$response = $this->authRequest()->getJson('/api/admin/settings');
|
|
|
|
$response->assertStatus(200)
|
|
->assertJsonStructure([
|
|
'data' => [
|
|
'available_drivers' => [
|
|
'storage',
|
|
'public_asset',
|
|
'cache',
|
|
'session',
|
|
'queue',
|
|
'log',
|
|
'websocket',
|
|
'mail',
|
|
],
|
|
],
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* available_drivers의 각 드라이버에 id와 label 필드가 있는지 검증합니다.
|
|
*
|
|
* @scenario engine_source=core
|
|
*
|
|
* @effects admin_driver_options_include_search_category
|
|
*/
|
|
#[Test]
|
|
public function available_drivers_have_correct_structure(): void
|
|
{
|
|
$response = $this->authRequest()->getJson('/api/admin/settings');
|
|
|
|
$response->assertStatus(200);
|
|
|
|
$data = $response->json('data.available_drivers');
|
|
|
|
// 9개 카테고리 존재 (search 는 폴백 가드 편입으로 추가 — A5b)
|
|
$this->assertCount(9, $data);
|
|
|
|
// 각 카테고리에 최소 1개 이상의 드라이버 존재
|
|
foreach ($data as $category => $drivers) {
|
|
$this->assertNotEmpty($drivers, "{$category} 카테고리에 드라이버가 없습니다.");
|
|
|
|
// 첫 번째 드라이버 구조 검증
|
|
$this->assertArrayHasKey('id', $drivers[0]);
|
|
$this->assertArrayHasKey('label', $drivers[0]);
|
|
$this->assertArrayHasKey('ko', $drivers[0]['label']);
|
|
$this->assertArrayHasKey('en', $drivers[0]['label']);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* storage 카테고리에 코어 드라이버가 포함되는지 검증합니다.
|
|
*/
|
|
#[Test]
|
|
public function storage_drivers_include_core_options(): void
|
|
{
|
|
$response = $this->authRequest()->getJson('/api/admin/settings');
|
|
|
|
$storageDrivers = $response->json('data.available_drivers.storage');
|
|
$ids = array_column($storageDrivers, 'id');
|
|
|
|
$this->assertContains('local', $ids);
|
|
$this->assertContains('s3', $ids);
|
|
}
|
|
|
|
/**
|
|
* mail 카테고리에 코어 드라이버가 포함되는지 검증합니다.
|
|
*/
|
|
#[Test]
|
|
public function mail_drivers_include_core_options(): void
|
|
{
|
|
$response = $this->authRequest()->getJson('/api/admin/settings');
|
|
|
|
$mailDrivers = $response->json('data.available_drivers.mail');
|
|
$ids = array_column($mailDrivers, 'id');
|
|
|
|
$this->assertContains('smtp', $ids);
|
|
$this->assertContains('mailgun', $ids);
|
|
$this->assertContains('ses', $ids);
|
|
}
|
|
|
|
/**
|
|
* search 카테고리에 코어 검색엔진이 포함되는지 검증합니다.
|
|
*
|
|
* 카테고리 개수만 세면 어떤 카테고리가 늘었는지 알 수 없다 — search 가 빠진 채
|
|
* 다른 카테고리가 하나 늘어도 개수 단언은 통과한다.
|
|
*
|
|
* @scenario engine_source=core
|
|
*
|
|
* @effects admin_driver_options_include_search_category
|
|
*/
|
|
#[Test]
|
|
public function search_drivers_include_core_engine(): void
|
|
{
|
|
$response = $this->authRequest()->getJson('/api/admin/settings');
|
|
|
|
$response->assertStatus(200);
|
|
|
|
$drivers = $response->json('data.available_drivers.search');
|
|
|
|
$this->assertIsArray($drivers, 'search 카테고리가 응답에 없습니다.');
|
|
$this->assertContains('mysql-fulltext', array_column($drivers, 'id'));
|
|
}
|
|
|
|
/**
|
|
* 플러그인이 Scout 엔진 등록 훅으로 추가한 검색엔진이 카탈로그에 나타납니다.
|
|
*
|
|
* 관리자 화면 셀렉트가 이 카탈로그를 그대로 바인딩하므로, 여기 없으면 플러그인이
|
|
* 등록한 검색엔진을 운영자가 고를 수 없다.
|
|
*
|
|
* @scenario engine_source=plugin
|
|
*
|
|
* @effects admin_driver_options_include_search_category
|
|
*/
|
|
#[Test]
|
|
public function search_drivers_include_plugin_registered_engine(): void
|
|
{
|
|
HookManager::addFilter(
|
|
'core.search.engine_drivers',
|
|
fn (array $drivers) => array_merge($drivers, ['meilisearch' => \stdClass::class])
|
|
);
|
|
|
|
$response = $this->authRequest()->getJson('/api/admin/settings');
|
|
|
|
$ids = array_column($response->json('data.available_drivers.search'), 'id');
|
|
|
|
$this->assertContains('meilisearch', $ids, '플러그인이 등록한 검색엔진이 카탈로그에 없습니다.');
|
|
$this->assertContains('mysql-fulltext', $ids, '코어 검색엔진이 사라졌습니다.');
|
|
}
|
|
|
|
/**
|
|
* public_asset 카테고리에 코어 3종(none/public/s3)이 포함되는지 검증합니다.
|
|
*
|
|
* @effects settings_catalog_includes_plugin_registered_disks
|
|
*/
|
|
#[Test]
|
|
public function public_asset_drivers_include_core_options(): void
|
|
{
|
|
$response = $this->authRequest()->getJson('/api/admin/settings');
|
|
|
|
$drivers = $response->json('data.available_drivers.public_asset');
|
|
$ids = array_column($drivers, 'id');
|
|
|
|
$this->assertSame(['none', 'public', 's3'], $ids);
|
|
}
|
|
|
|
/**
|
|
* 카탈로그에 있는 공개 자산 디스크 저장이 성공하는지 검증합니다.
|
|
*/
|
|
#[Test]
|
|
public function saving_valid_public_asset_disk_succeeds(): void
|
|
{
|
|
$response = $this->authRequest()->postJson('/api/admin/settings', [
|
|
'_tab' => 'drivers',
|
|
'drivers' => $this->driversPayload(['public_asset_disk' => 'public']),
|
|
]);
|
|
|
|
$response->assertStatus(200);
|
|
|
|
$saved = (new JsonConfigRepository)->getCategory('drivers');
|
|
$this->assertSame('public', $saved['public_asset_disk'] ?? null);
|
|
}
|
|
|
|
/**
|
|
* 저장 → drivers.json → core.storage.public_asset_disk 주입 사슬을
|
|
* 한 테스트 안에서 종단으로 검증합니다.
|
|
*
|
|
* 주입 자동 실행은 testing 격리 가드(applyPublicAssetDiskConfig)가 막고 있으므로
|
|
* (dev 공유 drivers.json 유입 차단), 가드를 통과한 뒤의 주입부만 실제 저장소로
|
|
* 호출해 사슬을 잇습니다. mock 저장소를 쓰는 단위 테스트와 달리 이 테스트는
|
|
* 저장 산출물(drivers.json)이 주입 입력이 되는 것까지 고정합니다.
|
|
*
|
|
* @effects global_setting_injects_core_config_with_none_normalized
|
|
*/
|
|
#[Test]
|
|
public function saved_public_asset_disk_reaches_core_config_through_injection(): void
|
|
{
|
|
config(['core.storage.public_asset_disk' => 'stale_value']);
|
|
|
|
$this->authRequest()->postJson('/api/admin/settings', [
|
|
'_tab' => 'drivers',
|
|
'drivers' => $this->driversPayload(['public_asset_disk' => 'public']),
|
|
])->assertStatus(200);
|
|
|
|
$this->injectFromStoredSettings();
|
|
|
|
$this->assertSame('public', config('core.storage.public_asset_disk'));
|
|
|
|
// 'none' 저장은 미설정('')으로 정규화되어 스트리밍으로 되돌아간다
|
|
$this->authRequest()->postJson('/api/admin/settings', [
|
|
'_tab' => 'drivers',
|
|
'drivers' => $this->driversPayload(['public_asset_disk' => 'none']),
|
|
])->assertStatus(200);
|
|
|
|
$this->injectFromStoredSettings();
|
|
|
|
$this->assertSame('', config('core.storage.public_asset_disk'));
|
|
}
|
|
|
|
/**
|
|
* 실제 저장 산출물(drivers.json)을 읽어 주입부를 호출합니다.
|
|
*/
|
|
private function injectFromStoredSettings(): void
|
|
{
|
|
$provider = new SettingsServiceProvider($this->app);
|
|
$method = new \ReflectionMethod($provider, 'injectPublicAssetDiskConfig');
|
|
$method->invoke($provider, new JsonConfigRepository);
|
|
}
|
|
|
|
/**
|
|
* 카탈로그에 없는 공개 자산 디스크 저장이 422 로 거부되는지 검증합니다.
|
|
*
|
|
* @effects invalid_disk_rejected_with_422
|
|
*/
|
|
#[Test]
|
|
public function saving_unknown_public_asset_disk_fails_with_422(): void
|
|
{
|
|
$response = $this->authRequest()->postJson('/api/admin/settings', [
|
|
'_tab' => 'drivers',
|
|
'drivers' => $this->driversPayload(['public_asset_disk' => 'nonexistent_disk']),
|
|
]);
|
|
|
|
$response->assertStatus(422)
|
|
->assertJsonValidationErrors(['drivers.public_asset_disk']);
|
|
}
|
|
|
|
/**
|
|
* drivers 탭 저장에 필요한 최소 필수 필드 payload 를 반환합니다.
|
|
*
|
|
* @param array<string, mixed> $overrides 덮어쓸 필드
|
|
* @return array<string, mixed> drivers payload
|
|
*/
|
|
private function driversPayload(array $overrides = []): array
|
|
{
|
|
return array_merge([
|
|
'storage_driver' => 'local',
|
|
'cache_driver' => 'file',
|
|
'session_driver' => 'file',
|
|
'queue_driver' => 'sync',
|
|
'log_driver' => 'daily',
|
|
'log_level' => 'error',
|
|
], $overrides);
|
|
}
|
|
}
|