fastadmin_tailored/application/common/Enum/LotteryEnum.php

<?php
namespace app\common\Enum;

/**
 * 抽奖活动枚举类
 */
class LotteryEnum
{
      // ============ 抽奖基础状态 ============
      const STATUS_NOT_STARTED = 1;  // 未开始
      const STATUS_ONGOING = 2;      // 进行中
      const STATUS_ENDED = 3;        // 已结束
      const STATUS_CANCELLED = 4;    // 已取消
      const STATUS_SUSPENDED = 5;    // 已暂停
      const STATUS_CLOSED = 6;       // 已关闭
      const STATUS_DELETED = 7;      // 已删除
      const STATUS_EXPIRED = 8;      // 已过期
  
      // ============ 抽奖类型 ============
      const LOTTERY_TYPE_CONSUMPTION_LOTTERY = 1; // 消费抽奖
  
      // ============ 开奖方式 ============
      const LOTTERY_TYPE_INSTANT = 1;         // 即抽即中
      const LOTTERY_TYPE_TIME = 2;            // 按时间开奖
      const LOTTERY_TYPE_PEOPLE = 3;          // 按人数开奖
  
      // ============ 用户群体类型 ============
      const USER_LIMIT_ALL = 1;               // 全部会员
      const USER_LIMIT_LEVEL = 2;             // 会员等级
      const USER_LIMIT_TAG = 3;               // 会员标签
  
      // ============ 引导样式 ============
      const GUIDE_STYLE_DEFAULT = 1;          // 默认样式
      const GUIDE_STYLE_CUSTOM = 2;           // 自定义
  
      // ============ 奖品类型 ============
      const PRIZE_TYPE_NO_PRIZE = 1;          // 未中奖
      const PRIZE_TYPE_GOODS = 2;             // 实物奖品
      const PRIZE_TYPE_POINTS = 3;            // 积分
      const PRIZE_TYPE_BALANCE = 4;           // 余额
      const PRIZE_TYPE_COUPON = 5;            // 优惠券
      const PRIZE_TYPE_REDPACK = 6;           // 红包
      const PRIZE_TYPE_CODE = 7;              // 兑换码
      const PRIZE_TYPE_SHOP_GOODS = 8;        // 商城奖品
  
      // ============ 奖品发放方式 ============
      const DELIVER_TYPE_AUTO = 1;            // 自动发放
      const DELIVER_TYPE_MANUAL = 2;          // 手动发放
  
      // ============ 奖品发放状态 ============
      const DELIVER_STATUS_PENDING = 0;       // 待发放
      const DELIVER_STATUS_SUCCESS = 1;       // 已发放
      const DELIVER_STATUS_FAILED = 2;        // 发放失败
      const DELIVER_STATUS_CANCELLED = 3;     // 已取消
  
      // ============ 参与条件类型 ============
      const CONDITION_TYPE_BUY_GOODS = 1;     // 购买指定商品
      const CONDITION_TYPE_ORDER_AMOUNT = 2;  // 单笔订单消费满额
      const CONDITION_TYPE_RECHARGE_AMOUNT = 3; // 单次充值满额
      const CONDITION_TYPE_TOTAL_AMOUNT = 4;  // 活动期间累计消费满额
  
      // ============ 商品规则 ============
      const GOODS_RULE_INCLUDE = 1;           // 指定商品参与
      const GOODS_RULE_EXCLUDE = 2;           // 指定商品不可参与
  
          // ============ 触发类型 ============
    const TRIGGER_TYPE_BUY_GOODS = 1;       // 购买商品
    const TRIGGER_TYPE_ORDER_CONSUME = 2;   // 订单消费
    const TRIGGER_TYPE_RECHARGE = 3;        // 充值
    const TRIGGER_TYPE_TOTAL_CONSUME = 4;   // 累计消费

    // ============ 机会获取类型（与条件类型保持一致，额外增加管理员赠送） ============
    const CHANCE_GET_TYPE_BUY_GOODS = 1;    // 购买指定商品（对应CONDITION_TYPE_BUY_GOODS）
    const CHANCE_GET_TYPE_ORDER_AMOUNT = 2; // 单笔订单消费满额（对应CONDITION_TYPE_ORDER_AMOUNT）
    const CHANCE_GET_TYPE_RECHARGE = 3;     // 单次充值满额（对应CONDITION_TYPE_RECHARGE_AMOUNT）
    const CHANCE_GET_TYPE_TOTAL_AMOUNT = 4; // 活动期间累计消费满额（对应CONDITION_TYPE_TOTAL_AMOUNT）
    const CHANCE_GET_TYPE_ADMIN_GRANT = 5;  // 管理员赠送

