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

django_cfg/apps/payments/views/overview/services.py

@@ -3,19 +3,18 @@
 
 Services for aggregating payments dashboard data from existing models.
 """
-from django.db.models import Count, Sum, Avg, Q, Max
+from datetime import timedelta
+from typing import Any, Dict, List, Optional
+
+from django.db.models import Avg, Count, Max, Q, Sum
 from django.utils import timezone
-from datetime import timedelta, date
-from decimal import Decimal
-from typing import Dict, List, Any, Optional
 
 from ...models import (
+    APIKey,
+    Subscription,
+    Transaction,
     UniversalPayment,
     UserBalance,
-    Transaction,
-    Subscription,
-    EndpointGroup,
-    APIKey,
 )
 
 
@@ -23,7 +22,7 @@ class PaymentsDashboardMetricsService:
     """
     Service for calculating payments dashboard metrics
     """
-    
+
     def __init__(self, user):
         self.user = user
         self.now = timezone.now()
@@ -31,7 +30,7 @@ class PaymentsDashboardMetricsService:
         self.month_start = self.today.replace(day=1)
         self.last_month_start = (self.month_start - timedelta(days=1)).replace(day=1)
         self.last_month_end = self.month_start - timedelta(days=1)
-    
+
     def get_dashboard_metrics(self) -> Dict[str, Any]:
         """
         Get complete payments dashboard metrics
@@ -42,13 +41,13 @@ class PaymentsDashboardMetricsService:
             'api_keys': self.get_api_keys_overview(),
             'payments': self.get_payments_overview(),
         }
-    
+
     def get_balance_overview(self) -> Dict[str, Any]:
         """
         Get user balance overview using manager methods
         """
         balance = UserBalance.objects.get_or_create_for_user(self.user)
-        
+
         return {
             'current_balance': balance.balance_usd,
             'balance_display': balance.balance_display,
@@ -58,20 +57,20 @@ class PaymentsDashboardMetricsService:
             'has_transactions': balance.has_transactions,
             'is_empty': balance.is_empty,
         }
-    
+
     def get_subscription_overview(self) -> Optional[Dict[str, Any]]:
         """
         Get current subscription overview using manager methods
         """
         subscription = Subscription.objects.get_active_for_user(self.user)
-        
+
         if not subscription:
             return None
-        
+
         # Get endpoint groups info
         endpoint_groups = subscription.endpoint_groups.filter(is_enabled=True)
         endpoint_groups_names = list(endpoint_groups.values_list('name', flat=True))
-        
+
         return {
             'tier': subscription.tier,
             'tier_display': subscription.tier_display,
@@ -81,55 +80,55 @@ class PaymentsDashboardMetricsService:
             'is_active': subscription.is_active,
             'is_expired': subscription.is_expired,
             'days_remaining': subscription.days_remaining,
-            
+
             # Limits and usage
             'requests_per_hour': subscription.requests_per_hour,
             'requests_per_day': subscription.requests_per_day,
             'total_requests': subscription.total_requests,
             'usage_percentage': subscription.usage_percentage,
-            
+
             # Billing
             'monthly_cost_usd': subscription.monthly_cost_usd,
             'cost_display': f"${subscription.monthly_cost_usd:.2f}/month",
-            
+
             # Dates
             'starts_at': subscription.starts_at,
             'expires_at': subscription.expires_at,
             'last_request_at': subscription.last_request_at,
-            
+
             # Access
             'endpoint_groups_count': endpoint_groups.count(),
             'endpoint_groups': endpoint_groups_names,
         }
-    
+
     def get_api_keys_overview(self) -> Dict[str, Any]:
         """
         Get API keys overview using manager methods
         """
         api_keys = APIKey.objects.by_user(self.user)
-        
+
         total_keys = api_keys.count()
         active_keys = api_keys.active().count()
         expired_keys = api_keys.expired().count()
-        
+
         # Total requests across all keys
         total_requests = api_keys.aggregate(
             total=Sum('total_requests')
         )['total'] or 0
-        
+
         # Last used timestamp
         last_used_at = api_keys.aggregate(
             last_used=Max('last_used_at')
         )['last_used']
-        
+
         # Most used key
         most_used_key = api_keys.order_by('-total_requests').first()
         most_used_key_name = most_used_key.name if most_used_key else None
         most_used_key_requests = most_used_key.total_requests if most_used_key else 0
-        
+
         # Keys expiring soon (within 7 days)
         expiring_soon = api_keys.expiring_soon(7).count()
-        
+
         return {
             'total_keys': total_keys,
             'active_keys': active_keys,
@@ -140,59 +139,59 @@ class PaymentsDashboardMetricsService:
             'most_used_key_requests': most_used_key_requests,
             'expiring_soon_count': expiring_soon,
         }
