django-cfg 1.2.16__py3-none-any.whl → 1.2.18__py3-none-any.whl

django_cfg/apps/maintenance/views/sites.py

@@ -1,338 +0,0 @@
-"""
-Site management views.
-
-ViewSets for CloudflareSite and SiteGroup management.
-"""
-
-import logging
-from datetime import datetime
-
-from django.shortcuts import get_object_or_404
-from rest_framework import viewsets, status
-from rest_framework.decorators import action
-from drf_spectacular.utils import (
-    extend_schema, extend_schema_view, OpenApiResponse, OpenApiParameter, OpenApiTypes
-)
-
-from ..models import CloudflareSite, SiteGroup
-from ..serializers import (
-    CloudflareSiteSerializer, CloudflareSiteCreateSerializer, CloudflareSiteListSerializer,
-    SiteGroupSerializer, SiteGroupCreateSerializer,
-    BulkMaintenanceActionSerializer, APIResponseSerializer
-)
-from ..services import MaintenanceManager
-from .base import MaintenancePermissionMixin, MaintenanceResponseMixin
-
-logger = logging.getLogger(__name__)
-
-
-@extend_schema_view(
-    list=extend_schema(
-        summary="List Cloudflare sites",
-        description="Get list of Cloudflare sites with filtering options",
-        parameters=[
-            OpenApiParameter('environment', OpenApiTypes.STR, description='Filter by environment'),
-            OpenApiParameter('project', OpenApiTypes.STR, description='Filter by project'),
-            OpenApiParameter('status', OpenApiTypes.STR, description='Filter by status'),
-            OpenApiParameter('maintenance_active', OpenApiTypes.BOOL, description='Filter by maintenance status'),
-            OpenApiParameter('search', OpenApiTypes.STR, description='Search in name and domain'),
-        ]
-    ),
-    create=extend_schema(
-        summary="Create Cloudflare site",
-        description="Create a new Cloudflare site configuration"
-    ),
-    retrieve=extend_schema(
-        summary="Get Cloudflare site",
-        description="Get detailed information about a specific Cloudflare site"
-    ),
-    update=extend_schema(
-        summary="Update Cloudflare site",
-        description="Update Cloudflare site configuration"
-    ),
-    destroy=extend_schema(
-        summary="Delete Cloudflare site",
-        description="Delete a Cloudflare site configuration"
-    )
-)
-class CloudflareSiteViewSet(MaintenancePermissionMixin, MaintenanceResponseMixin, viewsets.ModelViewSet):
-    """ViewSet for managing Cloudflare sites."""
-    
-    serializer_class = CloudflareSiteSerializer
-    lookup_field = 'id'
-    filterset_fields = ['environment', 'project', 'current_status', 'maintenance_active']
-    search_fields = ['name', 'domain', 'project']
-    ordering_fields = ['name', 'domain', 'created_at', 'last_maintenance_at']
-    ordering = ['-created_at']
-    
-    def get_queryset(self):
-        """Get queryset filtered by user permissions."""
-        return self.get_user_queryset(CloudflareSite)
-    
-    def get_serializer_class(self):
-        """Return appropriate serializer based on action."""
-        if self.action == 'create':
-            return CloudflareSiteCreateSerializer
-        elif self.action == 'list':
-            return CloudflareSiteListSerializer
-        elif self.action == 'bulk_action':
-            return BulkMaintenanceActionSerializer
-        return CloudflareSiteSerializer
-    
-    def perform_create(self, serializer):
-        """Set owner when creating site."""
-        serializer.save(owner=self.request.user)
-    
-    @action(detail=True, methods=['post'])
-    @extend_schema(
-        summary="Enable maintenance mode",
-        description="Enable maintenance mode for this site",
-        request=None,
-        responses={
-            200: OpenApiResponse(response=APIResponseSerializer, description="Maintenance enabled successfully"),
-            400: OpenApiResponse(response=APIResponseSerializer, description="Bad request"),
-            500: OpenApiResponse(response=APIResponseSerializer, description="Internal server error")
-        }
-    )
-    def enable_maintenance(self, request, id=None):
-        """Enable maintenance mode for a site."""
-        try:
-            site = self.get_object()
-            reason = request.data.get('reason', 'Manual maintenance')
-            message = request.data.get('message', 'Site is under maintenance')
-            
-            # Use multi-site manager for consistency
-            manager = MaintenanceManager(self.request.user)
-            success = manager._enable_site_maintenance(site, reason, message)
-            
-            if success:
-                return self.success_response(f'Maintenance enabled for {site.domain}')
-            else:
-                return self.error_response('Failed to enable maintenance mode')
-                
-        except Exception as e:
-            return self.error_response(f"Enable maintenance error for site {id}: {e}")
-    
-    @action(detail=True, methods=['post'])
-    @extend_schema(
-        summary="Disable maintenance mode",
-        description="Disable maintenance mode for this site",
-        responses={
-            200: OpenApiResponse(response=APIResponseSerializer, description="Maintenance disabled successfully"),
-            500: OpenApiResponse(response=APIResponseSerializer, description="Internal server error")
-        }
-    )
-    def disable_maintenance(self, request, id=None):
-        """Disable maintenance mode for a site."""
-        try:
-            site = self.get_object()
-            
-            # Use multi-site manager for consistency
-            manager = MaintenanceManager(self.request.user)
-            success = manager._disable_site_maintenance(site)
-            
-            if success:
-                return self.success_response(f'Maintenance disabled for {site.domain}')
-            else:
-                return self.error_response('Failed to disable maintenance mode')
-                
-        except Exception as e:
-            return self.error_response(f"Disable maintenance error for site {id}: {e}")
-    
-    @action(detail=True, methods=['get'])
-    @extend_schema(
-        summary="Check site status",
-        description="Check current status of the site",
-        responses={
-            200: OpenApiResponse(response=APIResponseSerializer, description="Status checked successfully")
-        }
-    )
-    def check_status(self, request, id=None):
-        """Check current status of a site."""
-        try:
-            site = self.get_object()
-            
-            # Use multi-site manager for consistency
-            manager = MaintenanceManager(self.request.user)
-            site_status = manager._check_site_status(site)
-            
-            return self.success_response(
-                'Status checked successfully',
-                data={
-                    'site_id': site.id,
-                    'domain': site.domain,
-                    'status': site_status,
-                    'maintenance_active': site.maintenance_active,
-                    'last_check': datetime.now().isoformat()
-                }
-            )
-            
-        except Exception as e:
-            return self.error_response(f"Status check error for site {id}: {e}")
-    
-    @action(detail=False, methods=['post'])
-    @extend_schema(
-        summary="Bulk maintenance actions",
-        description="Perform bulk maintenance actions on multiple sites",
-        request=BulkMaintenanceActionSerializer,
-        responses={
-            200: OpenApiResponse(response=APIResponseSerializer, description="Bulk action completed"),
-            400: OpenApiResponse(response=APIResponseSerializer, description="Invalid request data")
-        }
-    )
-    def bulk_action(self, request):
-        """Perform bulk maintenance actions."""
-        serializer = BulkMaintenanceActionSerializer(data=request.data)
-        if not serializer.is_valid():
-            return self.validation_error_response(serializer.errors)
-        
-        try:
-            action_type = serializer.validated_data['action']
-            site_ids = serializer.validated_data['site_ids']
-            dry_run = serializer.validated_data.get('dry_run', False)
-            
-            # Get sites (filtered by user permissions)
-            sites = self.get_queryset().filter(id__in=site_ids)
-            
-            if dry_run:
-                return self.success_response(
-                    f'Dry run: would {action_type} maintenance for {sites.count()} sites',
-                    data={
-                        'dry_run': True,
-                        'would_affect': [site.domain for site in sites]
-                    }
-                )
-            
-            # Use multi-site manager for bulk operations
-            manager = MaintenanceManager(self.request.user).sites(request.user).filter(id__in=site_ids)
-            
-            if action_type == 'enable':
-                reason = serializer.validated_data.get('reason', 'Bulk maintenance')
-                result = manager.enable_maintenance(
-                    reason=reason,
-                    user=request.user,
-                    message=serializer.validated_data.get('maintenance_message')
-                )
-            elif action_type == 'disable':
-                result = manager.disable_maintenance(user=request.user)
-            elif action_type == 'status_check':
-                result = manager.check_status()
-            else:
-                return self.error_response(f'Unknown action: {action_type}', status.HTTP_400_BAD_REQUEST)
-            
-            return self.success_response(f'Bulk {action_type} completed', data=result)
-            
-        except Exception as e:
-            return self.error_response(f"Bulk action error: {e}")
-
-
-@extend_schema_view(
-    list=extend_schema(
-        summary="List site groups",
-        description="Get list of site groups"
-    ),
-    create=extend_schema(
-        summary="Create site group",
-        description="Create a new site group"
-    )
-)
-class SiteGroupViewSet(MaintenancePermissionMixin, MaintenanceResponseMixin, viewsets.ModelViewSet):
-    """ViewSet for managing site groups."""
-    
-    serializer_class = SiteGroupSerializer
-    lookup_field = 'id'
-    
-    def get_queryset(self):
-        """Get queryset filtered by user permissions."""
-        return self.get_user_queryset(SiteGroup)
-    
-    def get_serializer_class(self):
-        """Return appropriate serializer based on action."""
-        if self.action == 'create':
-            return SiteGroupCreateSerializer
-        return SiteGroupSerializer
-    
-    def perform_create(self, serializer):
-        """Set owner when creating group."""
-        serializer.save(owner=self.request.user)
-    
-    @action(detail=True, methods=['post'])
-    @extend_schema(
-        summary="Add sites to group",
-        description="Add sites to this group"
-    )
-    def add_sites(self, request, id=None):
-        """Add sites to group."""
-        try:
-            group = self.get_object()
-            site_ids = request.data.get('site_ids', [])
-            
-            # Get sites (filtered by user permissions)
-            sites = self.get_user_queryset(CloudflareSite).filter(id__in=site_ids)
-            group.sites.add(*sites)
-            
-            return self.success_response(f'Added {sites.count()} sites to group {group.name}')
-            
-        except Exception as e:
-            return self.error_response(f"Add sites to group error: {e}")
-    
-    @action(detail=True, methods=['post'])
-    @extend_schema(
-        summary="Remove sites from group",
-        description="Remove sites from this group"
-    )
-    def remove_sites(self, request, id=None):
-        """Remove sites from group."""
-        try:
-            group = self.get_object()
-            site_ids = request.data.get('site_ids', [])
-            
-            # Get sites (filtered by user permissions)
-            sites = self.get_user_queryset(CloudflareSite).filter(id__in=site_ids)
-            group.sites.remove(*sites)
-            
-            return self.success_response(f'Removed {sites.count()} sites from group {group.name}')
-            
-        except Exception as e:
-            return self.error_response(f"Remove sites from group error: {e}")
-    
-    @action(detail=True, methods=['post'])
-    @extend_schema(
-        summary="Enable maintenance for group",
-        description="Enable maintenance mode for all sites in this group"
-    )
-    def enable_maintenance(self, request, id=None):
-        """Enable maintenance for all sites in group."""
-        try:
-            group = self.get_object()
-            reason = request.data.get('reason', f'Group maintenance: {group.name}')
-            
-            result = group.enable_maintenance_for_all(request.user, reason)
-            
-            return self.success_response(
-                f'Group maintenance enabled for {group.name}',
-                data=result
-            )
-            
-        except Exception as e:
-            return self.error_response(f"Group maintenance enable error: {e}")
-    
-    @action(detail=True, methods=['post'])
-    @extend_schema(
-        summary="Disable maintenance for group",
-        description="Disable maintenance mode for all sites in this group"
-    )
-    def disable_maintenance(self, request, id=None):
-        """Disable maintenance for all sites in group."""
-        try:
-            group = self.get_object()
-            
-            result = group.disable_maintenance_for_all()
-            
-            return self.success_response(
-                f'Group maintenance disabled for {group.name}',
-                data=result
-            )
-            
-        except Exception as e:
-            return self.error_response(f"Group maintenance disable error: {e}")

