perf(board): 목록·검색·상세의 중복 실행 제거 및 상한 계약 소비

검색 — 이 코어에 추가한 BOOLEAN MODE 정제기가 게시판에는 도달하지 않아
원문 키워드가 그대로 바인딩되고 있었다. + - * " < > 를 넣으면 오류 화면이 떴다.
코어 정제기 경유로 옮겼고, 같은 술어를 count 와 get 으로 두 번 실행하던 것을
페이지네이터 한 번으로 합쳤다. 구체 엔진 직접 호출도 해석기 경유로 바꿔 플러그인
검색엔진이 게시글·신고 검색에 적용된다.

상세 — 같은 글을 3회, 같은 게시판을 5회 읽고 있었다. 조회한 인스턴스를 넘겨
글 1회·게시판 1회로 줄였고, 조회수 증가를 권한 확인 뒤로 옮겨 열람 권한이 없는
요청이 조회수를 올리지 않게 했다.

목록 — 답변 트리의 무제한 조회에 상한과 순환 가드를 두고, O(n²) 병합을 한 패스로
바꿨다. 댓글도 무제한 조회에 상한을 두되 잘렸다는 사실과 전체 건수를 함께 알린다.
조용히 잘리면 "댓글이 그만큼뿐" 으로 보인다. 원댓글 단위 페이지네이션을 더해
답글이 부모와 떨어지지 않게 했다.

관리자 화면 — 총 건수가 잘린 목록에서 페이저가 "1페이지뿐" 으로 접히던 자리를
고쳤다. 저장소가 상한을 붙인 목록인데 화면이 그 값을 1 로 채우고 있어, 기록이
상한을 넘으면 2페이지에 도달할 방법이 없었다.

같은 파일에서 드러난 사전 결함도 함께 처리했다 — 반복 렌더 안의 정적 HTML id,
Icon 의 박스 크기 지정, 단색 버튼의 다크 모드 대비.
This commit is contained in:
HeuJung committed 2026-08-06 11:13:51 +09:00
1 parent 2ae1972a3b
commit 41fe812f2c
31 files changed
+2092 -372

No files matched your search

