django-cfg 1.4.10__py3-none-any.whl → 1.4.11__py3-none-any.whl

django_cfg/apps/agents/management/commands/create_agent.py

@@ -6,7 +6,7 @@ import asyncio
 from django.core.management.base import BaseCommand, CommandError
 from django.contrib.auth.models import User
 
-from django_cfg.modules.django_orchestrator.models.registry import AgentDefinition
+from django_cfg.apps.agents.models.registry import AgentDefinition
 
 
 class Command(BaseCommand):

django_cfg/apps/agents/management/commands/orchestrator_status.py

@@ -7,9 +7,9 @@ from django.core.management.base import BaseCommand
 from django.utils import timezone
 from datetime import timedelta
 
-from django_cfg.modules.django_orchestrator.integration.registry import get_registry
-from django_cfg.modules.django_orchestrator.models.execution import AgentExecution, WorkflowExecution
-from django_cfg.modules.django_orchestrator.models.registry import AgentDefinition
+from django_cfg.apps.agents.integration.registry import get_registry
+from django_cfg.apps.agents.models.execution import AgentExecution, WorkflowExecution
+from django_cfg.apps.agents.models.registry import AgentDefinition
 
 
 class Command(BaseCommand):

django_cfg/apps/newsletter/serializers.py

@@ -12,8 +12,8 @@ User = get_user_model()
 
 class NewsletterSerializer(serializers.ModelSerializer):
     """Serializer for Newsletter model."""
-    
-    subscribers_count = serializers.ReadOnlyField()
+
+    subscribers_count = serializers.IntegerField(read_only=True)
     
     class Meta:
         model = Newsletter
@@ -102,7 +102,7 @@ class EmailLogSerializer(serializers.ModelSerializer):
 
 class BulkEmailSerializer(serializers.Serializer):
     """Simple serializer for bulk email."""
-    
+
     recipients = serializers.ListField(
         child=serializers.EmailField(),
         min_length=1,
@@ -115,3 +115,40 @@ class BulkEmailSerializer(serializers.Serializer):
     button_text = serializers.CharField(max_length=100, required=False, allow_blank=True)
     button_url = serializers.URLField(required=False, allow_blank=True)
     secondary_text = serializers.CharField(required=False, allow_blank=True)
+
+
+# Response serializers
+class SuccessResponseSerializer(serializers.Serializer):
+    """Generic success response."""
+    success = serializers.BooleanField()
+    message = serializers.CharField()
+
+
+class SubscribeResponseSerializer(serializers.Serializer):
+    """Response for subscription."""
+    success = serializers.BooleanField()
+    message = serializers.CharField()
+    subscription_id = serializers.IntegerField(required=False)
+
+
+class ErrorResponseSerializer(serializers.Serializer):
+    """Generic error response."""
+    success = serializers.BooleanField(default=False)
+    message = serializers.CharField()
+
+
+class BulkEmailResponseSerializer(serializers.Serializer):
+    """Response for bulk email sending."""
+    success = serializers.BooleanField()
+    sent_count = serializers.IntegerField()
+    failed_count = serializers.IntegerField()
+    total_recipients = serializers.IntegerField()
+    error = serializers.CharField(required=False, allow_blank=True)
+
+
+class SendCampaignResponseSerializer(serializers.Serializer):
+    """Response for sending campaign."""
+    success = serializers.BooleanField()
+    message = serializers.CharField(required=False)
+    sent_count = serializers.IntegerField(required=False)
+    error = serializers.CharField(required=False)

django_cfg/apps/newsletter/views/campaigns.py

@@ -8,7 +8,12 @@ from rest_framework.permissions import IsAuthenticated
 from drf_spectacular.utils import extend_schema
 
 from ..models import NewsletterCampaign
-from ..serializers import NewsletterCampaignSerializer, SendCampaignSerializer
+from ..serializers import (
+    NewsletterCampaignSerializer,
+    SendCampaignSerializer,
+    SendCampaignResponseSerializer,
+    ErrorResponseSerializer,
+)
 
 
 class NewsletterCampaignListView(generics.ListCreateAPIView):
@@ -67,7 +72,7 @@ class NewsletterCampaignDetailView(generics.RetrieveUpdateDestroyAPIView):
     @extend_schema(
         summary="Delete Campaign",
         description="Delete a newsletter campaign.",
-        responses={204: "No Content"},
+        responses={204: None},
         tags=["Campaigns"]
     )
     def delete(self, request, *args, **kwargs):
@@ -84,7 +89,11 @@ class SendCampaignView(generics.CreateAPIView):
         summary="Send Newsletter Campaign",
         description="Send a newsletter campaign to all subscribers.",
         request=SendCampaignSerializer,
-        responses={200: "Success", 400: "Bad Request", 404: "Campaign not found"},
+        responses={
+            200: SendCampaignResponseSerializer,
+            400: ErrorResponseSerializer,
+            404: ErrorResponseSerializer,
+        },
         tags=["Campaigns"]
     )
     def post(self, request, *args, **kwargs):