    // ============ 兑奖期限类型 ============
    const REDEEM_EXPIRE_FOREVER = 1;        // 永久有效
    const REDEEM_EXPIRE_FIXED = 2;          // 固定时长
  
      /**
       * 获取活动状态映射（页面显示用）
       */
      public static function getActivityStatusMap()
      {
          return [
              self::STATUS_NOT_STARTED => '未开始',
              self::STATUS_ONGOING => '进行中',
              self::STATUS_ENDED => '已结束',
              self::STATUS_CANCELLED => '已取消',
              self::STATUS_SUSPENDED => '已暂停',
          ];
      }
      
      /**
       * 获取全部活动状态映射（包含逻辑状态）
       */
      public static function getAllActivityStatusMap()
      {
          return [
              self::STATUS_NOT_STARTED => '未开始',
              self::STATUS_ONGOING => '进行中',
              self::STATUS_ENDED => '已结束',
              self::STATUS_CANCELLED => '已取消',
              self::STATUS_SUSPENDED => '已暂停',
              self::STATUS_CLOSED => '已关闭',
              self::STATUS_DELETED => '已删除',
              self::STATUS_EXPIRED => '已过期',
          ];
      }
  
      /**
       * 获取活动类型映射
       */
      public static function getActivityTypeMap()
      {
          return [
              self::LOTTERY_TYPE_CONSUMPTION_LOTTERY => '消费抽奖',
          ];
      }
  
      /**
       * 获取开奖方式映射
       */
      public static function getLotteryTypeMap()
      {
          return [
              self::LOTTERY_TYPE_INSTANT => '即抽即中',
              self::LOTTERY_TYPE_TIME => '按时间开奖',
              self::LOTTERY_TYPE_PEOPLE => '按人数开奖',
          ];
      }
  
      /**
       * 获取用户群体类型映射
       */
      public static function getUserLimitTypeMap()
      {
          return [
              self::USER_LIMIT_ALL => '全部会员',
              self::USER_LIMIT_LEVEL => '会员等级',
              self::USER_LIMIT_TAG => '会员标签',
          ];
      }
  
      /**
       * 获取引导样式映射
       */
      public static function getGuideStyleMap()
      {
          return [
              self::GUIDE_STYLE_DEFAULT => '默认样式',
              self::GUIDE_STYLE_CUSTOM => '自定义',
          ];
      }
  
      /**
       * 获取奖品类型映射
       */
      public static function getPrizeTypeMap()
      {
          return [
              self::PRIZE_TYPE_NO_PRIZE => '未中奖',
              self::PRIZE_TYPE_GOODS => '实物奖品',
              self::PRIZE_TYPE_POINTS => '积分',
              self::PRIZE_TYPE_BALANCE => '余额',
              self::PRIZE_TYPE_COUPON => '优惠券',
              self::PRIZE_TYPE_REDPACK => '红包',
              self::PRIZE_TYPE_CODE => '兑换码',
              self::PRIZE_TYPE_SHOP_GOODS => '商城奖品',
          ];
      }
  
      /**
       * 获取奖品默认图片映射
       */
      public static function getPrizeDefaultImageMap()
      {
          // 从配置文件获取图片路径
          $config = config('site');
          
          return [
              self::PRIZE_TYPE_NO_PRIZE => $config['prize_losing_lottery'] ?? '/assets/img/avatar.png',
              self::PRIZE_TYPE_GOODS => $config['prize_goods'] ?? '/assets/img/package.png',
              self::PRIZE_TYPE_POINTS => $config['prize_credit'] ?? '/assets/img/circle.png',
              self::PRIZE_TYPE_BALANCE => $config['prize_balance'] ?? '/assets/img/circle.png',
              self::PRIZE_TYPE_COUPON => $config['prize_coupon'] ?? '/assets/img/circle.png',
              self::PRIZE_TYPE_REDPACK => $config['prize_redbag'] ?? '/assets/img/circle.png',
              self::PRIZE_TYPE_CODE => $config['prize_code'] ?? '/assets/img/circle.png',
              self::PRIZE_TYPE_SHOP_GOODS => $config['prize_shop_goods'] ?? '/assets/img/package.png',
          ];
      }
  
      /**
       * 获取奖品发放方式映射
       */
      public static function getDeliverTypeMap()
      {
          return [
              self::DELIVER_TYPE_AUTO => '自动发放',
              self::DELIVER_TYPE_MANUAL => '手动发放',
          ];
      }
  
      /**
       * 获取奖品发放状态映射
       */
      public static function getDeliverStatusMap()
      {
          return [
              self::DELIVER_STATUS_PENDING => '待发放',
              self::DELIVER_STATUS_SUCCESS => '已发放',
              self::DELIVER_STATUS_FAILED => '发放失败',
              self::DELIVER_STATUS_CANCELLED => '已取消',
          ];
      }
  
