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

django_cfg/apps/maintenance/migrations/0002_cloudflaresite_maintenance_url.py

@@ -0,0 +1,21 @@
+# Generated by Django 5.2.6 on 2025-09-23 08:14
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("maintenance", "0001_initial"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="cloudflaresite",
+            name="maintenance_url",
+            field=models.URLField(
+                blank=True,
+                help_text="URL to redirect to during maintenance mode. If empty, uses default maintenance page.",
+                max_length=500,
+            ),
+        ),
+    ]

django_cfg/apps/maintenance/models/__init__.py

@@ -1,27 +1,29 @@
 """
-Maintenance app models.
+Simplified maintenance models.
 
-Following django-cfg patterns with proper imports and exports.
+Clean imports for the 4 models, properly decomposed.
+Uses lazy imports to avoid Django initialization issues.
 """
 
-from .maintenance import MaintenanceEvent, MaintenanceLog
-from .sites import CloudflareSite, SiteGroup
-from .monitoring import MonitoringTarget, HealthCheckResult
-from .cloudflare import CloudflareDeployment
+# Lazy import registry to avoid Django initialization issues
+_LAZY_IMPORTS = {
+    'CloudflareApiKey': ('django_cfg.apps.maintenance.models.cloudflare_api_key', 'CloudflareApiKey'),
+    'CloudflareSite': ('django_cfg.apps.maintenance.models.cloudflare_site', 'CloudflareSite'),
+    'MaintenanceLog': ('django_cfg.apps.maintenance.models.maintenance_log', 'MaintenanceLog'),
+    'ScheduledMaintenance': ('django_cfg.apps.maintenance.models.scheduled_maintenance', 'ScheduledMaintenance'),
+}
 
-__all__ = [
-    # Maintenance models
-    'MaintenanceEvent',
-    'MaintenanceLog',
-    
-    # Site management models
-    'CloudflareSite',
-    'SiteGroup',
-    
-    # Monitoring models
-    'MonitoringTarget',
-    'HealthCheckResult',
+
+def __getattr__(name: str):
+    """Lazy import mechanism to avoid Django initialization issues."""
+    if name in _LAZY_IMPORTS:
+        module_path, attr_name = _LAZY_IMPORTS[name]
+        
+        import importlib
+        module = importlib.import_module(module_path)
+        return getattr(module, attr_name)
     
-    # Cloudflare integration models
-    'CloudflareDeployment',
-]
+    raise AttributeError(f"module '{__name__}' has no attribute '{name}'")
+
+
+__all__ = list(_LAZY_IMPORTS.keys())

django_cfg/apps/maintenance/models/cloudflare_api_key.py

@@ -0,0 +1,109 @@
+"""
+CloudflareApiKey model.
+
+Store Cloudflare API keys for different accounts/domains.
+"""
+
+from django.db import models
+from django.core.exceptions import ValidationError
+
+
+class CloudflareApiKey(models.Model):
+    """
+    Store Cloudflare API keys for different domains/accounts.
+    
+    Allows managing multiple Cloudflare accounts with different API tokens.
+    """
+    
+    # Basic info
+    name = models.CharField(
+        max_length=100,
+        help_text="Friendly name for this API key (e.g., 'Production', 'Staging')"
+    )
+    description = models.TextField(
+        blank=True,
+        help_text="Optional description of what this key is used for"
+    )
+    
+    # Cloudflare credentials
+    api_token = models.CharField(
+        max_length=255,
+        help_text="Cloudflare API token"
+    )
+    account_id = models.CharField(
+        max_length=32,
+        blank=True,
+        help_text="Cloudflare Account ID (auto-discovered if empty)"
+    )
+    
+    # Settings
+    is_active = models.BooleanField(
+        default=True,
+        help_text="Whether this API key is active"
+    )
+    is_default = models.BooleanField(
+        default=False,
+        help_text="Whether this is the default API key to use"
+    )
+    
+    # Timestamps
+    created_at = models.DateTimeField(auto_now_add=True)
+    updated_at = models.DateTimeField(auto_now=True)
+    last_used_at = models.DateTimeField(
+        null=True,
+        blank=True,
+        help_text="When this API key was last used"
+    )
+    
+    class Meta:
+        ordering = ['-is_default', 'name']
+        verbose_name = "Cloudflare API Key"
+        verbose_name_plural = "Cloudflare API Keys"
+        indexes = [
+            models.Index(fields=['is_active']),
+            models.Index(fields=['is_default']),
+        ]
+    
+    def __str__(self) -> str:
+        status = "🔑" if self.is_active else "🔒"
+        default = " (Default)" if self.is_default else ""
+        return f"{status} {self.name}{default}"
+    
+    def clean(self) -> None:
+        """Validate model data."""
+        super().clean()
+        
+        # Validate API token format (basic check)
+        if not self.api_token.strip():
+            raise ValidationError({'api_token': 'API token cannot be empty'})
+        
+        # Validate account_id format if provided
+        if self.account_id and len(self.account_id) != 32:
+            raise ValidationError({'account_id': 'Account ID must be 32 characters'})
+    
+    def save(self, *args, **kwargs):
+        """Override save to ensure only one default key."""
+        if self.is_default:
+            # Set all other keys to non-default
+            self.__class__.objects.filter(is_default=True).exclude(pk=self.pk).update(is_default=False)
+        
+        super().save(*args, **kwargs)
+    
+    @classmethod
+    def get_default(cls):
+        """Get the default API key."""
+        try:
+            return cls.objects.filter(is_active=True, is_default=True).first()
+        except cls.DoesNotExist:
+            return None
+    
+    @classmethod
+    def get_active_keys(cls):
+        """Get all active API keys."""
+        return cls.objects.filter(is_active=True)
+    
+    def mark_used(self):
+        """Mark this key as recently used."""
+        from django.utils import timezone
+        self.last_used_at = timezone.now()
+        self.save(update_fields=['last_used_at'])

