django-cfg 1.4.84__py3-none-any.whl → 1.4.86__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.84"
+__version__ = "1.4.86"
 __license__ = "MIT"
 
 # Import registry for organized lazy loading

django_cfg/apps/dashboard/serializers/__init__.py

@@ -0,0 +1,55 @@
+"""
+Dashboard Serializers
+
+Organized by domain for better maintainability.
+"""
+
+from .base import APIResponseSerializer
+from .statistics import StatCardSerializer, UserStatisticsSerializer, AppStatisticsSerializer
+from .system import SystemHealthSerializer, SystemHealthItemSerializer, SystemMetricsSerializer
+from .activity import ActivityEntrySerializer, QuickActionSerializer
+from .overview import DashboardOverviewSerializer
+from .charts import (
+    ChartDataSerializer,
+    ChartDatasetSerializer,
+    ActivityTrackerDaySerializer,
+    RecentUserSerializer,
+)
+from .commands import CommandSerializer, CommandsSummarySerializer
+from .apizones import APIZoneSerializer, APIZonesSummarySerializer
+
+__all__ = [
+    # Base
+    'APIResponseSerializer',
+
+    # Statistics
+    'StatCardSerializer',
+    'UserStatisticsSerializer',
+    'AppStatisticsSerializer',
+
+    # System
+    'SystemHealthSerializer',
+    'SystemHealthItemSerializer',
+    'SystemMetricsSerializer',
+
+    # Activity
+    'ActivityEntrySerializer',
+    'QuickActionSerializer',
+
+    # Overview
+    'DashboardOverviewSerializer',
+
+    # Charts
+    'ChartDataSerializer',
+    'ChartDatasetSerializer',
+    'ActivityTrackerDaySerializer',
+    'RecentUserSerializer',
+
+    # Commands
+    'CommandSerializer',
+    'CommandsSummarySerializer',
+
+    # API Zones
+    'APIZoneSerializer',
+    'APIZonesSummarySerializer',
+]

django_cfg/apps/dashboard/serializers/activity.py

@@ -0,0 +1,38 @@
+"""
+Activity Serializers
+
+Serializers for activity tracking and quick actions.
+"""
+
+from rest_framework import serializers
+
+
+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")

django_cfg/apps/dashboard/serializers/apizones.py

@@ -0,0 +1,26 @@
+"""
+API Zones Serializers
+
+Serializers for OpenAPI zones/groups endpoints.
+"""
+
+from rest_framework import serializers
+
+
+class APIZoneSerializer(serializers.Serializer):
+    """OpenAPI zone/group serializer."""
+    name = serializers.CharField()
+    title = serializers.CharField()
+    description = serializers.CharField()
+    app_count = serializers.IntegerField()
+    endpoint_count = serializers.IntegerField()
+    status = serializers.CharField()
+    schema_url = serializers.CharField()
+    api_url = serializers.CharField()
+    apps = serializers.ListField(child=serializers.CharField())
+
+
+class APIZonesSummarySerializer(serializers.Serializer):
+    """API zones summary serializer."""
+    zones = APIZoneSerializer(many=True)
+    summary = serializers.DictField()

django_cfg/apps/dashboard/serializers/base.py

@@ -0,0 +1,16 @@
+"""
+Base Serializers
+
+Common serializers used across dashboard endpoints.
+"""
+
+from rest_framework import serializers
+
+
+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/serializers/charts.py

@@ -0,0 +1,44 @@
+"""
+Charts Serializers
+
+Serializers for chart data endpoints.
+"""
+
+from rest_framework import serializers
+
+
+class ChartDatasetSerializer(serializers.Serializer):
+    """Chart.js dataset serializer."""
+    label = serializers.CharField()
+    data = serializers.ListField(child=serializers.IntegerField())
+    backgroundColor = serializers.CharField()
+    borderColor = serializers.CharField()
+    tension = serializers.FloatField()
+    fill = serializers.BooleanField(required=False)
+
+
+class ChartDataSerializer(serializers.Serializer):
+    """Chart.js data structure serializer."""
+    labels = serializers.ListField(child=serializers.CharField())
+    datasets = ChartDatasetSerializer(many=True)
+
+
+class ActivityTrackerDaySerializer(serializers.Serializer):
+    """Activity tracker single day serializer."""
+    date = serializers.DateField()
+    count = serializers.IntegerField()
+    level = serializers.IntegerField()
+    color = serializers.CharField()
+    tooltip = serializers.CharField()
+
+
+class RecentUserSerializer(serializers.Serializer):
+    """Recent user serializer."""
+    id = serializers.IntegerField()
+    username = serializers.CharField()
+    email = serializers.EmailField()
+    date_joined = serializers.CharField()
+    is_active = serializers.BooleanField()
+    is_staff = serializers.BooleanField()
+    is_superuser = serializers.BooleanField()
+    last_login = serializers.CharField(allow_null=True)

django_cfg/apps/dashboard/serializers/commands.py

@@ -0,0 +1,26 @@
+"""
+Commands Serializers
+
+Serializers for Django management commands endpoints.
+"""
+
+from rest_framework import serializers
+
+
+class CommandSerializer(serializers.Serializer):
+    """Django management command serializer."""
+    name = serializers.CharField()
+    app = serializers.CharField()
+    help = serializers.CharField()
+    is_core = serializers.BooleanField()
+    is_custom = serializers.BooleanField()
+
+
+class CommandsSummarySerializer(serializers.Serializer):
+    """Commands summary serializer."""
+    total_commands = serializers.IntegerField()
+    core_commands = serializers.IntegerField()
+    custom_commands = serializers.IntegerField()
+    categories = serializers.ListField(child=serializers.CharField())
+    commands = CommandSerializer(many=True)
+    categorized = serializers.DictField()

