110-error-handling

🚨 MANEJO DE ERRORES Y LOGGING — TRADING TERMINAL

FILOSOFÍA: FAIL LOUDLY, NOT SILENTLY

En trading, un error silencioso puede significar:

• Orden que se envió pero no se registró
• Pérdida calculada incorrectamente
• Precio desactualizado sin que el usuario lo sepa

Cada error DEBE ser visible: al usuario, en los logs, o ambos.

🐍 JERARQUÍA DE EXCEPCIONES (Python)

# core/exceptions.py — Mapa completo de excepciones del dominio

class TradingError(Exception):
    """Base de todas las excepciones. Nunca usar directamente."""
    def __init__(self, message: str, code: str = "TRADING_ERROR"):
        self.message = message
        self.code = code
        super().__init__(message)

# ── Errores de autenticación ──────────────────────────
class UnauthorizedError(TradingError):
    """JWT inválido, expirado, o usuario sin permisos."""
    def __init__(self, message: str = "No autorizado"):
        super().__init__(message, "UNAUTHORIZED")

# ── Errores de validación ──────────────────────────────
class ValidationError(TradingError):
    """Input del usuario es inválido."""
    def __init__(self, message: str, field: str = ""):
        self.field = field
        super().__init__(message, "VALIDATION_ERROR")

class InvalidSymbolError(ValidationError):
    """El símbolo de trading no existe o no está disponible."""
    pass

# ── Errores financieros ────────────────────────────────
class InsufficientFundsError(TradingError):
    """No hay fondos suficientes para la operación."""
    def __init__(self, required: float, available: float):
        super().__init__(
            f"Fondos insuficientes: necesitas ${required:.2f}, tienes ${available:.2f}",
            "INSUFFICIENT_FUNDS"
        )
        self.required = required
        self.available = available

class RiskViolationError(TradingError):
    """La operación viola las reglas de gestión de riesgo."""
    def __init__(self, message: str, rule: str = ""):
        self.rule = rule
        super().__init__(message, "RISK_VIOLATION")

# ── Errores de órdenes ─────────────────────────────────
class OrderNotFoundError(TradingError):
    """La orden no existe o no pertenece al usuario."""
    pass

class OrderAlreadyCancelledError(TradingError):
    """La orden ya fue cancelada y no se puede modificar."""
    pass

class OrderExecutionError(TradingError):
    """Error al ejecutar la orden en el exchange."""
    pass

# ── Errores de exchange ────────────────────────────────
class ExchangeConnectionError(TradingError):
    """Error de conexión con el exchange."""
    pass

class ExchangeRateLimitError(TradingError):
    """Se alcanzó el límite de solicitudes del exchange."""
    pass