django_cfg/apps/maintenance/models/cloudflare_site.py

@@ -0,0 +1,125 @@
+"""
+CloudflareSite model.
+
+Simplified model for storing Cloudflare sites for synchronization and maintenance.
+"""
+
+from django.db import models
+from django.core.validators import URLValidator
+from django.core.exceptions import ValidationError
+from django.utils import timezone
+import re
+from django_cfg.config import get_maintenance_url
+
+class CloudflareSite(models.Model):
+    """
+    Store Cloudflare sites for synchronization and maintenance.
+    
+    Simplified from 30+ fields to just 11 essential fields.
+    """
+    
+    # Basic info
+    name = models.CharField(
+        max_length=100,
+        help_text="Friendly site name for identification"
+    )
+    domain = models.CharField(
+        max_length=255,
+        unique=True,
+        help_text="Domain name (e.g., vamcar.com)"
+    )
+    
+    # Cloudflare IDs (auto-discovered during sync)
+    zone_id = models.CharField(
+        max_length=32,
+        unique=True,
+        help_text="Cloudflare Zone ID"
+    )
+    account_id = models.CharField(
+        max_length=32,
+        help_text="Cloudflare Account ID"
+    )
+    api_key = models.ForeignKey(
+        'CloudflareApiKey',
+        on_delete=models.PROTECT,
+        help_text="API key to use for this site"
+    )
+    
+    # Simple status
+    maintenance_active = models.BooleanField(
+        default=False,
+        help_text="Whether maintenance mode is currently active"
+    )
+    maintenance_url = models.URLField(
+        max_length=500,
+        blank=True,
+        help_text="URL to redirect to during maintenance mode. If empty, uses default maintenance page."
+    )
+    is_active = models.BooleanField(
+        default=True,
+        help_text="Whether this site is active in our system"
+    )
+    
+    # Timestamps
+    created_at = models.DateTimeField(auto_now_add=True)
+    updated_at = models.DateTimeField(auto_now=True)
+    last_maintenance_at = models.DateTimeField(
+        null=True,
+        blank=True,
+        help_text="When maintenance was last activated"
+    )
+    
+    # Custom manager
+    from ..managers.cloudflare_site_manager import CloudflareSiteManager
+    objects = CloudflareSiteManager()
+    
+    class Meta:
+        ordering = ['name']
+        verbose_name = "Cloudflare Site"
+        verbose_name_plural = "Cloudflare Sites"
+        indexes = [
+            models.Index(fields=['domain']),
+            models.Index(fields=['maintenance_active']),
+            models.Index(fields=['is_active']),
+        ]
+    
+    def __str__(self) -> str:
+        status_emoji = "🔧" if self.maintenance_active else "🟢"
+        return f"{status_emoji} {self.name} ({self.domain})"
+    
+    def enable_maintenance(self) -> None:
+        """Enable maintenance mode for this site."""
+        self.maintenance_active = True
+        self.last_maintenance_at = timezone.now()
+        self.save(update_fields=['maintenance_active', 'last_maintenance_at', 'updated_at'])
+    
+    def disable_maintenance(self) -> None:
+        """Disable maintenance mode for this site."""
+        self.maintenance_active = False
+        self.save(update_fields=['maintenance_active', 'updated_at'])
+    
+    def get_maintenance_url(self) -> str:
+        """Get the maintenance URL for this site."""
+        if self.maintenance_url:
+            return self.maintenance_url
+        else:
+            # Default maintenance page with site parameter
+            return get_maintenance_url(self.domain)
+    
+    def clean(self) -> None:
+        """Validate model data."""
+        super().clean()
+        
+        # Validate domain format
+        domain_pattern = re.compile(
+            r'^[a-zA-Z0-9]([a-zA-Z0-9\-]{0,61}[a-zA-Z0-9])?'
+            r'(\.[a-zA-Z0-9]([a-zA-Z0-9\-]{0,61}[a-zA-Z0-9])?)*$'
+        )
+        if not domain_pattern.match(self.domain):
+            raise ValidationError({'domain': 'Invalid domain format'})
+        
+        # Validate zone_id format (Cloudflare zone IDs are 32 chars)
+        if len(self.zone_id) != 32:
+            raise ValidationError({'zone_id': 'Zone ID must be 32 characters'})
+
+

