django-cfg 1.4.82__py3-none-any.whl → 1.4.84__py3-none-any.whl

django_cfg/__init__.py

@@ -32,7 +32,7 @@ Example:
 default_app_config = "django_cfg.apps.DjangoCfgConfig"
 
 # Version information
-__version__ = "1.4.82"
+__version__ = "1.4.84"
 __license__ = "MIT"
 
 # Import registry for organized lazy loading

django_cfg/apps/centrifugo/serializers/channels.py

@@ -2,6 +2,8 @@
 Channel statistics serializers for Centrifugo monitoring API.
 """
 
+from typing import Optional
+
 from pydantic import BaseModel, Field
 
 
@@ -14,6 +16,7 @@ class ChannelStatsSerializer(BaseModel):
     failed: int = Field(description="Failed publishes")
     avg_duration_ms: float = Field(description="Average duration")
     avg_acks: float = Field(description="Average ACKs received")
+    last_activity_at: Optional[str] = Field(default=None, description="Last activity timestamp (ISO format)")
 
 
 class ChannelListSerializer(BaseModel):

django_cfg/apps/centrifugo/serializers/publishes.py

@@ -11,6 +11,8 @@ class RecentPublishesSerializer(BaseModel):
     publishes: list[dict] = Field(description="List of recent publishes")
     count: int = Field(description="Number of publishes returned")
     total_available: int = Field(description="Total publishes available")
+    offset: int = Field(default=0, description="Current offset for pagination")
+    has_more: bool = Field(default=False, description="Whether more results are available")
 
 
 __all__ = ["RecentPublishesSerializer"]

django_cfg/apps/centrifugo/views/admin_api.py

@@ -41,7 +41,7 @@ class CentrifugoAdminAPIViewSet(viewsets.ViewSet):
     All requests are authenticated via Django session and proxied to Centrifugo.
     """
 
-    authentication_classes = [SessionAuthentication]
+    # authentication_classes = [SessionAuthentication]
     permission_classes = [IsAdminUser]
 
     def __init__(self, *args, **kwargs):

django_cfg/apps/centrifugo/views/monitoring.py

@@ -4,10 +4,11 @@ Centrifugo Monitoring ViewSet.
 Provides REST API endpoints for monitoring Centrifugo publish statistics.
 """
 
-from datetime import datetime
+from datetime import datetime, timedelta
 
 from django.db import models
-from django.db.models import Avg, Count
+from django.db.models import Avg, Count, Max
+from django.db.models.functions import TruncHour, TruncDay
 from django_cfg.modules.django_logging import get_logger
 from drf_spectacular.types import OpenApiTypes
 from drf_spectacular.utils import OpenApiParameter, extend_schema
@@ -41,7 +42,7 @@ class CentrifugoMonitorViewSet(viewsets.ViewSet):
     - Channel-level statistics
     """
 
-    authentication_classes = [SessionAuthentication]
+    # authentication_classes = [SessionAuthentication]
     permission_classes = [IsAdminUser]
 
     @extend_schema(
@@ -144,6 +145,20 @@ class CentrifugoMonitorViewSet(viewsets.ViewSet):
                 description="Filter by channel name",
                 required=False,
             ),
