django-cfg 1.4.48__py3-none-any.whl → 1.5.7__py3-none-any.whl

django_cfg/apps/system/dashboard/serializers/config.py

@@ -0,0 +1,245 @@
+"""
+Django Config Serializers
+
+Serializers for displaying user's DjangoConfig settings.
+"""
+
+from rest_framework import serializers
+
+
+# Nested serializers for complex structures
+
+class DatabaseConfigSerializer(serializers.Serializer):
+    """Database configuration."""
+    engine = serializers.CharField()
+    name = serializers.CharField()
+    user = serializers.CharField(required=False, allow_null=True)
+    password = serializers.CharField(required=False, allow_null=True)
+    host = serializers.CharField(required=False, allow_null=True)
+    port = serializers.IntegerField(required=False, allow_null=True)
+    connect_timeout = serializers.IntegerField(required=False, allow_null=True)
+    sslmode = serializers.CharField(required=False, allow_null=True)
+    options = serializers.DictField(required=False, allow_null=True)
+    apps = serializers.ListField(required=False, allow_null=True)
+    operations = serializers.ListField(required=False, allow_null=True)
+    migrate_to = serializers.CharField(required=False, allow_null=True)
+    routing_description = serializers.CharField(required=False, allow_null=True)
+
+
+class EmailConfigSerializer(serializers.Serializer):
+    """Email configuration."""
+    backend = serializers.CharField(required=False, allow_null=True)
+    host = serializers.CharField(required=False, allow_null=True)
+    port = serializers.IntegerField(required=False, allow_null=True)
+    username = serializers.CharField(required=False, allow_null=True)
+    password = serializers.CharField(required=False, allow_null=True)
+    use_tls = serializers.BooleanField(required=False, allow_null=True)
+    use_ssl = serializers.BooleanField(required=False, allow_null=True)
+    ssl_verify = serializers.BooleanField(required=False, allow_null=True)
+    timeout = serializers.IntegerField(required=False, allow_null=True)
+    default_from = serializers.CharField(required=False, allow_null=True)
+
+
+class PaymentsNowPaymentsSerializer(serializers.Serializer):
+    """NowPayments configuration."""
+    api_key = serializers.CharField(required=False, allow_null=True)
+    ipn_secret = serializers.CharField(required=False, allow_null=True)
+    sandbox = serializers.BooleanField(required=False, allow_null=True)
+    enabled = serializers.BooleanField(required=False, allow_null=True)
+
+
+class PaymentsConfigSerializer(serializers.Serializer):
+    """Payments configuration."""
+    enabled = serializers.BooleanField(required=False, allow_null=True)
+    nowpayments = PaymentsNowPaymentsSerializer(required=False, allow_null=True)
+
+
+class GRPCConfigDashboardSerializer(serializers.Serializer):
+    """gRPC configuration for dashboard."""
+    enabled = serializers.BooleanField(required=False, allow_null=True)
+    host = serializers.CharField(required=False, allow_null=True)
+    port = serializers.IntegerField(required=False, allow_null=True)
+    max_workers = serializers.IntegerField(required=False, allow_null=True)
+    reflection = serializers.BooleanField(required=False, allow_null=True)
+    health_check = serializers.BooleanField(required=False, allow_null=True)
+    interceptors = serializers.ListField(required=False, allow_null=True)
+
+
+class CentrifugoConfigSerializer(serializers.Serializer):
+    """Centrifugo configuration."""
+    enabled = serializers.BooleanField(required=False, allow_null=True)
+    api_url = serializers.CharField(required=False, allow_null=True)
+    api_key = serializers.CharField(required=False, allow_null=True)
+    token_hmac_secret_key = serializers.CharField(required=False, allow_null=True)
+    timeout = serializers.IntegerField(required=False, allow_null=True)
+
+
+class RedisQueueConfigSerializer(serializers.Serializer):
+    """Redis Queue configuration."""
+    url = serializers.CharField(required=False, allow_null=True)
+    host = serializers.CharField(required=False, allow_null=True)
+    port = serializers.IntegerField(required=False, allow_null=True)
+    db = serializers.IntegerField(required=False, allow_null=True)
+    username = serializers.CharField(required=False, allow_null=True)
+    password = serializers.CharField(required=False, allow_null=True)
+    default_timeout = serializers.IntegerField(required=False, allow_null=True)
+    default_result_ttl = serializers.IntegerField(required=False, allow_null=True)
+    sentinels = serializers.ListField(required=False, allow_null=True)
+    master_name = serializers.CharField(required=False, allow_null=True)
+    socket_timeout = serializers.IntegerField(required=False, allow_null=True)
+
+
+class DjangoRQConfigSerializer(serializers.Serializer):
+    """Django-RQ configuration."""
+    enabled = serializers.BooleanField(required=False, allow_null=True)
+    queues = serializers.ListField(child=RedisQueueConfigSerializer(), required=False, allow_null=True)
+    show_admin_link = serializers.BooleanField(required=False, allow_null=True)
+    exception_handlers = serializers.ListField(required=False, allow_null=True)
+    api_token = serializers.CharField(required=False, allow_null=True)
+    prometheus_enabled = serializers.BooleanField(required=False, allow_null=True)
+    schedules = serializers.ListField(child=serializers.DictField(), required=False, allow_null=True)
+
+
+class DRFConfigSerializer(serializers.Serializer):
+    """Django REST Framework configuration."""
+    default_pagination_class = serializers.CharField(required=False, allow_null=True)
+    page_size = serializers.IntegerField(required=False, allow_null=True)
+
+
+class SpectacularConfigSerializer(serializers.Serializer):
+    """DRF Spectacular configuration."""
+    title = serializers.CharField(required=False, allow_null=True)
+    description = serializers.CharField(required=False, allow_null=True)
+    version = serializers.CharField(required=False, allow_null=True)
+
+
+class JWTConfigSerializer(serializers.Serializer):
+    """JWT configuration."""
+    access_token_lifetime = serializers.IntegerField(required=False, allow_null=True)
+    refresh_token_lifetime = serializers.IntegerField(required=False, allow_null=True)
+    algorithm = serializers.CharField(required=False, allow_null=True)
+
+
+class ConfigMetaSerializer(serializers.Serializer):
+    """Config metadata."""
+    config_class = serializers.CharField()
+    secret_key_configured = serializers.BooleanField()
+
+
+class DjangoConfigSerializer(serializers.Serializer):
+    """
+    Typed serializer for user's DjangoConfig settings.
+
+    Reflects the actual structure of DjangoConfig model.
+    All passwords and sensitive data are sanitized before reaching this serializer.
+    """
+
+    # Project info
+    env_mode = serializers.CharField(required=False, allow_null=True)
+    project_name = serializers.CharField(required=False, allow_null=True)
+    project_logo = serializers.CharField(required=False, allow_null=True)
+    project_version = serializers.CharField(required=False, allow_null=True)
+    project_description = serializers.CharField(required=False, allow_null=True)
+    startup_info_mode = serializers.CharField(required=False, allow_null=True)
+
+    # Feature flags
+    enable_support = serializers.BooleanField(required=False, allow_null=True)
+    enable_accounts = serializers.BooleanField(required=False, allow_null=True)
+    enable_newsletter = serializers.BooleanField(required=False, allow_null=True)
+    enable_leads = serializers.BooleanField(required=False, allow_null=True)
+    enable_knowbase = serializers.BooleanField(required=False, allow_null=True)
+    enable_agents = serializers.BooleanField(required=False, allow_null=True)
+    enable_maintenance = serializers.BooleanField(required=False, allow_null=True)
+    enable_frontend = serializers.BooleanField(required=False, allow_null=True)
+    enable_drf_tailwind = serializers.BooleanField(required=False, allow_null=True)
+
+    # URLs
+    site_url = serializers.CharField(required=False, allow_null=True)
+    api_url = serializers.CharField(required=False, allow_null=True)
+
+    # Debug settings
+    debug = serializers.BooleanField(required=False, allow_null=True)
+    debug_warnings = serializers.BooleanField(required=False, allow_null=True)
+
+    # Django settings
+    root_urlconf = serializers.CharField(required=False, allow_null=True)
+    wsgi_application = serializers.CharField(required=False, allow_null=True)
+    auth_user_model = serializers.CharField(required=False, allow_null=True)
+    project_apps = serializers.ListField(required=False, allow_null=True)
+
+    # Infrastructure
+    databases = serializers.DictField(child=DatabaseConfigSerializer(), required=False, allow_null=True)
+    redis_url = serializers.CharField(required=False, allow_null=True)
+    cache_default = serializers.CharField(required=False, allow_null=True)
+    cache_sessions = serializers.CharField(required=False, allow_null=True)
+
+    # Security
+    security_domains = serializers.ListField(required=False, allow_null=True)
+    ssl_redirect = serializers.BooleanField(required=False, allow_null=True)
+    cors_allow_headers = serializers.ListField(required=False, allow_null=True)
+
+    # Integrations
+    email = EmailConfigSerializer(required=False, allow_null=True)
+    payments = PaymentsConfigSerializer(required=False, allow_null=True)
+    grpc = GRPCConfigDashboardSerializer(required=False, allow_null=True)
+    centrifugo = CentrifugoConfigSerializer(required=False, allow_null=True)
+    django_rq = DjangoRQConfigSerializer(required=False, allow_null=True)
+    drf = DRFConfigSerializer(required=False, allow_null=True)
+    spectacular = SpectacularConfigSerializer(required=False, allow_null=True)
+    jwt = JWTConfigSerializer(required=False, allow_null=True)
+
+    # Other configs (pass-through for flexibility)
+    telegram = serializers.DictField(required=False, allow_null=True)
+    ngrok = serializers.DictField(required=False, allow_null=True)
+    axes = serializers.DictField(required=False, allow_null=True)
+    crypto_fields = serializers.DictField(required=False, allow_null=True)
+    unfold = serializers.CharField(required=False, allow_null=True)  # String representation of Unfold config
+    tailwind_app_name = serializers.CharField(required=False, allow_null=True)
+    tailwind_version = serializers.IntegerField(required=False, allow_null=True)  # Integer version number
+    limits = serializers.DictField(required=False, allow_null=True)
+    api_keys = serializers.DictField(required=False, allow_null=True)
+    custom_middleware = serializers.ListField(required=False, allow_null=True)
+    nextjs_admin = serializers.DictField(required=False, allow_null=True)
+    admin_emails = serializers.ListField(required=False, allow_null=True)
+    constance = serializers.DictField(required=False, allow_null=True)
+    openapi_client = serializers.DictField(required=False, allow_null=True)
+
+    # Metadata
+    _meta = ConfigMetaSerializer(required=False, allow_null=True)
+
+
+class ConfigValidationSerializer(serializers.Serializer):
+    """Validation result for config serializer."""
+    status = serializers.CharField(help_text="Validation status: 'valid', 'warning', or 'error'")
+    missing_in_serializer = serializers.ListField(
+        child=serializers.CharField(),
+        help_text="Fields present in config but missing in serializer"
+    )
+    extra_in_serializer = serializers.ListField(
+        child=serializers.CharField(),
+        help_text="Fields present in serializer but not in config"
+    )
+    type_mismatches = serializers.ListField(
+        child=serializers.DictField(),
+        help_text="Fields with type mismatches"
+    )
+    total_config_fields = serializers.IntegerField(help_text="Total fields in config")
+    total_serializer_fields = serializers.IntegerField(help_text="Total fields in serializer")
+
+
+class ConfigDataSerializer(serializers.Serializer):
+    """
+    Serializer for complete config data endpoint.
+
+    Returns both DjangoConfig and Django settings with validation info.
+    """
+
+    django_config = DjangoConfigSerializer(
+        help_text="User's DjangoConfig settings"
+    )
+    django_settings = serializers.DictField(
+        help_text="Complete Django settings (sanitized)"
+    )
+    _validation = ConfigValidationSerializer(
+        help_text="Validation result comparing serializer with actual config"
+    )