      /**
       * 获取参与条件类型映射
       */
      public static function getConditionTypeMap()
      {
          return [
              self::CONDITION_TYPE_BUY_GOODS => '购买指定商品',
              self::CONDITION_TYPE_ORDER_AMOUNT => '单笔订单消费满N元',
              self::CONDITION_TYPE_RECHARGE_AMOUNT => '单次充值金额满N元',
              self::CONDITION_TYPE_TOTAL_AMOUNT => '活动期间累计消费N元',
          ];
      }
  
      /**
       * 获取商品规则映射
       */
      public static function getGoodsRuleMap()
      {
          return [
              self::GOODS_RULE_INCLUDE => '指定商品参与',
              self::GOODS_RULE_EXCLUDE => '指定商品不可参与',
          ];
      }
  
          /**
     * 获取触发类型映射  后台
     */
    public static function getTriggerTypeMap()
    {
        return [
            self::TRIGGER_TYPE_BUY_GOODS => '购买商品',
            self::TRIGGER_TYPE_ORDER_CONSUME => '订单消费',
            self::TRIGGER_TYPE_RECHARGE => '充值',
            self::TRIGGER_TYPE_TOTAL_CONSUME => '累计消费',
        ];
    }
    /**
     * 获取机会获取类型映射h
     */
    public static function getChanceGetTypeMap()
    {
        return [
            self::CHANCE_GET_TYPE_BUY_GOODS => '购买指定商品',
            self::CHANCE_GET_TYPE_ORDER_AMOUNT => '单笔订单消费满额',
            self::CHANCE_GET_TYPE_RECHARGE => '单次充值满额',
            self::CHANCE_GET_TYPE_TOTAL_AMOUNT => '活动期间累计消费满额',
            self::CHANCE_GET_TYPE_ADMIN_GRANT => '管理员赠送',
        ];
    }
  
      /**
       * 获取兑奖期限类型映射
       */
      public static function getRedeemExpireTypeMap()
      {
          return [
              self::REDEEM_EXPIRE_FOREVER => '永久有效',
              self::REDEEM_EXPIRE_FIXED => '固定时长',
          ];
      }
  
      /**
       * 获取活动状态文本
       */
      public static function getActivityStatusText($status)
      {
          $map = self::getAllActivityStatusMap();
          return $map[$status] ?? '未知';
      }
  
      /**
       * 获取奖品类型文本
       */
      public static function getPrizeTypeText($type)
      {
          $map = self::getPrizeTypeMap();
          return $map[$type] ?? '未知';
      }
  
      /**
       * 获取开奖方式文本
       */
      public static function getLotteryTypeText($type)
      {
          $map = self::getLotteryTypeMap();
          return $map[$type] ?? '未知';
      }
  
          /**
     * 获取条件类型文本
     */
    public static function getConditionTypeText($type)
    {
        $map = self::getConditionTypeMap();
        return $map[$type] ?? '未知';
    }



    /**
     * 获取机会获取类型文本
     */
    public static function getChanceGetTypeText($type)
    {
        $map = self::getChanceGetTypeMap();
        return $map[$type] ?? '未知';
    }
  
      /**
       * 验证活动状态是否有效（包含所有状态）
       */
      public static function isValidActivityStatus($status)
      {
          return array_key_exists($status, self::getAllActivityStatusMap());
      }
  
      /**
       * 判断是否为可在页面显示的状态
       */
      public static function isDisplayableStatus($status)
      {
          return array_key_exists($status, self::getActivityStatusMap());
      }
  
      /**
       * 判断是否为逻辑状态（不在页面显示）
       */
      public static function isLogicalStatus($status)
      {
          return in_array($status, [
              self::STATUS_CLOSED,
              self::STATUS_DELETED,
              self::STATUS_EXPIRED
          ]);
      }
  
      /**
       * 验证奖品类型是否有效
       */
      public static function isValidPrizeType($type)
      {
          return array_key_exists($type, self::getPrizeTypeMap());
      }
  
      /**
       * 验证开奖方式是否有效
       */
      public static function isValidLotteryType($type)
      {
          return array_key_exists($type, self::getLotteryTypeMap());
      }
  
          /**
     * 验证条件类型是否有效
     */
    public static function isValidConditionType($type)
    {
        return array_key_exists($type, self::getConditionTypeMap());
    }



    /**
     * 验证机会获取类型是否有效
     */
    public static function isValidChanceGetType($type)
    {
        return array_key_exists($type, self::getChanceGetTypeMap());
    }
}