django-cfg 1.3.7__py3-none-any.whl → 1.3.11__py3-none-any.whl

django_cfg/apps/payments/tasks/usage_tracking.py

@@ -0,0 +1,308 @@
+"""
+Background tasks for API usage tracking and statistics.
+"""
+import dramatiq
+import logging
+import time
+from typing import Dict, Any, List
+from django.db import transaction
+from django.db.models import F
+from django.utils import timezone
+from django.core.cache import cache
+
+from ..models import APIKey, Subscription
+from .types import (
+    TaskResult,
+    UsageUpdateRequest,
+    UsageUpdateResult,
+    BatchUpdateResult,
+    CleanupResult
+)
+
+logger = logging.getLogger(__name__)
+
+@dramatiq.actor(queue_name="payments")
+def update_api_key_usage_async(
+    api_key_id: str, 
+    ip_address: str = None,
+    increment: int = 1
+) -> UsageUpdateResult:
+    """
+    Update API key usage counters asynchronously.
+    
+    Args:
+        api_key_id: API key UUID to update
+        ip_address: Client IP address for logging
+        increment: Number to increment (default: 1)
+        
+    Returns:
+        Update result with statistics
+    """
+    start_time = time.time()
+    
+    try:
+        with transaction.atomic():
+            # Use F() expressions for atomic updates
+            updated_count = APIKey.objects.filter(id=api_key_id).update(
+                total_requests=F('total_requests') + increment,
+                last_used_at=timezone.now(),
+                updated_at=timezone.now()
+            )
+            
+            if updated_count == 0:
+                logger.warning(f"API key not found: {api_key_id}")
+                return UsageUpdateResult(
+                    status='error',
+                    error='API key not found',
+                    resource_id=api_key_id,
+                    increment=increment
+                )
+            
+            # Get updated values for logging
+            api_key = APIKey.objects.get(id=api_key_id)
+            
+            processing_time = (time.time() - start_time) * 1000
+            
+            logger.debug(f"API key usage updated", extra={
+                'api_key_id': api_key_id,
+                'user_id': api_key.user.id,
+                'total_requests': api_key.total_requests,
+                'increment': increment,
+                'ip_address': ip_address,
+                'processing_time_ms': round(processing_time, 2)
+            })
+            
+            return UsageUpdateResult(
+                status='success',
+                resource_id=api_key_id,
+                total_requests=api_key.total_requests,
+                increment=increment,
+                user_id=api_key.user.id,
+                processing_time_ms=round(processing_time, 2)
+            )
+            
+    except Exception as e:
+        logger.error(f"Failed to update API key usage", extra={
+            'api_key_id': api_key_id,
+            'error': str(e),
+            'ip_address': ip_address
+        })
+        raise  # Re-raise for Dramatiq retry logic
+
+@dramatiq.actor(queue_name="payments")
+def update_subscription_usage_async(
+    subscription_id: str,
+    increment: int = 1
+) -> UsageUpdateResult:
+    """
+    Update subscription usage counters asynchronously.
+    
+    Args:
+        subscription_id: Subscription UUID to update
+        increment: Number to increment (default: 1)
+        
+    Returns:
+        Update result with statistics
+    """
+    start_time = time.time()
+    
+    try:
+        with transaction.atomic():
+            # Use F() expressions for atomic updates
+            updated_count = Subscription.objects.filter(id=subscription_id).update(
+                total_requests=F('total_requests') + increment,
+                last_request_at=timezone.now(),
+                updated_at=timezone.now()
+            )
+            
+            if updated_count == 0:
+                logger.warning(f"Subscription not found: {subscription_id}")
+                return UsageUpdateResult(
+                    status='error',
+                    error='Subscription not found',
+                    resource_id=subscription_id,
+                    increment=increment
+                )
+            
+            # Get updated values for logging
+            subscription = Subscription.objects.get(id=subscription_id)
+            
+            processing_time = (time.time() - start_time) * 1000
+            
+            logger.debug(f"Subscription usage updated", extra={
+                'subscription_id': subscription_id,
+                'user_id': subscription.user.id,
+                'total_requests': subscription.total_requests,
+                'increment': increment,
+                'processing_time_ms': round(processing_time, 2)
+            })
+            
+            return UsageUpdateResult(
+                status='success',
+                resource_id=subscription_id,
+                total_requests=subscription.total_requests,
+                increment=increment,
+                user_id=subscription.user.id,
+                processing_time_ms=round(processing_time, 2)
+            )
+            
+    except Exception as e:
+        logger.error(f"Failed to update subscription usage", extra={
+            'subscription_id': subscription_id,
+            'error': str(e)
+        })
+        raise  # Re-raise for Dramatiq retry logic
+
+@dramatiq.actor(queue_name="payments")
+def batch_update_usage_counters() -> BatchUpdateResult:
+    """
+    Batch update usage counters from cache to reduce database load.
+    
+    This task processes accumulated usage data from Redis cache
+    and performs batch updates to the database.
+    
+    Returns:
+        Batch processing results
+    """
+    start_time = time.time()
+    api_keys_updated = 0
+    subscriptions_updated = 0
+    errors = []
+    
+    try:
+        # Process API key usage counters
+        api_key_pattern = "api_usage_pending:*"
+        api_key_keys = cache.keys(api_key_pattern)
+        
+        for cache_key in api_key_keys:
+            try:
+                # Extract API key ID from cache key
+                api_key_id = cache_key.split(':')[-1]
+                pending_count = cache.get(cache_key, 0)
+                
+                if pending_count > 0:
+                    # Update in background
+                    update_api_key_usage_async.send(
+                        api_key_id=api_key_id,
+                        increment=pending_count
+                    )
+                    
+                    # Clear cache
+                    cache.delete(cache_key)
+                    api_keys_updated += 1
+                    
+            except Exception as e:
+                errors.append({
+                    'type': 'api_key',
+                    'cache_key': cache_key,
+                    'error': str(e)
+                })
+        
+        # Process subscription usage counters
+        subscription_pattern = "subscription_usage_pending:*"
+        subscription_keys = cache.keys(subscription_pattern)
+        
+        for cache_key in subscription_keys:
+            try:
+                # Extract subscription ID from cache key
+                subscription_id = cache_key.split(':')[-1]
+                pending_count = cache.get(cache_key, 0)
+                
+                if pending_count > 0:
+                    # Update in background
+                    update_subscription_usage_async.send(
+                        subscription_id=subscription_id,
+                        increment=pending_count
+                    )
+                    
+                    # Clear cache
+                    cache.delete(cache_key)
+                    subscriptions_updated += 1
+                    
+            except Exception as e:
+                errors.append({
+                    'type': 'subscription',
+                    'cache_key': cache_key,
+                    'error': str(e)
+                })
+        
+        processing_time = (time.time() - start_time) * 1000
+        
+        logger.info(f"Batch usage update completed", extra={
+            'api_keys_updated': api_keys_updated,
+            'subscriptions_updated': subscriptions_updated,
+            'errors_count': len(errors),
+            'processing_time_ms': round(processing_time, 2)
+        })
+        
+        return BatchUpdateResult(
+            status='success',
+            api_keys_updated=api_keys_updated,
+            subscriptions_updated=subscriptions_updated,
+            errors=errors,
+            total_items=api_keys_updated + subscriptions_updated,
+            processing_time_ms=round(processing_time, 2)
+        )
+        
+    except Exception as e:
+        logger.error(f"Batch usage update failed: {e}")
+        errors.append({
+            'type': 'batch_processing',
+            'error': str(e)
+        })
+        return BatchUpdateResult(
+            status='error',
+            api_keys_updated=api_keys_updated,
+            subscriptions_updated=subscriptions_updated,
+            errors=errors,
+            total_items=api_keys_updated + subscriptions_updated,
+            error=str(e)
+        )
+
+@dramatiq.actor(queue_name="payments")
+def cleanup_stale_usage_cache() -> CleanupResult:
+    """
+    Cleanup stale usage tracking cache entries.
+    
+    Removes old cache entries that might have been left behind
+    due to processing errors or system restarts.
+    
+    Returns:
+        Cleanup results
+    """
+    try:
+        cleanup_count = 0
+        
+        # Cleanup old API key usage cache
+        api_key_keys = cache.keys("api_usage_pending:*")
+        for key in api_key_keys:
+            # Check if cache entry is older than 1 hour
+            ttl = cache.ttl(key)
+            if ttl is not None and ttl < 3600:  # Less than 1 hour remaining
+                cache.delete(key)
+                cleanup_count += 1
+        
+        # Cleanup old subscription usage cache
+        subscription_keys = cache.keys("subscription_usage_pending:*")
+        for key in subscription_keys:
+            ttl = cache.ttl(key)
+            if ttl is not None and ttl < 3600:
+                cache.delete(key)
+                cleanup_count += 1
+        
+        logger.info(f"Cleaned up {cleanup_count} stale cache entries")
+        
+        return CleanupResult(
+            status='completed',
+            cleaned_entries=cleanup_count,
+            cleanup_type='stale_usage_cache'
+        )
+        
+    except Exception as e:
+        logger.error(f"Cache cleanup failed: {e}")
+        return CleanupResult(
+            status='error',
+            error=str(e),
+            cleaned_entries=0,
+            cleanup_type='stale_usage_cache'
+        )

