django-cfg 1.2.23__py3-none-any.whl → 1.2.27__py3-none-any.whl

django_cfg/apps/payments/config/utils.py

@@ -4,12 +4,12 @@ Configuration utility functions.
 Helper functions for working with payment configurations.
 """
 
-from typing import Optional, List, Dict, Any
+from typing import Optional
 import logging
 
 from .module import PaymentsCfgModule
 from .settings import PaymentsSettings
-from .providers import PaymentProviderConfig, NowPaymentsConfig, StripeConfig, CryptAPIConfig
+from django_cfg.models.payments import PaymentProviderConfig
 
 logger = logging.getLogger(__name__)
 
@@ -28,171 +28,25 @@ def get_provider_config(provider_name: str) -> Optional[PaymentProviderConfig]:
     return config.providers.get(provider_name)
 
 
-def get_nowpayments_config() -> Optional[NowPaymentsConfig]:
-    """Get NowPayments configuration."""
-    provider_config = get_provider_config('nowpayments')
-    if isinstance(provider_config, NowPaymentsConfig):
-        return provider_config
-    return None
-
-
-def get_stripe_config() -> Optional[StripeConfig]:
-    """Get Stripe configuration."""
-    provider_config = get_provider_config('stripe')
-    if isinstance(provider_config, StripeConfig):
-        return provider_config
-    return None
-
-
-def get_cryptapi_config() -> Optional[CryptAPIConfig]:
-    """Get CryptAPI configuration."""
-    provider_config = get_provider_config('cryptapi')
-    if isinstance(provider_config, CryptAPIConfig):
-        return provider_config
-    return None
-
-
-
-
 def is_payments_enabled() -> bool:
     """Check if payments module is enabled."""
     try:
         config = get_payments_config()
         return config.enabled
     except Exception as e:
-        logger.warning(f"Error checking payments status: {e}")
-        return False
-
-
-def is_feature_enabled(feature_name: str) -> bool:
-    """Check if specific payment feature is enabled."""
-    try:
-        config = get_payments_config()
-        feature_map = {
-            'crypto_payments': config.enable_crypto_payments,
-            'fiat_payments': config.enable_fiat_payments,
-            'subscriptions': config.enable_subscription_system,
-            'balance': config.enable_balance_system,
-            'api_keys': config.enable_api_key_system,
-            'webhooks': config.enable_webhook_processing,
-        }
-        return feature_map.get(feature_name, False)
-    except Exception as e:
-        logger.warning(f"Error checking feature {feature_name}: {e}")
+        logger.warning(f"Failed to check payments status: {e}")
         return False
 
 
-def get_enabled_providers() -> List[str]:
-    """Get list of enabled payment providers."""
-    try:
-        config = get_payments_config()
-        return [name for name, provider_config in config.providers.items() if provider_config.enabled]
-    except Exception as e:
-        logger.warning(f"Error getting enabled providers: {e}")
-        return []
-
-
-def get_provider_settings(provider_name: str) -> Dict[str, Any]:
-    """Get provider settings as dictionary for service initialization."""
-    try:
-        provider_config = get_provider_config(provider_name)
-        if provider_config:
-            return provider_config.get_config_dict()
-        return {}
-    except Exception as e:
-        logger.error(f"Error getting settings for provider {provider_name}: {e}")
-        return {}
-
-
-def validate_provider_config(provider_name: str) -> bool:
-    """Validate provider configuration."""
-    try:
-        provider_config = get_provider_config(provider_name)
-        if not provider_config:
-            return False
-        
-        # Basic validation - check if API key exists
-        config_dict = provider_config.get_config_dict()
-        return bool(config_dict.get('api_key'))
-        
-    except Exception as e:
-        logger.error(f"Error validating provider {provider_name}: {e}")
-        return False
-
-
-def get_rate_limit_settings() -> Dict[str, int]:
-    """Get rate limiting settings."""
-    try:
-        config = get_payments_config()
-        return {
-            'hourly_limit': config.rate_limits.default_rate_limit_per_hour,
-            'daily_limit': config.rate_limits.default_rate_limit_per_day,
-            'burst_multiplier': config.rate_limits.burst_limit_multiplier,
-            'window_size': config.rate_limits.sliding_window_size,
-        }
-    except Exception as e:
-        logger.warning(f"Error getting rate limit settings: {e}")
-        return {
-            'hourly_limit': 1000,
-            'daily_limit': 10000,
-            'burst_multiplier': 2.0,
-            'window_size': 3600,
-        }
-
-
-def get_cache_settings() -> Dict[str, int]:
-    """Get cache timeout settings."""
-    try:
-        config = get_payments_config()
-        return {
-            'access_check': config.cache.cache_timeout_access_check,
-            'user_balance': config.cache.cache_timeout_user_balance,
-            'subscriptions': config.cache.cache_timeout_subscriptions,
-            'provider_status': config.cache.cache_timeout_provider_status,
-            'currency_rates': config.cache.cache_timeout_currency_rates,
-        }
-    except Exception as e:
-        logger.warning(f"Error getting cache settings: {e}")
-        return {
-            'access_check': 60,
-            'user_balance': 300,
-            'subscriptions': 600,
-            'provider_status': 1800,
-            'currency_rates': 3600,
-        }
-
-
-def get_billing_settings() -> Dict[str, Any]:
-    """Get billing settings."""
-    try:
-        config = get_payments_config()
-        return {
-            'auto_bill': config.billing.auto_bill_subscriptions,
-            'grace_period_hours': config.billing.billing_grace_period_hours,
-            'retry_failed': config.billing.retry_failed_payments,
-            'max_retries': config.billing.max_payment_retries,
-            'min_amount_usd': config.billing.min_payment_amount_usd,
-            'max_amount_usd': config.billing.max_payment_amount_usd,
-        }
-    except Exception as e:
-        logger.warning(f"Error getting billing settings: {e}")
-        return {
-            'auto_bill': True,
-            'grace_period_hours': 24,
-            'retry_failed': True,
-            'max_retries': 3,
-            'min_amount_usd': 1.0,
-            'max_amount_usd': 50000.0,
-        }
-
-
 def reset_config_cache():
-    """Reset configuration cache (useful for testing)."""
+    """Reset configuration cache."""
     global _payments_config
     _payments_config.reset_cache()
 
 
-def reload_config():
-    """Reload configuration from project settings."""
-    reset_config_cache()
-    return get_payments_config()
+__all__ = [
+    'get_payments_config',
+    'get_provider_config', 
+    'is_payments_enabled',
+    'reset_config_cache'
+]

django_cfg/apps/payments/management/__init__.py

@@ -0,0 +1,3 @@
+"""
+Management commands for the payments app.
+"""

django_cfg/apps/payments/management/commands/README.md

@@ -0,0 +1,178 @@
+# Currency Management Commands
+
+Management команды для работы с валютами в Universal Payments System.
+
+## Команды
+
+### 🪙 `populate_currencies` - Первоначальное заполнение
+
+Заполняет пустую базу данных валютами из внешних API (CoinGecko, YFinance).
+
+```bash
+# Быстрое заполнение (50 криптовалют + 20 фиатных)
+python manage.py populate_currencies --quick
+
+# Стандартное заполнение (200 криптовалют + 30 фиатных)
+python manage.py populate_currencies
+
+# Только криптовалюты
+python manage.py populate_currencies --crypto-only
+
+# Только фиатные валюты
+python manage.py populate_currencies --fiat-only
+
+# Пропустить существующие валюты
+python manage.py populate_currencies --skip-existing
+```
+
+### 🔄 `update_currencies` - Обновление курсов
+
+Обновляет курсы валют с внешних API.
+
+```bash
+# Обновить устаревшие курсы (старше 6 часов)
+python manage.py update_currencies
+
+# Принудительно обновить все валюты
+python manage.py update_currencies --force-update
+
+# Сухой прогон (показать что будет обновлено)
+python manage.py update_currencies --dry-run
+
+# Кастомные лимиты
+python manage.py update_currencies --max-crypto 100 --max-fiat 30
+
+# Исключить стейблкоины
+python manage.py update_currencies --exclude-stablecoins
+
+# Подробный вывод
+python manage.py update_currencies --verbose
+```
+
+### 📊 `currency_stats` - Статистика валют
+
+Показывает статистику базы данных валют.
+
+```bash
+# Базовая статистика
+python manage.py currency_stats
+
+# Детальная статистика
+python manage.py currency_stats --detailed
+
+# Показать топ-10 валют
+python manage.py currency_stats --top 10
+
+# Проверить устаревшие курсы
+python manage.py currency_stats --check-rates
+
+# Экспортировать в CSV
+python manage.py currency_stats --export-csv currencies.csv
+```
+
+## Автоматизация
+
+### Cron для регулярного обновления
+
+```bash
+# Обновлять курсы каждые 6 часов
+0 */6 * * * cd /path/to/project && poetry run python manage.py update_currencies
+
+# Ежедневная проверка статистики
+0 9 * * * cd /path/to/project && poetry run python manage.py currency_stats --check-rates
+```
+
+### Docker
+
+```bash
+# В Docker контейнере
+docker exec -it container_name poetry run python manage.py populate_currencies --quick
+docker exec -it container_name poetry run python manage.py update_currencies
+```
+
+## Примеры использования
+
+### Первоначальная настройка
+
+```bash
+# 1. Заполнить базу данных валютами
+python manage.py populate_currencies --quick
+
+# 2. Проверить результат
+python manage.py currency_stats
+```
+
+### Регулярное обслуживание
+
+```bash
+# 1. Обновить курсы
+python manage.py update_currencies --verbose
+
+# 2. Проверить устаревшие курсы
+python manage.py currency_stats --check-rates
+
+# 3. При необходимости - принудительное обновление
+python manage.py update_currencies --force-update
+```
+
+### Production обслуживание
+
+```bash
+# Обновление с минимальными API запросами
+python manage.py update_currencies --max-crypto 50 --max-fiat 20
+
+# Мониторинг состояния
+python manage.py currency_stats --detailed --export-csv daily_report.csv
+```
+
+## Интеграция с django_currency
+
+Команды используют модуль `django_currency.database.database_loader` для:
+
+- ✅ Получения списка валют с CoinGecko
+- ✅ Загрузки курсов фиатных валют с YFinance  
+- ✅ Rate limiting для защиты от API throttling
+- ✅ Кэширования для оптимизации производительности
+- ✅ Pydantic валидации для типобезопасности
+
+## Конфигурация
+
+Настройки в `DatabaseLoaderConfig`:
+
+```python
+config = DatabaseLoaderConfig(
+    max_cryptocurrencies=500,        # Максимум криптовалют
+    max_fiat_currencies=50,          # Максимум фиатных валют  
+    min_market_cap_usd=1_000_000,    # Минимальная капитализация
+    coingecko_delay=1.5,             # Задержка между запросами
+    yfinance_delay=0.5,              # Задержка для YFinance
+    exclude_stablecoins=False,       # Исключить стейблкоины
+    cache_ttl_hours=24               # TTL кэша в часах
+)
+```
+
+## Мониторинг
+
+### Логи
+
+Команды логируют в `django_cfg.apps.payments.management.commands`:
+
+```python
+import logging
+logger = logging.getLogger('django_cfg.apps.payments.management.commands')
+```
+
+### Метрики
+
+- Количество созданных/обновленных валют
+- Время выполнения API запросов
+- Ошибки валидации и API
+- Статистика курсов валют
+
+## Безопасность
+
+- ✅ Rate limiting для API запросов
+- ✅ Atomic транзакции для консистентности
+- ✅ Graceful handling ошибок API
+- ✅ Валидация данных с Pydantic
+- ✅ Rollback при критических ошибках

django_cfg/apps/payments/management/commands/__init__.py

@@ -0,0 +1,3 @@
+"""
+Management commands directory.
+"""