feat: registration form fields, section preferences, tag sync & schema updates

Implement EAV system for dynamic event-specific registration fields
with organisation-level templates, person section preferences with
priority ranking, and TagSyncService for deferred tag_picker sync.

New tables: registration_field_templates, registration_form_fields,
person_field_values, person_section_preferences.
New columns: persons.remarks, events.registration_show_section_preferences,
events.registration_show_availability.

58 tests, 126 assertions — all 432 tests pass (zero regressions).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-04-12 22:10:16 +02:00
parent fcff3b0344
commit f6e3568011
51 changed files with 3774 additions and 1 deletions

View File

@@ -0,0 +1,41 @@
<?php
declare(strict_types=1);
namespace App\Http\Requests\Api\V1;
use App\Models\Event;
use Illuminate\Foundation\Http\FormRequest;
final class ImportFromEventRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
/** @return array<string, mixed> */
public function rules(): array
{
return [
'source_event_id' => ['required', 'ulid', 'exists:events,id'],
];
}
public function withValidator($validator): void
{
$validator->after(function ($validator) {
$sourceEventId = $this->input('source_event_id');
if (!$sourceEventId) {
return;
}
$sourceEvent = Event::find($sourceEventId);
$targetEvent = $this->route('event');
if ($sourceEvent && $targetEvent && $sourceEvent->organisation_id !== $targetEvent->organisation_id) {
$validator->errors()->add('source_event_id', 'Source event must belong to the same organisation.');
}
});
}
}

View File

@@ -0,0 +1,24 @@
<?php
declare(strict_types=1);
namespace App\Http\Requests\Api\V1;
use Illuminate\Foundation\Http\FormRequest;
final class ReorderRegistrationFormFieldsRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
/** @return array<string, mixed> */
public function rules(): array
{
return [
'ids' => ['required', 'array', 'min:1'],
'ids.*' => ['required', 'ulid', 'exists:registration_form_fields,id'],
];
}
}

View File

@@ -0,0 +1,72 @@
<?php
declare(strict_types=1);
namespace App\Http\Requests\Api\V1;
use App\Models\FestivalSection;
use Illuminate\Foundation\Http\FormRequest;
final class ReplacePersonSectionPreferencesRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
/** @return array<string, mixed> */
public function rules(): array
{
return [
'preferences' => ['required', 'array', 'min:1', 'max:5'],
'preferences.*.festival_section_id' => ['required', 'ulid'],
'preferences.*.priority' => ['required', 'integer', 'min:1', 'max:5'],
];
}
public function withValidator($validator): void
{
$validator->after(function ($validator) {
$preferences = $this->input('preferences', []);
if (!is_array($preferences)) {
return;
}
// Priorities must be unique
$priorities = array_column($preferences, 'priority');
if (count($priorities) !== count(array_unique($priorities))) {
$validator->errors()->add('preferences', 'Priorities must be unique within the request.');
}
// Validate section IDs belong to the event
$event = $this->route('event');
$person = $this->route('person');
if (!$event || !$person) {
return;
}
// Valid sections: own event's sections + parent festival's cross_event sections
$validSectionIds = FestivalSection::where('event_id', $event->id)
->pluck('id');
if ($event->parent_event_id) {
$parentCrossEventSections = FestivalSection::where('event_id', $event->parent_event_id)
->where('type', 'cross_event')
->pluck('id');
$validSectionIds = $validSectionIds->merge($parentCrossEventSections);
}
foreach ($preferences as $index => $pref) {
$sectionId = $pref['festival_section_id'] ?? null;
if ($sectionId && !$validSectionIds->contains($sectionId)) {
$validator->errors()->add(
"preferences.{$index}.festival_section_id",
'Section does not belong to this event.'
);
}
}
});
}
}

View File

@@ -27,6 +27,8 @@ final class StoreEventRequest extends FormRequest
'event_type' => ['nullable', 'in:event,festival,series'],
'event_type_label' => ['nullable', 'string', 'max:50'],
'sub_event_label' => ['nullable', 'string', 'max:50'],
'registration_show_section_preferences' => ['nullable', 'boolean'],
'registration_show_availability' => ['nullable', 'boolean'],
];
}
}

View File

@@ -25,6 +25,7 @@ final class StorePersonRequest extends FormRequest
'phone' => ['nullable', 'string', 'max:30'],
'company_id' => ['nullable', 'ulid', 'exists:companies,id'],
'status' => ['nullable', 'in:invited,applied,pending,approved,rejected,no_show'],
'remarks' => ['nullable', 'string', 'max:5000'],
'custom_fields' => ['nullable', 'array'],
];
}

View File