django_cfg/apps/payments/templates/admin/payments/_components/dashboard_header.html

@@ -0,0 +1,23 @@
+{% comment %}
+Reusable dashboard header component
+
+Usage:
+{% include "admin/payments/_components/dashboard_header.html" with title="Payment Overview" icon="💳" %}
+
+Parameters:
+- title: Dashboard title
+- icon: Emoji or icon to display
+- subtitle: Optional subtitle
+{% endcomment %}
+
+<div class="bg-white border border-base-200 dark:bg-base-900 dark:border-base-700 p-4 rounded-default mb-4">
+    <h3 class="text-lg font-semibold text-font-important-light dark:text-font-important-dark mb-3">
+        {% if icon %}{{ icon }} {% endif %}{{ title }}
+        {% if subtitle %}
+            <span class="text-sm font-normal text-font-subtle-light dark:text-font-subtle-dark">{{ subtitle }}</span>
+        {% endif %}
+    </h3>
+    
+    {% block dashboard_content %}
+    {% endblock %}
+</div>

django_cfg/apps/payments/templates/admin/payments/_components/stats_card.html

@@ -0,0 +1,25 @@
+{% comment %}
+Reusable stats card component for payment admin dashboards
+
+Usage:
+{% include "admin/payments/_components/stats_card.html" with title="Total Users" value="1,234" color="primary" icon="👥" %}
+
+Parameters:
+- title: Card title
+- value: Main value to display
+- color: Color theme (primary, success, warning, error, info)
+- icon: Emoji or icon to display
+- subtitle: Optional subtitle text
+{% endcomment %}
+
+{% load humanize %}
+
+<div class="text-center bg-base-50 dark:bg-base-800 p-3 rounded-default">
+    <p class="text-2xl font-bold text-{{ color|default:'primary' }}-600 dark:text-{{ color|default:'primary' }}-400">
+        {% if icon %}<span class="mr-1">{{ icon }}</span>{% endif %}{{ value|default:0 }}
+    </p>
+    <p class="text-sm text-font-subtle-light dark:text-font-subtle-dark">{{ title }}</p>
+    {% if subtitle %}
+        <p class="text-xs text-gray-500">{{ subtitle }}</p>
+    {% endif %}
+</div>