@@ -2,9 +2,21 @@
namespace Modules\Sirsoft\Board\Tests;
use App\Contracts\Extension\HookListenerInterface;
use App\Enums\ExtensionStatus;
use App\Extension\HookListenerRegistrar;
use App\Extension\HookManager;
use App\Extension\ModuleManager;
use App\Http\Middleware\PermissionMiddleware;
use App\Models\Module;
use App\Models\Permission;
use App\Models\Role;
use App\Models\User;
use Illuminate\Foundation\Testing\DatabaseTransactions;
use Illuminate\Support\Facades\Route;
use Illuminate\Support\Facades\Schema;
use Modules\Sirsoft\Board\Models\Board;
use Modules\Sirsoft\Board\Providers\BoardServiceProvider;
use Tests\TestCase;
/**
@@ -62,7 +74,7 @@ abstract class ModuleTestCase extends TestCase
$this->registerModuleAutoload();
// 모듈 ServiceProvider 등록 (Repository 바인딩)
$this->app->register(\Modules\Sirsoft\Board\Providers\BoardServiceProvider::class);
$this->app->register(BoardServiceProvider::class);
// 모듈 마이그레이션 실행 (boards 테이블 등)
$this->runModuleMigrationIfNeeded();
@@ -73,7 +85,7 @@ abstract class ModuleTestCase extends TestCase
// ModuleManager 메모리 맵에 sirsoft-board 로드 (테스트 환경)
// CoreServiceProvider::boot()에서 loadModules()가 호출되지만,
// 테스트 컨테이너에서 ModuleManager 싱글톤이 비어있는 경우를 대비해 명시적으로 재로드
$this->app->make(\App\Extension\ModuleManager::class)->loadModules();
$this->app->make(ModuleManager::class)->loadModules();
// _bundled 디렉토리 모듈은 loadModules() 가 스캔하지 않아
// 모듈 인스턴스 등록 + 훅 리스너 자동 등록이 누락된다.
@@ -91,11 +103,7 @@ abstract class ModuleTestCase extends TestCase
// PermissionMiddleware::$guestRoleCache 초기화 — 이전 테스트에서 로드된 guest role/permissions 캐시가
// DatabaseTransactions 롤백 후에도 남아있어 다음 테스트의 새 permission 설정이 반영되지 않는 문제 회피.
$middlewareRef = new \ReflectionClass(\App\Http\Middleware\PermissionMiddleware::class);
if ($middlewareRef->hasProperty('guestRoleCache')) {
$prop = $middlewareRef->getProperty('guestRoleCache');
$prop->setValue(null, null);
}
PermissionMiddleware::clearGuestRoleCache();
}
/**
@@ -113,7 +121,7 @@ abstract class ModuleTestCase extends TestCase
*/
private function snapshotHookManager(): void
{
$ref = new \ReflectionClass(\App\Extension\HookManager::class);
$ref = new \ReflectionClass(HookManager::class);
$this->hookSnapshot = [
'hooks' => $ref->getProperty('hooks')->getValue(),
'filters' => $ref->getProperty('filters')->getValue(),
@@ -130,7 +138,7 @@ abstract class ModuleTestCase extends TestCase
return;
}
$ref = new \ReflectionClass(\App\Extension\HookManager::class);
$ref = new \ReflectionClass(HookManager::class);
$ref->getProperty('hooks')->setValue(null, $this->hookSnapshot['hooks']);
$ref->getProperty('filters')->setValue(null, $this->hookSnapshot['filters']);
$ref->getProperty('dispatching')->setValue(null, $this->hookSnapshot['dispatching']);
@@ -159,7 +167,7 @@ abstract class ModuleTestCase extends TestCase
// 모듈 마이그레이션 실행 (코어 테이블 생성 후)
$this->artisan('migrate', [
'--path' => $this->getModuleBasePath() . '/database/migrations',
'--path' => $this->getModuleBasePath().'/database/migrations',
'--realpath' => true,
]);
@@ -179,13 +187,13 @@ abstract class ModuleTestCase extends TestCase
$moduleClass = \Modules\Sirsoft\Board\Module::class;
if (! class_exists($moduleClass)) {
require_once $this->getModuleBasePath() . '/module.php';
require_once $this->getModuleBasePath().'/module.php';
}
$module = new $moduleClass();
$module = new $moduleClass;
/** @var \App\Extension\ModuleManager $manager */
$manager = $this->app->make(\App\Extension\ModuleManager::class);
/** @var ModuleManager $manager */
$manager = $this->app->make(ModuleManager::class);
// ModuleManager.modules 에 인스턴스 주입
$reflection = new \ReflectionClass($manager);
@@ -203,11 +211,11 @@ abstract class ModuleTestCase extends TestCase
if (! class_exists($listenerClass)) {
continue;
}
if (! in_array(\App\Contracts\Extension\HookListenerInterface::class, class_implements($listenerClass), true)) {
if (! in_array(HookListenerInterface::class, class_implements($listenerClass), true)) {
continue;
}
try {
\App\Extension\HookListenerRegistrar::register($listenerClass, 'sirsoft-board');
HookListenerRegistrar::register($listenerClass, 'sirsoft-board');
} catch (\Throwable $e) {
// 중복 등록 등 무해한 예외는 무시 (snapshot/restore 패턴이 정리)
}
@@ -221,15 +229,15 @@ abstract class ModuleTestCase extends TestCase
protected function registerModuleAsActive(): void
{
// 이미 등록되어 있으면 스킵
if (\App\Models\Module::where('identifier', 'sirsoft-board')->exists()) {
if (Module::where('identifier', 'sirsoft-board')->exists()) {
return;
}
\App\Models\Module::create([
Module::create([
'identifier' => 'sirsoft-board',
'vendor' => 'sirsoft',
'name' => ['ko' => '게시판', 'en' => 'Board'],
'status' => \App\Enums\ExtensionStatus::Active->value,
'status' => ExtensionStatus::Active->value,
'version' => '1.0.0',
'config' => [],
]);
@@ -240,7 +248,7 @@ abstract class ModuleTestCase extends TestCase
*/
protected function registerModuleAutoload(): void
{
$moduleBasePath = $this->getModuleBasePath() . '/src/';
$moduleBasePath = $this->getModuleBasePath().'/src/';
spl_autoload_register(function ($class) use ($moduleBasePath) {
$prefix = 'Modules\\Sirsoft\\Board\\';
@@ -264,10 +272,10 @@ 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)) {
\Illuminate\Support\Facades\Route::prefix('api/modules/sirsoft-board')
Route::prefix('api/modules/sirsoft-board')
->name('api.modules.sirsoft-board.')
->middleware('api')
->group($apiRoutesFile);
@@ -279,17 +287,17 @@ abstract class ModuleTestCase extends TestCase
*/
protected function createDefaultRoles(): void
{
\App\Models\Role::firstOrCreate(
Role::firstOrCreate(
['identifier' => 'admin'],
['name' => ['ko' => '관리자', 'en' => 'Administrator']]
);
\App\Models\Role::firstOrCreate(
Role::firstOrCreate(
['identifier' => 'user'],
['name' => ['ko' => '일반 사용자', 'en' => 'User']]
);
\App\Models\Role::firstOrCreate(
Role::firstOrCreate(
['identifier' => 'guest'],
['name' => ['ko' => '비회원', 'en' => 'Guest']]
);
@@ -300,18 +308,18 @@ abstract class ModuleTestCase extends TestCase
* 관리자 역할을 가진 사용자를 생성합니다.
*
* @param array $permissions 추가 권한 목록
* @return \App\Models\User
* @return User
*/
protected function createAdminUser(array $permissions = []): \App\Models\User
protected function createAdminUser(array $permissions = []): User
{
$adminRole = \App\Models\Role::where('identifier', 'admin')->first();
$user = \App\Models\User::factory()->create();
$adminRole = Role::where('identifier', 'admin')->first();
$user = User::factory()->create();
$user->roles()->attach($adminRole->id);
// 추가 권한이 있으면 생성 및 할당
if (! empty($permissions)) {
foreach ($permissions as $permissionIdentifier) {
$permission = \App\Models\Permission::firstOrCreate(
$permission = Permission::firstOrCreate(
['identifier' => $permissionIdentifier],
[
'name' => ['ko' => $permissionIdentifier, 'en' => $permissionIdentifier],
@@ -328,14 +336,14 @@ abstract class ModuleTestCase extends TestCase
/**
* 일반 사용자를 생성합니다.
*
* @return \App\Models\User
* @return 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;
}
}
}