feat(form-builder): form_field_conditional_logic_{groups,conditions} tables + OrganisationScope cap raise to 5
WS-5c commit 1 of 4 — relational infrastructure for the conditional- logic tree that replaces form_fields.conditional_logic JSON (ARCH- FORM-BUILDER §8; addendum Q3 WS-5c). Tables: groups (nesting via parent_group_id) + conditions (leaves, value JSON nullable for empty/not_empty). Simple FK to form_fields — addendum Q3 explicitly excludes form_field_library from conditional_ logic scope, so no polymorphic morph here. OrganisationScope cap raised 3 → 5 hops. The conditions chain is 4 hops (condition → group → field → schema → organisation_id column) and the new cap gives headroom for future deeper trees without denormalising form_field_id onto conditions. Cascade observer (FormFieldChildTablesCascadeObserver) extended to physically delete the new groups table on FormField delete (hard or soft). Conditions cascade automatically via the group_id FK on the groups table. Factories: FormFieldConditionalLogicGroupFactory, FormFieldConditional LogicConditionFactory, and FormFieldFactory::withConditionalLogic($tree) for concise test fixtures. Tests: 16 new under tests/Feature/FormBuilder/ConditionalLogic/ (relation, scope, cascade, enum catalogue). 3 new scope-cap tests in ScopeLeakageTest verify 4/5-hop chains pass and 6-hop throws. Hardcoded rollback step counts in WS-5a/b migration tests bumped for the 2 new WS-5c migrations. Baseline 1104 → 1122 green (2988 → 3032 assertions). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,53 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
namespace Database\Factories\FormBuilder;
|
||||
|
||||
use App\Enums\FormBuilder\FormFieldConditionalLogicConditionOperator;
|
||||
use App\Models\FormBuilder\FormFieldConditionalLogicCondition;
|
||||
use App\Models\FormBuilder\FormFieldConditionalLogicGroup;
|
||||
use Illuminate\Database\Eloquent\Factories\Factory;
|
||||
|
||||
/** @extends Factory<FormFieldConditionalLogicCondition> */
|
||||
final class FormFieldConditionalLogicConditionFactory extends Factory
|
||||
{
|
||||
protected $model = FormFieldConditionalLogicCondition::class;
|
||||
|
||||
/** @return array<string, mixed> */
|
||||
public function definition(): array
|
||||
{
|
||||
return [
|
||||
'group_id' => FormFieldConditionalLogicGroup::factory(),
|
||||
'field_slug' => 'gate',
|
||||
'comparison_operator' => FormFieldConditionalLogicConditionOperator::Equals->value,
|
||||
'value' => 'yes',
|
||||
'sort_order' => 0,
|
||||
];
|
||||
}
|
||||
|
||||
public function inGroup(FormFieldConditionalLogicGroup $group, int $sortOrder = 0): static
|
||||
{
|
||||
return $this->state(fn () => [
|
||||
'group_id' => $group->id,
|
||||
'sort_order' => $sortOrder,
|
||||
]);
|
||||
}
|
||||
|
||||
public function withOperator(
|
||||
FormFieldConditionalLogicConditionOperator $operator,
|
||||
mixed $value = null,
|
||||
): static {
|
||||
return $this->state(fn () => [
|
||||
'comparison_operator' => $operator->value,
|
||||
'value' => $operator->isValueless() ? null : $value,
|
||||
]);
|
||||
}
|
||||
|
||||
public function forFieldSlug(string $slug): static
|
||||
{
|
||||
return $this->state(fn () => [
|
||||
'field_slug' => $slug,
|
||||
]);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,50 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
namespace Database\Factories\FormBuilder;
|
||||
|
||||
use App\Enums\FormBuilder\FormFieldConditionalLogicGroupOperator;
|
||||
use App\Models\FormBuilder\FormField;
|
||||
use App\Models\FormBuilder\FormFieldConditionalLogicGroup;
|
||||
use Illuminate\Database\Eloquent\Factories\Factory;
|
||||
|
||||
/** @extends Factory<FormFieldConditionalLogicGroup> */
|
||||
final class FormFieldConditionalLogicGroupFactory extends Factory
|
||||
{
|
||||
protected $model = FormFieldConditionalLogicGroup::class;
|
||||
|
||||
/** @return array<string, mixed> */
|
||||
public function definition(): array
|
||||
{
|
||||
return [
|
||||
'form_field_id' => FormField::factory(),
|
||||
'parent_group_id' => null,
|
||||
'operator' => FormFieldConditionalLogicGroupOperator::All->value,
|
||||
'sort_order' => 0,
|
||||
];
|
||||
}
|
||||
|
||||
public function forField(FormField $field): static
|
||||
{
|
||||
return $this->state(fn () => [
|
||||
'form_field_id' => $field->id,
|
||||
]);
|
||||
}
|
||||
|
||||
public function withOperator(FormFieldConditionalLogicGroupOperator $operator): static
|
||||
{
|
||||
return $this->state(fn () => [
|
||||
'operator' => $operator->value,
|
||||
]);
|
||||
}
|
||||
|
||||
public function nestedUnder(FormFieldConditionalLogicGroup $parent, int $sortOrder = 0): static
|
||||
{
|
||||
return $this->state(fn () => [
|
||||
'form_field_id' => $parent->form_field_id,
|
||||
'parent_group_id' => $parent->id,
|
||||
'sort_order' => $sortOrder,
|
||||
]);
|
||||
}
|
||||
}
|
||||
@@ -5,11 +5,15 @@ declare(strict_types=1);
|
||||
namespace Database\Factories\FormBuilder;
|
||||
|
||||
use App\Enums\FormBuilder\FormFieldBindingMode;
|
||||
use App\Enums\FormBuilder\FormFieldConditionalLogicConditionOperator;
|
||||
use App\Enums\FormBuilder\FormFieldConditionalLogicGroupOperator;
|
||||
use App\Enums\FormBuilder\FormFieldDisplayWidth;
|
||||
use App\Enums\FormBuilder\FormFieldType;
|
||||
use App\Enums\FormBuilder\FormFieldValidationRuleType;
|
||||
use App\Models\FormBuilder\FormField;
|
||||
use App\Models\FormBuilder\FormFieldBinding;
|
||||
use App\Models\FormBuilder\FormFieldConditionalLogicCondition;
|
||||
use App\Models\FormBuilder\FormFieldConditionalLogicGroup;
|
||||
use App\Models\FormBuilder\FormFieldValidationRule;
|
||||
use App\Models\FormBuilder\FormSchema;
|
||||
use Illuminate\Database\Eloquent\Factories\Factory;
|
||||
@@ -118,4 +122,81 @@ final class FormFieldFactory extends Factory
|
||||
->create();
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* Build a conditional-logic tree for this field after persistence.
|
||||
* `$tree` mirrors the canonical ARCH §8 JSON shape without the
|
||||
* outer `show_when` wrapper — the root must be a group.
|
||||
*
|
||||
* Example:
|
||||
*
|
||||
* $factory->withConditionalLogic([
|
||||
* 'operator' => 'all',
|
||||
* 'children' => [
|
||||
* ['field_slug' => 'gate', 'operator' => 'equals', 'value' => 'yes'],
|
||||
* [
|
||||
* 'operator' => 'any',
|
||||
* 'children' => [
|
||||
* ['field_slug' => 'region', 'operator' => 'equals', 'value' => 'NL'],
|
||||
* ['field_slug' => 'region', 'operator' => 'equals', 'value' => 'BE'],
|
||||
* ],
|
||||
* ],
|
||||
* ],
|
||||
* ]);
|
||||
*
|
||||
* @param array<string, mixed> $tree
|
||||
*/
|
||||
public function withConditionalLogic(array $tree): static
|
||||
{
|
||||
return $this->afterCreating(function (FormField $field) use ($tree): void {
|
||||
self::buildLogicTree($field->id, null, $tree, 0);
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* Recursive walker used only by `withConditionalLogic`. The service
|
||||
* layer (WS-5c commit 2) owns the canonical write path; this helper
|
||||
* stays minimal and keeps factories self-contained.
|
||||
*
|
||||
* @param array<string, mixed> $node
|
||||
*/
|
||||
private static function buildLogicTree(string $fieldId, ?string $parentId, array $node, int $sortOrder): void
|
||||
{
|
||||
if (isset($node['field_slug'])) {
|
||||
/** @var string $slug */
|
||||
$slug = $node['field_slug'];
|
||||
$rawOperator = isset($node['operator']) && is_string($node['operator'])
|
||||
? $node['operator']
|
||||
: FormFieldConditionalLogicConditionOperator::Equals->value;
|
||||
$operator = FormFieldConditionalLogicConditionOperator::from($rawOperator);
|
||||
|
||||
FormFieldConditionalLogicCondition::factory()->create([
|
||||
'group_id' => $parentId,
|
||||
'field_slug' => $slug,
|
||||
'comparison_operator' => $operator->value,
|
||||
'value' => $operator->isValueless() ? null : ($node['value'] ?? null),
|
||||
'sort_order' => $sortOrder,
|
||||
]);
|
||||
|
||||
return;
|
||||
}
|
||||
|
||||
$rawOperator = isset($node['operator']) && is_string($node['operator'])
|
||||
? $node['operator']
|
||||
: FormFieldConditionalLogicGroupOperator::All->value;
|
||||
$groupOperator = FormFieldConditionalLogicGroupOperator::from($rawOperator);
|
||||
|
||||
$group = FormFieldConditionalLogicGroup::factory()->create([
|
||||
'form_field_id' => $fieldId,
|
||||
'parent_group_id' => $parentId,
|
||||
'operator' => $groupOperator->value,
|
||||
'sort_order' => $sortOrder,
|
||||
]);
|
||||
|
||||
/** @var array<int, array<string, mixed>> $children */
|
||||
$children = $node['children'] ?? [];
|
||||
foreach ($children as $childSortOrder => $child) {
|
||||
self::buildLogicTree($fieldId, $group->id, $child, $childSortOrder);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user