django_cfg/apps/payments/templates/admin/payments/_components/stats_grid.html

@@ -0,0 +1,16 @@
+{% comment %}
+Reusable stats grid component for payment admin dashboards
+
+Usage:
+{% include "admin/payments/_components/stats_grid.html" with stats=stats_data columns=4 %}
+
+Parameters:
+- stats: List of stat objects with title, value, color, icon properties
+- columns: Number of columns (2, 3, 4, 5)
+{% endcomment %}
+
+<div class="grid grid-cols-{{ columns|default:4 }} gap-4 mb-4">
+    {% for stat in stats %}
+        {% include "admin/payments/_components/stats_card.html" with title=stat.title value=stat.value color=stat.color icon=stat.icon subtitle=stat.subtitle %}
+    {% endfor %}
+</div>

django_cfg/apps/payments/templates/admin/payments/apikey/change_list.html

@@ -0,0 +1,39 @@
+{% extends "admin/change_list.html" %}
+{% load static %}
+
+{% block result_list %}
+    <!-- API Key Statistics Dashboard -->
+    {% include "admin/payments/_components/dashboard_header.html" with title="API Keys Overview" icon="🔑" %}
+    
+    {% if api_key_stats %}
+        {% with stats=api_key_stats %}
+            <div class="grid grid-cols-4 gap-4 mb-4">
+                {% include "admin/payments/_components/stats_card.html" with title="Total Keys" value=stats.total_keys color="primary" %}
+                {% include "admin/payments/_components/stats_card.html" with title="Active" value=stats.active_keys color="success" %}
+                {% include "admin/payments/_components/stats_card.html" with title="Expiring Soon" value=stats.expiring_soon color="warning" %}
+                {% include "admin/payments/_components/stats_card.html" with title="Expired" value=stats.expired_keys color="error" %}
+            </div>
+        {% endwith %}
+    {% endif %}
+        
+        <div class="grid grid-cols-2 gap-4">
+            <div class="bg-base-50 dark:bg-base-800 p-3 rounded-default">
+                <h4 class="font-semibold text-font-important-light dark:text-font-important-dark mb-2">Usage Statistics</h4>
+                <ul class="text-sm space-y-1 text-font-default-light dark:text-font-default-dark">
+                    <li>📊 Total Requests: <span class="font-medium text-primary-600 dark:text-primary-400">{{ stats.total_requests|default:0 }}</span></li>
+                    <li>📈 Recently Used: <span class="font-medium text-success-600 dark:text-success-400">{{ stats.recently_used|default:0 }}</span></li>
+                    <li>🆕 Unused: <span class="font-medium text-warning-600 dark:text-warning-400">{{ stats.unused_keys|default:0 }}</span></li>
+                </ul>
+            </div>
+            <div class="bg-base-50 dark:bg-base-800 p-3 rounded-default">
+                <h4 class="font-semibold text-font-important-light dark:text-font-important-dark mb-2">🔒 Security</h4>
+                <ul class="text-sm space-y-1 text-font-default-light dark:text-font-default-dark">
+                    <li>🔥 Heavy Usage: <span class="font-medium text-purple-600 dark:text-purple-400">{{ stats.heavy_usage_keys|default:0 }}</span></li>
+                    <li>⚠️ Old Unused: <span class="font-medium text-error-600 dark:text-error-400">{{ stats.never_used_old_keys|default:0 }}</span></li>
+                    <li>👥 Top Users: <span class="font-medium text-info-600 dark:text-info-400">{{ stats.top_users|length|default:0 }}</span></li>
+                </ul>
+            </div>
+        </div>
+
+    {{ block.super }}
+{% endblock %}