django_cfg/apps/newsletter/views/emails.py

@@ -9,7 +9,12 @@ from drf_spectacular.utils import extend_schema
 
 from ..models import EmailLog
 from ..services.email_service import NewsletterEmailService
-from ..serializers import TestEmailSerializer, BulkEmailSerializer, EmailLogSerializer
+from ..serializers import (
+    TestEmailSerializer,
+    BulkEmailSerializer,
+    EmailLogSerializer,
+    BulkEmailResponseSerializer,
+)
 
 
 class TestEmailView(generics.CreateAPIView):
@@ -22,7 +27,10 @@ class TestEmailView(generics.CreateAPIView):
         summary="Test Email Sending",
         description="Send a test email to verify mailer configuration.",
         request=TestEmailSerializer,
-        responses={200: "Success", 400: "Bad Request"},
+        responses={
+            200: BulkEmailResponseSerializer,
+            400: BulkEmailResponseSerializer,
+        },
         tags=["Testing"]
     )
     def post(self, request, *args, **kwargs):
@@ -67,7 +75,10 @@ class BulkEmailView(generics.CreateAPIView):
         summary="Send Bulk Email",
         description="Send bulk emails to multiple recipients using base email template.",
         request=BulkEmailSerializer,
-        responses={200: "Success", 400: "Bad Request"},
+        responses={
+            200: BulkEmailResponseSerializer,
+            400: BulkEmailResponseSerializer,
+        },
         tags=["Bulk Email"]
     )
     def post(self, request, *args, **kwargs):

django_cfg/apps/newsletter/views/subscriptions.py

@@ -12,6 +12,9 @@ from ..serializers import (
     NewsletterSubscriptionSerializer,
     SubscribeSerializer,
     UnsubscribeSerializer,
+    SubscribeResponseSerializer,
+    SuccessResponseSerializer,
+    ErrorResponseSerializer,
 )
 
 
@@ -25,7 +28,11 @@ class SubscribeView(generics.CreateAPIView):
         summary="Subscribe to Newsletter",
         description="Subscribe an email address to a newsletter.",
         request=SubscribeSerializer,
-        responses={201: "Created", 400: "Bad Request"},
+        responses={
+            201: SubscribeResponseSerializer,
+            400: ErrorResponseSerializer,
+            404: ErrorResponseSerializer,
+        },
         tags=["Subscriptions"]
     )
     def post(self, request, *args, **kwargs):
@@ -83,7 +90,10 @@ class UnsubscribeView(generics.UpdateAPIView):
         summary="Unsubscribe from Newsletter",
         description="Unsubscribe from a newsletter using subscription ID.",
         request=UnsubscribeSerializer,
-        responses={200: "Success", 404: "Subscription not found"},
+        responses={
+            200: SuccessResponseSerializer,
+            404: ErrorResponseSerializer,
+        },
         tags=["Subscriptions"]
     )
     def post(self, request, *args, **kwargs):