@@ -0,0 +1,47 @@
<?php
declare(strict_types=1);
namespace App\Http\Requests\Api\V1;
use App\Enums\RegistrationFieldType;
use Illuminate\Foundation\Http\FormRequest;
use Illuminate\Validation\Rule;
final class StoreRegistrationFieldTemplateRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
/** @return array<string, mixed> */
public function rules(): array
{
$fieldType = $this->input('field_type');
$type = RegistrationFieldType::tryFrom($fieldType);
return [
'label' => ['required', 'string', 'max:255'],
'field_type' => ['required', Rule::in(array_column(RegistrationFieldType::cases(), 'value'))],
'options' => [
$type?->requiresOptions() ? 'required' : 'nullable',
$type?->prohibitsOptions() ? 'prohibited' : 'nullable',
'array',
],
'options.*' => ['string', 'max:255'],
'tag_category' => [
$type === RegistrationFieldType::TAG_PICKER ? 'nullable' : 'prohibited',
'string',
'max:50',
],
'is_required' => ['nullable', 'boolean'],
'is_filterable' => ['nullable', 'boolean'],
'is_portal_visible' => ['nullable', 'boolean'],
'is_admin_only' => ['nullable', 'boolean'],
'section' => ['nullable', 'string', 'max:100'],
'help_text' => ['nullable', 'string', 'max:5000'],
'sort_order' => ['nullable', 'integer', 'min:0'],
];
}
}

View File

@@ -0,0 +1,47 @@
<?php
declare(strict_types=1);
namespace App\Http\Requests\Api\V1;
use App\Enums\RegistrationFieldType;
use Illuminate\Foundation\Http\FormRequest;
use Illuminate\Validation\Rule;
final class StoreRegistrationFormFieldRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
/** @return array<string, mixed> */
public function rules(): array
{
$fieldType = $this->input('field_type');
$type = RegistrationFieldType::tryFrom($fieldType);
return [
'label' => ['required', 'string', 'max:255'],
'field_type' => ['required', Rule::in(array_column(RegistrationFieldType::cases(), 'value'))],
'options' => [
$type?->requiresOptions() ? 'required' : 'nullable',
$type?->prohibitsOptions() ? 'prohibited' : 'nullable',
'array',
],
'options.*' => ['string', 'max:255'],
'tag_category' => [
$type === RegistrationFieldType::TAG_PICKER ? 'nullable' : 'prohibited',
'string',
'max:50',
],
'is_required' => ['nullable', 'boolean'],
'is_portal_visible' => ['nullable', 'boolean'],
'is_admin_only' => ['nullable', 'boolean'],
'is_filterable' => ['nullable', 'boolean'],
'section' => ['nullable', 'string', 'max:100'],
'help_text' => ['nullable', 'string', 'max:5000'],
'sort_order' => ['nullable', 'integer', 'min:0'],
];
}
}

View File

@@ -28,6 +28,8 @@ final class UpdateEventRequest extends FormRequest
'event_type_label' => ['nullable', 'string', 'max:50'],
'sub_event_label' => ['nullable', 'string', 'max:50'],
'registration_welcome_text' => ['nullable', 'string', 'max:1000'],
'registration_show_section_preferences' => ['nullable', 'boolean'],
'registration_show_availability' => ['nullable', 'boolean'],
];
}
}

View File

@@ -27,6 +27,7 @@ final class UpdatePersonRequest extends FormRequest
'status' => ['sometimes', 'in:invited,applied,pending,approved,rejected,no_show'],
'is_blacklisted' => ['sometimes', 'boolean'],
'admin_notes' => ['nullable', 'string'],
'remarks' => ['nullable', 'string', 'max:5000'],
'custom_fields' => ['nullable', 'array'],
];
}

View File

@@ -0,0 +1,34 @@
<?php
declare(strict_types=1);
namespace App\Http\Requests\Api\V1;
use App\Enums\RegistrationFieldType;
use Illuminate\Foundation\Http\FormRequest;
final class UpdateRegistrationFieldTemplateRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
/** @return array<string, mixed> */
public function rules(): array
{
return [
'label' => ['sometimes', 'string', 'max:255'],
'options' => ['nullable', 'array'],
'options.*' => ['string', 'max:255'],
'tag_category' => ['nullable', 'string', 'max:50'],
'is_required' => ['nullable', 'boolean'],
'is_filterable' => ['nullable', 'boolean'],
'is_portal_visible' => ['nullable', 'boolean'],
'is_admin_only' => ['nullable', 'boolean'],
'section' => ['nullable', 'string', 'max:100'],
'help_text' => ['nullable', 'string', 'max:5000'],
'sort_order' => ['nullable', 'integer', 'min:0'],
];
}
}

View File

