fix(extension): 확장 수명주기 캐시 무효화 순서 회귀 및 실패 사유 전달

route:cache 는 새 앱을 부팅해 라우트를 수집하고, 그 부팅의 확장 라우트 프로바이더는
DB 가 아니라 캐시된 활성 확장 목록을 읽는다. 그래서 rebuild 가
invalidate*StatusCache 보다 앞서면 방금 바뀐 상태가 빠진 채 라우트가 박제되고,
라우트 캐시에는 스캔 폴백이 없어 오류도 로그도 없이 404 가 된다. 무효화를 굽기 직전이
아니라 DB 상태 쓰기 직후로 올려, 같은 목록을 읽는 훅 매핑 캐시까지 함께 바로잡았다.
update 경로는 Updating 전이 직후에 비우면 그 창의 오토로드 갱신이 확장을 비활성으로
판정하므로, 상태 복원 직후에 비운 뒤 훅 캐시를 다시 굽는다.

플러그인 라우트 프로바이더에는 활성 게이트가 없어 비활성 플러그인의 API 가 계속
응답했다. 화면·메뉴만 사라지고 기능은 살아 있는 상태였다. 모듈과 같은 기준을 적용했다.

실패 사유가 하위 계층에서 버려져 관리자 화면에 :error 자리표시자가 그대로 노출되던
문제도 고쳤다. 반환 경로를 깨지 않도록 배열 키 reason 과 뒤에 붙인 선택적 out
파라미터로 사유를 실어 올리고, 확장이 수명주기 훅에서 사유를 남길 수 있는 통로를
추가했다. 설치 경로의 광역 RuntimeException catch 는 도메인 예외로 좁혀 원본 키와
파라미터를 응답에 싣는다 — 상태코드 422 는 유지해 사용자 계약을 함께 바꾸지 않는다.
언어팩 화면은 프로덕션에서 예외 원문을 싣지 않는 것이 확정된 계약이므로, 자리를
일반 문구로 채우는 대신 치환 자리 자체를 제거했다. 원문은 종전대로 errors 통로를
거쳐 디버그 모드에서 도달한다.
This commit is contained in:
HeuJung committed 2026-08-21 17:09:30 +09:00
1 parent 565f6c0117
commit 03cbb99196
35 files changed
+1362 -239

No files matched your search

