fastadmin_tailored/application/common/Enum/ChannelEnum.php

<?php

namespace app\common\Enum;

/**
 * 渠道枚举类
 */
class ChannelEnum
{
    // ============ 渠道类型 ============
    const CHANNEL_WECHAT_OFFICIAL_ACCOUNT = 'wechat_official_account';  // 微信公众号
    const CHANNEL_WECHAT_MINI_PROGRAM = 'wechat_mini_program';      // 微信小程序
    const CHANNEL_IOS_APP = 'ios_app';                  // iOS APP
    const CHANNEL_ANDROID_APP = 'android_app';              // Android APP
    const CHANNEL_H5 = 'h5';                       // H5
    const CHANNEL_DOUYIN_MINI_PROGRAM = 'douyin_mini_program';      // 抖音小程序
    const CHANNEL_PC = 'pc';                       // PC
    const CHANNEL_QQ_MINI_PROGRAM = 'qq_mini_program';          // QQ小程序
    const CHANNEL_ALIPAY_MINI_PROGRAM = 'alipay_mini_program';      // 支付宝小程序

    // ============ 渠道分组 ============
    const GROUP_WECHAT = 'wechat';              // 微信生态
    const GROUP_MOBILE_APP = 'mobile_app';      // 移动应用
    const GROUP_WEB = 'web';                    // 网页端
    const GROUP_MINI_PROGRAM = 'mini_program';  // 小程序

    /**
     * 获取渠道映射
     */
    public static function getChannelMap()
    {
        return [
            self::CHANNEL_WECHAT_OFFICIAL_ACCOUNT => '微信公众号',
            self::CHANNEL_WECHAT_MINI_PROGRAM => '微信小程序',
            self::CHANNEL_IOS_APP => 'iOS APP',
            self::CHANNEL_ANDROID_APP => 'Android APP',
            self::CHANNEL_H5 => 'H5',
            self::CHANNEL_DOUYIN_MINI_PROGRAM => '抖音小程序',
            self::CHANNEL_PC => 'PC',
            self::CHANNEL_QQ_MINI_PROGRAM => 'QQ小程序',
            self::CHANNEL_ALIPAY_MINI_PROGRAM => '支付宝小程序',
        ];
    }

    /**
     * 获取渠道分组映射
     */
    public static function getChannelGroupMap()
    {
        return [
            self::GROUP_WECHAT => '微信生态',
            self::GROUP_MOBILE_APP => '移动应用',
            self::GROUP_WEB => '网页端',
            self::GROUP_MINI_PROGRAM => '小程序',
        ];
    }

    /**
     * 获取按分组组织的渠道
     */
    public static function getChannelsByGroup()
    {
        return [
            self::GROUP_WECHAT => [
                self::CHANNEL_WECHAT_OFFICIAL_ACCOUNT => '微信公众号',
                self::CHANNEL_WECHAT_MINI_PROGRAM => '微信小程序',
            ],
            self::GROUP_MOBILE_APP => [
                self::CHANNEL_IOS_APP => 'iOS APP',
                self::CHANNEL_ANDROID_APP => 'Android APP',
            ],
            self::GROUP_WEB => [
                self::CHANNEL_H5 => 'H5',
                self::CHANNEL_PC => 'PC',
            ],
            self::GROUP_MINI_PROGRAM => [
                self::CHANNEL_WECHAT_MINI_PROGRAM => '微信小程序',
                self::CHANNEL_DOUYIN_MINI_PROGRAM => '抖音小程序',
                self::CHANNEL_QQ_MINI_PROGRAM => 'QQ小程序',
                self::CHANNEL_ALIPAY_MINI_PROGRAM => '支付宝小程序',
            ],
        ];
    }

    /**
     * 获取渠道标识映射（用于API接口）
     */
    public static function getChannelCodeMap()
    {
        return [
            self::CHANNEL_WECHAT_OFFICIAL_ACCOUNT => 'wechat_official_account',
            self::CHANNEL_WECHAT_MINI_PROGRAM => 'wechat_mini_program',
            self::CHANNEL_IOS_APP => 'ios_app',
            self::CHANNEL_ANDROID_APP => 'android_app',
            self::CHANNEL_H5 => 'h5',
            self::CHANNEL_DOUYIN_MINI_PROGRAM => 'douyin_mini_program',
            self::CHANNEL_PC => 'pc',
            self::CHANNEL_QQ_MINI_PROGRAM => 'qq_mini_program',
            self::CHANNEL_ALIPAY_MINI_PROGRAM => 'alipay_mini_program',
        ];
    }

    /**
     * 获取渠道文本
     */
    public static function getChannelText($channel)
    {
        $map = self::getChannelMap();
        return $map[$channel] ?? '未知渠道';
    }

    /**
     * 获取渠道标识
     */
    public static function getChannelCode($channel)
    {
        $map = self::getChannelCodeMap();
        return $map[$channel] ?? 'unknown';
    }