django_cfg/models/cloudflare.py

@@ -1,316 +0,0 @@
-"""
-Cloudflare configuration models for django_cfg.
-
-Type-safe Cloudflare maintenance mode configuration following CRITICAL_REQUIREMENTS.
-No raw Dict/Any usage - everything through Pydantic v2 models.
-"""
-
-from typing import Annotated, Optional, List, Dict, Any
-from pydantic import BaseModel, Field, SecretStr, field_validator, HttpUrl
-from enum import Enum
-from datetime import timedelta
-
-
-class MaintenanceTemplate(str, Enum):
-    """Available maintenance page templates."""
-    BASIC = "basic"
-    MODERN = "modern"
-    CUSTOM = "custom"
-
-
-class CloudflareConfig(BaseModel):
-    """
-    Zero-configuration Cloudflare maintenance mode setup.
-    
-    Following KISS principle - user provides only api_token and domain,
-    everything else is auto-discovered and configured.
-    """
-    
-    model_config = {
-        "env_prefix": "CLOUDFLARE_",
-        "case_sensitive": False,
-        "validate_assignment": True,
-        "extra": "forbid",
-        "str_strip_whitespace": True,
-    }
-    
-    # === Required Configuration (Zero-config approach) ===
-    api_token: SecretStr = Field(
-        description="Cloudflare API token with Zone:Edit permissions"
-    )
-    domain: Annotated[str, Field(
-        min_length=3,
-        max_length=253,
-        pattern=r"^[a-zA-Z0-9]([a-zA-Z0-9\-]{0,61}[a-zA-Z0-9])?(\.[a-zA-Z0-9]([a-zA-Z0-9\-]{0,61}[a-zA-Z0-9])?)*$",
-        description="Domain name (auto-discovers Zone ID)"
-    )]
-    
-    # === Auto-discovered Fields (set by system) ===
-    zone_id: Optional[str] = Field(
-        default=None, 
-        description="Auto-discovered Cloudflare Zone ID"
-    )
-    account_id: Optional[str] = Field(
-        default=None, 
-        description="Auto-discovered Cloudflare Account ID"
-    )
-    
-    # === Optional Customization ===
-    enabled: bool = Field(
-        default=True,
-        description="Enable Cloudflare maintenance mode integration"
-    )
-    
-    template: MaintenanceTemplate = Field(
-        default=MaintenanceTemplate.MODERN,
-        description="Maintenance page template"
-    )
-    
-    maintenance_title: str = Field(
-        default="Site Under Maintenance",
-        max_length=200,
-        description="Title for maintenance page"
-    )
-    
-    maintenance_message: str = Field(
-        default="We're performing scheduled maintenance. Please try again shortly.",
-        max_length=1000,
-        description="Message for maintenance page"
-    )
-    
-    # === Auto-configuration Flags ===
-    auto_ssl: bool = Field(
-        default=True, 
-        description="Automatically configure SSL/TLS settings"
-    )
-    auto_dns: bool = Field(
-        default=True, 
-        description="Create missing DNS records automatically"
-    )
-    auto_monitoring: bool = Field(
-        default=True, 
-        description="Enable external monitoring"
-    )
-    
-    # === Advanced Settings (Smart Defaults) ===
-    worker_name: str = Field(
-        default="maintenance-mode",
-        max_length=100,
-        pattern=r"^[a-zA-Z0-9\-_]+$",
-        description="Cloudflare Worker name"
-    )
-    
-    monitoring_interval: Annotated[int, Field(
-        ge=30, 
-        le=3600,
-        description="Health check interval in seconds"
-    )] = 60
-    
-    failure_threshold: Annotated[int, Field(
-        ge=1, 
-        le=10,
-        description="Consecutive failures before enabling maintenance"
-    )] = 3
-    
-    recovery_threshold: Annotated[int, Field(
-        ge=1, 
-        le=10,
-        description="Consecutive successes before disabling maintenance"
-    )] = 2
-    
-    # === Multi-site Support ===
-    multi_site_enabled: bool = Field(
-        default=False,
-        description="Enable multi-site management features"
-    )
-    
-    @field_validator('domain')
-    @classmethod
-    def validate_domain(cls, v: str) -> str:
-        """Validate and normalize domain name."""
-        domain = v.lower().strip()
-        
-        # Remove protocol if present
-        if domain.startswith(('http://', 'https://')):
-            raise ValueError('Domain should not include protocol (http:// or https://)')
-        
-        # Remove www prefix for consistency
-        if domain.startswith('www.'):
-            domain = domain[4:]
-        
-        # Basic domain validation
-        if not domain or '.' not in domain:
-            raise ValueError('Domain must be a valid domain name')
-        
-        return domain
-    
-    def get_api_token(self) -> str:
-        """Get decrypted API token."""
-        return self.api_token.get_secret_value()
-    
-    def is_configured(self) -> bool:
-        """Check if Cloudflare is fully configured."""
-        return bool(self.zone_id and self.account_id)
-
-
-class MultiSiteConfig(BaseModel):
-    """
-    Multi-site management configuration.
-    
-    Extends CloudflareConfig for managing multiple sites.
-    """
-    
-    model_config = {
-        "validate_assignment": True,
-        "extra": "forbid"
-    }
-    
-    # === Site Discovery ===
-    auto_discover_sites: bool = Field(
-        default=True,
-        description="Automatically discover all sites in Cloudflare account"
-    )
-    
-    site_filters: List[str] = Field(
-        default_factory=list,
-        description="Domain patterns to include (e.g., ['*.example.com', 'api.*.com'])"
-    )
-    
-    excluded_domains: List[str] = Field(
-        default_factory=list,
-        description="Domains to exclude from management"
-    )
-    
-    # === Default Site Settings ===
-    default_environment: str = Field(
-        default="production",
-        pattern=r"^(production|staging|development|testing)$",
-        description="Default environment for discovered sites"
-    )
-    
-    default_project: str = Field(
-        default="",
-        max_length=100,
-        description="Default project name for discovered sites"
-    )
-    
-    default_tags: List[str] = Field(
-        default_factory=list,
-        description="Default tags for discovered sites"
-    )
-    
-    # === Bulk Operations ===
-    max_concurrent_operations: Annotated[int, Field(
-        ge=1, 
-        le=50,
-        description="Maximum concurrent Cloudflare API operations"
-    )] = 10
-    
-    operation_timeout: Annotated[int, Field(
-        ge=5, 
-        le=300,
-        description="Timeout for individual operations in seconds"
-    )] = 30
-    
-    # === Notifications ===
-    notification_channels: List[str] = Field(
-        default_factory=lambda: ["email"],
-        description="Notification channels for maintenance events"
-    )
-    
-    webhook_url: Optional[HttpUrl] = Field(
-        default=None,
-        description="Webhook URL for maintenance notifications"
-    )
-
-
-class MonitoringConfig(BaseModel):
-    """
-    External monitoring configuration.
-    
-    Configures health checks and automatic maintenance triggers.
-    """
-    
-    model_config = {
-        "validate_assignment": True,
-        "extra": "forbid"
-    }
-    
-    # === Monitoring Settings ===
-    enabled: bool = Field(
-        default=True,
-        description="Enable external monitoring"
-    )
-    
-    check_interval: Annotated[int, Field(
-        ge=10, 
-        le=3600,
-        description="Health check interval in seconds"
-    )] = 60
-    
-    timeout: Annotated[int, Field(
-        ge=1, 
-        le=300,
-        description="Health check timeout in seconds"
-    )] = 10
-    
-    # === Health Check Configuration ===
-    health_check_path: str = Field(
-        default="/health/",
-        description="Health check endpoint path"
-    )
-    
-    expected_status_codes: List[int] = Field(
-        default_factory=lambda: [200, 201, 204],
-        description="Expected HTTP status codes for healthy response"
-    )
-    
-    expected_response_time_ms: Optional[int] = Field(
-        default=5000,
-        ge=100,
-        le=60000,
-        description="Maximum expected response time in milliseconds"
-    )
-    
-    # === Failure Detection ===
-    failure_threshold: Annotated[int, Field(
-        ge=1, 
-        le=20,
-        description="Consecutive failures before triggering maintenance"
-    )] = 3
-    
-    recovery_threshold: Annotated[int, Field(
-        ge=1, 
-        le=20,
-        description="Consecutive successes before disabling maintenance"
-    )] = 2
-    
-    # === Advanced Settings ===
-    user_agent: str = Field(
-        default="Django-CFG-Monitor/1.0",
-        description="User agent for health checks"
-    )
-    
-    follow_redirects: bool = Field(
-        default=True,
-        description="Follow HTTP redirects during health checks"
-    )
-    
-    verify_ssl: bool = Field(
-        default=True,
-        description="Verify SSL certificates during health checks"
-    )
-    
-    custom_headers: Dict[str, str] = Field(
-        default_factory=dict,
-        description="Custom headers for health check requests"
-    )
-
-
-# Export all models
-__all__ = [
-    "CloudflareConfig",
-    "MultiSiteConfig", 
-    "MonitoringConfig",
-    "MaintenanceTemplate",
-]