-    
+
     def get_payments_overview(self) -> Dict[str, Any]:
         """
         Get payments overview using manager methods
         """
         payments = UniversalPayment.objects.by_user(self.user)
-        
+
         # Basic counts using manager methods
         total_payments = payments.count()
         completed_payments = payments.completed().count()
         pending_payments = payments.pending().count()
         failed_payments = payments.failed().count()
-        
+
         # Amount calculations
         total_amount_usd = payments.total_amount()
         completed_amount_usd = payments.completed().total_amount()
         average_payment_usd = payments.average_amount()
-        
+
         # Success rate
         success_rate = (completed_payments / total_payments * 100) if total_payments > 0 else 0.0
-        
+
         # Recent activity
         last_payment = payments.order_by('-created_at').first()
         last_payment_at = last_payment.created_at if last_payment else None
-        
+
         # This month stats using manager methods
         payments_this_month = payments.this_month().count()
         amount_this_month = payments.this_month().total_amount()
-        
+
         # Top currency
         top_currency_data = payments.values('currency__code').annotate(
             count=Count('id')
         ).order_by('-count').first()
-        
+
         top_currency = top_currency_data['currency__code'] if top_currency_data else None
         top_currency_count = top_currency_data['count'] if top_currency_data else 0
-        
+
         return {
             'total_payments': total_payments,
             'completed_payments': completed_payments,
             'pending_payments': pending_payments,
             'failed_payments': failed_payments,
-            
+
             'total_amount_usd': total_amount_usd,
             'completed_amount_usd': completed_amount_usd,
             'average_payment_usd': average_payment_usd,
-            
+
             'success_rate': round(success_rate, 2),
-            
+
             'last_payment_at': last_payment_at,
             'payments_this_month': payments_this_month,
             'amount_this_month': amount_this_month,
-            
+
             'top_currency': top_currency,
             'top_currency_count': top_currency_count,
         }
@@ -202,10 +201,10 @@ class PaymentsUsageChartService:
     """
     Service for generating payments usage chart data
     """
-    
+
     def __init__(self, user):
         self.user = user
-    
+
     def get_chart_data(self, period: str = '30d') -> Dict[str, Any]:
         """
         Get chart data for payments analytics
@@ -216,10 +215,10 @@ class PaymentsUsageChartService:
             '90d': 90,
             '1y': 365
         }
-        
+
         days = days_map.get(period, 30)
         start_date = timezone.now().date() - timedelta(days=days)
-        
+
         # Get payments for the period using manager methods
         payments = UniversalPayment.objects.by_user(self.user).filter(
             created_at__date__gte=start_date
@@ -243,37 +242,37 @@ class PaymentsUsageChartService:
                 ])
             )
         ).order_by('created_at__date')
-        
+
         # Generate chart series data
         amounts_data = []
         completed_data = []
         failed_data = []
-        
+
         # Create data points for each day
         for i in range(days):
             current_date = start_date + timedelta(days=i)
             date_str = current_date.strftime('%Y-%m-%d')
-            
+
             # Find payments for this date
             day_data = next(
                 (p for p in payments if p['created_at__date'] == current_date),
                 None
             )
-            
+
             total_amount = day_data['total_amount'] if day_data and day_data['total_amount'] is not None else 0.0
             completed_amount = day_data['completed_amount'] if day_data and day_data['completed_amount'] is not None else 0.0
             failed_count = day_data['failed_count'] if day_data else 0
-            
+
             amounts_data.append({'x': date_str, 'y': total_amount})
             completed_data.append({'x': date_str, 'y': completed_amount})
             failed_data.append({'x': date_str, 'y': failed_count})
-        
+
         # Calculate totals
         total_amount = sum(p['y'] for p in amounts_data)
         total_payments = sum(1 for p in amounts_data if p['y'] > 0)
         completed_amount = sum(p['y'] for p in completed_data)
         success_rate = (completed_amount / total_amount * 100) if total_amount > 0 else 0.0
-        
+
         return {
             'series': [
                 {
@@ -303,16 +302,16 @@ class RecentPaymentsService:
     """
     Service for getting recent payments and transactions
     """
-    
+
     def __init__(self, user):
         self.user = user
-    
+
     def get_recent_payments(self, limit: int = 10) -> List[Dict[str, Any]]:
         """
         Get recent payments for the user using manager methods
         """
         payments = UniversalPayment.objects.by_user(self.user).optimized().order_by('-created_at')[:limit]
-        
+
         result = []
         for payment in payments:
             result.append({
@@ -327,21 +326,21 @@ class RecentPaymentsService:
                 'provider': payment.provider,
                 'created_at': payment.created_at,
                 'completed_at': payment.completed_at,
-                
+
                 # Status flags
                 'is_pending': payment.is_pending,
                 'is_completed': payment.is_completed,
                 'is_failed': payment.is_failed,
             })
-        
+
         return result
-    
+
     def get_recent_transactions(self, limit: int = 10) -> List[Dict[str, Any]]:
         """
         Get recent transactions for the user using manager methods
         """
         transactions = Transaction.objects.by_user(self.user).optimized().order_by('-created_at')[:limit]
-        
+
         result = []
         for transaction in transactions:
             result.append({
@@ -353,13 +352,13 @@ class RecentPaymentsService:
                 'description': transaction.description,
                 'created_at': transaction.created_at,
                 'payment_id': transaction.payment_id,
-                
+
                 # Type info
                 'is_credit': transaction.is_credit,
                 'is_debit': transaction.is_debit,
                 'type_color': transaction.type_color,
             })
-        
+
         return result
 
 
@@ -367,10 +366,10 @@ class PaymentsAnalyticsService:
     """
     Service for payments analytics and insights
     """
-    
+
     def __init__(self, user):
         self.user = user
-    
+
     def get_payment_analytics(self, limit: int = 10) -> List[Dict[str, Any]]:
         """
         Get payment analytics by currency, provider, etc.
