Skip to content

domain.errors.account_error

src.domain.errors.account_error

Account domain errors.

Defines account-specific error constants for validation, money operations, and state management.

Architecture
  • Domain layer errors (no infrastructure dependencies)
  • Used in Result types (railway-oriented programming)
  • Never raised as exceptions (return Failure(error) instead)
Usage

from src.domain.errors import AccountError from src.core.result import Failure

if not name: return Failure(AccountError.INVALID_ACCOUNT_NAME)

Reference
  • docs/architecture/account-domain-model.md

Classes

AccountError

Account error constants.

Used in Result types for account operation failures. These are NOT exceptions - they are error value constants used in railway-oriented programming pattern.

Error Categories
  • Validation errors: INVALID_ACCOUNT_NAME, INVALID_CURRENCY
  • Money errors: CURRENCY_MISMATCH, INVALID_AMOUNT
  • State errors: ACCOUNT_INACTIVE
Source code in src/domain/errors/account_error.py 
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
class AccountError:
    """Account error constants.

    Used in Result types for account operation failures.
    These are NOT exceptions - they are error value constants
    used in railway-oriented programming pattern.

    Error Categories:
        - Validation errors: INVALID_ACCOUNT_NAME, INVALID_CURRENCY
        - Money errors: CURRENCY_MISMATCH, INVALID_AMOUNT
        - State errors: ACCOUNT_INACTIVE
    """

    # -------------------------------------------------------------------------
    # Validation Errors
    # -------------------------------------------------------------------------

    INVALID_ACCOUNT_NAME = "Account name cannot be empty"
    """Account name is required for display purposes."""

    INVALID_CURRENCY = "Invalid ISO 4217 currency code"
    """Currency must be a valid 3-letter ISO 4217 code."""

    INVALID_PROVIDER_ACCOUNT_ID = "Provider account ID cannot be empty"
    """Provider's unique account identifier is required for sync."""

    INVALID_ACCOUNT_NUMBER = "Account number mask cannot be empty"
    """Masked account number is required for display."""

    # -------------------------------------------------------------------------
    # Money Errors
    # -------------------------------------------------------------------------

    CURRENCY_MISMATCH = "Cannot perform operation on different currencies"
    """Arithmetic operations require same currency."""

    INVALID_AMOUNT = "Amount must be a valid Decimal"
    """Balance amount must be a valid decimal number."""

    NEGATIVE_BALANCE_NOT_ALLOWED = "Balance cannot be negative for this account type"
    """Some account types cannot have negative balances."""

    # -------------------------------------------------------------------------
    # State Errors
    # -------------------------------------------------------------------------

    ACCOUNT_INACTIVE = "Account is not active"
    """Account has been deactivated and cannot be modified."""

    ACCOUNT_NOT_FOUND = "Account not found"
    """Account with given ID does not exist."""

    # -------------------------------------------------------------------------
    # Sync Errors
    # -------------------------------------------------------------------------

    SYNC_FAILED = "Account sync failed"
    """Failed to sync account data from provider."""

    CONNECTION_REQUIRED = "Account must be associated with a connection"
    """Account requires a valid provider connection."""
Attributes
INVALID_ACCOUNT_NAME class-attribute instance-attribute 
INVALID_ACCOUNT_NAME = 'Account name cannot be empty'

Account name is required for display purposes.

INVALID_CURRENCY class-attribute instance-attribute 
INVALID_CURRENCY = 'Invalid ISO 4217 currency code'

Currency must be a valid 3-letter ISO 4217 code.

INVALID_PROVIDER_ACCOUNT_ID class-attribute instance-attribute 
INVALID_PROVIDER_ACCOUNT_ID = (
    "Provider account ID cannot be empty"
)

Provider's unique account identifier is required for sync.

INVALID_ACCOUNT_NUMBER class-attribute instance-attribute 
INVALID_ACCOUNT_NUMBER = (
    "Account number mask cannot be empty"
)

Masked account number is required for display.

CURRENCY_MISMATCH class-attribute instance-attribute 
CURRENCY_MISMATCH = (
    "Cannot perform operation on different currencies"
)

Arithmetic operations require same currency.

INVALID_AMOUNT class-attribute instance-attribute 
INVALID_AMOUNT = 'Amount must be a valid Decimal'

Balance amount must be a valid decimal number.

NEGATIVE_BALANCE_NOT_ALLOWED class-attribute instance-attribute 
NEGATIVE_BALANCE_NOT_ALLOWED = (
    "Balance cannot be negative for this account type"
)

Some account types cannot have negative balances.

ACCOUNT_INACTIVE class-attribute instance-attribute 
ACCOUNT_INACTIVE = 'Account is not active'

Account has been deactivated and cannot be modified.

ACCOUNT_NOT_FOUND class-attribute instance-attribute 
ACCOUNT_NOT_FOUND = 'Account not found'

Account with given ID does not exist.

SYNC_FAILED class-attribute instance-attribute 
SYNC_FAILED = 'Account sync failed'

Failed to sync account data from provider.

CONNECTION_REQUIRED class-attribute instance-attribute 
CONNECTION_REQUIRED = (
    "Account must be associated with a connection"
)

Account requires a valid provider connection.