1461a8d113
按 2026-11-02 需求补齐计划交付后端能力： - 角色授权：权限目录化，接口统一准入校验，未登记默认拒绝； 管理员判断改为按数据库角色重新判定，防止权限码持有者绕过 - 系统监控：单进程采集资源、请求与异常指标，分钟级聚合， 阈值配置化；敏感配置增加 repr 保护，Redis 密码 URL 转义 - 试用期计提：按回款日判定并写入快照，年度结清与调整单联动； 人员模型补试用期、离职日期与工资版本历史字段 - 计提模板：公式骨架受控，页面维护名称与参数绑定 - T+ 采集：自动化配置表与进度查询 内置角色禁停用保护对齐模块注释；核算规则版本提为常量并 补充批量核算失败堆栈日志。 影响范围：后端全部模块、数据库迁移 V22-V28 验证：uv run ruff check 通过；922 个单元测试全部通过； 集成测试因本机 MySQL 数据卷被其他容器锁定暂未运行
62 lines
1.7 KiB
Python
62 lines
1.7 KiB
Python
"""业务异常定义。
|
|
|
|
`code` 直接作为 HTTP 状态码返回，使前端拦截器既能读 HTTP 状态也能读响应体的 code。
|
|
|
|
重要约定：**401 只表示"受保护接口的鉴权失败"**，登录接口自身的失败一律用 400/403。
|
|
否则前端"401 即跳登录页"的拦截器会在用户输错密码时触发跳转，导致登录页反复重挂载。
|
|
"""
|
|
|
|
from app.core.constants import (
|
|
CODE_BAD_REQUEST,
|
|
CODE_FORBIDDEN,
|
|
CODE_NOT_FOUND,
|
|
CODE_SERVER_ERROR,
|
|
CODE_UNAUTHORIZED,
|
|
)
|
|
|
|
|
|
class AppException(Exception):
|
|
"""业务异常基类。业务逻辑中主动抛出，由全局处理器转换为统一响应。"""
|
|
|
|
code: int = CODE_SERVER_ERROR
|
|
message: str = "服务端异常"
|
|
|
|
def __init__(self, message: str | None = None) -> None:
|
|
self.message = message or self.message
|
|
super().__init__(self.message)
|
|
|
|
|
|
class BadRequestError(AppException):
|
|
"""参数错误或业务规则校验不通过。"""
|
|
|
|
code = CODE_BAD_REQUEST
|
|
message = "参数错误"
|
|
|
|
|
|
class AuthError(AppException):
|
|
"""未认证：令牌缺失、无效、过期或已登出。"""
|
|
|
|
code = CODE_UNAUTHORIZED
|
|
message = "登录状态已失效，请重新登录"
|
|
|
|
|
|
class ForbiddenError(AppException):
|
|
"""已认证但无权限，或账号被禁用/锁定。"""
|
|
|
|
code = CODE_FORBIDDEN
|
|
message = "无权限"
|
|
|
|
|
|
class NotFoundError(AppException):
|
|
"""请求的资源不存在。"""
|
|
|
|
code = CODE_NOT_FOUND
|
|
message = "资源不存在"
|
|
|
|
|
|
class ConflictError(AppException):
|
|
"""授权版本已变化，客户端应刷新后重新核对。"""
|
|
|
|
code = 409
|
|
message = "配置已被其他人修改，请刷新后重新核对"
|