gper/Gnuboard7
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

v7.0.0 release

Browse Source
This commit is contained in:
HeuJung committed 2026-07-01 10:30:32 +09:00
1 parent 0e7fa04b03
commit c4ea9a6cd1
3582 files changed
+626189 -160151
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

modules/_bundled/sirsoft-ecommerce/tests/ModuleTestCase.php
+120 -51
View File
@@ -2,7 +2,29 @@
namespace Modules\Sirsoft\Ecommerce\Tests;
use App\Enums\PermissionType;
use App\Extension\HookManager;
use App\Extension\ModuleManager;
use App\Helpers\ResponseHelper;
use App\Models\Permission;
use App\Models\Role;
use App\Models\User;
use App\Services\ModuleSettingsService;
use Illuminate\Contracts\Debug\ExceptionHandler;
use Illuminate\Foundation\Exceptions\Handler;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Foundation\Testing\RefreshDatabaseState;
use Illuminate\Support\Facades\File;
use Illuminate\Support\Facades\Route;
use Illuminate\Support\Facades\Schema;
use Modules\Sirsoft\Ecommerce\Database\Seeders\TestingSeeder;
use Modules\Sirsoft\Ecommerce\Exceptions\UnauthorizedPresetAccessException;
use Modules\Sirsoft\Ecommerce\Models\Product;
use Modules\Sirsoft\Ecommerce\Models\SearchPreset;
use Modules\Sirsoft\Ecommerce\Models\ShippingType;
use Modules\Sirsoft\Ecommerce\Module;
use Modules\Sirsoft\Ecommerce\Providers\EcommerceServiceProvider;
use Modules\Sirsoft\Ecommerce\Services\EcommerceSettingsService;
use Tests\TestCase;
/**
@@ -33,8 +55,6 @@ abstract class ModuleTestCase extends TestCase
/**
* 시딩 활성화
*
* @return bool
*/
protected function shouldSeed(): bool
{
@@ -43,12 +63,10 @@ abstract class ModuleTestCase extends TestCase
/**
* 테스트용 시더 클래스
*
* @return string
*/
protected function seeder(): string
{
return \Modules\Sirsoft\Ecommerce\Database\Seeders\TestingSeeder::class;
return TestingSeeder::class;
}
/**
@@ -56,8 +74,6 @@ abstract class ModuleTestCase extends TestCase
*
* RefreshDatabase의 migrate:fresh 명령에 코어 + 모듈 마이그레이션 경로를 전달합니다.
* 이를 통해 트랜잭션 시작 전에 모든 마이그레이션이 완료됩니다.
*
* @return array
*/
protected function migrateFreshUsing(): array
{
@@ -68,7 +84,7 @@ abstract class ModuleTestCase extends TestCase
'--seeder' => $this->seeder(),
'--path' => [
base_path('database/migrations'),
$this->getModuleBasePath() . '/database/migrations',
$this->getModuleBasePath().'/database/migrations',
],
'--realpath' => true,
];
@@ -105,12 +121,13 @@ abstract class ModuleTestCase extends TestCase
*/
protected function setUpTraits()
{
if (\Illuminate\Foundation\Testing\RefreshDatabaseState::$migrated) {
if (RefreshDatabaseState::$migrated) {
try {
if (! \Illuminate\Support\Facades\Schema::hasTable('ecommerce_shipping_types')) {
\Illuminate\Foundation\Testing\RefreshDatabaseState::$migrated = false;
if (! Schema::hasTable('ecommerce_shipping_types')) {
RefreshDatabaseState::$migrated = false;
}
} catch (\Throwable $e) { /* DB 미초기화 / 연결 부재 — RefreshDatabase 가 처리 */ }
} catch (\Throwable $e) { /* DB 미초기화 / 연결 부재 — RefreshDatabase 가 처리 */
}
}
return parent::setUpTraits();
@@ -124,7 +141,7 @@ abstract class ModuleTestCase extends TestCase
$this->registerModuleAutoload();
// 모듈 ServiceProvider 등록 (Repository 바인딩)
$this->app->register(\Modules\Sirsoft\Ecommerce\Providers\EcommerceServiceProvider::class);
$this->app->register(EcommerceServiceProvider::class);
// 모듈 인스턴스를 ModuleManager 에 등록 (Storage/Cache 바인딩에 필수)
// BaseModuleServiceProvider::registerStorageBindings 가 런타임에
@@ -142,12 +159,17 @@ abstract class ModuleTestCase extends TestCase
// HookManager 현재 상태 스냅샷 (tearDown 에서 복원)
$this->snapshotHookManager();
// 테스트 격리: 모듈 다국어 네임스페이스 + 설정 상태를 매 테스트마다 결정적으로 복원.
// (개별 통과 / 풀 스위트 실패 = 컨테이너 싱글톤 누수 — 과거 ModuleLayoutOverrideTest 와 동일 부류)
$this->isolateModuleTranslations();
$this->isolateModuleSettings();
// 모델 static cache 초기화 (RefreshDatabase 의 트랜잭션 롤백과 static 상태 불일치 방지)
// - ShippingType::$codeCache: getCachedByCode() 가 첫 호출 시 self::all() 결과를 캐시하는데,
// 첫 테스트가 ShippingType 시드 전에 호출하면 empty cache 로 고정되어 이후 테스트에서
// Resource::resolveShippingMethodLabel() 이 null 반환
if (method_exists(\Modules\Sirsoft\Ecommerce\Models\ShippingType::class, 'clearCodeCache')) {
\Modules\Sirsoft\Ecommerce\Models\ShippingType::clearCodeCache();
if (method_exists(ShippingType::class, 'clearCodeCache')) {
ShippingType::clearCodeCache();
}
}
@@ -158,15 +180,65 @@ abstract class ModuleTestCase extends TestCase
{
$this->restoreHookManager();
// 테스트가 saveSettings() 로 디스크에 남긴 settings JSON 정리 (다음 테스트 오염 방지)
$this->purgeTestSettingsDirectory();
parent::tearDown();
}
/**
* 모듈 다국어 네임스페이스를 라이브 translator 에 재등록합니다.
*
* `sirsoft-ecommerce::enums.*` 등의 키가 풀 스위트 실행 시 원문 키로 반환되는 회귀를 차단합니다.
* 선행 테스트가 translator 싱글톤을 모듈 hint 없이 resolve 해두면, ServiceProvider 의 boot()
* 가 이미 부팅된 것으로 간주되어 loadTranslationsFrom() 이 재호출되지 않아 hint 가 누락됩니다.
* 매 테스트마다 명시적으로 hint 를 재등록해 순서 무관 결정성을 보장합니다.
*/
private function isolateModuleTranslations(): void
{
$langPath = $this->getModuleBasePath().'/src/lang';
if (is_dir($langPath)) {
$this->app['translator']->addNamespace('sirsoft-ecommerce', $langPath);
}
}
/**
* 모듈 설정 관련 싱글톤과 디스크 settings 를 초기화합니다.
*
* EcommerceSettingsService / ModuleSettingsService 싱글톤이 이전 테스트의 mock 또는
* saveSettings() 영속 상태를 유지하면 후속 테스트가 오염됩니다. 싱글톤을 forget 하고
* 테스트 settings 디렉토리를 비워 매 테스트가 깨끗한 기본값에서 시작하도록 합니다.
*/
private function isolateModuleSettings(): void
{
$this->app->forgetInstance(EcommerceSettingsService::class);
$this->app->forgetInstance(ModuleSettingsService::class);
$this->purgeTestSettingsDirectory();
}
/**
* 테스트 환경 settings 디렉토리(storage/framework/testing/...)를 삭제합니다.
*
* EcommerceSettingsService::getStoragePath() 가 runningUnitTests 시 사용하는 경로로,
* RefreshDatabase 의 트랜잭션 롤백 대상이 아니므로 명시적으로 정리해야 합니다.
*/
private function purgeTestSettingsDirectory(): void
{
$path = storage_path('framework/testing/modules/sirsoft-ecommerce/settings');
if (File::isDirectory($path)) {
File::deleteDirectory($path);
}
}
/**
* HookManager static $hooks / $filters / $dispatching 를 스냅샷.
*/
private function snapshotHookManager(): void
{
$ref = new \ReflectionClass(\App\Extension\HookManager::class);
$ref = new \ReflectionClass(HookManager::class);
$hooks = $ref->getProperty('hooks');
$hooks->setAccessible(true);
$filters = $ref->getProperty('filters');
@@ -190,7 +262,7 @@ abstract class ModuleTestCase extends TestCase
return;
}
$ref = new \ReflectionClass(\App\Extension\HookManager::class);
$ref = new \ReflectionClass(HookManager::class);
$hooks = $ref->getProperty('hooks');
$hooks->setAccessible(true);
$hooks->setValue(null, $this->hookSnapshot['hooks']);
@@ -211,20 +283,20 @@ abstract class ModuleTestCase extends TestCase
*/
protected function registerModuleInstance(): void
{
$moduleClass = \Modules\Sirsoft\Ecommerce\Module::class;
$moduleClass = Module::class;
if (! class_exists($moduleClass)) {
require_once $this->getModuleBasePath() . '/module.php';
require_once $this->getModuleBasePath().'/module.php';
}
/** @var \App\Extension\ModuleManager $manager */
$manager = $this->app->make(\App\Extension\ModuleManager::class);
/** @var ModuleManager $manager */
$manager = $this->app->make(ModuleManager::class);
$reflection = new \ReflectionClass($manager);
$modulesProp = $reflection->getProperty('modules');
$modulesProp->setAccessible(true);
$current = $modulesProp->getValue($manager);
$current['sirsoft-ecommerce'] = new $moduleClass();
$current['sirsoft-ecommerce'] = new $moduleClass;
$modulesProp->setValue($manager, $current);
}
@@ -235,11 +307,11 @@ abstract class ModuleTestCase extends TestCase
*/
protected function registerModuleExceptionHandler(): void
{
/** @var \Illuminate\Foundation\Exceptions\Handler $handler */
$handler = $this->app->make(\Illuminate\Contracts\Debug\ExceptionHandler::class);
/** @var Handler $handler */
$handler = $this->app->make(ExceptionHandler::class);
$handler->renderable(function (\Modules\Sirsoft\Ecommerce\Exceptions\UnauthorizedPresetAccessException $e) {
return \App\Helpers\ResponseHelper::forbidden($e->getMessage());
$handler->renderable(function (UnauthorizedPresetAccessException $e) {
return ResponseHelper::forbidden($e->getMessage());
});
}
@@ -248,7 +320,7 @@ abstract class ModuleTestCase extends TestCase
*/
protected function registerModuleAutoload(): void
{
$moduleBasePath = $this->getModuleBasePath() . '/src/';
$moduleBasePath = $this->getModuleBasePath().'/src/';
// PSR-4 클래스 오토로드 등록
spl_autoload_register(function ($class) use ($moduleBasePath) {
@@ -260,7 +332,7 @@ abstract class ModuleTestCase extends TestCase
}
$relativeClass = substr($class, $len);
$file = $moduleBasePath . str_replace('\\', '/', $relativeClass) . '.php';
$file = $moduleBasePath.str_replace('\\', '/', $relativeClass).'.php';
if (file_exists($file)) {
require $file;
@@ -268,7 +340,7 @@ abstract class ModuleTestCase extends TestCase
});
// composer.json files 오토로드 (헬퍼 함수 등록)
$helpersFile = $moduleBasePath . 'Helpers/helpers.php';
$helpersFile = $moduleBasePath.'Helpers/helpers.php';
if (file_exists($helpersFile)) {
require_once $helpersFile;
}
@@ -279,18 +351,18 @@ abstract class ModuleTestCase extends TestCase
*/
protected function registerModuleRoutes(): void
{
$apiRoutesFile = $this->getModuleBasePath() . '/src/routes/api.php';
$apiRoutesFile = $this->getModuleBasePath().'/src/routes/api.php';
if (file_exists($apiRoutesFile)) {
// Route Model Binding 등록 (테스트 환경)
\Illuminate\Support\Facades\Route::bind('product', function ($value) {
$model = new \Modules\Sirsoft\Ecommerce\Models\Product();
Route::bind('product', function ($value) {
$model = new Product;
return $model->resolveRouteBinding($value);
});
\Illuminate\Support\Facades\Route::model('preset', \Modules\Sirsoft\Ecommerce\Models\SearchPreset::class);
Route::model('preset', SearchPreset::class);
\Illuminate\Support\Facades\Route::prefix('api/modules/sirsoft-ecommerce')
Route::prefix('api/modules/sirsoft-ecommerce')
->name('api.modules.sirsoft-ecommerce.')
->middleware('api')
->group($apiRoutesFile);
@@ -302,22 +374,22 @@ abstract class ModuleTestCase extends TestCase
*/
protected function createDefaultRoles(): void
{
$adminRole = \App\Models\Role::firstOrCreate(
$adminRole = Role::firstOrCreate(
['identifier' => 'admin'],
['name' => ['ko' => '관리자', 'en' => 'Administrator']]
);
// admin 역할에 admin 타입 권한 부여 (isAdmin() 체크용)
$adminPermission = \App\Models\Permission::firstOrCreate(
$adminPermission = Permission::firstOrCreate(
['identifier' => 'admin.access'],
[
'name' => ['ko' => '관리자 접근', 'en' => 'Admin Access'],
'type' => \App\Enums\PermissionType::Admin,
'type' => PermissionType::Admin,
]
);
$adminRole->permissions()->syncWithoutDetaching([$adminPermission->id]);
\App\Models\Role::firstOrCreate(
Role::firstOrCreate(
['identifier' => 'user'],
['name' => ['ko' => '일반 사용자', 'en' => 'User']]
);
@@ -329,26 +401,25 @@ abstract class ModuleTestCase extends TestCase
* 각 사용자에 대해 고유한 역할을 생성하여 권한을 독립적으로 관리합니다.
*
* @param array $permissions 추가 권한 목록
* @return \App\Models\User
*/
protected function createAdminUser(array $permissions = []): \App\Models\User
protected function createAdminUser(array $permissions = []): User
{
$user = \App\Models\User::factory()->create();
$user = User::factory()->create();
// 사용자별 고유 역할 생성 (권한 격리를 위함)
$uniqueRoleIdentifier = 'admin-test-' . $user->id . '-' . time();
$userRole = \App\Models\Role::create([
$uniqueRoleIdentifier = 'admin-test-'.$user->id.'-'.time();
$userRole = Role::create([
'identifier' => $uniqueRoleIdentifier,
'name' => ['ko' => '테스트 관리자', 'en' => 'Test Admin'],
]);
$user->roles()->attach($userRole->id);
// admin.access 권한 추가 (isAdmin() 체크용)
$adminAccessPermission = \App\Models\Permission::firstOrCreate(
$adminAccessPermission = Permission::firstOrCreate(
['identifier' => 'admin.access'],
[
'name' => ['ko' => '관리자 접근', 'en' => 'Admin Access'],
'type' => \App\Enums\PermissionType::Admin,
'type' => PermissionType::Admin,
]
);
$userRole->permissions()->attach($adminAccessPermission->id);
@@ -356,7 +427,7 @@ abstract class ModuleTestCase extends TestCase
// 추가 권한이 있으면 역할에 할당
if (! empty($permissions)) {
foreach ($permissions as $permissionIdentifier) {
$permission = \App\Models\Permission::firstOrCreate(
$permission = Permission::firstOrCreate(
['identifier' => $permissionIdentifier],
[
'name' => ['ko' => $permissionIdentifier, 'en' => $permissionIdentifier],
@@ -372,13 +443,11 @@ abstract class ModuleTestCase extends TestCase
/**
* 일반 사용자를 생성합니다.
*
* @return \App\Models\User
*/
protected function createUser(): \App\Models\User
protected function createUser(): User
{
$userRole = \App\Models\Role::where('identifier', 'user')->first();
$user = \App\Models\User::factory()->create();
$userRole = Role::where('identifier', 'user')->first();
$user = User::factory()->create();
$user->roles()->attach($userRole->id);
return $user;