+            OpenApiParameter(
+                name="status",
+                type=OpenApiTypes.STR,
+                location=OpenApiParameter.QUERY,
+                description="Filter by status (success, failed, timeout, pending, partial)",
+                required=False,
+            ),
+            OpenApiParameter(
+                name="offset",
+                type=OpenApiTypes.INT,
+                location=OpenApiParameter.QUERY,
+                description="Offset for pagination (default: 0)",
+                required=False,
+            ),
         ],
         responses={
             200: RecentPublishesSerializer,
@@ -158,14 +173,24 @@ class CentrifugoMonitorViewSet(viewsets.ViewSet):
             count = min(count, 200)  # Max 200
 
             channel = request.GET.get("channel")
+            status_filter = request.GET.get("status")  # NEW: status filter
+            offset = int(request.GET.get("offset", 0))  # NEW: offset for pagination
 
             queryset = CentrifugoLog.objects.all()
 
             if channel:
                 queryset = queryset.filter(channel=channel)
 
+            # NEW: Filter by status
+            if status_filter and status_filter in ["success", "failed", "timeout", "pending", "partial"]:
+                queryset = queryset.filter(status=status_filter)
+
+            # Get total count before slicing
+            total = queryset.count()
+
+            # NEW: Apply offset and limit
             publishes_list = list(
-                queryset.order_by("-created_at")[:count].values(
+                queryset.order_by("-created_at")[offset:offset + count].values(
                     "message_id",
                     "channel",
                     "status",
@@ -187,12 +212,12 @@ class CentrifugoMonitorViewSet(viewsets.ViewSet):
                 if pub["completed_at"]:
                     pub["completed_at"] = pub["completed_at"].isoformat()
 
-            total = queryset.count()
-
             response_data = {
                 "publishes": publishes_list,
                 "count": len(publishes_list),
                 "total_available": total,
+                "offset": offset,  # NEW: for pagination
+                "has_more": (offset + count) < total,  # NEW: pagination helper
             }
 
             serializer = RecentPublishesSerializer(**response_data)
@@ -228,6 +253,89 @@ class CentrifugoMonitorViewSet(viewsets.ViewSet):
             400: {"description": "Invalid parameters"},
         },
     )
+    @extend_schema(
+        tags=["Centrifugo Monitoring"],
+        summary="Get publish timeline",
+        description="Returns hourly or daily breakdown of publish counts for charts.",
+        parameters=[
+            OpenApiParameter(
+                name="hours",
+                type=OpenApiTypes.INT,
+                location=OpenApiParameter.QUERY,
+                description="Time period in hours (default: 24)",
+                required=False,
+            ),
+            OpenApiParameter(
+                name="interval",
+                type=OpenApiTypes.STR,
+                location=OpenApiParameter.QUERY,
+                description="Time interval: 'hour' or 'day' (default: hour)",
+                required=False,
+            ),
+        ],
+        responses={
+            200: {"description": "Timeline data"},
+            400: {"description": "Invalid parameters"},
+        },
+    )
+    @action(detail=False, methods=["get"], url_path="timeline")
+    def timeline(self, request):
+        """Get publish timeline breakdown for charts."""
+        try:
+            hours = int(request.GET.get("hours", 24))
+            hours = min(max(hours, 1), 168)
+            interval = request.GET.get("interval", "hour")
+
+            if interval not in ["hour", "day"]:
+                interval = "hour"
+
+            # Determine truncation function
+            trunc_func = TruncHour if interval == "hour" else TruncDay
+
+            # Get timeline data
+            timeline_data = (
+                CentrifugoLog.objects.recent(hours)
+                .annotate(period=trunc_func("created_at"))
+                .values("period")
+                .annotate(
+                    count=Count("id"),
+                    successful=Count("id", filter=models.Q(status="success")),
+                    failed=Count("id", filter=models.Q(status="failed")),
+                    timeout=Count("id", filter=models.Q(status="timeout")),
+                )
+                .order_by("period")
+            )
+
+            timeline_list = []
+            for item in timeline_data:
+                timeline_list.append({
+                    "timestamp": item["period"].isoformat(),
+                    "count": item["count"],
+                    "successful": item["successful"],
+                    "failed": item["failed"],
+                    "timeout": item["timeout"],
+                })
+
+            response_data = {
+                "timeline": timeline_list,
+                "period_hours": hours,
+                "interval": interval,
+            }
+
+            return Response(response_data)
+
+        except ValueError as e:
+            logger.warning(f"Timeline validation error: {e}")
+            return Response(
+                {"error": str(e)}, status=status.HTTP_400_BAD_REQUEST
+            )
+        except Exception as e:
+            logger.error(f"Timeline error: {e}", exc_info=True)
+            return Response(
+                {"error": "Internal server error"},
+                status=status.HTTP_500_INTERNAL_SERVER_ERROR,
+            )
+
     @action(detail=False, methods=["get"], url_path="channels")
     def channels(self, request):
         """Get statistics per channel."""
@@ -245,6 +353,7 @@ class CentrifugoMonitorViewSet(viewsets.ViewSet):
                     failed=Count("id", filter=models.Q(status="failed")),
                     avg_duration_ms=Avg("duration_ms"),
                     avg_acks=Avg("acks_received"),
+                    last_activity_at=Max("created_at"),  # NEW: last activity timestamp
                 )
                 .order_by("-total")
             )
