fix(core,board,ecommerce,page,gdpr,ckeditor5,kginicis,admin_basic,basic): 목록 조회·검증 계층 정비 및 감사 지적 전건 처리
목록 조회 성능 축(깊은 OFFSET·정렬·색인)과 그 검증 계층에서 계획서 전수검수와 3회에 걸친 감사가 지적한 항목을 처리했다. 세부 경위는 의 각 회차 문서에 있다. 검증 계층 — 컨트롤러가 base Request 를 직접 주입받던 확장 13곳을 전용 FormRequest 로 옮겼다. 옮기면서 기존 동작 계약은 그대로 두었다: 상한 초과 limit 을 거부하지 않고 상한까지 반환하던 공개 API, per_page 를 범위로 조정하던 관리자 목록, 미지원 period 를 year 로 해석하던 인기글 목록 모두 종전과 같은 응답을 낸다. 상한/폴백을 rules 로 승격시키면 200 이던 응답이 422 가 되어 기존 링크가 깨지므로, 규칙은 타입만 닫고 클램프·폴백은 접근자가 맡는다. period 는 접근자가 닫힌 집합만 반환해 캐시 키 공간도 함께 닫힌다. ckeditor5 이미지 업로드만 ResponseHelper 봉투를 쓰지 않는다. 응답을 파싱하는 주체가 CDN 으로 로드되는 상위 CKEditor5 43.3.1 의 SimpleUploadAdapter 라 규약을 바꿀 수 없어, 각 응답 지점에 사유를 명시한 면제를 부착하고 근거를 API 문서에 남겼다. 하네스 — 룰 5개의 대상 경로 패턴이 매처와 맞지 않아 번들 확장 컨트롤러가 검사 대상에서 통째로 빠져 있었다. 패턴을 고치자 확장 위반 17건이 드러나 전건 처리했다. severity 오타가 요약 집계 양쪽에 안 잡혀 "0 error" 로 보고되던 문제도 런너 사전 검증으로 막았다. 정렬 게이트 대조 하네스는 관계 정렬 변형만 쓰는 저장소를 탐지하지 못한 채 통과시키고 있었다. 탐지·제외·인자 파싱을 함께 고치고 단위 테스트를 신설했다.
This commit is contained in:
HeuJung committed
1 parent
5f4a733b3b
commit
b10e89bef0
276 files changed
+12519
-1438
No files matched your search
@@ -29,18 +29,22 @@ class MenuController extends AdminBaseController
|
||||
parent::__construct();
|
||||
}
|
||||
|
||||
/**
|
||||
* 관리용 메뉴 목록을 조회합니다.
|
||||
*
|
||||
* @param MenuListRequest $request 목록 필터·정렬 요청
|
||||
* @return JsonResponse 메뉴 컬렉션을 담은 JSON 응답
|
||||
*/
|
||||
public function index(MenuListRequest $request): JsonResponse
|
||||
{
|
||||
try {
|
||||
$filters = $request->validated();
|
||||
$user = Auth::user();
|
||||
|
||||
// 필터가 있으면 필터링된 메뉴 조회, 없으면 전체 조회
|
||||
if (isset($filters['is_active']) || ! empty($filters['filters'])) {
|
||||
$menus = $this->menuService->getFilteredMenusForManagement($filters, $user);
|
||||
} else {
|
||||
$menus = $this->menuService->getTopLevelMenusForManagement($user);
|
||||
}
|
||||
// 필터 유무와 무관하게 같은 경로로 조회한다. 예전에는 필터가 없으면 filters 를
|
||||
// 받지 않는 메서드로 분기했는데, 그 경로는 sort_by/sort_order 를 통째로 버려
|
||||
// "필터를 하나라도 걸어야 정렬이 먹는" 상태가 됐다 (#492 D-22).
|
||||
$menus = $this->menuService->getFilteredMenusForManagement($filters, $user);
|
||||
|
||||
return $this->successWithResource(
|
||||
'menu.fetch_success',
|
||||
|
||||
@@ -7,6 +7,7 @@ use App\Extension\Vendor\VendorMode;
|
||||
use App\Http\Controllers\Api\Base\AdminBaseController;
|
||||
use App\Http\Controllers\Concerns\InjectsExtensionLanguagePacks;
|
||||
use App\Http\Controllers\Concerns\OrchestratesCascadeInstall;
|
||||
use App\Http\Controllers\Concerns\RebuildsSearchIndexOnDemand;
|
||||
use App\Http\Requests\Extension\ChangelogRequest;
|
||||
use App\Http\Requests\Module\ActivateModuleRequest;
|
||||
use App\Http\Requests\Module\DeactivateModuleRequest;
|
||||
@@ -38,6 +39,7 @@ class ModuleController extends AdminBaseController
|
||||
{
|
||||
use InjectsExtensionLanguagePacks;
|
||||
use OrchestratesCascadeInstall;
|
||||
use RebuildsSearchIndexOnDemand;
|
||||
|
||||
public function __construct(
|
||||
private ModuleService $moduleService,
|
||||
@@ -531,25 +533,36 @@ class ModuleController extends AdminBaseController
|
||||
$force = (bool) ($validated['force'] ?? false);
|
||||
$result = $this->moduleService->updateModule($moduleName, $vendorMode, $layoutStrategy, $force);
|
||||
|
||||
// 검색 인덱스 재생성은 운영자가 체크했을 때만 수행한다 — 인덱스 잠금·재색인 비용이
|
||||
// 있어 운영 중인 사이트에서 업데이트만으로 발생해서는 안 된다.
|
||||
$searchIndex = $this->rebuildSearchIndexIfRequested(
|
||||
(bool) ($validated['rebuild_search_index'] ?? false)
|
||||
);
|
||||
|
||||
$moduleInfo = $result['module_info'] ?? null;
|
||||
|
||||
// 메시지 치환 파라미터를 반드시 전달한다 — 누락 시 ":module"/":version"
|
||||
// 플레이스홀더가 그대로 사용자에게 노출된다.
|
||||
$messageParams = [
|
||||
'module' => $moduleName,
|
||||
'version' => $result['to_version'] ?? ($moduleInfo['version'] ?? ''),
|
||||
'version' => (string) ($result['to_version'] ?? data_get($moduleInfo, 'version') ?? ''),
|
||||
];
|
||||
|
||||
if ($moduleInfo) {
|
||||
return $this->successWithResource(
|
||||
'modules.update_success',
|
||||
new ModuleResource($moduleInfo),
|
||||
(new ModuleResource($moduleInfo))->additional(['search_index' => $searchIndex]),
|
||||
200,
|
||||
$messageParams
|
||||
);
|
||||
}
|
||||
|
||||
return $this->success('modules.update_success', $result, 200, $messageParams);
|
||||
return $this->success(
|
||||
'modules.update_success',
|
||||
$result + ['search_index' => $searchIndex],
|
||||
200,
|
||||
$messageParams
|
||||
);
|
||||
} catch (ValidationException $e) {
|
||||
// Service/Manager에서 이미 번역된 메시지를 errors에 포함하므로
|
||||
// 첫 번째 에러를 top-level message로 직접 사용 (이중 래핑 방지)
|
||||
|
||||
@@ -8,6 +8,7 @@ use App\Helpers\PermissionHelper;
|
||||
use App\Http\Controllers\Api\Base\AdminBaseController;
|
||||
use App\Http\Controllers\Concerns\InjectsExtensionLanguagePacks;
|
||||
use App\Http\Controllers\Concerns\OrchestratesCascadeInstall;
|
||||
use App\Http\Controllers\Concerns\RebuildsSearchIndexOnDemand;
|
||||
use App\Http\Requests\Extension\ChangelogRequest;
|
||||
use App\Http\Requests\Plugin\ActivatePluginRequest;
|
||||
use App\Http\Requests\Plugin\DeactivatePluginRequest;
|
||||
@@ -39,6 +40,7 @@ class PluginController extends AdminBaseController
|
||||
{
|
||||
use InjectsExtensionLanguagePacks;
|
||||
use OrchestratesCascadeInstall;
|
||||
use RebuildsSearchIndexOnDemand;
|
||||
|
||||
public function __construct(
|
||||
private PluginService $pluginService,
|
||||
@@ -538,25 +540,35 @@ class PluginController extends AdminBaseController
|
||||
$force = (bool) ($validated['force'] ?? false);
|
||||
$result = $this->pluginService->updatePlugin($pluginName, $vendorMode, $layoutStrategy, $force);
|
||||
|
||||
// 검색 인덱스 재생성은 운영자가 체크했을 때만 수행한다 — 인덱스 잠금·재색인 비용이
|
||||
// 있어 운영 중인 사이트에서 업데이트만으로 발생해서는 안 된다.
|
||||
$searchIndex = $this->rebuildSearchIndexIfRequested(
|
||||
(bool) ($validated['rebuild_search_index'] ?? false)
|
||||
);
|
||||
|
||||
$pluginInfo = $result['plugin_info'] ?? null;
|
||||
|
||||
// 메시지 치환 파라미터를 반드시 전달한다 — 누락 시 ":plugin"/":version"
|
||||
// 플레이스홀더가 그대로 사용자에게 노출된다.
|
||||
// 성공 메시지는 ":plugin"/":version" 치환자를 쓰므로 값을 함께 넘긴다
|
||||
$messageParams = [
|
||||
'plugin' => $pluginName,
|
||||
'version' => $result['to_version'] ?? ($pluginInfo['version'] ?? ''),
|
||||
'version' => (string) ($result['to_version'] ?? data_get($pluginInfo, 'version') ?? ''),
|
||||
];
|
||||
|
||||
if ($pluginInfo) {
|
||||
return $this->successWithResource(
|
||||
'plugins.update_success',
|
||||
new PluginResource($pluginInfo),
|
||||
(new PluginResource($pluginInfo))->additional(['search_index' => $searchIndex]),
|
||||
200,
|
||||
$messageParams
|
||||
);
|
||||
}
|
||||
|
||||
return $this->success('plugins.update_success', $result, 200, $messageParams);
|
||||
return $this->success(
|
||||
'plugins.update_success',
|
||||
$result + ['search_index' => $searchIndex],
|
||||
200,
|
||||
$messageParams
|
||||
);
|
||||
} catch (ValidationException $e) {
|
||||
// Service/Manager에서 이미 번역된 메시지를 errors에 포함하므로
|
||||
// 첫 번째 에러를 top-level message로 직접 사용 (이중 래핑 방지)
|
||||
|
||||
@@ -0,0 +1,46 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Controllers\Concerns;
|
||||
|
||||
use App\Search\SearchIndexMaintenanceManager;
|
||||
|
||||
/**
|
||||
* 관리자 화면의 설치·업데이트 응답에 "검색 인덱스 재생성" 선택 결과를 싣는 트레이트.
|
||||
*
|
||||
* 재생성 비용은 엔진마다 다르지만(테이블 잠금 / 전체 재색인) 어느 쪽이든 운영 중인
|
||||
* 사이트에 영향을 줍니다. 그래서 **운영자가 화면에서 체크했을 때만** 수행하고,
|
||||
* 체크하지 않았을 때는 점검 결과만 실어 보내 화면이 "지금 색인이 누락된 인덱스가 있다"
|
||||
* 는 사실을 알릴 수 있게 합니다 — 색인이 비면 검색이 오류 없이 0건을 돌려주므로
|
||||
* 알려 주지 않으면 운영자가 알 방법이 없습니다.
|
||||
*/
|
||||
trait RebuildsSearchIndexOnDemand
|
||||
{
|
||||
/**
|
||||
* 요청이 있었으면 재생성하고, 없었으면 점검 결과만 반환합니다.
|
||||
*
|
||||
* @param bool $requested 재생성 요청 여부
|
||||
* @return array<string, mixed>|null 응답에 실을 페이로드 (점검 불가 엔진이면 null)
|
||||
*/
|
||||
protected function rebuildSearchIndexIfRequested(bool $requested): ?array
|
||||
{
|
||||
$manager = app(SearchIndexMaintenanceManager::class);
|
||||
|
||||
// 점검을 제공하지 않는 엔진에서는 실을 정보가 없다 (검색 자체는 정상 동작)
|
||||
if (! $manager->hasMaintainer() || $manager->unavailableReason() !== null) {
|
||||
return null;
|
||||
}
|
||||
|
||||
if ($requested) {
|
||||
return ['rebuilt' => true] + $manager->repairStale()->toArray();
|
||||
}
|
||||
|
||||
$stale = array_values(array_filter($manager->inspect(), fn ($health) => $health->needsRebuild()));
|
||||
|
||||
return [
|
||||
'rebuilt' => false,
|
||||
'driver' => $manager->driver(),
|
||||
'stale' => array_map(fn ($health) => $health->identifier, $stale),
|
||||
'stale_count' => count($stale),
|
||||
];
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user