django_cfg/apps/system/dashboard/serializers/overview.py

@@ -0,0 +1,45 @@
+"""
+Overview Serializers
+
+Serializers for dashboard overview endpoint.
+"""
+
+from rest_framework import serializers
+from .statistics import StatCardSerializer, UserStatisticsSerializer, AppStatisticsSerializer
+from .system import SystemHealthSerializer, SystemMetricsSerializer
+from .activity import QuickActionSerializer, ActivityEntrySerializer
+
+
+class DashboardOverviewSerializer(serializers.Serializer):
+    """
+    Main serializer for dashboard overview endpoint.
+    Uses typed serializers for proper OpenAPI schema generation.
+    """
+
+    stat_cards = StatCardSerializer(
+        many=True,
+        help_text="Dashboard statistics cards"
+    )
+    system_health = SystemHealthSerializer(
+        help_text="System health status"
+    )
+    quick_actions = QuickActionSerializer(
+        many=True,
+        help_text="Quick action buttons"
+    )
+    recent_activity = ActivityEntrySerializer(
+        many=True,
+        help_text="Recent activity entries"
+    )
+    system_metrics = SystemMetricsSerializer(
+        help_text="System performance metrics"
+    )
+    user_statistics = UserStatisticsSerializer(
+        help_text="User statistics"
+    )
+    app_statistics = AppStatisticsSerializer(
+        many=True,
+        required=False,
+        help_text="Application statistics"
+    )
+    timestamp = serializers.CharField(help_text="Data timestamp (ISO format)")

django_cfg/apps/system/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/system/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/system/dashboard/services/__init__.py

@@ -0,0 +1,24 @@
+"""
+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
+from .charts_service import ChartsService
+from .commands_service import CommandsService
+from .apizones_service import APIZonesService
+from .overview_service import OverviewService
+from .config_service import ConfigService
+
+__all__ = [
+    'StatisticsService',
+    'SystemHealthService',
+    'ChartsService',
+    'CommandsService',
+    'APIZonesService',
+    'OverviewService',
+    'ConfigService',
+]

django_cfg/apps/system/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},
+            }