Files
2026-05-11 11:29:41 +09:00

93 lines
3.3 KiB
PHP

<?php
namespace App\Http\Requests\Template;
use App\Extension\HookManager;
use Illuminate\Foundation\Http\FormRequest;
/**
* 템플릿 목록 조회 요청
*
* 다중 검색 조건을 지원합니다.
* - search: 단일 검색어 (이름, 식별자, 설명, 벤더 OR 검색) - 하위 호환성
* - filters: 다중 검색 조건 (AND 조건)
* - type: 템플릿 타입 (admin, user)
*/
class IndexTemplateRequest extends FormRequest
{
/**
* 검색 가능한 필드 목록
*/
public const SEARCHABLE_FIELDS = ['name', 'identifier', 'description', 'vendor'];
/**
* 사용자가 이 요청을 수행할 권한이 있는지 확인
*
* 권한 체크는 라우트의 permission 미들웨어에서 수행됩니다.
*/
public function authorize(): bool
{
return true;
}
/**
* 요청에 적용할 검증 규칙
*
* @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
*/
public function rules(): array
{
$searchableFields = implode(',', self::SEARCHABLE_FIELDS);
$rules = [
// 템플릿 타입 필터
'type' => 'nullable|string|in:user,admin',
// 단일 검색어 (하위 호환성 - 이름, 식별자, 설명, 벤더 OR 검색)
'search' => 'nullable|string|max:255',
// 다중 검색 조건
'filters' => 'nullable|array|max:10',
'filters.*.field' => "required_with:filters|string|in:{$searchableFields}",
'filters.*.value' => 'required_with:filters|string|max:255',
'filters.*.operator' => 'nullable|string|in:like,eq,starts_with,ends_with',
// 상태 필터
'status' => 'nullable|string|in:installed,not_installed,active,inactive',
// 페이지네이션
'per_page' => 'nullable|integer|min:1|max:100',
'page' => 'nullable|integer|min:1',
// 숨김 항목 포함 여부 (manifest hidden=true 확장)
'include_hidden' => 'nullable|boolean',
];
// 모듈/플러그인이 validation rules를 동적으로 추가할 수 있도록 훅 제공
return HookManager::applyFilters('core.template.index_validation_rules', $rules, $this);
}
/**
* 검증 오류 메시지 커스터마이징
*
* @return array<string, string>
*/
public function messages(): array
{
return [
'type.in' => __('templates.validation.type_in'),
'search.max' => __('templates.validation.search_max'),
'filters.max' => __('templates.validation.filters_max'),
'filters.*.field.required_with' => __('templates.validation.filter_field_required'),
'filters.*.field.in' => __('templates.validation.filter_field_invalid'),
'filters.*.value.required_with' => __('templates.validation.filter_value_required'),
'filters.*.value.max' => __('templates.validation.filter_value_max'),
'filters.*.operator.in' => __('templates.validation.filter_operator_invalid'),
'status.in' => __('templates.validation.status_invalid'),
'per_page.min' => __('templates.validation.per_page_min'),
'per_page.max' => __('templates.validation.per_page_max'),
'page.min' => __('templates.validation.page_min'),
];
}
}