@@ -391,7 +390,7 @@ class PaymentsAnalyticsService:
                 filter=Q(status=UniversalPayment.PaymentStatus.COMPLETED)
             ) * 100.0 / Count('id')
         ).order_by('-total_amount')[:limit]
-        
+
         result = []
         for stat in currency_stats:
             result.append({
@@ -403,9 +402,9 @@ class PaymentsAnalyticsService:
                 'average_amount': stat['avg_amount'] or 0.0,
                 'success_rate': round(stat['success_rate'] or 0.0, 2),
             })
-        
+
         return result
-    
+
     def get_provider_analytics(self) -> List[Dict[str, Any]]:
         """
         Get analytics by payment provider
@@ -422,7 +421,7 @@ class PaymentsAnalyticsService:
                 filter=Q(status=UniversalPayment.PaymentStatus.COMPLETED)
             ) * 100.0 / Count('id')
         ).order_by('-total_payments')
-        
+
         result = []
         for stat in provider_stats:
             result.append({
@@ -435,5 +434,5 @@ class PaymentsAnalyticsService:
                 'completed_payments': stat['completed_payments'],
                 'success_rate': round(stat['success_rate'] or 0.0, 2),
             })
-        
+
         return result

django_cfg/apps/payments/views/overview/urls.py

@@ -4,6 +4,7 @@
 Nested router configuration for payments dashboard API endpoints.
 """
 from rest_framework.routers import DefaultRouter
+
 from .views import PaymentsDashboardViewSet
 
 # Create router
@@ -17,7 +18,7 @@ urlpatterns = router.urls
 
 # Available endpoints:
 # GET /api/payments/overview/dashboard/overview/ - Complete payments dashboard overview
-# GET /api/payments/overview/dashboard/metrics/ - Payments dashboard metrics only  
+# GET /api/payments/overview/dashboard/metrics/ - Payments dashboard metrics only
 # GET /api/payments/overview/dashboard/chart_data/?period=30d - Payments chart data
 # GET /api/payments/overview/dashboard/recent_payments/?limit=10 - Recent payments
 # GET /api/payments/overview/dashboard/recent_transactions/?limit=10 - Recent transactions

django_cfg/apps/payments/views/overview/views.py

@@ -3,30 +3,30 @@
 
 API views for payments dashboard data using existing models.
 """
-from rest_framework import viewsets, status
+from drf_spectacular.openapi import OpenApiParameter
+from drf_spectacular.utils import extend_schema, extend_schema_view
+from rest_framework import status, viewsets
 from rest_framework.decorators import action
-from rest_framework.response import Response
 from rest_framework.permissions import IsAuthenticated
-from drf_spectacular.utils import extend_schema, extend_schema_view
-from drf_spectacular.openapi import OpenApiParameter
+from rest_framework.response import Response
 
-from .services import (
-    PaymentsDashboardMetricsService,
-    PaymentsUsageChartService,
-    RecentPaymentsService,
-    PaymentsAnalyticsService,
-)
 from .serializers import (
+    APIKeysOverviewSerializer,
+    BalanceOverviewSerializer,
+    PaymentAnalyticsResponseSerializer,
+    PaymentsChartResponseSerializer,
     PaymentsDashboardOverviewSerializer,
     PaymentsMetricsSerializer,
-    PaymentsChartResponseSerializer,
-    TimePeriodSerializer,
     RecentPaymentSerializer,
     RecentTransactionSerializer,
-    BalanceOverviewSerializer,
     SubscriptionOverviewSerializer,
-    APIKeysOverviewSerializer,
-    PaymentAnalyticsResponseSerializer,
+    TimePeriodSerializer,
+)
+from .services import (
+    PaymentsAnalyticsService,
+    PaymentsDashboardMetricsService,
+    PaymentsUsageChartService,
+    RecentPaymentsService,
 )
 
 
@@ -119,7 +119,7 @@ class PaymentsDashboardViewSet(viewsets.GenericViewSet):
     Payments dashboard data endpoints
     """
     permission_classes = [IsAuthenticated]