django_cfg/apps/payments/templates/admin/payments/balance/change_list.html

@@ -0,0 +1,50 @@
+{% extends "admin/change_list.html" %}
+{% load static %}
+
+{% block result_list %}
+    <!-- Balance Statistics Dashboard -->
+    {% if balance_stats %}
+        {% include "admin/payments/_components/dashboard_header.html" with title="Balance Overview" icon="💰" %}
+        
+        {% with stats=balance_stats %}
+            <div class="grid grid-cols-4 gap-4 mb-4">
+                {% include "admin/payments/_components/stats_card.html" with title="Total Balances" value=stats.total_balances color="primary" %}
+                {% include "admin/payments/_components/stats_card.html" with title="Total Value" value="$"|add:stats.total_balance|floatformat:2 color="success" %}
+                {% include "admin/payments/_components/stats_card.html" with title="Average Balance" value="$"|add:stats.avg_balance|floatformat:2 color="warning" %}
+                {% include "admin/payments/_components/stats_card.html" with title="Active (7 days)" value=stats.active_balances color="info" %}
+            </div>
+        {% endwith %}
+        
+        <div class="grid grid-cols-3 gap-4">
+            <div class="bg-base-50 dark:bg-base-800 p-3 rounded-default">
+                <h4 class="font-semibold text-font-important-light dark:text-font-important-dark mb-2">Balance Distribution</h4>
+                <ul class="text-sm space-y-1 text-font-default-light dark:text-font-default-dark">
+                    <li>💸 Empty: <span class="font-medium text-base-600 dark:text-base-400">{{ balance_stats.zero_balances|default:0 }}</span></li>
+                    <li>🪙 Low ($0-10): <span class="font-medium text-yellow-600 dark:text-yellow-400">{{ balance_stats.low_balances|default:0 }}</span></li>
+                    <li>💰 Medium ($10-100): <span class="font-medium text-green-600 dark:text-green-400">{{ balance_stats.medium_balances|default:0 }}</span></li>
+                    <li>💎 High ($100-1000): <span class="font-medium text-blue-600 dark:text-blue-400">{{ balance_stats.high_balances|default:0 }}</span></li>
+                    <li>🐋 Whale ($1000+): <span class="font-medium text-purple-600 dark:text-purple-400">{{ balance_stats.whale_balances|default:0 }}</span></li>
+                </ul>
+            </div>
+            <div class="bg-base-50 dark:bg-base-800 p-3 rounded-default">
+                <h4 class="font-semibold text-font-important-light dark:text-font-important-dark mb-2">🚨 Alerts</h4>
+                <ul class="text-sm space-y-1 text-font-default-light dark:text-font-default-dark">
+                    <li>⚠️ Negative: <span class="font-medium text-red-600 dark:text-red-400">{{ balance_stats.negative_balances|default:0 }}</span></li>
+                    <li>🔒 Reserved: <span class="font-medium text-orange-600 dark:text-orange-400">${{ balance_stats.total_reserved|floatformat:2|default:0 }}</span></li>
+                </ul>
+            </div>
+            <div class="bg-base-50 dark:bg-base-800 p-3 rounded-default">
+                <h4 class="font-semibold text-font-important-light dark:text-font-important-dark mb-2">🏆 Top Balances</h4>
+                <ul class="text-sm space-y-1 text-font-default-light dark:text-font-default-dark">
+                    {% for balance in balance_stats.top_balances %}
+                        <li><span class="font-semibold text-primary-600 dark:text-primary-400">{{ balance.user.username|truncatechars:15 }}:</span> ${{ balance.balance_usd|floatformat:2 }}</li>
+                    {% empty %}
+                        <li class="text-font-subtle-light dark:text-font-subtle-dark">No balances available</li>
+                    {% endfor %}
+                </ul>
+            </div>
+        </div>
+    {% endif %}
+
+    {{ block.super }}
+{% endblock %}