@@ -3,11 +3,15 @@
namespace Tests\Feature\Api\Admin;
use App\Enums\ExtensionOwnerType;
use App\Enums\PermissionType;
use App\Exceptions\ModuleOperationException;
use App\Models\Permission;
use App\Models\Role;
use App\Models\User;
use App\Services\ModuleService;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Http\UploadedFile;
use Illuminate\Support\Facades\File;
use Illuminate\Support\Facades\Storage;
use Tests\TestCase;
@@ -54,7 +58,7 @@ class ModuleControllerTest extends TestCase
'description' => json_encode(['ko' => $permIdentifier.' 권한', 'en' => $permIdentifier.' Permission']),
'extension_type' => ExtensionOwnerType::Core,
'extension_identifier' => 'core',
'type' => \App\Enums\PermissionType::Admin,
'type' => PermissionType::Admin,
]
);
$permissionIds[] = $permission->id;
@@ -498,7 +502,7 @@ class ModuleControllerTest extends TestCase
*/
public function test_install_from_file_succeeds_with_valid_zip(): void
{
$moduleServiceMock = \Mockery::mock(\App\Services\ModuleService::class);
$moduleServiceMock = \Mockery::mock(ModuleService::class);
$moduleServiceMock->shouldReceive('installFromZipFile')
->once()
->andReturn([
@@ -506,7 +510,7 @@ class ModuleControllerTest extends TestCase
'name' => 'Test Module',
'version' => '1.0.0',
]);
$this->app->instance(\App\Services\ModuleService::class, $moduleServiceMock);
$this->app->instance(ModuleService::class, $moduleServiceMock);
$file = UploadedFile::fake()->create('module.zip', 100, 'application/zip');
@@ -520,15 +524,20 @@ class ModuleControllerTest extends TestCase
}
/**
* ModuleService에서 RuntimeException 발생 시 422 반환
* ModuleService에서 도메인 예외 발생 시 422 반환 + 키가 해석된 문구
*
* 종전에는 raw `\RuntimeException` 이 이미 번역된 문장을 들고 오는 것을 컨트롤러가
* 메시지 **키** 자리로 넘겨 그대로 내보냈다. 키 해석에 실패한 원문이 나가는 형태라
* 계약 테스트가 이 지점을 위반으로 등재해 두고 있었다. 이제 도메인 실패는 키와
* 파라미터를 들고 다니는 예외로 오고, 컨트롤러가 그 키를 해석해 내보낸다.
*/
public function test_install_from_file_returns_422_on_runtime_exception(): void
public function test_install_from_file_returns_422_on_domain_exception(): void
{
$moduleServiceMock = \Mockery::mock(\App\Services\ModuleService::class);
$moduleServiceMock = \Mockery::mock(ModuleService::class);
$moduleServiceMock->shouldReceive('installFromZipFile')
->once()
->andThrow(new \RuntimeException('module.json을 찾을 수 없습니다.'));
$this->app->instance(\App\Services\ModuleService::class, $moduleServiceMock);
->andThrow(new ModuleOperationException('modules.errors.module_json_not_found'));
$this->app->instance(ModuleService::class, $moduleServiceMock);
$file = UploadedFile::fake()->create('module.zip', 100, 'application/zip');
@@ -537,7 +546,27 @@ class ModuleControllerTest extends TestCase
]);
$response->assertStatus(422);
$response->assertJsonPath('message', 'module.json을 찾을 수 없습니다.');
$response->assertJsonPath('message', __('modules.errors.module_json_not_found'));
}
/**
* 도메인 예외가 아닌 raw RuntimeException 은 500 (인프라 장애를 입력 오류로 위장하지 않는다)
*/
public function test_install_from_file_returns_500_on_raw_runtime_exception(): void
{
$moduleServiceMock = \Mockery::mock(ModuleService::class);
$moduleServiceMock->shouldReceive('installFromZipFile')
->once()
->andThrow(new \RuntimeException('disk full'));
$this->app->instance(ModuleService::class, $moduleServiceMock);
$file = UploadedFile::fake()->create('module.zip', 100, 'application/zip');
$response = $this->authRequest()->postJson('/api/admin/modules/install-from-file', [
'file' => $file,
]);
$response->assertStatus(500);
}
/**
@@ -545,11 +574,11 @@ class ModuleControllerTest extends TestCase
*/
public function test_install_from_file_returns_500_on_general_exception(): void
{
$moduleServiceMock = \Mockery::mock(\App\Services\ModuleService::class);
$moduleServiceMock = \Mockery::mock(ModuleService::class);
$moduleServiceMock->shouldReceive('installFromZipFile')
->once()
->andThrow(new \Exception('예상치 못한 오류'));
$this->app->instance(\App\Services\ModuleService::class, $moduleServiceMock);
$this->app->instance(ModuleService::class, $moduleServiceMock);
$file = UploadedFile::fake()->create('module.zip', 100, 'application/zip');
@@ -569,7 +598,7 @@ class ModuleControllerTest extends TestCase
*/
public function test_install_from_github_calls_service_with_valid_url(): void
{
$moduleServiceMock = \Mockery::mock(\App\Services\ModuleService::class);
$moduleServiceMock = \Mockery::mock(ModuleService::class);
$moduleServiceMock->shouldReceive('installFromGithub')
->once()
->with('https://github.com/sirsoft/sample-module')
@@ -578,7 +607,7 @@ class ModuleControllerTest extends TestCase
'name' => 'Sample Module',
'version' => '1.0.0',
]);
$this->app->instance(\App\Services\ModuleService::class, $moduleServiceMock);
$this->app->instance(ModuleService::class, $moduleServiceMock);
$response = $this->authRequest()->postJson('/api/admin/modules/install-from-github', [
'github_url' => 'https://github.com/sirsoft/sample-module',
@@ -592,20 +621,20 @@ class ModuleControllerTest extends TestCase
/**
* ModuleService에서 RuntimeException 발생 시 422 반환 (GitHub)
*/
public function test_install_from_github_returns_422_on_runtime_exception(): void
public function test_install_from_github_returns_422_on_domain_exception(): void
{
$moduleServiceMock = \Mockery::mock(\App\Services\ModuleService::class);
$moduleServiceMock = \Mockery::mock(ModuleService::class);
$moduleServiceMock->shouldReceive('installFromGithub')
->once()
->andThrow(new \RuntimeException('GitHub 저장소를 찾을 수 없습니다.'));
$this->app->instance(\App\Services\ModuleService::class, $moduleServiceMock);
->andThrow(new ModuleOperationException('modules.errors.github_repo_not_found'));
$this->app->instance(ModuleService::class, $moduleServiceMock);
$response = $this->authRequest()->postJson('/api/admin/modules/install-from-github', [
'github_url' => 'https://github.com/sirsoft/sample-module',
]);
$response->assertStatus(422);
$response->assertJsonPath('message', 'GitHub 저장소를 찾을 수 없습니다.');
$response->assertJsonPath('message', __('modules.errors.github_repo_not_found'));
}
/**
@@ -613,11 +642,11 @@ class ModuleControllerTest extends TestCase
*/
public function test_install_from_github_returns_500_on_general_exception(): void
{
$moduleServiceMock = \Mockery::mock(\App\Services\ModuleService::class);
$moduleServiceMock = \Mockery::mock(ModuleService::class);
$moduleServiceMock->shouldReceive('installFromGithub')
->once()
->andThrow(new \Exception('예상치 못한 오류'));
$this->app->instance(\App\Services\ModuleService::class, $moduleServiceMock);
$this->app->instance(ModuleService::class, $moduleServiceMock);
$response = $this->authRequest()->postJson('/api/admin/modules/install-from-github', [
'github_url' => 'https://github.com/sirsoft/sample-module',
@@ -682,7 +711,7 @@ class ModuleControllerTest extends TestCase
public function test_activate_returns_409_when_dependencies_not_met(): void
{
// Arrange: ModuleService를 Mock
$moduleServiceMock = \Mockery::mock(\App\Services\ModuleService::class);
$moduleServiceMock = \Mockery::mock(ModuleService::class);
$moduleServiceMock->shouldReceive('activateModule')
->with('test-module', false)
->andReturn([
@@ -696,7 +725,7 @@ class ModuleControllerTest extends TestCase
],
'message' => '이 모듈을 활성화하려면 필요한 의존성이 충족되어야 합니다.',
]);
$this->app->instance(\App\Services\ModuleService::class, $moduleServiceMock);
$this->app->instance(ModuleService::class, $moduleServiceMock);
// Act
$response = $this->authRequest()->postJson('/api/admin/modules/activate', [
@@ -731,7 +760,7 @@ class ModuleControllerTest extends TestCase
public function test_activate_with_force_bypasses_dependency_check(): void
{
// Arrange: ModuleService를 Mock
$moduleServiceMock = \Mockery::mock(\App\Services\ModuleService::class);
$moduleServiceMock = \Mockery::mock(ModuleService::class);
$moduleServiceMock->shouldReceive('activateModule')
->with('test-module', true)
->andReturn([
@@ -742,7 +771,7 @@ class ModuleControllerTest extends TestCase
'status' => 'active',
],
]);
$this->app->instance(\App\Services\ModuleService::class, $moduleServiceMock);
$this->app->instance(ModuleService::class, $moduleServiceMock);
// Act
$response = $this->authRequest()->postJson('/api/admin/modules/activate', [
@@ -761,7 +790,7 @@ class ModuleControllerTest extends TestCase
public function test_deactivate_returns_409_when_dependents_exist(): void
{
// Arrange: ModuleService를 Mock
$moduleServiceMock = \Mockery::mock(\App\Services\ModuleService::class);
$moduleServiceMock = \Mockery::mock(ModuleService::class);
$moduleServiceMock->shouldReceive('deactivateModule')
->with('test-module', false)
->andReturn([
@@ -774,7 +803,7 @@ class ModuleControllerTest extends TestCase
'dependent_plugins' => [],
'message' => '이 모듈에 의존하는 활성화된 확장이 있습니다.',
]);
$this->app->instance(\App\Services\ModuleService::class, $moduleServiceMock);
$this->app->instance(ModuleService::class, $moduleServiceMock);
// Act
$response = $this->authRequest()->postJson('/api/admin/modules/deactivate', [
@@ -801,7 +830,7 @@ class ModuleControllerTest extends TestCase
public function test_deactivate_with_force_bypasses_dependent_check(): void
{
// Arrange: ModuleService를 Mock
$moduleServiceMock = \Mockery::mock(\App\Services\ModuleService::class);
$moduleServiceMock = \Mockery::mock(ModuleService::class);
$moduleServiceMock->shouldReceive('deactivateModule')
->with('test-module', true)
->andReturn([
@@ -812,7 +841,7 @@ class ModuleControllerTest extends TestCase
'status' => 'inactive',
],
]);
$this->app->instance(\App\Services\ModuleService::class, $moduleServiceMock);
$this->app->instance(ModuleService::class, $moduleServiceMock);
// Act
$response = $this->authRequest()->postJson('/api/admin/modules/deactivate', [
@@ -835,7 +864,7 @@ class ModuleControllerTest extends TestCase
public function test_activate_response_includes_assets_when_module_has_assets(): void
{
// Arrange: ModuleService를 Mock
$moduleServiceMock = \Mockery::mock(\App\Services\ModuleService::class);
$moduleServiceMock = \Mockery::mock(ModuleService::class);
$moduleServiceMock->shouldReceive('activateModule')
->with('test-module', false)
->andReturn([
@@ -851,7 +880,7 @@ class ModuleControllerTest extends TestCase
],
],
]);
$this->app->instance(\App\Services\ModuleService::class, $moduleServiceMock);
$this->app->instance(ModuleService::class, $moduleServiceMock);
// Act
$response = $this->authRequest()->postJson('/api/admin/modules/activate', [
@@ -872,7 +901,7 @@ class ModuleControllerTest extends TestCase
public function test_deactivate_response_includes_assets_when_module_has_assets(): void
{
// Arrange: ModuleService를 Mock
$moduleServiceMock = \Mockery::mock(\App\Services\ModuleService::class);
$moduleServiceMock = \Mockery::mock(ModuleService::class);
$moduleServiceMock->shouldReceive('deactivateModule')
->with('test-module', false)
->andReturn([
@@ -888,7 +917,7 @@ class ModuleControllerTest extends TestCase
],
],
]);
$this->app->instance(\App\Services\ModuleService::class, $moduleServiceMock);
$this->app->instance(ModuleService::class, $moduleServiceMock);
// Act
$response = $this->authRequest()->postJson('/api/admin/modules/deactivate', [
@@ -913,8 +942,8 @@ class ModuleControllerTest extends TestCase
{
// Arrange: 테스트용 CHANGELOG.md 생성
$modulePath = base_path('modules/test-changelog-mod');
\Illuminate\Support\Facades\File::ensureDirectoryExists($modulePath);
\Illuminate\Support\Facades\File::put($modulePath.'/CHANGELOG.md', "# Changelog\n\n## [0.1.1] - 2026-02-25\n\n### Added\n- 새 기능\n\n## [0.1.0] - 2026-02-20\n\n### Added\n- 초기 릴리스\n");
File::ensureDirectoryExists($modulePath);
File::put($modulePath.'/CHANGELOG.md', "# Changelog\n\n## [0.1.1] - 2026-02-25\n\n### Added\n- 새 기능\n\n## [0.1.0] - 2026-02-20\n\n### Added\n- 초기 릴리스\n");
try {
$response = $this->authRequest()->getJson('/api/admin/modules/test-changelog-mod/changelog');
@@ -924,7 +953,7 @@ class ModuleControllerTest extends TestCase
->assertJsonPath('data.changelog.0.categories.0.name', 'Added')
->assertJsonPath('data.changelog.1.version', '0.1.0');
} finally {
\Illuminate\Support\Facades\File::deleteDirectory($modulePath);
File::deleteDirectory($modulePath);
}
}
@@ -945,8 +974,8 @@ class ModuleControllerTest extends TestCase
public function test_changelog_with_version_range(): void
{
$modulePath = base_path('modules/test-changelog-range');
\Illuminate\Support\Facades\File::ensureDirectoryExists($modulePath);
\Illuminate\Support\Facades\File::put($modulePath.'/CHANGELOG.md', "# Changelog\n\n## [0.1.2] - 2026-02-28\n\n### Added\n- 기능 C\n\n## [0.1.1] - 2026-02-25\n\n### Added\n- 기능 B\n\n## [0.1.0] - 2026-02-20\n\n### Added\n- 초기 릴리스\n");
File::ensureDirectoryExists($modulePath);
File::put($modulePath.'/CHANGELOG.md', "# Changelog\n\n## [0.1.2] - 2026-02-28\n\n### Added\n- 기능 C\n\n## [0.1.1] - 2026-02-25\n\n### Added\n- 기능 B\n\n## [0.1.0] - 2026-02-20\n\n### Added\n- 초기 릴리스\n");
try {
$response = $this->authRequest()->getJson('/api/admin/modules/test-changelog-range/changelog?from_version=0.1.0&to_version=0.1.2');
@@ -957,7 +986,7 @@ class ModuleControllerTest extends TestCase
$this->assertSame('0.1.2', $changelog[0]['version']);
$this->assertSame('0.1.1', $changelog[1]['version']);
} finally {
\Illuminate\Support\Facades\File::deleteDirectory($modulePath);
File::deleteDirectory($modulePath);
}
}
@@ -980,8 +1009,8 @@ class ModuleControllerTest extends TestCase
public function test_license_returns_content(): void
{
$modulePath = base_path('modules/test-license-mod');
\Illuminate\Support\Facades\File::ensureDirectoryExists($modulePath);
\Illuminate\Support\Facades\File::put($modulePath.'/LICENSE', 'MIT License - Test');
File::ensureDirectoryExists($modulePath);
File::put($modulePath.'/LICENSE', 'MIT License - Test');
try {
$response = $this->authRequest()->getJson('/api/admin/modules/test-license-mod/license');
@@ -989,7 +1018,7 @@ class ModuleControllerTest extends TestCase
$response->assertStatus(200)
->assertJsonPath('data.content', 'MIT License - Test');
} finally {
\Illuminate\Support\Facades\File::deleteDirectory($modulePath);
File::deleteDirectory($modulePath);
}
}