django_cfg/apps/payments/views/api/currencies.py

@@ -9,6 +9,8 @@ from rest_framework.decorators import action
 from rest_framework.response import Response
 from django_filters.rest_framework import DjangoFilterBackend
 from django.utils import timezone
+from drf_spectacular.utils import extend_schema, OpenApiParameter
+from drf_spectacular.types import OpenApiTypes
 
 from .base import ReadOnlyPaymentViewSet
 from ...models import Currency, Network, ProviderCurrency
@@ -157,34 +159,75 @@ class CurrencyViewSet(ReadOnlyPaymentViewSet):
         
         return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)
     
+    @extend_schema(
+        parameters=[
+            OpenApiParameter(
+                name='base_currency',
+                type=OpenApiTypes.STR,
+                location=OpenApiParameter.QUERY,
+                description='Base currency code (e.g., USD)',
+                required=True,
+            ),
+            OpenApiParameter(
+                name='currencies',
+                type=OpenApiTypes.STR,
+                location=OpenApiParameter.QUERY,
+                description='Comma-separated list of target currency codes (e.g., BTC,ETH,USDT)',
+                required=True,
+            ),
+        ],
+        summary='Get exchange rates',
+        description='Get current exchange rates for specified currencies',
+    )
     @action(detail=False, methods=['get'])
     def rates(self, request):
         """
         Get current exchange rates.
-        
+
         GET /api/currencies/rates/?base_currency=USD&currencies=BTC,ETH
         """
         serializer = CurrencyRatesSerializer(data=request.query_params)
-        
+
         if serializer.is_valid():
             result = serializer.save()
             return Response(result)
-        
+
         return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)
     
+    @extend_schema(
+        parameters=[
+            OpenApiParameter(
+                name='provider',
+                type=OpenApiTypes.STR,
+                location=OpenApiParameter.QUERY,
+                description='Payment provider name (e.g., nowpayments)',
+                required=False,
+            ),
+            OpenApiParameter(
+                name='currency_type',
+                type=OpenApiTypes.STR,
+                location=OpenApiParameter.QUERY,
+                description='Currency type filter: crypto, fiat, or stablecoin',
+                required=False,
+                enum=['crypto', 'fiat', 'stablecoin'],
+            ),
+        ],
+        summary='Get supported currencies',
+        description='Get list of supported currencies from payment providers',
+    )
     @action(detail=False, methods=['get'])
     def supported(self, request):
         """
         Get supported currencies from providers.
-        
+
         GET /api/currencies/supported/?provider=nowpayments&currency_type=crypto
         """
         serializer = SupportedCurrenciesSerializer(data=request.query_params)
-        
+
         if serializer.is_valid():
             result = serializer.save()
             return Response(result)
-        
+
         return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)
 
 

django_cfg/apps/payments/views/api/webhooks.py

@@ -17,9 +17,16 @@ from rest_framework.decorators import api_view, permission_classes
 from rest_framework.permissions import AllowAny
 from rest_framework.response import Response
 from rest_framework.views import APIView
+from drf_spectacular.utils import extend_schema, OpenApiParameter, OpenApiTypes
 
 from ...services.core.webhook_service import WebhookService
 from ...services.types import WebhookValidationRequest, WebhookProcessingResult
+from ..serializers.webhooks import (
+    WebhookResponseSerializer,
+    WebhookHealthSerializer,
+    WebhookStatsSerializer,
+    SupportedProvidersSerializer,
+)
 from django_cfg.modules.django_logging import get_logger
 
 logger = get_logger("webhook_views")
@@ -29,7 +36,7 @@ logger = get_logger("webhook_views")
 class UniversalWebhookView(APIView):
     """
     Universal webhook handler for all payment providers.
-    
+
     Features:
     - Provider-agnostic webhook processing
     - Signature validation and security
@@ -37,13 +44,29 @@ class UniversalWebhookView(APIView):
     - Comprehensive logging and monitoring
     - Integration with ngrok for development
     """
