django-cfg 1.4.21__py3-none-any.whl → 1.4.23__py3-none-any.whl

django_cfg/apps/payments/models/balance.py

@@ -4,11 +4,11 @@ Balance and transaction models for the Universal Payment System v2.0.
 Handles user balances and transaction history with atomic operations.
 """
 
-from django.db import models, transaction
 from django.contrib.auth import get_user_model
-from django.core.validators import MinValueValidator
 from django.core.exceptions import ValidationError
-from django.utils import timezone
+from django.core.validators import MinValueValidator
+from django.db import models
+
 from .base import UUIDTimestampedModel
 
 User = get_user_model()
@@ -21,53 +21,53 @@ class UserBalance(models.Model):
     Tracks user balance in USD (float for performance as per requirements).
     All balance updates are handled via Django signals for consistency.
     """
-    
+
     user = models.OneToOneField(
         User,
         on_delete=models.CASCADE,
         related_name='payment_balance',
         help_text="User who owns this balance"
     )
-    
+
     balance_usd = models.FloatField(
         default=0.0,
         validators=[MinValueValidator(0.0)],
         help_text="Current balance in USD (float for performance)"
     )
-    
+
     reserved_usd = models.FloatField(
         default=0.0,
         validators=[MinValueValidator(0.0)],
         help_text="Reserved amount in USD (pending transactions)"
     )
-    
+
     # Tracking fields
     total_deposited = models.FloatField(
         default=0.0,
         validators=[MinValueValidator(0.0)],
         help_text="Total amount deposited (lifetime)"
     )
-    
+
     total_spent = models.FloatField(
         default=0.0,
         validators=[MinValueValidator(0.0)],
         help_text="Total amount spent (lifetime)"
     )
-    
+
     last_transaction_at = models.DateTimeField(
         null=True,
         blank=True,
         help_text="When the last transaction occurred"
     )
-    
+
     # Timestamps
     created_at = models.DateTimeField(auto_now_add=True)
     updated_at = models.DateTimeField(auto_now=True)
-    
+
     # Manager
     from .managers.balance_managers import UserBalanceManager
     objects = UserBalanceManager()
-    
+
     class Meta:
         db_table = 'payments_user_balances'
         verbose_name = 'User Balance'
@@ -86,46 +86,46 @@ class UserBalance(models.Model):
                 name='reserved_non_negative_check'
             ),
         ]
-    
+
     def __str__(self):
         return f"{self.user.username}: ${self.balance_usd:.2f}"
-    
+
     def clean(self):
         """Validate balance data."""
         if self.balance_usd < 0:
             raise ValidationError("Balance cannot be negative")
         if self.reserved_usd < 0:
             raise ValidationError("Reserved amount cannot be negative")
-    
+
     @property
     def balance_display(self) -> str:
         """Formatted balance display."""
         return f"${self.balance_usd:.2f} USD"
-    
+
     @property
     def is_empty(self) -> bool:
         """Check if balance is zero."""
         return self.balance_usd == 0.0
-    
+
     @property
     def has_transactions(self) -> bool:
         """Check if user has any transactions."""
         return self.last_transaction_at is not None