django_cfg/apps/payments/templates/admin/payments/currency/change_list.html

@@ -0,0 +1,40 @@
+{% extends "admin/change_list.html" %}
+{% load static %}
+
+{% block result_list %}
+    <!-- Currency Statistics Dashboard -->
+    {% if currency_stats %}
+        {% include "admin/payments/_components/dashboard_header.html" with title="Currency Overview" icon="📊" %}
+        
+        {% with stats=currency_stats %}
+            <div class="grid grid-cols-4 gap-4 mb-4">
+                {% include "admin/payments/_components/stats_card.html" with title="Total Currencies" value=stats.total_currencies color="primary" %}
+                {% include "admin/payments/_components/stats_card.html" with title="Provider Mappings" value=stats.enabled_provider_currencies color="success" %}
+                {% include "admin/payments/_components/stats_card.html" with title="With USD Rates" value=stats.currencies_with_rates color="warning" %}
+                {% include "admin/payments/_components/stats_card.html" with title="Rate Coverage" value=stats.rate_coverage|floatformat:1|add:"%" color="info" %}
+            </div>
+        {% endwith %}
+        
+        <div class="grid grid-cols-2 gap-4">
+            <div class="bg-base-50 dark:bg-base-800 p-3 rounded-default">
+                <h4 class="font-semibold text-font-important-light dark:text-font-important-dark mb-2">Currency Types</h4>
+                <ul class="text-sm space-y-1 text-font-default-light dark:text-font-default-dark">
+                    <li>💵 Fiat: <span class="font-medium text-primary-600 dark:text-primary-400">{{ stats.fiat_count|default:0 }}</span></li>
+                    <li>₿ Crypto: <span class="font-medium text-warning-600 dark:text-warning-400">{{ stats.crypto_count|default:0 }}</span></li>
+                </ul>
+            </div>
+            <div class="bg-base-50 dark:bg-base-800 p-3 rounded-default">
+                <h4 class="font-semibold text-font-important-light dark:text-font-important-dark mb-2">🚀 Top Supported</h4>
+                <ul class="text-sm space-y-1 text-font-default-light dark:text-font-default-dark">
+                    {% for currency in stats.top_currencies %}
+                        <li><span class="font-semibold text-primary-600 dark:text-primary-400">{{ currency.code }}:</span> {{ currency.provider_count }} provider{{ currency.provider_count|pluralize }}</li>
+                    {% empty %}
+                        <li class="text-font-subtle-light dark:text-font-subtle-dark">No provider data available</li>
+                    {% endfor %}
+                </ul>
+            </div>
+        </div>
+    {% endif %}
+
+    {{ block.super }}
+{% endblock %}

