fastadmin_tailored/application/common/Enum/ErrorCodeEnum.php

<?php

namespace app\common\Enum;

/**
 * 错误码枚举类
 * 统一管理系统中的所有错误码
 * 
 * 注意：这些错误码主要用于：
 * 1. 日志记录和调试追踪
 * 2. 内部业务逻辑区分
 * 
 * 前端接收的API响应中，所有业务异常统一返回 code=0（与验证异常一致）
 * 具体错误信息通过 msg 字段传递
 */
class ErrorCodeEnum
{
    // ============ 抽奖相关错误码 (1000-1999) ============
    const LOTTERY_ACTIVITY_NOT_FOUND = 1001;           // 活动不存在或未开始
    const LOTTERY_NOT_IN_TIME = 1002;                  // 不在抽奖时间内
    const LOTTERY_USER_NOT_QUALIFIED = 1003;           // 用户不符合参与条件
    const LOTTERY_NO_CHANCE = 1004;                    // 没有抽奖机会
    const LOTTERY_REACH_LIMIT = 1005;                  // 已达到参与次数上限
    const LOTTERY_ORDER_ALREADY_DRAWN = 1006;          // 该订单已参与过抽奖

    // ============ 用户相关错误码 (2000-2999) ============
    const USER_NOT_LOGIN = 2002;                       // 请先登录
    const USER_ACTIVITY_NOT_FOUND = 2001;              // 活动不存在
    const USER_WIN_RECORD_NOT_FOUND = 2003;            // 中奖记录不存在
    const USER_PRIZE_ALREADY_PROCESSED = 2004;         // 该奖品已处理，无法修改地址

    // ============ 商品折扣相关错误码 (3000-3999) ============
    const GOODS_NO_DISCOUNT = 3001;                    // 该商品当前没有参与折扣活动

    // ============ 订单相关错误码 (4000-4999) ============
    // 预留给订单相关功能

    // ============ 支付相关错误码 (5000-5999) ============
    // 预留给支付相关功能

    /**
     * 获取错误码对应的默认消息
     * @param int $code 错误码
     * @return string
     */
    public static function getMessage($code)
    {
        $messages = [
            // 抽奖相关
            self::LOTTERY_ACTIVITY_NOT_FOUND => '活动不存在或未开始',
            self::LOTTERY_NOT_IN_TIME => '不在抽奖时间内',
            self::LOTTERY_USER_NOT_QUALIFIED => '用户不符合参与条件',
            self::LOTTERY_NO_CHANCE => '没有抽奖机会',
            self::LOTTERY_REACH_LIMIT => '已达到参与次数上限',
            self::LOTTERY_ORDER_ALREADY_DRAWN => '该订单已参与过抽奖',

            // 用户相关
            self::USER_NOT_LOGIN => '请先登录',
            self::USER_ACTIVITY_NOT_FOUND => '活动不存在',
            self::USER_WIN_RECORD_NOT_FOUND => '中奖记录不存在',
            self::USER_PRIZE_ALREADY_PROCESSED => '该奖品已处理，无法修改地址',

            // 商品折扣相关
            self::GOODS_NO_DISCOUNT => '该商品当前没有参与折扣活动',
        ];

        return $messages[$code] ?? '未知错误';
    }
}