xiaoxia-saas/packages/domain/exceptions.py

"""
领域层通用异常定义。

所有应用层共享的通用异常在此统一定义，
消除各 use_cases 模块中重复的异常类。
领域特定的异常仍在各模块内定义。
"""


class DomainError(Exception):
    """领域层异常基类。"""

    pass


class NotFoundError(DomainError):
    """资源不存在。"""

    pass


class ValidationError(DomainError):
    """业务规则校验失败。"""

    pass


class QuotaExceededError(DomainError):
    """配额超限。"""

    def __init__(self, dimension: str, limit: float, used: float) -> None:
        self.dimension = dimension
        self.limit = limit
        self.used = used
        super().__init__(f"Quota exceeded for {dimension}: {used}/{limit}")