-    
+
     permission_classes = [AllowAny]  # Webhooks don't use standard auth
+    serializer_class = WebhookResponseSerializer  # For OpenAPI schema generation
     
     def __init__(self, **kwargs):
         super().__init__(**kwargs)
         self.webhook_service = WebhookService()
-    
+
+    @extend_schema(
+        summary="Process Webhook",
+        description="Process incoming webhook from payment provider",
+        parameters=[
+            OpenApiParameter(
+                name='provider',
+                description='Payment provider name (nowpayments, stripe, etc.)',
+                required=True,
+                type=OpenApiTypes.STR,
+                location=OpenApiParameter.PATH
+            )
+        ],
+        responses={200: WebhookResponseSerializer},
+        tags=["Webhooks"]
+    )
     def post(self, request: HttpRequest, provider: str) -> JsonResponse:
         """
         Handle incoming webhook from any payment provider.
@@ -144,10 +167,25 @@ class UniversalWebhookView(APIView):
                 request_id
             )
     
+    @extend_schema(
+        summary="Webhook Endpoint Info",
+        description="Get webhook endpoint information for debugging and configuration",
+        parameters=[
+            OpenApiParameter(
+                name='provider',
+                description='Payment provider name',
+                required=True,
+                type=OpenApiTypes.STR,
+                location=OpenApiParameter.PATH
+            )
+        ],
+        responses={200: WebhookResponseSerializer},
+        tags=["Webhooks"]
+    )
     def get(self, request: HttpRequest, provider: str) -> JsonResponse:
         """
         Handle GET requests for webhook endpoint info.
-        
+
         Useful for debugging and provider configuration verification.
         """
         
@@ -314,12 +352,18 @@ class UniversalWebhookView(APIView):
         return JsonResponse(response_data, status=status_code)
 
 
+@extend_schema(
+    summary="Webhook Health Check",
+    description="Check webhook service health status and recent activity metrics",
+    responses={200: WebhookHealthSerializer},
+    tags=["Webhooks"]
+)
 @api_view(['GET'])
 @permission_classes([AllowAny])
 def webhook_health_check(request):
     """
     Health check endpoint for webhook service.
-    
+
     Returns service status and recent activity metrics.
     """
     
@@ -362,12 +406,27 @@ def webhook_health_check(request):
         }, status=status.HTTP_500_INTERNAL_SERVER_ERROR)
 
 
+@extend_schema(
+    summary="Webhook Statistics",
+    description="Get webhook processing statistics for a given time period",
+    parameters=[
+        OpenApiParameter(
+            name='days',
+            description='Number of days to analyze (1-365)',
+            required=False,
+            type=OpenApiTypes.INT,
+            default=30
+        )
+    ],
+    responses={200: WebhookStatsSerializer},
+    tags=["Webhooks"]
+)
 @api_view(['GET'])
 @permission_classes([AllowAny])
 def webhook_stats(request):
     """
     Get webhook processing statistics.
-    
+
     Query parameters:
     - days: Number of days to analyze (default: 30)
     """
@@ -408,12 +467,18 @@ def webhook_stats(request):
         }, status=status.HTTP_500_INTERNAL_SERVER_ERROR)
 
 
+@extend_schema(
+    summary="Supported Webhook Providers",
+    description="Get list of supported webhook providers with configuration details",
+    responses={200: SupportedProvidersSerializer},
+    tags=["Webhooks"]
+)
 @api_view(['GET'])
 @permission_classes([AllowAny])
 def supported_providers(request):
     """
     Get list of supported webhook providers.
