Files
crewli/api/config/form_builder/purposes.php
bert.hausmans 16a9265430 feat(form-builder): add PurposeSubjectResolver per purpose (WS-6)
Parallel interface to PurposeGuardProvider for runtime subject
resolution. Seven concrete resolvers, one per v1.0 purpose. Wired
through purposes.php via subject_resolver_class key.

EventRegistration uses PersonProvisioner (may create). Other purposes
resolve from existing context (portal token, production request, auth).
IncidentReport is the only purpose allowed to return null (anonymous-
allowed configurations); the others return concrete model types
(narrowed via PHP covariance) for caller convenience.

Refs: RFC-WS-6.md §3 (Q9)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-26 12:57:21 +02:00

100 lines
4.1 KiB
PHP

<?php
declare(strict_types=1);
use App\Enums\FormBuilder\FormSubmissionMode;
/*
|--------------------------------------------------------------------------
| Form Builder — Purpose registry (v1.0)
|--------------------------------------------------------------------------
|
| Declarative set of purposes served by the universal form builder. v1.0
| ships seven purposes. Adding a new purpose requires a code change (this
| file) plus, typically, a new listener — per ARCH-CONSOLIDATION §3
| besluit 4. Purposes are not user-defined.
|
| Each purpose declares:
| - label (NL): organizer-facing label
| - subject_type: morph alias used for form_submissions.subject_type
| - default_submission_mode: FormSubmissionMode enum case
| - allows_public_access: schema-level public submission without token
| - required_bindings: list of "{entity}.{attribute}" binding paths
| that must be present on a schema before publish
|
*/
return [
'event_registration' => [
'label' => 'Aanmelding vrijwilligers/crew',
'subject_type' => 'person',
'default_submission_mode' => FormSubmissionMode::SINGLE,
'allows_public_access' => true,
'required_bindings' => ['person.email', 'person.first_name', 'person.last_name'],
'guards_class' => \App\FormBuilder\Purposes\Guards\EventRegistrationGuards::class,
'subject_resolver_class' => \App\FormBuilder\Purposes\Resolvers\EventRegistrationSubjectResolver::class,
],
'artist_advance' => [
'label' => 'Artiest advance',
'subject_type' => 'artist',
'default_submission_mode' => FormSubmissionMode::DRAFT_SINGLE,
'allows_public_access' => false,
'required_bindings' => [],
'guards_class' => \App\FormBuilder\Purposes\Guards\ArtistAdvanceGuards::class,
'subject_resolver_class' => \App\FormBuilder\Purposes\Resolvers\ArtistAdvanceSubjectResolver::class,
],
'supplier_intake' => [
'label' => 'Leverancier intake',
'subject_type' => 'company',
'default_submission_mode' => FormSubmissionMode::SINGLE,
'allows_public_access' => false,
'required_bindings' => ['company.name'],
'guards_class' => \App\FormBuilder\Purposes\Guards\SupplierIntakeGuards::class,
'subject_resolver_class' => \App\FormBuilder\Purposes\Resolvers\SupplierIntakeSubjectResolver::class,
],
'post_event_evaluation' => [
'label' => 'Evaluatie na afloop',
'subject_type' => 'person',
'default_submission_mode' => FormSubmissionMode::SINGLE,
'allows_public_access' => false,
'required_bindings' => [],
'guards_class' => \App\FormBuilder\Purposes\Guards\PostEventEvaluationGuards::class,
'subject_resolver_class' => \App\FormBuilder\Purposes\Resolvers\PostEventEvaluationSubjectResolver::class,
],
'incident_report' => [
'label' => 'Incident-melding',
'subject_type' => 'person',
'default_submission_mode' => FormSubmissionMode::MULTIPLE,
'allows_public_access' => false,
'required_bindings' => [],
'guards_class' => \App\FormBuilder\Purposes\Guards\IncidentReportGuards::class,
'subject_resolver_class' => \App\FormBuilder\Purposes\Resolvers\IncidentReportSubjectResolver::class,
],
'signature_contract' => [
'label' => 'Contract-ondertekening',
'subject_type' => 'user',
'default_submission_mode' => FormSubmissionMode::SINGLE,
'allows_public_access' => false,
'required_bindings' => [],
'guards_class' => \App\FormBuilder\Purposes\Guards\SignatureContractGuards::class,
'subject_resolver_class' => \App\FormBuilder\Purposes\Resolvers\SignatureContractSubjectResolver::class,
],
'user_profile' => [
'label' => 'Profiel-update',
'subject_type' => 'user',
'default_submission_mode' => FormSubmissionMode::SINGLE,
'allows_public_access' => false,
'required_bindings' => [],
'guards_class' => \App\FormBuilder\Purposes\Guards\UserProfileGuards::class,
'subject_resolver_class' => \App\FormBuilder\Purposes\Resolvers\UserProfileSubjectResolver::class,
],
];