bert.hausmans
2064b9901e
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>
77 lines
2.2 KiB
PHP
77 lines
2.2 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace App\Models\FormBuilder;
|
|
|
|
use App\Enums\FormBuilder\FormFieldConditionalLogicGroupOperator;
|
|
use App\Models\Scopes\OrganisationScope;
|
|
use Illuminate\Database\Eloquent\Concerns\HasUlids;
|
|
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
|
use Illuminate\Database\Eloquent\Model;
|
|
use Illuminate\Database\Eloquent\Relations\BelongsTo;
|
|
use Illuminate\Database\Eloquent\Relations\HasMany;
|
|
|
|
/**
|
|
* A node in the relational conditional-logic tree for a form field
|
|
* (ARCH-FORM-BUILDER §8). The root group carries the outer boolean
|
|
* operator (`all` / `any`); nested sub-groups link via
|
|
* `parent_group_id`. Leaves live in `FormFieldConditionalLogicCondition`.
|
|
*
|
|
* Multi-tenancy uses the Q2 declarative FK-chain resolver via
|
|
* `tenantScopeStrategy()`. The chain (group → field → schema →
|
|
* organisation_id) is 3 hops — comfortably inside the cap (5 hops as of
|
|
* WS-5c).
|
|
*/
|
|
final class FormFieldConditionalLogicGroup extends Model
|
|
{
|
|
use HasFactory;
|
|
use HasUlids;
|
|
|
|
protected $table = 'form_field_conditional_logic_groups';
|
|
|
|
protected static function booted(): void
|
|
{
|
|
static::addGlobalScope(new OrganisationScope());
|
|
}
|
|
|
|
/** @return array{via: class-string, fk: string} */
|
|
public static function tenantScopeStrategy(): array
|
|
{
|
|
return ['via' => FormField::class, 'fk' => 'form_field_id'];
|
|
}
|
|
|
|
protected $fillable = [
|
|
'form_field_id',
|
|
'parent_group_id',
|
|
'operator',
|
|
'sort_order',
|
|
];
|
|
|
|
/** @var array<string, string> */
|
|
protected $casts = [
|
|
'operator' => FormFieldConditionalLogicGroupOperator::class,
|
|
'sort_order' => 'int',
|
|
];
|
|
|
|
public function formField(): BelongsTo
|
|
{
|
|
return $this->belongsTo(FormField::class, 'form_field_id');
|
|
}
|
|
|
|
public function parentGroup(): BelongsTo
|
|
{
|
|
return $this->belongsTo(self::class, 'parent_group_id');
|
|
}
|
|
|
|
public function childGroups(): HasMany
|
|
{
|
|
return $this->hasMany(self::class, 'parent_group_id');
|
|
}
|
|
|
|
public function conditions(): HasMany
|
|
{
|
|
return $this->hasMany(FormFieldConditionalLogicCondition::class, 'group_id');
|
|
}
|
|
}
|