v7.0.0-beta.1 release

This commit is contained in:
HeuJung committed 2026-04-01 10:30:52 +09:00
commit 6595fd0eb5
3967 files changed
+1875383

No files matched your search

@@ -0,0 +1,93 @@
<?php
namespace App\Http\Requests\Menu;
use App\Extension\HookManager;
use App\Models\Menu;
use App\Models\Module;
use App\Models\Role;
use App\Rules\LocaleRequiredTranslatable;
use Illuminate\Foundation\Http\FormRequest;
use Illuminate\Validation\Rule;
class CreateMenuRequest extends FormRequest
{
/**
* 사용자가 이 요청을 수행할 권한이 있는지 확인
*
* 권한 체크는 라우트의 permission 미들웨어에서 수행됩니다.
*/
public function authorize(): bool
{
return true;
}
/**
* 요청에 적용할 검증 규칙
*
* @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
*/
public function rules(): array
{
$rules = [
'name' => ['required', new LocaleRequiredTranslatable(maxLength: 255)],
'slug' => ['required', 'string', 'max:255', Rule::unique(Menu::class, 'slug')],
'url' => 'nullable|string|max:500',
'icon' => 'nullable|string|max:100',
'parent_id' => ['nullable', 'integer', Rule::exists(Menu::class, 'id')],
'order' => 'nullable|integer|min:0',
'is_active' => 'nullable|boolean',
'extension_type' => 'nullable|string|in:core,module,plugin',
'extension_identifier' => 'nullable|string|max:255',
'roles' => 'nullable|array',
'roles.*' => ['integer', Rule::exists(Role::class, 'id')],
];
// 모듈/플러그인이 validation rules를 동적으로 추가할 수 있도록 훅 제공
return HookManager::applyFilters('core.menu.create_validation_rules', $rules, $this);
}
/**
* 검증 오류 메시지 커스터마이징
*
* @return array<string, string>
*/
public function messages(): array
{
return [
'name.required' => __('validation.menu.name.required'),
'slug.required' => __('validation.menu.slug.required'),
'slug.unique' => __('validation.menu.slug.unique'),
'slug.max' => __('validation.menu.slug.max'),
'url.max' => __('validation.menu.url.max'),
'icon.max' => __('validation.menu.icon.max'),
'order.integer' => __('validation.menu.order.integer'),
'order.min' => __('validation.menu.order.min'),
'parent_id.exists' => __('validation.menu.parent_id.exists'),
'is_active.boolean' => __('validation.menu.is_active.boolean'),
'extension_type.in' => __('validation.menu.extension_type.in'),
'extension_identifier.max' => __('validation.menu.extension_identifier.max'),
'roles.array' => __('validation.menu.roles.array'),
'roles.*.integer' => __('validation.menu.roles.integer'),
'roles.*.exists' => __('validation.menu.roles.exists'),
];
}
/**
* 검증 전 데이터 전처리
*
* 역호환성을 위해 문자열로 입력된 name을 다국어 배열로 자동 변환합니다.
*/
protected function prepareForValidation(): void
{
$locales = config('app.translatable_locales', ['ko', 'en']);
if ($this->has('name') && is_string($this->name)) {
$nameArray = [];
foreach ($locales as $locale) {
$nameArray[$locale] = $this->name;
}
$this->merge(['name' => $nameArray]);
}
}
}
+114
View File
@@ -0,0 +1,114 @@
<?php
namespace App\Http\Requests\Menu;
use App\Extension\HookManager;
use Illuminate\Foundation\Http\FormRequest;
/**
* 메뉴 목록 조회 요청 검증
*
* 메뉴 목록 조회 시 사용되는 필터링, 정렬 조건을 검증합니다.
*/
class MenuListRequest extends FormRequest
{
/**
* 검색 가능한 필드 목록
*/
public const SEARCHABLE_FIELDS = ['name', 'slug', 'url'];
/**
* Determine if the user is authorized to make this request.
*
* @return bool 인증 여부
*/
public function authorize(): bool
{
return true;
}
/**
* Get the validation rules that apply to the request.
*
* @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
*/
public function rules(): array
{
// 'all'은 전체 필드 검색을 의미하는 특수 값
$searchableFields = implode(',', array_merge(['all'], self::SEARCHABLE_FIELDS));
$rules = [
// 활성화 상태 필터
'is_active' => 'nullable|boolean',
// 다중 검색 조건
'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',
// 정렬
'sort_by' => 'nullable|string|in:created_at,name,slug,order',
'sort_order' => 'nullable|string|in:asc,desc',
];
// 모듈/플러그인이 validation rules를 동적으로 추가할 수 있도록 훅 제공
return HookManager::applyFilters('core.menu.list_validation_rules', $rules, $this);
}
/**
* Get custom messages for validator errors.
*
* @return array<string, string>
*/
public function messages(): array
{
return [
'is_active.boolean' => __('menu.validation.is_active_boolean'),
'sort_by.in' => __('menu.validation.sort_by_invalid'),
'sort_order.in' => __('menu.validation.sort_order_invalid'),
// 다중 검색 조건 관련 메시지
'filters.array' => __('menu.validation.filters_array'),
'filters.max' => __('menu.validation.filters_max'),
'filters.*.field.required_with' => __('menu.validation.filter_field_required'),
'filters.*.field.in' => __('menu.validation.filter_field_invalid'),
'filters.*.value.required_with' => __('menu.validation.filter_value_required'),
'filters.*.value.max' => __('menu.validation.filter_value_max'),
'filters.*.operator.in' => __('menu.validation.filter_operator_invalid'),
];
}
/**
* Prepare the data for validation.
*
* @return void
*/
protected function prepareForValidation(): void
{
// value가 비어있는 filters 제거
$filters = $this->filters;
if (is_array($filters)) {
$filters = array_filter($filters, function ($filter) {
return ! empty($filter['value']);
});
// 인덱스 재정렬
$filters = array_values($filters);
$this->merge(['filters' => $filters ?: null]);
}
// 기본값 설정
$this->merge([
'sort_by' => $this->sort_by ?? 'order',
'sort_order' => $this->sort_order ?? 'asc',
]);
// is_active 파라미터 처리 (문자열 'true'/'false'를 boolean으로 변환)
if ($this->has('is_active') && $this->is_active !== null) {
$isActive = $this->is_active;
if (is_string($isActive)) {
$isActive = filter_var($isActive, FILTER_VALIDATE_BOOLEAN, FILTER_NULL_ON_FAILURE);
}
$this->merge(['is_active' => $isActive]);
}
}
}
@@ -0,0 +1,86 @@
<?php
namespace App\Http\Requests\Menu;
use App\Extension\HookManager;
use App\Models\Menu;
use App\Rules\NotCircularParent;
use Illuminate\Foundation\Http\FormRequest;
use Illuminate\Validation\Rule;
class UpdateMenuOrderRequest extends FormRequest
{
/**
* 사용자가 이 요청을 수행할 권한이 있는지 확인
*
* 권한 체크는 라우트의 permission 미들웨어에서 수행됩니다.
*/
public function authorize(): bool
{
return true;
}
/**
* 요청에 적용할 검증 규칙
*
* @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
*/
public function rules(): array
{
$rules = [
'parent_menus' => 'required|array|min:1',
'parent_menus.*.id' => ['required', 'integer', Rule::exists(Menu::class, 'id')],
'parent_menus.*.order' => 'required|integer|min:1',
'child_menus' => 'sometimes|array',
'child_menus.*.*.id' => ['required', 'integer', Rule::exists(Menu::class, 'id')],
'child_menus.*.*.order' => 'required|integer|min:1',
'moved_items' => 'sometimes|array',
'moved_items.*.id' => ['required', 'integer', Rule::exists(Menu::class, 'id')],
'moved_items.*.new_parent_id' => ['nullable', 'integer', Rule::exists(Menu::class, 'id')],
];
// moved_items 각 항목에 순환 참조 검증 추가
$movedItems = $this->input('moved_items', []);
foreach ($movedItems as $index => $movedItem) {
if (isset($movedItem['id'])) {
$rules["moved_items.{$index}.new_parent_id"][] = new NotCircularParent((int) $movedItem['id']);
}
}
// 모듈/플러그인이 validation rules를 동적으로 추가할 수 있도록 훅 제공
return HookManager::applyFilters('core.menu.update_order_validation_rules', $rules, $this);
}
/**
* 검증 오류 메시지 커스터마이징
*
* @return array<string, string>
*/
public function messages(): array
{
return [
'parent_menus.required' => __('validation.menu.parent_menus.required'),
'parent_menus.array' => __('validation.menu.parent_menus.array'),
'parent_menus.min' => __('validation.menu.parent_menus.min'),
'parent_menus.*.id.required' => __('validation.menu.parent_menus.id.required'),
'parent_menus.*.id.integer' => __('validation.menu.parent_menus.id.integer'),
'parent_menus.*.id.exists' => __('validation.menu.parent_menus.id.exists'),
'parent_menus.*.order.required' => __('validation.menu.parent_menus.order.required'),
'parent_menus.*.order.integer' => __('validation.menu.parent_menus.order.integer'),
'parent_menus.*.order.min' => __('validation.menu.parent_menus.order.min'),
'child_menus.array' => __('validation.menu.child_menus.array'),
'child_menus.*.*.id.required' => __('validation.menu.child_menus.id.required'),
'child_menus.*.*.id.integer' => __('validation.menu.child_menus.id.integer'),
'child_menus.*.*.id.exists' => __('validation.menu.child_menus.id.exists'),
'child_menus.*.*.order.required' => __('validation.menu.child_menus.order.required'),
'child_menus.*.*.order.integer' => __('validation.menu.child_menus.order.integer'),
'child_menus.*.*.order.min' => __('validation.menu.child_menus.order.min'),
'moved_items.array' => __('validation.menu.moved_items.array'),
'moved_items.*.id.required' => __('validation.menu.moved_items.id.required'),
'moved_items.*.id.integer' => __('validation.menu.moved_items.id.integer'),
'moved_items.*.id.exists' => __('validation.menu.moved_items.id.exists'),
'moved_items.*.new_parent_id.integer' => __('validation.menu.moved_items.new_parent_id.integer'),
'moved_items.*.new_parent_id.exists' => __('validation.menu.moved_items.new_parent_id.exists'),
];
}
}
@@ -0,0 +1,97 @@
<?php
namespace App\Http\Requests\Menu;
use App\Extension\HookManager;
use App\Models\Menu;
use App\Models\Module;
use App\Models\Role;
use App\Rules\LocaleRequiredTranslatable;
use App\Rules\NotSelfParent;
use Illuminate\Foundation\Http\FormRequest;
use Illuminate\Validation\Rule;
class UpdateMenuRequest extends FormRequest
{
/**
* 사용자가 이 요청을 수행할 권한이 있는지 확인
*
* 권한 체크는 라우트의 permission 미들웨어에서 수행됩니다.
*/
public function authorize(): bool
{
return true;
}
/**
* 요청에 적용할 검증 규칙
*
* @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
*/
public function rules(): array
{
// Route Model Binding으로 Menu 모델을 받으므로 menu->id 사용
$menuId = $this->route('menu')?->id;
$rules = [
'name' => ['nullable', new LocaleRequiredTranslatable(maxLength: 255)],
'slug' => ['required', 'string', 'max:255', Rule::unique(Menu::class, 'slug')->ignore($menuId)],
'url' => 'nullable|string|max:500',
'icon' => 'nullable|string|max:100',
'parent_id' => ['nullable', 'integer', Rule::exists(Menu::class, 'id'), new NotSelfParent($menuId)],
'order' => 'nullable|integer|min:0',
'is_active' => 'nullable|boolean',
'extension_type' => 'nullable|string|in:core,module,plugin',
'extension_identifier' => 'nullable|string|max:255',
'roles' => 'nullable|array',
'roles.*' => ['integer', Rule::exists(Role::class, 'id')],
];
// 모듈/플러그인이 validation rules를 동적으로 추가할 수 있도록 훅 제공
return HookManager::applyFilters('core.menu.update_validation_rules', $rules, $this);
}
/**
* 검증 오류 메시지 커스터마이징
*
* @return array<string, string>
*/
public function messages(): array
{
return [
'name.required' => __('validation.menu.name.required'),
'slug.required' => __('validation.menu.slug.required'),
'slug.unique' => __('validation.menu.slug.unique'),
'slug.max' => __('validation.menu.slug.max'),
'url.max' => __('validation.menu.url.max'),
'icon.max' => __('validation.menu.icon.max'),
'order.integer' => __('validation.menu.order.integer'),
'order.min' => __('validation.menu.order.min'),
'parent_id.exists' => __('validation.menu.parent_id.exists'),
'is_active.boolean' => __('validation.menu.is_active.boolean'),
'extension_type.in' => __('validation.menu.extension_type.in'),
'extension_identifier.max' => __('validation.menu.extension_identifier.max'),
'roles.array' => __('validation.menu.roles.array'),
'roles.*.integer' => __('validation.menu.roles.integer'),
'roles.*.exists' => __('validation.menu.roles.exists'),
];
}
/**
* 검증 전 데이터 전처리
*
* 역호환성을 위해 문자열로 입력된 name을 다국어 배열로 자동 변환합니다.
*/
protected function prepareForValidation(): void
{
$locales = config('app.translatable_locales', ['ko', 'en']);
if ($this->has('name') && is_string($this->name)) {
$nameArray = [];
foreach ($locales as $locale) {
$nameArray[$locale] = $this->name;
}
$this->merge(['name' => $nameArray]);
}
}
}