<?php

declare(strict_types=1);

/**
 * RFC-WS-6 §4 (V1) — single source of truth for binding-target storage
 * shape. Consulted by `BindingTypeRegistry`, `AppendStrategyRequiresCollectionTarget`
 * publish guard, and `FormBindingApplicator`.
 *
 * `type` values:
 *   - 'scalar'     — single column (string/int/datetime/email/...)
 *   - 'collection' — JSON array column or pivot relation with set semantics
 *   - 'relation'   — FK column resolving to another entity
 *
 * `php` values map to native PHP / cast types: 'string', 'int', 'bool',
 * 'date', 'datetime', 'array'. Validated by
 * BindingTypeRegistryConsistencyTest.
 *
 * `identity_key_eligible` permits a binding to set `is_identity_key=true`
 * on this attribute. PurposeGuardProvider's RequiresIdentityKeyBinding
 * may only target attributes that are eligible.
 *
 * Every entry MUST map 1:1 to a real Eloquent model column on the
 * corresponding entity model — enforced by
 * BindingTypeRegistryConsistencyTest's model-existence + column-existence
 * assertions (sessie 3a.5).
 *
 * Intentional gaps (Crewli v1):
 *
 * - 'artist' entity has NO registry entries in v1. The artist_advance
 *   purpose accepts schemas without bindings (subject is resolved via
 *   portal_token, not via field-to-attribute mapping). The Artist
 *   Eloquent model class does not exist; the artists table is reachable
 *   only via the morph map. Tracked: BACKLOG ARTIST-ADV-BINDING-MODEL.
 *
 * - person.dietary_preferences is NOT in the registry. Person-level
 *   dietary preferences live inside the persons.custom_fields JSON
 *   column. JSON-path bindings are out of scope for v1 binding pipeline.
 *   For v1, model dietary_preferences as a TAG_PICKER form_field with
 *   tag_categories config; see ARCH-FORM-BUILDER §31.10 for the
 *   TAG_PICKER → user_organisation_tags sync path.
 *   Tracked: BACKLOG FORM-BINDING-JSON-PATH.
 */
return [
    'person' => [
        'email' => ['type' => 'scalar', 'php' => 'string', 'identity_key_eligible' => true],
        'first_name' => ['type' => 'scalar', 'php' => 'string', 'identity_key_eligible' => false],
        'last_name' => ['type' => 'scalar', 'php' => 'string', 'identity_key_eligible' => false],
        'date_of_birth' => ['type' => 'scalar', 'php' => 'date', 'identity_key_eligible' => false],
        'phone' => ['type' => 'scalar', 'php' => 'string', 'identity_key_eligible' => false],
    ],
    'company' => [
        'name' => ['type' => 'scalar', 'php' => 'string', 'identity_key_eligible' => true],
        'contact_email' => ['type' => 'scalar', 'php' => 'string', 'identity_key_eligible' => true],
        'contact_phone' => ['type' => 'scalar', 'php' => 'string', 'identity_key_eligible' => false],
        'kvk_number' => ['type' => 'scalar', 'php' => 'string', 'identity_key_eligible' => true],
    ],
    'user' => [
        'email' => ['type' => 'scalar', 'php' => 'string', 'identity_key_eligible' => true],
        'first_name' => ['type' => 'scalar', 'php' => 'string', 'identity_key_eligible' => false],
        'last_name' => ['type' => 'scalar', 'php' => 'string', 'identity_key_eligible' => false],
    ],
];