-    
-    def add_funds(self, amount: float, transaction_type: str = 'deposit', 
+
+    def add_funds(self, amount: float, transaction_type: str = 'deposit',
                   description: str = None, payment_id: str = None) -> 'Transaction':
         """Add funds to balance (delegates to manager)."""
         return self.__class__.objects.add_funds_to_user(
             self.user, amount, transaction_type, description, payment_id
         )
-    
+
     def subtract_funds(self, amount: float, transaction_type: str = 'withdrawal',
                       description: str = None, payment_id: str = None) -> 'Transaction':
         """Subtract funds from balance (delegates to manager)."""
         return self.__class__.objects.subtract_funds_from_user(
             self.user, amount, transaction_type, description, payment_id
         )
-    
+
     @classmethod
     def get_or_create_for_user(cls, user: User) -> 'UserBalance':
         """Get or create balance for user (delegates to manager)."""
@@ -140,7 +140,7 @@ class Transaction(UUIDTimestampedModel):
     
     Immutable record of all balance changes with full audit trail.
     """
-    
+
     class TransactionType(models.TextChoices):
         DEPOSIT = "deposit", "Deposit"
         WITHDRAWAL = "withdrawal", "Withdrawal"
@@ -149,30 +149,30 @@ class Transaction(UUIDTimestampedModel):
         FEE = "fee", "Fee"
         BONUS = "bonus", "Bonus"
         ADJUSTMENT = "adjustment", "Adjustment"
-    
+
     user = models.ForeignKey(
         User,
         on_delete=models.CASCADE,
         related_name='payment_transactions',
         help_text="User who owns this transaction"
     )
-    
+
     transaction_type = models.CharField(
         max_length=20,
         choices=TransactionType.choices,
         help_text="Type of transaction"
     )
-    
+
     # Amount in USD (float for performance, positive for credits, negative for debits)
     amount_usd = models.FloatField(
         help_text="Transaction amount in USD (positive=credit, negative=debit)"
     )
-    
+
     balance_after = models.FloatField(
         validators=[MinValueValidator(0.0)],
         help_text="User balance after this transaction"
     )
-    
+
     # Reference to related payment
     payment_id = models.CharField(
         max_length=100,
@@ -181,23 +181,23 @@ class Transaction(UUIDTimestampedModel):
         db_index=True,
         help_text="Related payment ID (if applicable)"
     )
-    
+
     # Transaction details
     description = models.TextField(
         help_text="Transaction description"
     )
-    
+
     # Metadata for additional information
     metadata = models.JSONField(
         default=dict,
         blank=True,
         help_text="Additional transaction metadata"
     )
-    
+
     # Manager
     from .managers.balance_managers import TransactionManager
     objects = TransactionManager()
-    
+
     class Meta:
         db_table = 'payments_transactions'
         verbose_name = 'Transaction'
@@ -209,32 +209,32 @@ class Transaction(UUIDTimestampedModel):
             models.Index(fields=['payment_id']),
             models.Index(fields=['amount_usd']),
         ]
-    
+
     def __str__(self):
         sign = "+" if self.amount_usd >= 0 else ""
         return f"{self.user.username}: {sign}${self.amount_usd:.2f} ({self.transaction_type})"
-    
+
     def clean(self):
         """Validate transaction data."""
         if self.balance_after < 0:
             raise ValidationError("Balance after transaction cannot be negative")
-    
+
     @property
     def is_credit(self) -> bool:
         """Check if this is a credit transaction."""
         return self.amount_usd > 0
-    
+
     @property
     def is_debit(self) -> bool:
         """Check if this is a debit transaction."""
         return self.amount_usd < 0
-    
+
     @property
     def amount_display(self) -> str:
         """Formatted amount display."""
         sign = "+" if self.amount_usd >= 0 else ""
         return f"{sign}${abs(self.amount_usd):.2f}"
-    
+
     @property
     def type_color(self) -> str:
         """Get color for transaction type display."""
@@ -248,7 +248,7 @@ class Transaction(UUIDTimestampedModel):
             self.TransactionType.ADJUSTMENT: 'secondary',
         }
         return colors.get(self.transaction_type, 'secondary')
-    
+
     def save(self, *args, **kwargs):
         """Override save to ensure immutability."""
         # Only prevent updates, not creation

django_cfg/apps/payments/models/base.py

@@ -5,6 +5,7 @@ Provides common functionality for all payment-related models.
 """
 
 import uuid
+
 from django.db import models
 from django.utils import timezone
 
@@ -18,42 +19,42 @@ class UUIDTimestampedModel(models.Model):
     - Created/updated timestamps with timezone awareness
     - Common functionality for all payment models
     """
-    
+
     id = models.UUIDField(
         primary_key=True,
         default=uuid.uuid4,
         editable=False,
         help_text="Unique identifier for this record"
     )
-    
+
     created_at = models.DateTimeField(
         auto_now_add=True,
         db_index=True,
         help_text="When this record was created"
     )
-    
+
     updated_at = models.DateTimeField(
         auto_now=True,
         help_text="When this record was last updated"
     )
-    
+
     class Meta:
         abstract = True
         ordering = ['-created_at']
-    
+
     def __str__(self):
         """String representation showing ID and creation time."""
         return f"{self.__class__.__name__}({str(self.id)[:8]}...)"
-    
+
     def __repr__(self):
         """Developer-friendly representation."""
         return f"<{self.__class__.__name__}: {str(self.id)}>"
-    
+
     @property
     def age_in_seconds(self) -> int:
         """Get age of this record in seconds."""
         return int((timezone.now() - self.created_at).total_seconds())
-    
+
     @property
     def is_recent(self) -> bool:
         """Check if record was created in the last hour."""
@@ -66,18 +67,18 @@ class TimestampedModel(models.Model):
     
     Use this for models that don't need UUID (like configuration models).
     """
-    
+
     created_at = models.DateTimeField(
         auto_now_add=True,
         db_index=True,
         help_text="When this record was created"
     )
-    
+
     updated_at = models.DateTimeField(
         auto_now=True,
         help_text="When this record was last updated"
     )
-    
+
     class Meta:
         abstract = True
         ordering = ['-created_at']

django_cfg/apps/payments/models/currencies.py

@@ -4,9 +4,10 @@ Currency models for the Universal Payment System v2.0.
 Handles multi-provider currency support with integration to django_currency module.
 """
 
-from django.db import models
-from django.core.validators import MinLengthValidator, MaxLengthValidator
 from django.core.exceptions import ValidationError
+from django.core.validators import MaxLengthValidator, MinLengthValidator
+from django.db import models
+
 from .base import TimestampedModel
 
 
@@ -16,67 +17,67 @@ class Currency(TimestampedModel):
     
     Integrates with django_currency module for rate conversion.
     """
-    
+
     class CurrencyType(models.TextChoices):
         FIAT = "fiat", "Fiat Currency"
         CRYPTO = "crypto", "Cryptocurrency"
-    
+
     code = models.CharField(
         max_length=10,
         unique=True,
         validators=[MinLengthValidator(3), MaxLengthValidator(10)],
         help_text="Currency code (e.g., BTC, USD, ETH)"
     )
-    
+
     name = models.CharField(
         max_length=100,
         help_text="Full currency name (e.g., Bitcoin, US Dollar)"
     )
-    
+
     currency_type = models.CharField(
         max_length=10,
         choices=CurrencyType.choices,
         help_text="Type of currency"
     )
-    
+
     symbol = models.CharField(
         max_length=10,
         blank=True,
         help_text="Currency symbol (e.g., $, ₿, Ξ)"
     )
-    
+
     decimal_places = models.PositiveSmallIntegerField(
         default=8,
         help_text="Number of decimal places for this currency"
     )
-    
+
     is_active = models.BooleanField(
         default=True,
         help_text="Whether this currency is available for payments"
     )
-    
+
     # Integration with django_currency
     exchange_rate_source = models.CharField(
         max_length=50,
         blank=True,
         help_text="Source for exchange rates (auto-detected by django_currency)"
     )
-    
+
     usd_rate = models.FloatField(
         default=1.0,
         help_text="Current USD exchange rate (1 unit = X USD)"
     )
-    
+
     usd_rate_updated_at = models.DateTimeField(
         null=True,
         blank=True,
         help_text="When USD rate was last updated"
     )
-    
+
     # Manager
     from .managers.currency_managers import CurrencyManager
     objects = CurrencyManager()
-    
+
     class Meta:
         db_table = 'payments_currencies'
         verbose_name = 'Currency'
@@ -86,32 +87,32 @@ class Currency(TimestampedModel):
             models.Index(fields=['currency_type', 'is_active']),
             models.Index(fields=['code']),
         ]