    /**
     * 根据渠道标识获取渠道ID
     */
    public static function getChannelByCode($code)
    {
        $map = array_flip(self::getChannelCodeMap());
        return $map[$code] ?? null;
    }

    /**
     * 验证渠道是否有效
     */
    public static function isValidChannel($channel)
    {
        return array_key_exists($channel, self::getChannelMap());
    }

    /**
     * 判断是否为微信生态渠道
     */
    public static function isWechatChannel($channel)
    {
        return in_array($channel, [
            self::CHANNEL_WECHAT_OFFICIAL_ACCOUNT,
            self::CHANNEL_WECHAT_MINI_PROGRAM,
        ]);
    }

    /**
     * 判断是否为小程序渠道
     */
    public static function isMiniProgramChannel($channel)
    {
        return in_array($channel, [
            self::CHANNEL_WECHAT_MINI_PROGRAM,
            self::CHANNEL_DOUYIN_MINI_PROGRAM,
            self::CHANNEL_QQ_MINI_PROGRAM,
            self::CHANNEL_ALIPAY_MINI_PROGRAM,
        ]);
    }

    /**
     * 判断是否为移动端渠道
     */
    public static function isMobileChannel($channel)
    {
        return in_array($channel, [
            self::CHANNEL_IOS_APP,  
            self::CHANNEL_ANDROID_APP,
            self::CHANNEL_H5,
            self::CHANNEL_WECHAT_MINI_PROGRAM,
            self::CHANNEL_DOUYIN_MINI_PROGRAM,
            self::CHANNEL_QQ_MINI_PROGRAM,
            self::CHANNEL_ALIPAY_MINI_PROGRAM,
        ]);
    }

    /**
     * 判断是否为桌面端渠道
     */
    public static function isDesktopChannel($channel)
    {
        return in_array($channel, [
            self::CHANNEL_PC,
        ]);
    }

    /**
     * 获取渠道支持的功能
     */
    public static function getChannelFeatures($channel)
    {
        $features = [
            self::CHANNEL_WECHAT_OFFICIAL_ACCOUNT => [
                'payment' => true,
                'share' => true,
                'location' => true,
                'camera' => false,
                'push' => true,
            ],
            self::CHANNEL_WECHAT_MINI_PROGRAM => [
                'payment' => true,
                'share' => true,
                'location' => true,
                'camera' => true,
                'push' => true,
            ],
            self::CHANNEL_IOS_APP => [
                'payment' => true,
                'share' => true,
                'location' => true,
                'camera' => true,
                'push' => true,
            ],
            self::CHANNEL_ANDROID_APP => [
                'payment' => true,
                'share' => true,
                'location' => true,
                'camera' => true,
                'push' => true,
            ],
            self::CHANNEL_H5 => [
                'payment' => true,
                'share' => true,
                'location' => true,
                'camera' => true,
                'push' => false,
            ],
            self::CHANNEL_DOUYIN_MINI_PROGRAM => [
                'payment' => true,
                'share' => true,
                'location' => true,
                'camera' => true,
                'push' => true,
            ],
            self::CHANNEL_PC => [
                'payment' => true,
                'share' => false,
                'location' => false,
                'camera' => false,
                'push' => false,
            ],
            self::CHANNEL_QQ_MINI_PROGRAM => [
                'payment' => true,
                'share' => true,
                'location' => true,
                'camera' => true,
                'push' => true,
            ],
            self::CHANNEL_ALIPAY_MINI_PROGRAM => [
                'payment' => true,
                'share' => true,
                'location' => true,
                'camera' => true,
                'push' => true,
            ],
        ];

        return $features[$channel] ?? [];
    }

    /**
     * 检查渠道是否支持某个功能
     */
    public static function channelSupportsFeature($channel, $feature)
    {
        $features = self::getChannelFeatures($channel);
        return $features[$feature] ?? false;
    }

    // ============ 支付方式枚举 ============
    const PAYMENT_WECHAT = 'wechat';        // 微信支付
    const PAYMENT_ALIPAY = 'alipay';        // 支付宝支付
    const PAYMENT_BALANCE = 'balance';      // 余额支付
    const PAYMENT_OFFLINE = 'offline';      // 线下支付

    /**
     * 获取支付方式映射
     */
    public static function getPaymentMap()
    {
        return [
            self::PAYMENT_WECHAT => '微信支付',
            self::PAYMENT_ALIPAY => '支付宝支付',
            self::PAYMENT_BALANCE => '余额支付',
            self::PAYMENT_OFFLINE => '线下支付',
        ];
    }

