django-cfg 1.4.83__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.83"
+__version__ = "1.4.84"
 __license__ = "MIT"
 
 # Import registry for organized lazy loading

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")

django_cfg/apps/dashboard/api/viewsets.py

@@ -0,0 +1,257 @@
+"""
+Dashboard API ViewSets
+
+Provides RESTful endpoints for dashboard data.
+No ORM dependencies - uses services for data collection.
+"""
+
+import logging
+from datetime import datetime
+from typing import Any, Dict
+
+from drf_spectacular.utils import OpenApiParameter, OpenApiResponse, extend_schema, inline_serializer
+from drf_spectacular.types import OpenApiTypes
+from rest_framework import serializers, status, viewsets
+from rest_framework.authentication import BasicAuthentication, SessionAuthentication
+from rest_framework.decorators import action
+from rest_framework.permissions import IsAdminUser
+from rest_framework.response import Response
+
+from ..services import StatisticsService, SystemHealthService
+from .serializers import (
+    ActivityEntrySerializer,
+    APIResponseSerializer,
+    AppStatisticsSerializer,
+    DashboardOverviewSerializer,
+    QuickActionSerializer,
+    StatCardSerializer,
+    SystemHealthItemSerializer,
+    SystemHealthSerializer,
+    SystemMetricsSerializer,
+    UserStatisticsSerializer,
+)
+
+logger = logging.getLogger(__name__)
+
+
+class DashboardViewSet(viewsets.GenericViewSet):
+    """
+    Dashboard Data ViewSet
+
+    Provides comprehensive dashboard endpoints for Next.js frontend.
+    All data is collected via services without ORM dependencies.
+
+    %%PRIORITY:HIGH%%
+    %%AI_HINT: Main entry point for dashboard API%%
+
+    TAGS: dashboard, api, viewset
+    USED_BY: Next.js admin panel
+    """
+
+    authentication_classes = [SessionAuthentication, BasicAuthentication]
+    permission_classes = [IsAdminUser]
+    serializer_class = DashboardOverviewSerializer
+
+    @action(detail=False, methods=['get'], url_path='overview')
+    @extend_schema(
+        summary="Get dashboard overview",
+        description="Retrieve complete dashboard data including stats, health, actions, and metrics",
+        responses={200: DashboardOverviewSerializer},
+        tags=["Dashboard"]
+    )
+    def overview(self, request):
+        """
+        Get complete dashboard overview.
+
+        Returns all dashboard data in a single request:
+        - Statistics cards
+        - System health status
+        - Quick actions
+        - Recent activity
+        - System metrics
+        - User statistics
+        """
+        try:
+            stats_service = StatisticsService()
+            health_service = SystemHealthService()
+
+            data = {
+                'stat_cards': stats_service.get_stat_cards(),
+                'system_health': health_service.get_all_health_checks(),
+                'quick_actions': health_service.get_quick_actions(),
+                'recent_activity': stats_service.get_recent_activity(limit=10),
+                'system_metrics': stats_service.get_system_metrics(),
+                'user_statistics': stats_service.get_user_statistics(),
+                'timestamp': datetime.now().isoformat(),
+            }
+
+            return Response(data)
+
+        except Exception as e:
+            logger.error(f"Dashboard overview API error: {e}", exc_info=True)
+            return Response({
+                'error': str(e)
+            }, status=status.HTTP_500_INTERNAL_SERVER_ERROR)
+
+    @extend_schema(
+        summary="Get statistics cards",
+        description="Retrieve dashboard statistics cards with key metrics",
+        responses=StatCardSerializer(many=True),
+        tags=["dashboard"]
+    )
+    @action(detail=False, methods=['get'], url_path='stats/cards', pagination_class=None, serializer_class=StatCardSerializer)
+    def stat_cards(self, request):
+        """Get dashboard statistics cards."""
+        try:
+            stats_service = StatisticsService()
+            cards = stats_service.get_stat_cards()
+
+            return Response(cards)
+
+        except Exception as e:
+            logger.error(f"Stat cards API error: {e}")
+            return Response({
+                'error': str(e)
+            }, status=status.HTTP_500_INTERNAL_SERVER_ERROR)
+
+    @extend_schema(
+        summary="Get system health status",
+        description="Retrieve overall system health including all component checks",
+        responses={200: SystemHealthSerializer},
+        tags=["dashboard"]
+    )
+    @action(detail=False, methods=['get'], url_path='health', serializer_class=SystemHealthSerializer)
+    def system_health(self, request):
+        """Get overall system health status."""
+        try:
+            health_service = SystemHealthService()
+            health_data = health_service.get_overall_health_status()
+
+            return Response(health_data)
+
+        except Exception as e:
+            logger.error(f"System health API error: {e}")
+            return Response({
+                'error': str(e)
+            }, status=status.HTTP_500_INTERNAL_SERVER_ERROR)
+
+    @extend_schema(
+        summary="Get quick actions",
+        description="Retrieve quick action buttons for dashboard",
+        responses=QuickActionSerializer(many=True),
+        tags=["Dashboard"]
+    )
+    @action(detail=False, methods=['get'], url_path='actions', pagination_class=None, serializer_class=QuickActionSerializer)
+    def quick_actions(self, request):
+        """Get quick action buttons."""
+        try:
+            health_service = SystemHealthService()
+            actions = health_service.get_quick_actions()
+
+            return Response(actions)
+
+        except Exception as e:
+            logger.error(f"Quick actions API error: {e}")
+            return Response({
+                'error': str(e)
+            }, status=status.HTTP_500_INTERNAL_SERVER_ERROR)
+
+    @extend_schema(
+        summary="Get recent activity",
+        description="Retrieve recent system activity entries",
+        parameters=[
+            OpenApiParameter(
+                name='limit',
+                description='Maximum number of entries to return',
+                required=False,
+                type=int,
+                default=10
+            ),
+        ],
+        responses=ActivityEntrySerializer(many=True),
+        tags=["dashboard"]
+    )
+    @action(detail=False, methods=['get'], url_path='activity', pagination_class=None, serializer_class=ActivityEntrySerializer)
+    def recent_activity(self, request):
+        """Get recent activity entries."""
+        try:
+            limit = int(request.query_params.get('limit', 10))
+            stats_service = StatisticsService()
+            activity = stats_service.get_recent_activity(limit=limit)
+
+            return Response(activity)
+
+        except Exception as e:
+            logger.error(f"Recent activity API error: {e}")
+            return Response({
+                'error': str(e)
+            }, status=status.HTTP_500_INTERNAL_SERVER_ERROR)
+
+    @extend_schema(
+        summary="Get system metrics",
+        description="Retrieve system performance metrics (CPU, memory, disk, etc.)",
+        responses={200: SystemMetricsSerializer},
+        tags=["dashboard"]
+    )
+    @action(detail=False, methods=['get'], url_path='metrics', serializer_class=SystemMetricsSerializer)
+    def system_metrics(self, request):
+        """Get system performance metrics."""
+        try:
+            stats_service = StatisticsService()
+            metrics = stats_service.get_system_metrics()
+
+            return Response(metrics)
+
+        except Exception as e:
+            logger.error(f"System metrics API error: {e}")
+            return Response({
+                'error': str(e)
+            }, status=status.HTTP_500_INTERNAL_SERVER_ERROR)
+
+    @extend_schema(
+        summary="Get user statistics",
+        description="Retrieve user-related statistics",
+        responses={200: UserStatisticsSerializer},
+        tags=["dashboard"]
+    )
+    @action(detail=False, methods=['get'], url_path='stats/users', serializer_class=UserStatisticsSerializer)
+    def user_statistics(self, request):
+        """Get user statistics."""
+        try:
+            stats_service = StatisticsService()
+            user_stats = stats_service.get_user_statistics()
+
+            return Response(user_stats)
+
+        except Exception as e:
+            logger.error(f"User statistics API error: {e}")
+            return Response({
+                'error': str(e)
+            }, status=status.HTTP_500_INTERNAL_SERVER_ERROR)
+
+    @extend_schema(
+        summary="Get application statistics",
+        description="Retrieve statistics for all enabled django-cfg applications",
+        responses=AppStatisticsSerializer(many=True),
+        tags=["dashboard"]
+    )
+    @action(detail=False, methods=['get'], url_path='stats/apps', pagination_class=None, serializer_class=AppStatisticsSerializer)
+    def app_statistics(self, request):
+        """Get application-specific statistics."""
+        try:
+            stats_service = StatisticsService()
+            app_stats = stats_service.get_app_statistics()
+
+            # Convert dict to list of {app_name, statistics} objects
+            data = [
+                {'app_name': app_name, 'statistics': stats}
+                for app_name, stats in app_stats.items()
+            ]
+
+            return Response(data)
+
+        except Exception as e:
+            logger.error(f"App statistics API error: {e}")
+            return Response({
+                'error': str(e)
+            }, status=status.HTTP_500_INTERNAL_SERVER_ERROR)

django_cfg/apps/dashboard/apps.py

@@ -0,0 +1,23 @@
+"""
+Dashboard App Configuration
+"""
+
+from django.apps import AppConfig
+
+
+class DashboardConfig(AppConfig):
+    """Configuration for Dashboard application."""
+
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'django_cfg.apps.dashboard'
+    label = 'dashboard'
+    verbose_name = 'Dashboard'
+
+    def ready(self):
+        """
+        Application initialization.
+
+        Called when Django starts. Import signals or perform
+        other initialization tasks here.
+        """
+        pass

django_cfg/apps/dashboard/services/__init__.py

@@ -0,0 +1,11 @@
+"""
+Dashboard Services
+
+Business logic for collecting and aggregating dashboard data.
+Services are separated from views/API layer for better testability and reusability.
+"""
+
+from .statistics_service import StatisticsService
+from .system_health_service import SystemHealthService
+
+__all__ = ['StatisticsService', 'SystemHealthService']