django_cfg/apps/payments/templates/admin/payments/payment/change_list.html

@@ -0,0 +1,48 @@
+{% extends "admin/change_list.html" %}
+{% load static %}
+
+{% block result_list %}
+    <!-- Payment Statistics Dashboard -->
+    {% if payment_stats %}
+        {% include "admin/payments/_components/dashboard_header.html" with title="Payment Overview" icon="💳" %}
+        
+        {% with stats=payment_stats %}
+            <div class="grid grid-cols-4 gap-4 mb-4">
+                {% include "admin/payments/_components/stats_card.html" with title="Total Payments" value=stats.total_payments color="primary" %}
+                {% include "admin/payments/_components/stats_card.html" with title="Completed" value=stats.status_stats.completed|default:0 color="success" %}
+                {% include "admin/payments/_components/stats_card.html" with title="Pending" value=stats.status_stats.pending|default:0 color="warning" %}
+                {% include "admin/payments/_components/stats_card.html" with title="Failed" value=stats.status_stats.failed|default:0 color="error" %}
+            </div>
+            
+            <div class="grid grid-cols-3 gap-4">
+                <div class="bg-base-50 dark:bg-base-800 p-3 rounded-default">
+                    <h4 class="font-semibold text-font-important-light dark:text-font-important-dark mb-2">💰 Financial</h4>
+                    <ul class="text-sm space-y-1 text-font-default-light dark:text-font-default-dark">
+                        <li>Total Volume: <span class="font-medium text-primary-600 dark:text-primary-400">${{ stats.total_amount|floatformat:2|default:0 }}</span></li>
+                        <li>Completed: <span class="font-medium text-success-600 dark:text-success-400">${{ stats.completed_amount|floatformat:2|default:0 }}</span></li>
+                        <li>Success Rate: <span class="font-medium text-info-600 dark:text-info-400">{{ stats.success_rate|floatformat:1|default:0 }}%</span></li>
+                    </ul>
+                </div>
+                <div class="bg-base-50 dark:bg-base-800 p-3 rounded-default">
+                    <h4 class="font-semibold text-font-important-light dark:text-font-important-dark mb-2">📊 Recent (24h)</h4>
+                    <ul class="text-sm space-y-1 text-font-default-light dark:text-font-default-dark">
+                        <li>Payments: <span class="font-medium text-primary-600 dark:text-primary-400">{{ stats.recent_payments|default:0 }}</span></li>
+                        <li>Volume: <span class="font-medium text-success-600 dark:text-success-400">${{ stats.recent_amount|floatformat:2|default:0 }}</span></li>
+                    </ul>
+                </div>
+                <div class="bg-base-50 dark:bg-base-800 p-3 rounded-default">
+                    <h4 class="font-semibold text-font-important-light dark:text-font-important-dark mb-2">🔗 Providers</h4>
+                    <ul class="text-sm space-y-1 text-font-default-light dark:text-font-default-dark">
+                        {% for provider in stats.provider_stats %}
+                            <li>{{ provider.provider|title }}: <span class="font-medium text-primary-600 dark:text-primary-400">{{ provider.count }}</span></li>
+                        {% empty %}
+                            <li class="text-font-subtle-light dark:text-font-subtle-dark">No provider data</li>
+                        {% endfor %}
+                    </ul>
+                </div>
+            </div>
+        {% endwith %}
+    {% endif %}
+
+    {{ block.super }}
+{% endblock %}