-    
+
     def __str__(self):
         return f"{self.code} ({self.name})"
-    
+
     def clean(self):
         """Validate currency data."""
         if self.code:
             self.code = self.code.upper()
-        
+
         # Validate decimal places based on currency type
         if self.currency_type == self.CurrencyType.FIAT and self.decimal_places > 4:
             raise ValidationError("Fiat currencies should not have more than 4 decimal places")
-        
+
         if self.currency_type == self.CurrencyType.CRYPTO and self.decimal_places > 18:
             raise ValidationError("Crypto currencies should not have more than 18 decimal places")
-    
+
     @property
     def is_crypto(self) -> bool:
         """Check if this is a cryptocurrency."""
         return self.currency_type == self.CurrencyType.CRYPTO
-    
+
     @property
     def is_fiat(self) -> bool:
         """Check if this is a fiat currency."""
         return self.currency_type == self.CurrencyType.FIAT
-    
+
     def get_provider_config(self, provider: str):
         """
         Get provider configuration for this currency.
@@ -123,7 +124,7 @@ class Currency(TimestampedModel):
             dict: Provider configuration or None
         """
         return Currency.objects.get_provider_config(self.code, provider)
-    
+
 
 
 class Network(TimestampedModel):
@@ -132,47 +133,47 @@ class Network(TimestampedModel):
     
     Represents different networks like Ethereum, Bitcoin, Polygon, etc.
     """
-    
+
     name = models.CharField(
         max_length=50,
         unique=True,
         help_text="Network name (e.g., Ethereum, Bitcoin, Polygon)"
     )
-    
+
     code = models.CharField(
         max_length=20,
         unique=True,
         help_text="Network code (e.g., ETH, BTC, MATIC)"
     )
-    
+
     native_currency = models.ForeignKey(
         Currency,
         on_delete=models.PROTECT,
         related_name='native_networks',
         help_text="Native currency of this network"
     )
-    
+
     block_explorer_url = models.URLField(
         blank=True,
         help_text="Block explorer URL template (use {tx} for transaction hash)"
     )
-    
+
     is_active = models.BooleanField(
         default=True,
         help_text="Whether this network is available for payments"
     )
-    
+
     # Network-specific settings
     confirmation_blocks = models.PositiveIntegerField(
         default=1,
         help_text="Number of confirmations required for this network"
     )
-    
+
     average_block_time = models.PositiveIntegerField(
         default=600,  # 10 minutes in seconds
         help_text="Average block time in seconds"
     )
-    
+
     class Meta:
         db_table = 'payments_networks'
         verbose_name = 'Network'
@@ -182,15 +183,15 @@ class Network(TimestampedModel):
             models.Index(fields=['is_active']),
             models.Index(fields=['code']),
         ]
-    
+
     def __str__(self):
         return f"{self.name} ({self.code})"
-    
+
     def clean(self):
         """Validate network data."""
         if self.code:
             self.code = self.code.upper()
-    
+
     @property
     def estimated_confirmation_time(self) -> int:
         """Estimated time for confirmations in seconds."""
@@ -203,18 +204,18 @@ class ProviderCurrency(TimestampedModel):
     
     Maps currencies to specific providers and networks.
     """