    /**
     * 获取渠道支持的支付方式
     */
    public static function getChannelSupportedPayments($channel)
    {
        $channelPayments = [
            self::CHANNEL_WECHAT_OFFICIAL_ACCOUNT => [self::PAYMENT_WECHAT, self::PAYMENT_BALANCE],
            self::CHANNEL_WECHAT_MINI_PROGRAM => [self::PAYMENT_WECHAT, self::PAYMENT_BALANCE],
            self::CHANNEL_IOS_APP => [self::PAYMENT_WECHAT, self::PAYMENT_ALIPAY, self::PAYMENT_BALANCE],
            self::CHANNEL_ANDROID_APP => [self::PAYMENT_WECHAT, self::PAYMENT_ALIPAY, self::PAYMENT_BALANCE],
            self::CHANNEL_H5 => [self::PAYMENT_WECHAT, self::PAYMENT_ALIPAY, self::PAYMENT_BALANCE],
            self::CHANNEL_DOUYIN_MINI_PROGRAM => [self::PAYMENT_ALIPAY, self::PAYMENT_BALANCE],
            self::CHANNEL_PC => [self::PAYMENT_ALIPAY, self::PAYMENT_BALANCE, self::PAYMENT_OFFLINE],
            self::CHANNEL_QQ_MINI_PROGRAM => [self::PAYMENT_BALANCE],
            self::CHANNEL_ALIPAY_MINI_PROGRAM => [self::PAYMENT_ALIPAY, self::PAYMENT_BALANCE],
        ];

        return $channelPayments[$channel] ?? [self::PAYMENT_BALANCE];
    }

    /**
     * 检查渠道是否支持指定支付方式
     */
    public static function channelSupportsPayment($channel, $payment)
    {
        $supportedPayments = self::getChannelSupportedPayments($channel);
        return in_array($payment, $supportedPayments);
    }

    /**
     * 获取渠道推荐的支付方式（按优先级排序）
     */
    public static function getChannelRecommendedPayments($channel)
    {
        $recommendedPayments = [
            self::CHANNEL_WECHAT_OFFICIAL_ACCOUNT => [self::PAYMENT_WECHAT, self::PAYMENT_BALANCE],
            self::CHANNEL_WECHAT_MINI_PROGRAM => [self::PAYMENT_WECHAT, self::PAYMENT_BALANCE],
            self::CHANNEL_IOS_APP => [self::PAYMENT_WECHAT, self::PAYMENT_ALIPAY, self::PAYMENT_BALANCE],
            self::CHANNEL_ANDROID_APP => [self::PAYMENT_ALIPAY, self::PAYMENT_WECHAT, self::PAYMENT_BALANCE],
            self::CHANNEL_H5 => [self::PAYMENT_ALIPAY, self::PAYMENT_WECHAT, self::PAYMENT_BALANCE],
            self::CHANNEL_DOUYIN_MINI_PROGRAM => [self::PAYMENT_ALIPAY, self::PAYMENT_BALANCE],
            self::CHANNEL_PC => [self::PAYMENT_ALIPAY, self::PAYMENT_OFFLINE, self::PAYMENT_BALANCE],
            self::CHANNEL_QQ_MINI_PROGRAM => [self::PAYMENT_BALANCE],
            self::CHANNEL_ALIPAY_MINI_PROGRAM => [self::PAYMENT_ALIPAY, self::PAYMENT_BALANCE],
        ];

        return $recommendedPayments[$channel] ?? [self::PAYMENT_BALANCE];
    }

    /**
     * 获取支付方式的渠道兼容性
     */
    public static function getPaymentChannelCompatibility($payment)
    {
        $compatibility = [
            self::PAYMENT_WECHAT => [
                'supported' => [
                    self::CHANNEL_WECHAT_OFFICIAL_ACCOUNT,
                    self::CHANNEL_WECHAT_MINI_PROGRAM,
                    self::CHANNEL_IOS_APP,
                    self::CHANNEL_ANDROID_APP,
                    self::CHANNEL_H5,
                ],
                'recommended' => [
                    self::CHANNEL_WECHAT_OFFICIAL_ACCOUNT,
                    self::CHANNEL_WECHAT_MINI_PROGRAM,
                ],
            ],
            self::PAYMENT_ALIPAY => [
                'supported' => [
                    self::CHANNEL_IOS_APP,
                    self::CHANNEL_ANDROID_APP,
                    self::CHANNEL_H5,
                    self::CHANNEL_PC,
                    self::CHANNEL_DOUYIN_MINI_PROGRAM,
                    self::CHANNEL_ALIPAY_MINI_PROGRAM,
                ],
                'recommended' => [
                    self::CHANNEL_ALIPAY_MINI_PROGRAM,
                    self::CHANNEL_PC,
                    self::CHANNEL_H5,
                ],
            ],
            self::PAYMENT_BALANCE => [
                'supported' => array_keys(self::getChannelMap()),
                'recommended' => array_keys(self::getChannelMap()),
            ],
            self::PAYMENT_OFFLINE => [
                'supported' => [self::CHANNEL_PC],
                'recommended' => [self::CHANNEL_PC],
            ],
        ];

        return $compatibility[$payment] ?? ['supported' => [], 'recommended' => []];
    }
}