django_cfg/apps/payments/templates/admin/payments/subscription/change_list.html

@@ -0,0 +1,48 @@
+{% extends "admin/change_list.html" %}
+{% load static %}
+
+{% block result_list %}
+    <!-- Subscription Statistics Dashboard -->
+    {% if subscription_stats %}
+        {% include "admin/payments/_components/dashboard_header.html" with title="Subscriptions Overview" icon="📋" %}
+        
+        {% with stats=subscription_stats %}
+            <div class="grid grid-cols-4 gap-4 mb-4">
+                {% include "admin/payments/_components/stats_card.html" with title="Total Subscriptions" value=stats.total_subscriptions color="primary" %}
+                {% include "admin/payments/_components/stats_card.html" with title="Active" value=stats.active_subscriptions color="success" %}
+                {% include "admin/payments/_components/stats_card.html" with title="Expiring Soon" value=stats.expiring_subscriptions color="warning" %}
+                {% include "admin/payments/_components/stats_card.html" with title="Monthly Revenue" value="$"|add:stats.monthly_revenue|floatformat:2 color="info" %}
+            </div>
+        {% endwith %}
+    {% endif %}
+        
+        <div class="grid grid-cols-3 gap-4">
+            <div class="bg-base-50 dark:bg-base-800 p-3 rounded-default">
+                <h4 class="font-semibold text-font-important-light dark:text-font-important-dark mb-2">Subscription Tiers</h4>
+                <ul class="text-sm space-y-1 text-font-default-light dark:text-font-default-dark">
+                    <li>🥉 Basic: <span class="font-medium text-base-600 dark:text-base-400">{{ stats.basic_subs|default:0 }}</span></li>
+                    <li>🥈 Premium: <span class="font-medium text-blue-600 dark:text-blue-400">{{ stats.premium_subs|default:0 }}</span></li>
+                    <li>🥇 Enterprise: <span class="font-medium text-purple-600 dark:text-purple-400">{{ stats.enterprise_subs|default:0 }}</span></li>
+                </ul>
+            </div>
+            <div class="bg-base-50 dark:bg-base-800 p-3 rounded-default">
+                <h4 class="font-semibold text-font-important-light dark:text-font-important-dark mb-2">Status Distribution</h4>
+                <ul class="text-sm space-y-1 text-font-default-light dark:text-font-default-dark">
+                    <li>✅ Active: <span class="font-medium text-success-600 dark:text-success-400">{{ stats.active_count|default:0 }}</span></li>
+                    <li>⏸️ Paused: <span class="font-medium text-warning-600 dark:text-warning-400">{{ stats.paused_count|default:0 }}</span></li>
+                    <li>❌ Cancelled: <span class="font-medium text-error-600 dark:text-error-400">{{ stats.cancelled_count|default:0 }}</span></li>
+                    <li>⏰ Expired: <span class="font-medium text-base-600 dark:text-base-400">{{ stats.expired_count|default:0 }}</span></li>
+                </ul>
+            </div>
+            <div class="bg-base-50 dark:bg-base-800 p-3 rounded-default">
+                <h4 class="font-semibold text-font-important-light dark:text-font-important-dark mb-2">📊 Metrics</h4>
+                <ul class="text-sm space-y-1 text-font-default-light dark:text-font-default-dark">
+                    <li>📈 New (30d): <span class="font-medium text-success-600 dark:text-success-400">{{ stats.new_subs_30d|default:0 }}</span></li>
+                    <li>📉 Churn Rate: <span class="font-medium text-warning-600 dark:text-warning-400">{{ stats.churn_rate|floatformat:1|default:0 }}%</span></li>
+                    <li>💰 ARPU: <span class="font-medium text-primary-600 dark:text-primary-400">${{ stats.arpu|floatformat:2|default:0 }}</span></li>
+                </ul>
+            </div>
+        </div>
+
+    {{ block.super }}
+{% endblock %}