-    
+
     provider = models.CharField(
         max_length=50,
         help_text="Payment provider name (e.g., nowpayments)"
     )
-    
+
     currency = models.ForeignKey(
         Currency,
         on_delete=models.CASCADE,
         related_name='provider_configs'
     )
-    
+
     network = models.ForeignKey(
         Network,
         on_delete=models.CASCADE,
@@ -223,22 +224,22 @@ class ProviderCurrency(TimestampedModel):
         blank=True,
         help_text="Network for crypto currencies (null for fiat)"
     )
-    
+
     # Provider-specific settings
     provider_currency_code = models.CharField(
         max_length=20,
         help_text="Currency code as used by the provider"
     )
-    
+
 # min_amount and max_amount removed - now provided by provider configuration properties
-    
+
     is_enabled = models.BooleanField(
         default=True,
         help_text="Whether this currency is enabled for this provider"
     )
-    
+
     # Fee configuration removed - now provided by provider configuration properties
-    
+
     class Meta:
         db_table = 'payments_provider_currencies'
         verbose_name = 'Provider Currency'
@@ -249,29 +250,29 @@ class ProviderCurrency(TimestampedModel):
             models.Index(fields=['provider', 'is_enabled']),
             models.Index(fields=['currency', 'is_enabled']),
         ]
-    
+
     def __str__(self):
         network_part = f" ({self.network.code})" if self.network else ""
         return f"{self.provider}: {self.currency.code}{network_part}"
-    
+
     def clean(self):
         """Validate provider currency configuration."""
         # Crypto currencies must have a network
         if self.currency and self.currency.is_crypto and not self.network:
             raise ValidationError("Crypto currencies must specify a network")
-        
+
         # Fiat currencies should not have a network
         if self.currency and self.currency.is_fiat and self.network:
             raise ValidationError("Fiat currencies should not specify a network")
-        
+
         # Amount limits validation removed - now handled by provider configuration
-    
+
     @property
     def display_name(self) -> str:
         """Human-readable display name."""
         network_part = f" on {self.network.name}" if self.network else ""
         return f"{self.currency.name}{network_part}"
-    
+
     # Provider configuration properties (get values from provider config)
     @property
     def provider_fee_percentage(self) -> float:
@@ -285,7 +286,7 @@ class ProviderCurrency(TimestampedModel):
             return 0.005  # Default 0.5%
         except Exception:
             return 0.005  # Default fallback
-    
+
     @property
     def provider_fixed_fee_usd(self) -> float:
         """Get fixed fee from provider configuration."""
@@ -298,7 +299,7 @@ class ProviderCurrency(TimestampedModel):
             return 0.0  # Default no fee
         except Exception:
             return 0.0  # Default fallback
-    
+
     @property
     def provider_min_amount_usd(self) -> float:
         """Get minimum amount from provider configuration."""
@@ -311,7 +312,7 @@ class ProviderCurrency(TimestampedModel):
             return 0.000001  # Default minimum
         except Exception:
             return 0.000001  # Default fallback
-    
+
     @property
     def provider_max_amount_usd(self) -> float:
         """Get maximum amount from provider configuration."""
@@ -324,7 +325,7 @@ class ProviderCurrency(TimestampedModel):
             return 1000000.0  # Default maximum
         except Exception:
             return 1000000.0  # Default fallback
-    
+
     @property
     def provider_confirmation_blocks(self) -> int:
         """Get confirmation blocks from provider configuration."""
@@ -337,7 +338,7 @@ class ProviderCurrency(TimestampedModel):
             return 1  # Default
         except Exception:
             return 1  # Default fallback
-    
+
     @property
     def provider_network_name(self) -> str:
         """Get network name from provider configuration."""