用途：为 API 提供一致的错误响应、机器可读错误码、人类可读消息、HTTP 状态码映射和瞬时故障重试提示，适合需要统一错误处理、客户端按错误码分支处理、基于错误类型重试以及大型代码库标准化的场景。
主要能力：定义抽象基类 BaseAppError，并派生 AuthenticationError(401)、AuthorizationError(403)、ResourceError(404/409)、ValidationError(422)、RateLimitError(429)、ExternalServiceError(502/503)、PaymentError(402) 等层级；提供 ErrorCode 枚举（如 AUTH_INVALID_CREDENTIALS、RESOURCE_NOT_FOUND、RATE_LIMIT_EXCEEDED、INVALID_STATE_TRANSITION 等）；异常对象可转为统一 JSON 结构，包含 message、code、details 和 retry_after。
使用方式：资料给出 Python 与 TypeScript 实现示例，以及 FastAPI 异常处理器注册方式（@app.exception_handler(BaseAppError)）和路由中抛出 NotFoundError、AuthorizationError 的用法；客户端可按 error.code 分支处理，如 AUTH_TOKEN_EXPIRED 触发刷新令牌、RATE_LIMIT_EXCEEDED 读取 retry_after 提示重试。
限制与注意：资料未提供安装命令、包名、版本、收费或平台信息；示例代码需按项目实际调整，生产环境应避免暴露内部错误细节，并保持各端点错误响应格式一致。相关模式包括 error-sanitization、error-handling、rate-limiting。