django_cfg/apps/payments/templatetags/payment_tags.py

@@ -464,3 +464,11 @@ def divide(value, arg):
         return float(value) / float(arg)
     except (ValueError, TypeError, ZeroDivisionError):
         return 0
+
+
+
+
+
+
+
+

django_cfg/apps/payments/urls.py

@@ -11,7 +11,7 @@ from rest_framework_nested import routers
 from .views.api import (
     PaymentViewSet, UserPaymentViewSet, PaymentCreateView, PaymentStatusView,
     UserBalanceViewSet, TransactionViewSet, UserTransactionViewSet,
-    CurrencyViewSet, NetworkViewSet, ProviderCurrencyViewSet, CurrencyConversionView, CurrencyRatesView, SupportedCurrenciesView,
+    CurrencyViewSet, NetworkViewSet, ProviderCurrencyViewSet, CurrencyRatesView, SupportedCurrenciesView,
     SubscriptionViewSet, UserSubscriptionViewSet, EndpointGroupViewSet, TariffViewSet,
     APIKeyViewSet, UserAPIKeyViewSet, APIKeyCreateView, APIKeyValidateView,
     UniversalWebhookView, webhook_health_check, webhook_stats, supported_providers,
@@ -60,7 +60,8 @@ urlpatterns = [
     path('payments/create/', PaymentCreateView.as_view(), name='payment-create'),
     path('payments/status/<uuid:pk>/', PaymentStatusView.as_view(), name='payment-status'),
     
-    path('currencies/convert/', CurrencyConversionView.as_view(), name='currency-convert'),
+    # Note: currencies/convert/ is handled by CurrencyViewSet action
+    # path('currencies/convert/', CurrencyConversionView.as_view(), name='currency-convert'),
     path('currencies/rates/', CurrencyRatesView.as_view(), name='currency-rates'),
     path('currencies/supported/', SupportedCurrenciesView.as_view(), name='currencies-supported'),
     

django_cfg/apps/payments/urls_admin.py

@@ -39,7 +39,7 @@ webhook_events_router.register(r'events', AdminWebhookEventViewSet, basename='ad
 
 # Public API router (no authentication required)
 public_router = DefaultRouter()
-public_router.register(r'webhooks', WebhookTestViewSet, basename='webhook-test')
+public_router.register(r'webhook-test', WebhookTestViewSet, basename='webhook-test')
 
 urlpatterns = [
     # Template Views