<?php

namespace Shm\ShmPayment\TBankPayment\TBankCollections;

use Shm\ShmUtils\DeepAccess;

/*
Полная структура
[
    TCustomersField::OWNER => null,
    TCustomersField::OWNER_COLLECTION => null,
    TCustomersField::PHONE => null,
    TCustomersField::CUSTOMER_KEY => null,
    TCustomersField::_ID => null,
    TCustomersField::CREATED_AT => null,
    TCustomersField::UPDATED_AT => null,
]
*/

/**
 * Контракт строковых ключей полей. Не DTO, не коллекция, не значения полей.
 *
 * Как выбирать константу:
 * 1) Документ: filter, $set, $unset, sort, projection → константа без суффикса (полный путь с точками).
 *    updateOne([_ID => $id], ['$set' => [STATUS => $v, INIT_RESULT__PAYMENT_ID => $pid]])
 * 2) Собрать вложенный Structure как PHP-массив → внутри родителя ключи `_KEY` (локальное имя).
 *    SEAT => [SEAT__NUMBER_KEY => 1, SEAT__ROW_KEY => 'A']
 * 3) Собрать / прочитать элемент массива → `EL_{ARRAY}__{FIELD}` (путь от элемента, не от документа).
 *    '$push' => [CANCEL_RESULT => [EL_CANCEL_RESULT__REQUEST => $req]]
 *    foreach (NOTIFICATIONS_GET($doc) as $item) { EL_NOTIFICATIONS__UUID_GET($item); }
 * 4) Mongo: «поле в любом элементе массива» → `{ARRAY}__IDX__{FIELD}` = 'array.field'.
 *    Только filter/aggregate. Запрещено с *_GET, DeepAccess и как ключ PHP-массива документа.
 *
 * Чтение:
 * - `{CONST}_GET($data, $default)` — значение по пути. $default только если пути нет, а не когда в данных null.
 * - Вложенное поле нельзя читать как $data[INIT_RESULT__PAYMENT_ID]: в PHP нет ключа с точкой.
 * - EL_*_GET только от элемента массива. У IDX нет GET.
 * - ID-поле: GET возвращает ObjectId/скаляр, не подгруженный документ.
 *
 * Запись:
 * - Ключи документа = полные пути (п.1). Ключи элемента / $push = EL_ (п.3).
 * - Не используйте *_GET для записи.
 *
 * Не путать:
 * - COLLECTION_CLASS — PHP-класс коллекции (findOne, updateOne, insertOne).
 * - COLLECTION_NAME — строка-имя в MongoDB. Класс туда не подставлять.
 * - Константа поля — ключ. `{FIELD}_ENUM_{VALUE}` — значение. Пишите STATUS => STATUS_ENUM_ACTIVE, не STATUS => STATUS.
 * - Карта «Полная структура» над классом — справочник формы, не шаблон insert со всеми null.
 *
 * Жёстко:
 * - Имена полей только константами этого класса, никогда строками ('status', 'members.owner').
 * - Нет константы → нет поля в схеме. Не выдумывайте имена и не склеивайте пути ('a.'.$x).
 * - Не берите константы из чужого *Field для документа этой коллекции.
 * - `__` в имени константы = точка в пути. `_KEY` / `EL_` / `IDX` / `_ENUM_` — разные роли, не взаимозаменяемы.
 *
 * Файл генерируется автоматически. Не редактируйте вручную.
 */
class TCustomersField
{
	/** Класс коллекции */
	public const COLLECTION_CLASS = TCustomers::class;

	/** Имя коллекции */
	public const COLLECTION_NAME = 'tCustomers';

	/** owner (ObjectId) полный пусть ключа */
	public const OWNER = 'owner';

	/** ownerCollection полный пусть ключа */
	public const OWNER_COLLECTION = 'ownerCollection';

	/** Phone полный пусть ключа */
	public const PHONE = 'Phone';

	/** Идентификатор покупателя в системе мерчанта полный пусть ключа */
	public const CUSTOMER_KEY = 'CustomerKey';

	/** _id (ObjectId) полный пусть ключа */
	public const _ID = '_id';

	/** created_at полный пусть ключа */
	public const CREATED_AT = 'created_at';

	/** updated_at полный пусть ключа */
	public const UPDATED_AT = 'updated_at';

	public static function OWNER_GET($data, $defaultValue = null)
	{
		return DeepAccess::get($data, self::OWNER, $defaultValue);
	}


	public static function OWNER_COLLECTION_GET($data, $defaultValue = null)
	{
		return DeepAccess::get($data, self::OWNER_COLLECTION, $defaultValue);
	}


	public static function PHONE_GET($data, $defaultValue = null)
	{
		return DeepAccess::get($data, self::PHONE, $defaultValue);
	}


	public static function CUSTOMER_KEY_GET($data, $defaultValue = null)
	{
		return DeepAccess::get($data, self::CUSTOMER_KEY, $defaultValue);
	}


	public static function _ID_GET($data, $defaultValue = null)
	{
		return DeepAccess::get($data, self::_ID, $defaultValue);
	}


	public static function CREATED_AT_GET($data, $defaultValue = null)
	{
		return DeepAccess::get($data, self::CREATED_AT, $defaultValue);
	}


	public static function UPDATED_AT_GET($data, $defaultValue = null)
	{
		return DeepAccess::get($data, self::UPDATED_AT, $defaultValue);
	}
}


