159 lines
7.0 KiB
Python
159 lines
7.0 KiB
Python
|
# =============================================================================
|
||
|
|
# IT智能服务台 — 错误码定义
|
||
|
|
# =============================================================================
|
||
|
|
# 说明：统一管理系统错误码，便于前端解析和国际化
|
||
|
|
# 格式：E{模块}{序号}
|
||
|
|
# =============================================================================
|
||
|
|
|
||
|
|
from enum import Enum
|
||
|
|
|
||
|
|
|
||
|
|
class ErrorCode(str, Enum):
|
||
|
|
"""系统错误码枚举"""
|
||
|
|
|
||
|
|
# --------------------------------------------------------------------------
|
||
|
|
# 通用错误 (0xxx)
|
||
|
|
# --------------------------------------------------------------------------
|
||
|
|
SUCCESS = "E0000" # 成功
|
||
|
|
UNKNOWN_ERROR = "E0001" # 未知错误
|
||
|
|
INVALID_PARAMETER = "E0002" # 参数错误
|
||
|
|
MISSING_PARAMETER = "E0003" # 缺少参数
|
||
|
|
NOT_FOUND = "E0004" # 资源不存在
|
||
|
|
UNAUTHORIZED = "E0005" # 未授权
|
||
|
|
FORBIDDEN = "E0006" # 禁止访问
|
||
|
|
INTERNAL_ERROR = "E0007" # 内部错误
|
||
|
|
SERVICE_UNAVAILABLE = "E0008" # 服务不可用
|
||
|
|
TIMEOUT = "E0009" # 请求超时
|
||
|
|
|
||
|
|
# --------------------------------------------------------------------------
|
||
|
|
# 认证相关 (1xxx)
|
||
|
|
# --------------------------------------------------------------------------
|
||
|
|
AUTH_FAILED = "E1001" # 认证失败
|
||
|
|
AUTH_TOKEN_EXPIRED = "E1002" # Token过期
|
||
|
|
AUTH_TOKEN_INVALID = "E1003" # Token无效
|
||
|
|
AUTH_PASSWORD_REQUIRED = "E1012" # 登录:首次登录请先设置密码
|
||
|
|
AUTH_PASSWORD_WRONG = "E1011" # 登录:本地密码错误
|
||
|
|
AUTH_OLD_PASSWORD_REQUIRED = "E1015" # 改密:请输入旧密码(2026-06-15 WB反馈 1012 上下文冲突后拆分)
|
||
|
|
AUTH_OLD_PASSWORD_WRONG = "E1016" # 改密:旧密码错误(2026-06-15 拆分)
|
||
|
|
|
||
|
|
# --------------------------------------------------------------------------
|
||
|
|
# 企微API错误 (2xxx)
|
||
|
|
# --------------------------------------------------------------------------
|
||
|
|
WECOM_API_ERROR = "E2001" # 企微API调用失败
|
||
|
|
WECOM_API_TIMEOUT = "E2002" # 企微API超时
|
||
|
|
WECOM_TOKEN_INVALID = "E2003" # 企微token无效
|
||
|
|
WECOM_USER_NOT_FOUND = "E2004" # 企微用户不存在
|
||
|
|
|
||
|
|
# --------------------------------------------------------------------------
|
||
|
|
# 会话/消息错误 (3xxx)
|
||
|
|
# --------------------------------------------------------------------------
|
||
|
|
CONVERSATION_NOT_FOUND = "E3001" # 会话不存在
|
||
|
|
MESSAGE_NOT_FOUND = "E3002" # 消息不存在
|
||
|
|
MESSAGE_TOO_LONG = "E3003" # 消息过长
|
||
|
|
CONVERSATION_CLOSED = "E3004" # 会话已关闭
|
||
|
|
|
||
|
|
# --------------------------------------------------------------------------
|
||
|
|
# 坐席错误 (4xxx)
|
||
|
|
# --------------------------------------------------------------------------
|
||
|
|
AGENT_NOT_FOUND = "E4001" # 坐席不存在
|
||
|
|
AGENT_OFFLINE = "E4002" # 坐席不在线
|
||
|
|
AGENT_BUSY = "E4003" # 坐席忙碌
|
||
|
|
AGENT_MAX_LOAD = "E4004" # 坐席已达最大接待量
|
||
|
|
|
||
|
|
# --------------------------------------------------------------------------
|
||
|
|
# 审批错误 (5xxx)
|
||
|
|
# --------------------------------------------------------------------------
|
||
|
|
APPROVAL_TEMPLATE_NOT_FOUND = "E5001" # 审批模板不存在
|
||
|
|
APPROVAL_FAILED = "E5002" # 审批提交失败
|
||
|
|
|
||
|
|
# --------------------------------------------------------------------------
|
||
|
|
# 文件上传错误 (6xxx)
|
||
|
|
# --------------------------------------------------------------------------
|
||
|
|
FILE_TOO_LARGE = "E6001" # 文件过大
|
||
|
|
FILE_TYPE_NOT_ALLOWED = "E6002" # 文件类型不允许
|
||
|
|
FILE_UPLOAD_FAILED = "E6003" # 文件上传失败
|
||
|
|
|
||
|
|
|
||
|
|
# 错误码到 HTTP 状态码的映射
|
||
|
|
ERROR_CODE_TO_STATUS = {
|
||
|
|
ErrorCode.SUCCESS: 200,
|
||
|
|
ErrorCode.INVALID_PARAMETER: 400,
|
||
|
|
ErrorCode.MISSING_PARAMETER: 400,
|
||
|
|
ErrorCode.NOT_FOUND: 404,
|
||
|
|
ErrorCode.UNAUTHORIZED: 401,
|
||
|
|
ErrorCode.FORBIDDEN: 403,
|
||
|
|
ErrorCode.INTERNAL_ERROR: 500,
|
||
|
|
ErrorCode.SERVICE_UNAVAILABLE: 503,
|
||
|
|
# 认证
|
||
|
|
ErrorCode.AUTH_FAILED: 401,
|
||
|
|
ErrorCode.AUTH_TOKEN_EXPIRED: 401,
|
||
|
|
ErrorCode.AUTH_TOKEN_INVALID: 401,
|
||
|
|
ErrorCode.AUTH_PASSWORD_REQUIRED: 401,
|
||
|
|
ErrorCode.AUTH_PASSWORD_WRONG: 401,
|
||
|
|
ErrorCode.AUTH_OLD_PASSWORD_REQUIRED: 400,
|
||
|
|
ErrorCode.AUTH_OLD_PASSWORD_WRONG: 400,
|
||
|
|
# 企微
|
||
|
|
ErrorCode.WECOM_API_ERROR: 502,
|
||
|
|
ErrorCode.WECOM_API_TIMEOUT: 504,
|
||
|
|
ErrorCode.WECOM_TOKEN_INVALID: 401,
|
||
|
|
ErrorCode.WECOM_USER_NOT_FOUND: 404,
|
||
|
|
# 会话
|
||
|
|
ErrorCode.CONVERSATION_NOT_FOUND: 404,
|
||
|
|
ErrorCode.MESSAGE_NOT_FOUND: 404,
|
||
|
|
ErrorCode.MESSAGE_TOO_LONG: 400,
|
||
|
|
ErrorCode.CONVERSATION_CLOSED: 400,
|
||
|
|
# 坐席
|
||
|
|
ErrorCode.AGENT_NOT_FOUND: 404,
|
||
|
|
ErrorCode.AGENT_OFFLINE: 400,
|
||
|
|
ErrorCode.AGENT_BUSY: 400,
|
||
|
|
ErrorCode.AGENT_MAX_LOAD: 400,
|
||
|
|
# 审批
|
||
|
|
ErrorCode.APPROVAL_TEMPLATE_NOT_FOUND: 404,
|
||
|
|
ErrorCode.APPROVAL_FAILED: 502,
|
||
|
|
# 文件
|
||
|
|
ErrorCode.FILE_TOO_LARGE: 413,
|
||
|
|
ErrorCode.FILE_TYPE_NOT_ALLOWED: 400,
|
||
|
|
ErrorCode.FILE_UPLOAD_FAILED: 500,
|
||
|
|
}
|
||
|
|
|
||
|
|
|
||
|
|
def get_error_message(code: ErrorCode) -> str:
|
||
|
|
"""获取错误码对应的默认消息"""
|
||
|
|
messages = {
|
||
|
|
ErrorCode.SUCCESS: "操作成功",
|
||
|
|
ErrorCode.UNKNOWN_ERROR: "未知错误，请稍后重试",
|
||
|
|
ErrorCode.INVALID_PARAMETER: "参数错误",
|
||
|
|
ErrorCode.MISSING_PARAMETER: "缺少必要参数",
|
||
|
|
ErrorCode.NOT_FOUND: "资源不存在",
|
||
|
|
ErrorCode.UNAUTHORIZED: "未授权，请先登录",
|
||
|
|
ErrorCode.FORBIDDEN: "禁止访问",
|
||
|
|
ErrorCode.INTERNAL_ERROR: "服务器内部错误",
|
||
|
|
ErrorCode.SERVICE_UNAVAILABLE: "服务暂时不可用",
|
||
|
|
ErrorCode.TIMEOUT: "请求超时",
|
||
|
|
ErrorCode.AUTH_FAILED: "认证失败",
|
||
|
|
ErrorCode.AUTH_TOKEN_EXPIRED: "登录已过期，请重新登录",
|
||
|
|
ErrorCode.AUTH_TOKEN_INVALID: "无效的登录凭证",
|
||
|
|
ErrorCode.AUTH_PASSWORD_REQUIRED: "首次登录请先设置密码",
|
||
|
|
ErrorCode.AUTH_PASSWORD_WRONG: "密码错误",
|
||
|
|
ErrorCode.AUTH_OLD_PASSWORD_REQUIRED: "请输入旧密码",
|
||
|
|
ErrorCode.AUTH_OLD_PASSWORD_WRONG: "旧密码错误",
|
||
|
|
ErrorCode.WECOM_API_ERROR: "企业微信服务异常",
|
||
|
|
ErrorCode.WECOM_API_TIMEOUT: "企业微信服务响应超时",
|
||
|
|
ErrorCode.WECOM_TOKEN_INVALID: "企业微信凭证无效",
|
||
|
|
ErrorCode.WECOM_USER_NOT_FOUND: "企业微信用户不存在",
|
||
|
|
ErrorCode.CONVERSATION_NOT_FOUND: "会话不存在",
|
||
|
|
ErrorCode.MESSAGE_NOT_FOUND: "消息不存在",
|
||
|
|
ErrorCode.MESSAGE_TOO_LONG: "消息内容过长",
|
||
|
|
ErrorCode.CONVERSATION_CLOSED: "会话已结束",
|
||
|
|
ErrorCode.AGENT_NOT_FOUND: "坐席不存在",
|
||
|
|
ErrorCode.AGENT_OFFLINE: "坐席不在线",
|
||
|
|
ErrorCode.AGENT_BUSY: "坐席忙碌中",
|
||
|
|
ErrorCode.AGENT_MAX_LOAD: "坐席已达到最大接待量",
|
||
|
|
ErrorCode.APPROVAL_TEMPLATE_NOT_FOUND: "审批模板不存在",
|
||
|
|
ErrorCode.APPROVAL_FAILED: "审批提交失败",
|
||
|
|
ErrorCode.FILE_TOO_LARGE: "文件过大",
|
||
|
|
ErrorCode.FILE_TYPE_NOT_ALLOWED: "不支持的文件类型",
|
||
|
|
ErrorCode.FILE_UPLOAD_FAILED: "文件上传失败",
|
||
|
|
}
|
||
|
|
return messages.get(code, "未知错误")
|