django_cfg/apps/maintenance/models/maintenance_log.py

@@ -0,0 +1,131 @@
+"""
+MaintenanceLog model.
+
+Simple log of all maintenance operations.
+"""
+
+from django.db import models
+from .cloudflare_site import CloudflareSite
+
+
+class MaintenanceLog(models.Model):
+    """
+    Simple log of all maintenance operations.
+    
+    Tracks enable/disable operations with success/failure status.
+    """
+    
+    class Action(models.TextChoices):
+        ENABLE = "enable", "Enable Maintenance"
+        DISABLE = "disable", "Disable Maintenance"
+        ERROR = "error", "Error"
+        SYNC = "sync", "Sync from Cloudflare"
+    
+    class Status(models.TextChoices):
+        SUCCESS = "success", "Success"
+        FAILED = "failed", "Failed"
+        PENDING = "pending", "Pending"
+    
+    # Related site
+    site = models.ForeignKey(
+        CloudflareSite,
+        on_delete=models.CASCADE,
+        related_name='logs',
+        help_text="Site this log entry belongs to"
+    )
+    
+    # Operation details
+    action = models.CharField(
+        max_length=20,
+        choices=Action.choices,
+        help_text="What action was performed"
+    )
+    status = models.CharField(
+        max_length=20,
+        choices=Status.choices,
+        help_text="Result of the operation"
+    )
+    
+    # Additional info
+    reason = models.TextField(
+        blank=True,
+        help_text="Why maintenance was enabled/disabled"
+    )
+    error_message = models.TextField(
+        blank=True,
+        help_text="Error details if operation failed"
+    )
+    cloudflare_response = models.JSONField(
+        null=True,
+        blank=True,
+        help_text="Full Cloudflare API response for debugging"
+    )
+    
+    # Timing
+    created_at = models.DateTimeField(auto_now_add=True)
+    duration_seconds = models.IntegerField(
+        null=True,
+        blank=True,
+        help_text="How long the operation took"
+    )
+    
+    # Custom manager
+    from ..managers.maintenance_log_manager import MaintenanceLogManager
+    objects = MaintenanceLogManager()
+    
+    class Meta:
+        ordering = ['-created_at']
+        verbose_name = "Maintenance Log"
+        verbose_name_plural = "Maintenance Logs"
+        indexes = [
+            models.Index(fields=['site', '-created_at']),
+            models.Index(fields=['action', '-created_at']),
+            models.Index(fields=['status', '-created_at']),
+        ]
+    
+    def __str__(self) -> str:
+        status_emoji = {
+            self.Status.SUCCESS: "✅",
+            self.Status.FAILED: "❌",
+            self.Status.PENDING: "⏳"
+        }.get(self.status, "❓")
+        
+        return f"{status_emoji} {self.get_action_display()} - {self.site.domain}"
+    
+    @classmethod
+    def log_success(cls, site: CloudflareSite, action: str, reason: str = "", 
+                   duration_seconds: int = None, cloudflare_response: dict = None) -> 'MaintenanceLog':
+        """Log successful operation."""
+        return cls.objects.create(
+            site=site,
+            action=action,
+            status=cls.Status.SUCCESS,
+            reason=reason,
+            duration_seconds=duration_seconds,
+            cloudflare_response=cloudflare_response
+        )
+    
+    @classmethod
+    def log_failure(cls, site: CloudflareSite, action: str, error_message: str,
+                   reason: str = "", cloudflare_response: dict = None) -> 'MaintenanceLog':
+        """Log failed operation."""
+        return cls.objects.create(
+            site=site,
+            action=action,
+            status=cls.Status.FAILED,
+            reason=reason,
+            error_message=error_message,
+            cloudflare_response=cloudflare_response
+        )
+    
+    @classmethod
+    def log_pending(cls, site: CloudflareSite, action: str, reason: str = "") -> 'MaintenanceLog':
+        """Log pending operation."""
+        return cls.objects.create(
+            site=site,
+            action=action,
+            status=cls.Status.PENDING,
+            reason=reason
+        )
+
+