"""业务异常与鉴权错误码（对齐 JWT-RBAC 手册）。

NotFoundError 继承 LookupError：服务层既有 `raise LookupError`（customer/product
not found）自动获得精确类型与 404 语义，调用方 except LookupError 无需改动
（B5 评审 P3-1 的收敛锚点）。
"""

from __future__ import annotations


class NotFoundError(LookupError):
    """资源不存在（HTTP 404）。"""


class PermissionDenied(PermissionError):
    """归属/权限拒绝（HTTP 403）；code 对齐 JWT 手册 §6.1 错误码。"""

    def __init__(self, code: str, message: str) -> None:
        super().__init__(message)
        self.code = code


class StateConflict(ValueError):
    """状态机冲突（HTTP 409；如处置非 pending_review 的预警单）。"""