@@ -259,6 +368,7 @@ class CentrifugoMonitorViewSet(viewsets.ViewSet):
                         failed=stats["failed"],
                         avg_duration_ms=round(stats["avg_duration_ms"] or 0, 2),
                         avg_acks=round(stats["avg_acks"] or 0, 2),
+                        last_activity_at=stats["last_activity_at"].isoformat() if stats["last_activity_at"] else None,  # NEW
                     )
                 )
 

django_cfg/apps/centrifugo/views/testing_api.py

@@ -103,7 +103,7 @@ class CentrifugoTestingAPIViewSet(viewsets.ViewSet):
     publishing, and manual ACK management.
     """
 
-    authentication_classes = [SessionAuthentication]
+    # authentication_classes = [SessionAuthentication]
     permission_classes = [IsAdminUser]
 
     def __init__(self, *args, **kwargs):

django_cfg/apps/dashboard/__init__.py

@@ -0,0 +1,8 @@
+"""
+Dashboard Application
+
+Provides RESTful API endpoints for dashboard statistics and metrics.
+Designed to work with Next.js frontend without ORM dependencies.
+"""
+
+default_app_config = 'django_cfg.apps.dashboard.apps.DashboardConfig'

django_cfg/apps/dashboard/api/__init__.py

@@ -0,0 +1,27 @@
+"""
+Dashboard API
+
+RESTful API endpoints for dashboard data.
+"""
+
+from .serializers import (
+    ActivityEntrySerializer,
+    DashboardOverviewSerializer,
+    QuickActionSerializer,
+    StatCardSerializer,
+    SystemHealthItemSerializer,
+    SystemHealthSerializer,
+    SystemMetricsSerializer,
+)
+from .viewsets import DashboardViewSet
+
+__all__ = [
+    'DashboardViewSet',
+    'StatCardSerializer',
+    'SystemHealthItemSerializer',
+    'SystemHealthSerializer',
+    'QuickActionSerializer',
+    'ActivityEntrySerializer',
+    'SystemMetricsSerializer',
+    'DashboardOverviewSerializer',
+]

django_cfg/apps/dashboard/api/serializers.py

@@ -0,0 +1,165 @@
+"""
+Dashboard API Serializers
+
+Simple serializers for dashboard endpoints - no nested serializers to avoid allOf.
+Returns plain dict structures for TypeScript generation.
+"""
+
+from rest_framework import serializers
+
+
+class StatCardSerializer(serializers.Serializer):
+    """
+    Serializer for dashboard statistics cards.
+
+    Maps to StatCard Pydantic model.
+    """
+
+    title = serializers.CharField(help_text="Card title")
+    value = serializers.CharField(help_text="Main value to display")
+    icon = serializers.CharField(help_text="Material icon name")
+    change = serializers.CharField(required=False, allow_null=True, help_text="Change indicator (e.g., '+12%')")
+    change_type = serializers.ChoiceField(
+        choices=['positive', 'negative', 'neutral'],
+        default='neutral',
+        help_text="Change type"
+    )
+    description = serializers.CharField(required=False, allow_null=True, help_text="Additional description")
+    color = serializers.CharField(default='primary', help_text="Card color theme")
+
+
+class SystemHealthItemSerializer(serializers.Serializer):
+    """
+    Serializer for system health status items.
+
+    Maps to SystemHealthItem Pydantic model.
+    """
+
+    component = serializers.CharField(help_text="Component name")
+    status = serializers.ChoiceField(
+        choices=['healthy', 'warning', 'error', 'unknown'],
+        help_text="Health status"
+    )
+    description = serializers.CharField(help_text="Status description")
+    last_check = serializers.CharField(help_text="Last check time (ISO format)")
+    health_percentage = serializers.IntegerField(
+        required=False,
+        allow_null=True,
+        min_value=0,
+        max_value=100,
+        help_text="Health percentage (0-100)"
+    )
+
+
+class SystemHealthSerializer(serializers.Serializer):
+    """Serializer for overall system health status."""
+
+    overall_status = serializers.ChoiceField(
+        choices=['healthy', 'warning', 'error', 'unknown'],
+        help_text="Overall system health status"
+    )
+    overall_health_percentage = serializers.IntegerField(
+        min_value=0,
+        max_value=100,
+        help_text="Overall health percentage"
+    )
+    components = SystemHealthItemSerializer(many=True, help_text="Health status of individual components")
+    timestamp = serializers.CharField(help_text="Check timestamp (ISO format)")
+
+
+class QuickActionSerializer(serializers.Serializer):
+    """
+    Serializer for quick action buttons.
+
+    Maps to QuickAction Pydantic model.
+    """
+
+    title = serializers.CharField(help_text="Action title")
+    description = serializers.CharField(help_text="Action description")
+    icon = serializers.CharField(help_text="Material icon name")
+    link = serializers.CharField(help_text="Action URL")
+    color = serializers.ChoiceField(
+        choices=['primary', 'success', 'warning', 'danger', 'secondary'],
+        default='primary',
+        help_text="Button color theme"
+    )
+    category = serializers.CharField(default='general', help_text="Action category")
+
+
+class ActivityEntrySerializer(serializers.Serializer):
+    """Serializer for recent activity entries."""
+
+    id = serializers.IntegerField(help_text="Activity ID")
+    user = serializers.CharField(help_text="User who performed the action")
+    action = serializers.CharField(help_text="Action type (created, updated, deleted, etc.)")
+    resource = serializers.CharField(help_text="Resource affected")
+    timestamp = serializers.CharField(help_text="Activity timestamp (ISO format)")
+    icon = serializers.CharField(help_text="Material icon name")
+    color = serializers.CharField(help_text="Icon color")
+
+
+class SystemMetricsSerializer(serializers.Serializer):
+    """Serializer for system performance metrics."""
+
+    cpu_usage = serializers.FloatField(help_text="CPU usage percentage")
+    memory_usage = serializers.FloatField(help_text="Memory usage percentage")
+    disk_usage = serializers.FloatField(help_text="Disk usage percentage")
+    network_in = serializers.CharField(help_text="Network incoming bandwidth")
+    network_out = serializers.CharField(help_text="Network outgoing bandwidth")
+    response_time = serializers.CharField(help_text="Average response time")
+    uptime = serializers.CharField(help_text="System uptime")
+
+
+class UserStatisticsSerializer(serializers.Serializer):
+    """Serializer for user statistics."""
+
+    total_users = serializers.IntegerField(help_text="Total number of users")
+    active_users = serializers.IntegerField(help_text="Active users (last 30 days)")
+    new_users = serializers.IntegerField(help_text="New users (last 7 days)")
+    superusers = serializers.IntegerField(help_text="Number of superusers")
+
+
+class AppStatisticsSerializer(serializers.Serializer):
+    """Serializer for application-specific statistics."""
+
+    app_name = serializers.CharField(help_text="Application name")
+    statistics = serializers.DictField(
+        child=serializers.IntegerField(),
+        help_text="Application statistics"
+    )
+
+
+class DashboardOverviewSerializer(serializers.Serializer):
+    """
+    Main serializer for dashboard overview endpoint.
+    Uses DictField to avoid allOf generation in OpenAPI.
+    """
+
+    stat_cards = serializers.ListField(
+        child=serializers.DictField(),
+        help_text="Dashboard statistics cards"
+    )
+    system_health = serializers.ListField(
+        child=serializers.DictField(),
+        help_text="System health status"
+    )
+    quick_actions = serializers.ListField(
+        child=serializers.DictField(),
+        help_text="Quick action buttons"
+    )
+    recent_activity = serializers.ListField(
+        child=serializers.DictField(),
+        help_text="Recent activity entries"
+    )
+    system_metrics = serializers.DictField(help_text="System performance metrics")
+    user_statistics = serializers.DictField(help_text="User statistics")
+    timestamp = serializers.CharField(help_text="Data timestamp (ISO format)")
+
+
+class APIResponseSerializer(serializers.Serializer):
+    """Standard API response wrapper."""
+
+    success = serializers.BooleanField(help_text="Operation success status")
+    message = serializers.CharField(required=False, help_text="Success message")
+    error = serializers.CharField(required=False, help_text="Error message")
+    data = serializers.DictField(required=False, help_text="Response data")