-    
+
     Returns provider information and webhook URLs.
     """
     

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

@@ -201,5 +201,38 @@ class TimePeriodSerializer(serializers.Serializer):
         ('90d', 'Last 90 days'),
         ('1y', 'Last year'),
     ]
-    
+
     period = serializers.ChoiceField(choices=PERIOD_CHOICES, default='30d')
+
+
+class CurrencyAnalyticsItemSerializer(serializers.Serializer):
+    """
+    Analytics data for a single currency
+    """
+    currency_code = serializers.CharField(help_text="Currency code (e.g., BTC)")
+    currency_name = serializers.CharField(help_text="Currency name (e.g., Bitcoin)")
+    total_payments = serializers.IntegerField(help_text="Total number of payments")
+    total_amount = serializers.FloatField(help_text="Total amount in USD")
+    completed_payments = serializers.IntegerField(help_text="Number of completed payments")
+    average_amount = serializers.FloatField(help_text="Average payment amount in USD")
+    success_rate = serializers.FloatField(help_text="Success rate percentage")
+
+
+class ProviderAnalyticsItemSerializer(serializers.Serializer):
+    """
+    Analytics data for a single payment provider
+    """
+    provider = serializers.CharField(help_text="Provider code")
+    provider_display = serializers.CharField(help_text="Provider display name")
+    total_payments = serializers.IntegerField(help_text="Total number of payments")
+    total_amount = serializers.FloatField(help_text="Total amount in USD")
+    completed_payments = serializers.IntegerField(help_text="Number of completed payments")
+    success_rate = serializers.FloatField(help_text="Success rate percentage")
+
+
+class PaymentAnalyticsResponseSerializer(serializers.Serializer):
+    """
+    Payment analytics response with currency and provider breakdown
+    """
+    currency_analytics = CurrencyAnalyticsItemSerializer(many=True, help_text="Analytics by currency")
+    provider_analytics = ProviderAnalyticsItemSerializer(many=True, help_text="Analytics by provider")

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

@@ -26,6 +26,7 @@ from .serializers import (
     BalanceOverviewSerializer,
     SubscriptionOverviewSerializer,
     APIKeysOverviewSerializer,
+    PaymentAnalyticsResponseSerializer,
 )
 
 
@@ -95,7 +96,7 @@ from .serializers import (
                 default=10
             )
         ],
-        responses={200: 'object'}  # Generic object since it's a dict with currency_analytics and provider_analytics
+        responses={200: PaymentAnalyticsResponseSerializer}
     ),
     balance_overview=extend_schema(
         summary="Balance Overview",

django_cfg/apps/payments/views/serializers/payments.py

@@ -27,7 +27,7 @@ class PaymentListSerializer(serializers.ModelSerializer):
     status_display = serializers.CharField(source='get_status_display', read_only=True)
     amount_display = serializers.SerializerMethodField(read_only=True)
     
-    def get_amount_display(self, obj):
+    def get_amount_display(self, obj) -> str:
         """Get formatted amount display."""
         return f"${obj.amount_usd:.2f}"
     
@@ -64,23 +64,23 @@ class PaymentSerializer(serializers.ModelSerializer):
     is_failed = serializers.SerializerMethodField(read_only=True)
     is_expired = serializers.SerializerMethodField(read_only=True)
     
-    def get_amount_display(self, obj):
+    def get_amount_display(self, obj) -> str:
         """Get formatted amount display."""
         return f"${obj.amount_usd:.2f}"
     
-    def get_is_pending(self, obj):
+    def get_is_pending(self, obj) -> bool:
         """Check if payment is pending."""
         return obj.status == obj.PaymentStatus.PENDING
     
-    def get_is_completed(self, obj):
+    def get_is_completed(self, obj) -> bool:
         """Check if payment is completed."""
         return obj.status == obj.PaymentStatus.COMPLETED
     
-    def get_is_failed(self, obj):
+    def get_is_failed(self, obj) -> bool:
         """Check if payment is failed."""
         return obj.status == obj.PaymentStatus.FAILED
     
-    def get_is_expired(self, obj):
+    def get_is_expired(self, obj) -> bool:
         """Check if payment is expired."""
         return obj.status == obj.PaymentStatus.EXPIRED