<?php

namespace App\Enums;

/**
 * 钱包交易角色枚举类
 */
enum TransactionRole: int
{
    /**
     * 交易角色：平台
     */
    case PLATFORM = 1;

    /**
     * 交易角色：技师
     */
    case TECHNICIAN = 2;

    /**
     * 交易角色：店铺
     */
    case SHOP = 3;

    /**
     * 交易角色：用户
     */
    case USER = 4;

    /**
     * 交易角色：代理商
     */
    case AGENT = 5;

    /**
     * 交易角色：运营人员
     */
    case OPERATOR = 6;

    /**
     * 交易角色：管理员
     */
    case ADMIN = 7;

    /**
     * 交易角色：其他
     */
    case OTHER = 8;

    /**
     * 获取角色的显示文本
     *
     * @return string 角色的中文描述
     */
    public function label(): string
    {
        return match ($this) {
            self::PLATFORM => '平台',
            self::TECHNICIAN => '技师',
            self::SHOP => '店铺',
            self::USER => '用户',
            self::AGENT => '代理商',
            self::OPERATOR => '运营人员',
            self::ADMIN => '管理员',
            self::OTHER => '其他',
        };
    }

    /**
     * 获取角色的整数值
     *
     * @return int 角色值
     */
    public function value(): int
    {
        return $this->value;
    }

    /**
     * 检查当前角色是否与指定角色相同
     *
     * @param self $role 要比较的角色
     * @return bool 如果角色相同返回 true，否则返回 false
     */
    public function is(self $role): bool
    {
        return $this === $role;
    }

    /**
     * 根据整数值创建对应的角色枚举实例
     *
     * @param int $value 角色值
     * @return self|null 返回对应的角色枚举实例，如果值无效则返回 null
     */
    public static function fromValue(int $value): ?self
    {
        return match ($value) {
            self::PLATFORM->value => self::PLATFORM,
            self::TECHNICIAN->value => self::TECHNICIAN,
            self::SHOP->value => self::SHOP,
            self::USER->value => self::USER,
            self::AGENT->value => self::AGENT,
            self::OPERATOR->value => self::OPERATOR,
            self::ADMIN->value => self::ADMIN,
            self::OTHER->value => self::OTHER,
            default => null
        };
    }

    /**
     * 获取所有角色的值数组
     *
     * @return array 包含所有角色值的数组
     */
    public static function values(): array
    {
        return array_column(self::cases(), 'value');
    }

    /**
     * 获取所有角色的键值对数组
     *
     * @return array 角色值作为键，显示文本作为值的关联数组
     */
    public static function all(): array
    {
        return [
            self::PLATFORM->value => self::PLATFORM->label(),
            self::TECHNICIAN->value => self::TECHNICIAN->label(),
            self::SHOP->value => self::SHOP->label(),
            self::USER->value => self::USER->label(),
            self::AGENT->value => self::AGENT->label(),
            self::OPERATOR->value => self::OPERATOR->label(),
            self::ADMIN->value => self::ADMIN->label(),
            self::OTHER->value => self::OTHER->label(),
        ];
    }
}