@@ -0,0 +1,33 @@
<?php
declare(strict_types=1);
namespace App\Http\Requests\Api\V1;
use Illuminate\Foundation\Http\FormRequest;
final class UpdateRegistrationFormFieldRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
/** @return array<string, mixed> */
public function rules(): array
{
return [
'label' => ['sometimes', 'string', 'max:255'],
'options' => ['nullable', 'array'],
'options.*' => ['string', 'max:255'],
'tag_category' => ['nullable', 'string', 'max:50'],
'is_required' => ['nullable', 'boolean'],
'is_portal_visible' => ['nullable', 'boolean'],
'is_admin_only' => ['nullable', 'boolean'],
'is_filterable' => ['nullable', 'boolean'],
'section' => ['nullable', 'string', 'max:100'],
'help_text' => ['nullable', 'string', 'max:5000'],
'sort_order' => ['nullable', 'integer', 'min:0'],
];
}
}

View File

@@ -0,0 +1,133 @@
<?php
declare(strict_types=1);
namespace App\Http\Requests\Api\V1;
use App\Enums\RegistrationFieldType;
use App\Models\PersonTag;
use App\Models\RegistrationFormField;
use Illuminate\Foundation\Http\FormRequest;
final class UpsertPersonFieldValuesRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
/** @return array<string, mixed> */
public function rules(): array
{
return [
'values' => ['required', 'array'],
];
}
public function withValidator($validator): void
{
$validator->after(function ($validator) {
$values = $this->input('values', []);
$event = $this->route('event');
if (!$event || !is_array($values)) {
return;
}
$fields = RegistrationFormField::where('event_id', $event->id)
->get()
->keyBy('slug');
$orgId = $event->organisation_id;
foreach ($values as $slug => $value) {
$field = $fields->get($slug);
if ($field === null) {
$validator->errors()->add("values.{$slug}", "Unknown field: {$slug}");
continue;
}
if ($field->is_required && ($value === null || $value === '' || $value === [])) {
$validator->errors()->add("values.{$slug}", "The {$slug} field is required.");
continue;
}
if ($value === null || $value === '') {
continue;
}
match ($field->field_type) {
RegistrationFieldType::TEXT, RegistrationFieldType::TEXTAREA => $this->validateString($validator, $slug, $value),
RegistrationFieldType::NUMBER => $this->validateNumber($validator, $slug, $value),
RegistrationFieldType::BOOLEAN => $this->validateBoolean($validator, $slug, $value),
RegistrationFieldType::SELECT, RegistrationFieldType::RADIO => $this->validateSingleOption($validator, $slug, $value, $field),
RegistrationFieldType::MULTISELECT, RegistrationFieldType::CHECKBOX => $this->validateMultiOption($validator, $slug, $value, $field),
RegistrationFieldType::TAG_PICKER => $this->validateTagPicker($validator, $slug, $value, $orgId),
};
}
});
}
private function validateString($validator, string $slug, mixed $value): void
{
if (!is_string($value) || mb_strlen($value) > 5000) {
$validator->errors()->add("values.{$slug}", "Must be a string (max 5000 characters).");
}
}
private function validateNumber($validator, string $slug, mixed $value): void
{
if (!is_numeric($value)) {
$validator->errors()->add("values.{$slug}", "Must be a number.");
}
}
private function validateBoolean($validator, string $slug, mixed $value): void
{
if (!in_array($value, [true, false, 0, 1, '0', '1'], true)) {
$validator->errors()->add("values.{$slug}", "Must be a boolean.");
}
}
private function validateSingleOption($validator, string $slug, mixed $value, RegistrationFormField $field): void
{
if (!is_string($value) || !in_array($value, $field->options ?? [], true)) {
$validator->errors()->add("values.{$slug}", "Must be one of the defined options.");
}
}
private function validateMultiOption($validator, string $slug, mixed $value, RegistrationFormField $field): void
{
if (!is_array($value)) {
$validator->errors()->add("values.{$slug}", "Must be an array.");
return;
}
$options = $field->options ?? [];
foreach ($value as $item) {
if (!in_array($item, $options, true)) {
$validator->errors()->add("values.{$slug}", "Invalid option: {$item}");
}
}
}
private function validateTagPicker($validator, string $slug, mixed $value, string $orgId): void
{
if (!is_array($value)) {
$validator->errors()->add("values.{$slug}", "Must be an array of tag IDs.");
return;
}
$validTagIds = PersonTag::where('organisation_id', $orgId)
->where('is_active', true)
->pluck('id')
->all();
foreach ($value as $tagId) {
if (!in_array($tagId, $validTagIds, true)) {
$validator->errors()->add("values.{$slug}", "Invalid tag ID: {$tagId}");
}
}
}
}