-    
+
     @action(detail=False, methods=['get'])
     def overview(self, request):
         """
@@ -129,7 +129,7 @@ class PaymentsDashboardViewSet(viewsets.GenericViewSet):
         metrics_service = PaymentsDashboardMetricsService(request.user)
         chart_service = PaymentsUsageChartService(request.user)
         payments_service = RecentPaymentsService(request.user)
-        
+
         # Get all data
         data = {
             'metrics': metrics_service.get_dashboard_metrics(),
@@ -137,9 +137,9 @@ class PaymentsDashboardViewSet(viewsets.GenericViewSet):
             'recent_transactions': payments_service.get_recent_transactions(limit=10),
             'chart_data': chart_service.get_chart_data(period='30d')
         }
-        
+
         return Response(data)
-    
+
     @action(detail=False, methods=['get'])
     def metrics(self, request):
         """
@@ -148,23 +148,23 @@ class PaymentsDashboardViewSet(viewsets.GenericViewSet):
         service = PaymentsDashboardMetricsService(request.user)
         metrics = service.get_dashboard_metrics()
         return Response(metrics)
-    
+
     @action(detail=False, methods=['get'])
     def chart_data(self, request):
         """
         Get payments usage chart data
         """
         period = request.query_params.get('period', '30d')
-        
+
         # Validate period
         serializer = TimePeriodSerializer(data={'period': period})
         if not serializer.is_valid():
             return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)
-        
+
         service = PaymentsUsageChartService(request.user)
         data = service.get_chart_data(period)
         return Response(data)
-    
+
     @action(detail=False, methods=['get'])
     def recent_payments(self, request):
         """
@@ -172,11 +172,11 @@ class PaymentsDashboardViewSet(viewsets.GenericViewSet):
         """
         limit = int(request.query_params.get('limit', 10))
         limit = min(limit, 50)  # Max 50 payments
-        
+
         service = RecentPaymentsService(request.user)
         payments = service.get_recent_payments(limit)
         return Response(payments)
-    
+
     @action(detail=False, methods=['get'])
     def recent_transactions(self, request):
         """
@@ -184,11 +184,11 @@ class PaymentsDashboardViewSet(viewsets.GenericViewSet):
         """
         limit = int(request.query_params.get('limit', 10))
         limit = min(limit, 50)  # Max 50 transactions
-        
+
         service = RecentPaymentsService(request.user)
         transactions = service.get_recent_transactions(limit)
         return Response(transactions)
-    
+
     @action(detail=False, methods=['get'])
     def payment_analytics(self, request):
         """
@@ -196,14 +196,14 @@ class PaymentsDashboardViewSet(viewsets.GenericViewSet):
         """
         limit = int(request.query_params.get('limit', 10))
         limit = min(limit, 20)  # Max 20 analytics items
-        
+
         service = PaymentsAnalyticsService(request.user)
         analytics = {
             'currency_analytics': service.get_payment_analytics(limit),
             'provider_analytics': service.get_provider_analytics(),
         }
         return Response(analytics)
-    
+
     @action(detail=False, methods=['get'])
     def balance_overview(self, request):
         """
@@ -212,7 +212,7 @@ class PaymentsDashboardViewSet(viewsets.GenericViewSet):
         service = PaymentsDashboardMetricsService(request.user)
         balance = service.get_balance_overview()
         return Response(balance)
-    
+
     @action(detail=False, methods=['get'])
     def subscription_overview(self, request):
         """
@@ -221,7 +221,7 @@ class PaymentsDashboardViewSet(viewsets.GenericViewSet):
         service = PaymentsDashboardMetricsService(request.user)
         subscription = service.get_subscription_overview()
         return Response(subscription)
-    
+
     @action(detail=False, methods=['get'])
     def api_keys_overview(self, request):
         """