HeuJung
b5c0ec1178
관리자 상품목록을 한 페이지 여는 것만으로 그 페이지 모든 상품의 옵션이 응답에 실렸다. 같은 패턴을 저장소 전역에서 찾아 14개 목록 엔드포인트를 함께 정리했다. 근본 원인은 둘이다. Resource 가 whenLoaded 로 방어하는데 Repository 가 목록 쿼리에서 관계를 무조건 로드해 가드가 항상 참이 되는 가짜 가드, 그리고 toListArray 경량 표현을 정의해 두고도 컬렉션이 toArray 를 부르는 목록/상세 미분리다. 둘 다 응답만 보면 정상이라 오류도 경고도 없이 페이로드만 불어난다. 목록은 화면이 실제로 그리는 것만 싣는다. 개수·합계는 PHP 컬렉션 연산이 아니라 DB 집계로, 대표 1건이 필요한 곳은 관계 자체를 oldestOfMany 로 좁힌다. eager load 의 limit(1) 은 부모별이 아니라 배치 쿼리 전체에 걸려 첫 행만 값을 갖게 되므로 쓸 수 없다. 뺀 값에는 대체 경로를 먼저 만들었다. 상품 옵션은 행을 펼칠 때 배치로 불러오고(상품 수와 무관하게 쿼리 상수), 종전 동작이 필요한 호출자를 위해 ?with_options=1 등 opt-in 을 남겼다. 배송정책 국가설정과 리뷰 첨부 이미지는 소비처를 실측한 결과 화면이 실제로 그리고 있어 제거하지 않았다 — 그 소비 사실을 회귀 테스트로 고정했다. 재발 방지로 정적 검사 룰 4종과 규정 문서 항목을 함께 넣었다.
236 lines
9.2 KiB
PHP
236 lines
9.2 KiB
PHP
<?php
|
|
|
|
namespace App\Http\Resources;
|
|
|
|
use App\Enums\ExtensionOwnerType;
|
|
use App\Extension\ModuleManager;
|
|
use App\Extension\PluginManager;
|
|
use App\Models\Permission;
|
|
use Illuminate\Http\Request;
|
|
use Illuminate\Support\Collection;
|
|
|
|
class RoleResource extends BaseApiResource
|
|
{
|
|
/**
|
|
* 역할 리소스를 배열로 변환합니다.
|
|
*
|
|
* @param Request $request HTTP 요청 객체
|
|
* @return array<string, mixed> 변환된 배열 데이터
|
|
*/
|
|
public function toArray(Request $request): array
|
|
{
|
|
return [
|
|
'id' => $this->getValue('id'),
|
|
'identifier' => $this->getValue('identifier'),
|
|
'name' => $this->getLocalizedName(),
|
|
'name_raw' => $this->getValue('name'),
|
|
'description' => $this->getLocalizedDescription(),
|
|
'description_raw' => $this->getValue('description'),
|
|
'extension_type' => $this->getValue('extension_type'),
|
|
'extension_identifier' => $this->getValue('extension_identifier'),
|
|
'extension_name' => $this->getExtensionName(),
|
|
'is_deletable' => is_object($this->resource) && method_exists($this->resource, 'isDeletable')
|
|
? $this->resource->isDeletable()
|
|
: true,
|
|
'is_active' => $this->getValue('is_active', true),
|
|
'users_count' => $this->when(
|
|
$this->resource->users_count !== null,
|
|
fn () => $this->resource->users_count
|
|
),
|
|
// 목록은 권한 배열 3종을 싣지 않는다. 그 대신 "몇 개가 할당됐는가" 는 집계로 남긴다
|
|
// — 목록 화면이 권한 규모를 보여주면서도 권한 트리를 전송하지 않게 하는 대체 경로다.
|
|
// 값 검사(`!== null`)가 아니라 별칭 존재 여부로 판정한다: COUNT 는 0건에서도 0 을
|
|
// 돌려주므로 "집계하지 않았다" 와 "집계했더니 0" 이 구분되지 않는다.
|
|
'permissions_count' => $this->whenHas(
|
|
'permissions_count',
|
|
fn () => (int) $this->resource->permissions_count
|
|
),
|
|
'permission_ids' => $this->when(
|
|
$this->resource->relationLoaded('permissions'),
|
|
fn () => $this->resource->permissions->pluck('id')->toArray()
|
|
),
|
|
'permission_values' => $this->when(
|
|
$this->resource->relationLoaded('permissions'),
|
|
fn () => $this->resource->permissions->map(fn ($p) => [
|
|
'id' => $p->id,
|
|
'scope_type' => $p->pivot->scope_type?->value ?? $p->pivot->scope_type,
|
|
])->toArray()
|
|
),
|
|
'permissions' => $this->when(
|
|
$this->resource->relationLoaded('permissions'),
|
|
fn () => $this->buildHierarchicalPermissions($this->resource->permissions)
|
|
),
|
|
|
|
...$this->formatTimestamps(),
|
|
...$this->resourceMeta($request),
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 확장(모듈/플러그인)의 로케일별 이름을 반환합니다.
|
|
*
|
|
* @return string|null 확장 이름 또는 null
|
|
*/
|
|
protected function getExtensionName(): ?string
|
|
{
|
|
$extensionType = $this->resource->extension_type ?? null;
|
|
$extensionIdentifier = $this->resource->extension_identifier ?? null;
|
|
|
|
if ($extensionType === null || $extensionIdentifier === null) {
|
|
return null;
|
|
}
|
|
|
|
// Enum 값 비교 (ExtensionOwnerType은 string-backed enum)
|
|
$typeValue = $extensionType instanceof ExtensionOwnerType
|
|
? $extensionType
|
|
: ExtensionOwnerType::tryFrom($extensionType);
|
|
|
|
if ($typeValue === ExtensionOwnerType::Module) {
|
|
$info = app(ModuleManager::class)->getModuleInfo($extensionIdentifier);
|
|
|
|
return $info['name'] ?? null;
|
|
}
|
|
|
|
if ($typeValue === ExtensionOwnerType::Plugin) {
|
|
$info = app(PluginManager::class)->getPluginInfo($extensionIdentifier);
|
|
|
|
return $info['name'] ?? null;
|
|
}
|
|
|
|
return null;
|
|
}
|
|
|
|
/**
|
|
* 리소스별 권한 매핑을 반환합니다.
|
|
*
|
|
* @return array<string, string>
|
|
*/
|
|
protected function abilityMap(): array
|
|
{
|
|
return [
|
|
'can_create' => 'core.permissions.create',
|
|
'can_update' => 'core.permissions.update',
|
|
'can_delete' => 'core.permissions.delete',
|
|
'can_toggle_status' => 'core.permissions.update',
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 권한을 계층형 구조로 변환합니다.
|
|
*
|
|
* @param Collection $permissions 역할에 할당된 권한 컬렉션
|
|
* @return array 계층형 권한 구조
|
|
*/
|
|
protected function buildHierarchicalPermissions(Collection $permissions): array
|
|
{
|
|
if ($permissions->isEmpty()) {
|
|
return [];
|
|
}
|
|
|
|
// 할당된 권한들의 ID 목록
|
|
$assignedPermissionIds = $permissions->pluck('id')->toArray();
|
|
|
|
// 모든 관련 부모 권한 ID 수집 (category level)
|
|
$parentIds = $permissions->pluck('parent_id')->filter()->unique()->toArray();
|
|
|
|
if (empty($parentIds)) {
|
|
// 부모가 없으면 flat 구조 그대로 반환
|
|
return PermissionResource::collection($permissions)->resolve();
|
|
}
|
|
|
|
// 부모 권한들 조회 (category level)
|
|
$categoryPermissions = Permission::whereIn('id', $parentIds)->get();
|
|
|
|
// 그 위의 부모 권한 ID 수집 (module level)
|
|
$moduleParentIds = $categoryPermissions->pluck('parent_id')->filter()->unique()->toArray();
|
|
|
|
// module level 권한들 조회
|
|
$modulePermissions = ! empty($moduleParentIds)
|
|
? Permission::whereIn('id', $moduleParentIds)->get()
|
|
: collect();
|
|
|
|
// 계층형 구조 생성
|
|
$hierarchy = [];
|
|
|
|
foreach ($modulePermissions as $modulePermission) {
|
|
$moduleData = $this->formatPermissionNode($modulePermission, $assignedPermissionIds);
|
|
$moduleData['children'] = [];
|
|
|
|
// 이 모듈에 속한 카테고리들
|
|
$moduleCategories = $categoryPermissions->where('parent_id', $modulePermission->id);
|
|
|
|
foreach ($moduleCategories as $categoryPermission) {
|
|
$categoryData = $this->formatPermissionNode($categoryPermission, $assignedPermissionIds);
|
|
$categoryData['children'] = [];
|
|
|
|
// 이 카테고리에 속한 권한들 (역할에 할당된 것만)
|
|
$categoryChildPermissions = $permissions->where('parent_id', $categoryPermission->id);
|
|
|
|
foreach ($categoryChildPermissions as $childPermission) {
|
|
$categoryData['children'][] = $this->formatPermissionNode($childPermission, $assignedPermissionIds);
|
|
}
|
|
|
|
if (! empty($categoryData['children'])) {
|
|
$moduleData['children'][] = $categoryData;
|
|
}
|
|
}
|
|
|
|
if (! empty($moduleData['children'])) {
|
|
$hierarchy[] = $moduleData;
|
|
}
|
|
}
|
|
|
|
// module level 부모가 없는 category들 처리 (2단계 구조인 경우)
|
|
$orphanCategories = $categoryPermissions->whereNull('parent_id');
|
|
foreach ($orphanCategories as $categoryPermission) {
|
|
$categoryData = $this->formatPermissionNode($categoryPermission, $assignedPermissionIds);
|
|
$categoryData['children'] = [];
|
|
|
|
$categoryChildPermissions = $permissions->where('parent_id', $categoryPermission->id);
|
|
foreach ($categoryChildPermissions as $childPermission) {
|
|
$categoryData['children'][] = $this->formatPermissionNode($childPermission, $assignedPermissionIds);
|
|
}
|
|
|
|
if (! empty($categoryData['children'])) {
|
|
$hierarchy[] = $categoryData;
|
|
}
|
|
}
|
|
|
|
return $hierarchy;
|
|
}
|
|
|
|
/**
|
|
* 권한 노드를 포맷합니다.
|
|
*
|
|
* @param Permission $permission 권한 모델
|
|
* @param array $assignedPermissionIds 할당된 권한 ID 목록
|
|
* @return array 포맷된 권한 데이터
|
|
*/
|
|
protected function formatPermissionNode(Permission $permission, array $assignedPermissionIds): array
|
|
{
|
|
$node = [
|
|
'id' => $permission->id,
|
|
'parent_id' => $permission->parent_id,
|
|
'identifier' => $permission->identifier,
|
|
'name' => $permission->getLocalizedName(),
|
|
'name_raw' => $permission->name,
|
|
'description' => $permission->getLocalizedDescription(),
|
|
'description_raw' => $permission->description,
|
|
'extension_type' => $permission->extension_type?->value,
|
|
'extension_identifier' => $permission->extension_identifier,
|
|
'resource_route_key' => $permission->resource_route_key,
|
|
'owner_key' => $permission->owner_key,
|
|
'order' => $permission->order,
|
|
'is_assigned' => in_array($permission->id, $assignedPermissionIds),
|
|
'is_assignable' => $permission->isAssignable(),
|
|
];
|
|
|
|
// 피벗 scope_type 포함 (할당된 권한만)
|
|
if ($node['is_assigned'] && $permission->pivot) {
|
|
$node['scope_type'] = $permission->pivot->scope_type?->value ?? $permission->pivot->scope_type;
|
|
}
|
|
|
|
return $node;
|
|
}
|
|
}
|