django_cfg/apps/dashboard/serializers/overview.py

@@ -0,0 +1,34 @@
+"""
+Overview Serializers
+
+Serializers for dashboard overview endpoint.
+"""
+
+from rest_framework import serializers
+
+
+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)")

django_cfg/apps/dashboard/serializers/statistics.py

@@ -0,0 +1,46 @@
+"""
+Statistics Serializers
+
+Serializers for dashboard statistics endpoints.
+"""
+
+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 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"
+    )

django_cfg/apps/dashboard/serializers/system.py

@@ -0,0 +1,58 @@
+"""
+System Serializers
+
+Serializers for system health and metrics endpoints.
+"""
+
+from rest_framework import serializers
+
+
+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 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")

django_cfg/apps/dashboard/services/__init__.py

@@ -7,5 +7,14 @@ Services are separated from views/API layer for better testability and reusabili
 
 from .statistics_service import StatisticsService
 from .system_health_service import SystemHealthService
+from .charts_service import ChartsService
+from .commands_service import CommandsService
+from .apizones_service import APIZonesService
 
-__all__ = ['StatisticsService', 'SystemHealthService']
+__all__ = [
+    'StatisticsService',
+    'SystemHealthService',
+    'ChartsService',
+    'CommandsService',
+    'APIZonesService',
+]

django_cfg/apps/dashboard/services/apizones_service.py

@@ -0,0 +1,119 @@
+"""
+API Zones Service
+
+OpenAPI zones/groups management and introspection.
+"""
+
+import logging
+from typing import Any, Dict, List, Tuple
+
+logger = logging.getLogger(__name__)
+
+
+class APIZonesService:
+    """
+    Service for OpenAPI zones (groups) management.
+
+    %%PRIORITY:MEDIUM%%
+    %%AI_HINT: Manages OpenAPI schema groups and endpoints%%
+
+    TAGS: openapi, api, zones, groups, service
+    """
+
+    def __init__(self):
+        """Initialize API zones service."""
+        self.logger = logger
+
+    def get_zones_data(self) -> Tuple[List[Dict[str, Any]], Dict[str, Any]]:
+        """
+        Get OpenAPI zones (groups) data.
+
+        Returns:
+            Tuple of (zones_list, summary_dict)
+
+        %%AI_HINT: Integrates with django_client module if available%%
+        """
+        try:
+            # Try to import django_client service
+            from django_cfg.modules.django_client.core import get_openapi_service
+
+            service = get_openapi_service()
+            if not service.config:
+                return [], {"total_apps": 0, "total_endpoints": 0, "total_zones": 0}
+
+            # Get groups (zones)
+            groups_dict = service.get_groups()
+            groups_list = list(groups_dict.values())
+            api_prefix = getattr(service.config, "api_prefix", "api")
+
+            zones_data = []
+            total_apps = 0
+            total_endpoints = 0
+
+            for group in groups_list:
+                # Handle both dict and object access
+                if isinstance(group, dict):
+                    zone_name = group.get("name", "unknown")
+                    title = group.get("title", zone_name.title())
+                    description = group.get("description", f"{zone_name} zone")
+                    apps = group.get("apps", [])
+                else:
+                    zone_name = getattr(group, "name", "unknown")
+                    title = getattr(group, "title", zone_name.title())
+                    description = getattr(group, "description", f"{zone_name} zone")
+                    apps = getattr(group, "apps", [])
+
+                # Estimate endpoint count
+                endpoint_count = len(apps) * 3
+
+                zones_data.append({
+                    "name": zone_name,
+                    "title": title,
+                    "description": description,
+                    "app_count": len(apps),
+                    "endpoint_count": endpoint_count,
+                    "status": "active" if apps else "empty",
+                    "schema_url": f"/cfg/openapi/{zone_name}/schema/",
+                    "api_url": f"/{api_prefix}/{zone_name}/",
+                    "apps": apps,
+                })
+
+                total_apps += len(apps)
+                total_endpoints += endpoint_count
+
+            summary = {
+                "total_apps": total_apps,
+                "total_endpoints": total_endpoints,
+                "total_zones": len(zones_data),
+            }
+
+            return zones_data, summary
+
+        except ImportError:
+            self.logger.warning("django_client module not available")
+            return [], {"total_apps": 0, "total_endpoints": 0, "total_zones": 0}
+        except Exception as e:
+            self.logger.error(f"Error getting zones data: {e}")
+            return [], {"total_apps": 0, "total_endpoints": 0, "total_zones": 0}
+
+    def get_zones_summary(self) -> Dict[str, Any]:
+        """
+        Get summary of all API zones.
+
+        Returns:
+            Dictionary with zones list and summary statistics
+        """
+        try:
+            zones_list, summary = self.get_zones_data()
+
+            return {
+                "zones": zones_list,
+                "summary": summary,
+            }
+
+        except Exception as e:
+            self.logger.error(f"Error getting zones summary: {e}")
+            return {
+                "zones": [],
+                "summary": {"total_apps": 0, "total_endpoints": 0, "total_zones": 0},
+            }