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

django_cfg/apps/urls.py

@@ -4,54 +4,52 @@ Django CFG API URLs
 Built-in API endpoints for django_cfg functionality.
 """
 
-import traceback
 from typing import List
 
 from django.urls import include, path
 
-from django_cfg.modules.django_logging import get_logger, sanitize_extra
-
-logger = get_logger(__name__)
+from django_cfg.modules.base import BaseCfgModule
 
 
 def get_enabled_cfg_apps() -> List[str]:
     """
     Get list of enabled django-cfg apps based on configuration.
-    
+
     Returns:
-        List of enabled app paths (e.g., ['django_cfg.apps.accounts', ...])
+        List of enabled app paths (e.g., ['django_cfg.apps.business.accounts', ...])
     """
-    from django_cfg.modules.base import BaseCfgModule
-
     base_module = BaseCfgModule()
     enabled_apps = []
 
     if base_module.is_accounts_enabled():
-        enabled_apps.append("django_cfg.apps.accounts")
+        enabled_apps.append("django_cfg.apps.business.accounts")
 
     if base_module.is_knowbase_enabled():
-        enabled_apps.append("django_cfg.apps.knowbase")
+        enabled_apps.append("django_cfg.apps.business.knowbase")
 
     if base_module.is_support_enabled():
-        enabled_apps.append("django_cfg.apps.support")
+        enabled_apps.append("django_cfg.apps.business.support")
 
     if base_module.is_newsletter_enabled():
-        enabled_apps.append("django_cfg.apps.newsletter")
+        enabled_apps.append("django_cfg.apps.business.newsletter")
 
     if base_module.is_leads_enabled():
-        enabled_apps.append("django_cfg.apps.leads")
+        enabled_apps.append("django_cfg.apps.business.leads")
 
     if base_module.is_agents_enabled():
-        enabled_apps.append("django_cfg.apps.agents")
-
-    if base_module.should_enable_tasks():
-        enabled_apps.append("django_cfg.apps.tasks")
+        enabled_apps.append("django_cfg.apps.business.agents")
 
     if base_module.is_payments_enabled():
-        enabled_apps.append("django_cfg.apps.payments")
+        enabled_apps.append("django_cfg.apps.business.payments")
+
+    if base_module.is_centrifugo_enabled():
+        enabled_apps.append("django_cfg.apps.integrations.centrifugo")
 
-    if base_module.is_rpc_enabled():
-        enabled_apps.append("django_cfg.apps.ipc")
+    if base_module.should_enable_rq():
+        enabled_apps.append("django_cfg.apps.integrations.rq")
+
+    if base_module.is_grpc_enabled():
+        enabled_apps.append("django_cfg.apps.integrations.grpc")
 
     return enabled_apps
 
@@ -84,108 +82,62 @@ def get_default_cfg_group():
         name="cfg",
         apps=get_enabled_cfg_apps(),
         title="Django-CFG API",
-        description="Authentication (OTP), Support, Newsletter, Leads, Knowledge Base, AI Agents, Tasks, Payments",
+        description="Authentication (OTP), Support, Newsletter, Leads, Knowledge Base, AI Agents, Tasks, Payments, Centrifugo, gRPC, Dashboard",
         version="1.0.0",
     )
 
 
-def _safe_include(pattern_path: str, module_path: str):
-    """
-    Helper to safely include URL module if it exists.
-
-    Args:
-        pattern_path: URL pattern (e.g., 'cfg/knowbase/')
-        module_path: Module path (e.g., 'django_cfg.apps.knowbase.urls')
-
-    Returns:
-        URLPattern if successful, None if import fails
-    """
-    try:
-        return path(pattern_path, include(module_path))
-    except ImportError as e:
-        logger.warning(
-            f"Failed to import URL module '{module_path}' for pattern '{pattern_path}': {e}",
-            extra=sanitize_extra({
-                'pattern': pattern_path,
-                'module': module_path,
-                'error': str(e),
-            })
-        )
-        logger.debug(f"Traceback for '{module_path}':\n{traceback.format_exc()}")
-        return None
-    except Exception as e:
-        logger.error(
-            f"Unexpected error including URL module '{module_path}' for pattern '{pattern_path}': {e}",
-            extra=sanitize_extra({
-                'pattern': pattern_path,
-                'module': module_path,
-                'error': str(e),
-                'traceback': traceback.format_exc(),
-            })
-        )
-        return None
-
-
 # Core API endpoints (always enabled)
-# Note: All prefixes are explicit here (cfg/, health/, etc.)
 urlpatterns = [
     path('cfg/health/', include('django_cfg.apps.api.health.urls')),
     path('cfg/endpoints/', include('django_cfg.apps.api.endpoints.urls')),
     path('cfg/commands/', include('django_cfg.apps.api.commands.urls')),
     path('cfg/openapi/', include('django_cfg.modules.django_client.urls')),
+    path('cfg/dashboard/', include('django_cfg.apps.system.dashboard.urls')),
+    path('cfg/admin/', include('django_cfg.apps.system.frontend.urls')),
 ]
 
-# Django-CFG apps - conditionally registered based on config
-# Map app paths to URL patterns (with cfg/ prefix from add_django_cfg_urls)
-APP_URL_MAP = {
-    "django_cfg.apps.accounts": [
-        ("cfg/accounts/", "django_cfg.apps.accounts.urls"),
-    ],
-    "django_cfg.apps.support": [
-        ("cfg/support/", "django_cfg.apps.support.urls"),
-    ],
-    "django_cfg.apps.newsletter": [
-        ("cfg/newsletter/", "django_cfg.apps.newsletter.urls"),
-    ],
-    "django_cfg.apps.leads": [
-        ("cfg/leads/", "django_cfg.apps.leads.urls"),
-    ],
-    "django_cfg.apps.knowbase": [
-        ("cfg/knowbase/", "django_cfg.apps.knowbase.urls"),
-        ("cfg/knowbase/admin/", "django_cfg.apps.knowbase.urls_admin"),
-        ("cfg/knowbase/system/", "django_cfg.apps.knowbase.urls_system"),
-    ],
-    "django_cfg.apps.agents": [
-        ("cfg/agents/", "django_cfg.apps.agents.urls"),
-    ],
-    "django_cfg.apps.tasks": [
-        ("cfg/tasks/", "django_cfg.apps.tasks.urls"),
-        ("cfg/tasks/admin/", "django_cfg.apps.tasks.urls_admin"),
-    ],
-    "django_cfg.apps.payments": [
-        ("cfg/payments/", "django_cfg.apps.payments.urls"),
-        # Payments v2.0: No separate urls_admin (uses Django Admin only)
-    ],
-    "django_cfg.apps.ipc": [
-        ("cfg/ipc/", "django_cfg.apps.ipc.urls"),
-        ("cfg/ipc/admin/", "django_cfg.apps.ipc.urls_admin"),
-    ],
-}
-
-# Register URLs for enabled apps only
-enabled_apps = get_enabled_cfg_apps()
-cfg_app_urls = []
-
-for app_path in enabled_apps:
-    if app_path in APP_URL_MAP:
-        for url_pattern, url_module in APP_URL_MAP[app_path]:
-            cfg_app_urls.append(_safe_include(url_pattern, url_module))
-
-# Maintenance (special case - admin only)
-from django_cfg.modules.base import BaseCfgModule
+# External Next.js Admin Integration (conditional)
+try:
+    from django_cfg.core.config import get_current_config
+    _config = get_current_config()
+    if _config and _config.nextjs_admin:
+        urlpatterns.append(path('cfg/nextjs-admin/', include('django_cfg.modules.nextjs_admin.urls')))
+except Exception:
+    pass
+
+# Business apps (conditional based on config)
+base_module = BaseCfgModule()
+
+if base_module.is_accounts_enabled():
+    urlpatterns.append(path('cfg/accounts/', include('django_cfg.apps.business.accounts.urls')))
+
+if base_module.is_knowbase_enabled():
+    urlpatterns.append(path('cfg/knowbase/', include('django_cfg.apps.business.knowbase.urls')))
+    urlpatterns.append(path('cfg/knowbase/system/', include('django_cfg.apps.business.knowbase.urls_system')))
+    urlpatterns.append(path('cfg/knowbase/admin/', include('django_cfg.apps.business.knowbase.urls_admin')))
+
+if base_module.is_support_enabled():
+    urlpatterns.append(path('cfg/support/', include('django_cfg.apps.business.support.urls')))
+
+if base_module.is_newsletter_enabled():
+    urlpatterns.append(path('cfg/newsletter/', include('django_cfg.apps.business.newsletter.urls')))
+
+if base_module.is_leads_enabled():
+    urlpatterns.append(path('cfg/leads/', include('django_cfg.apps.business.leads.urls')))
+
+if base_module.is_agents_enabled():
+    urlpatterns.append(path('cfg/agents/', include('django_cfg.apps.business.agents.urls')))
+
+if base_module.is_payments_enabled():
+    urlpatterns.append(path('cfg/payments/', include('django_cfg.apps.business.payments.urls')))
+
+# Integration apps (conditional based on config)
+if base_module.is_centrifugo_enabled():
+    urlpatterns.append(path('cfg/centrifugo/', include('django_cfg.apps.integrations.centrifugo.urls')))
 
-if BaseCfgModule().is_maintenance_enabled():
-    cfg_app_urls.append(_safe_include('admin/django_cfg_maintenance/', 'django_cfg.apps.maintenance.urls_admin'))
+if base_module.should_enable_rq():
+    urlpatterns.append(path('cfg/rq/', include('django_cfg.apps.integrations.rq.urls')))
 
-# Add only successfully imported URLs
-urlpatterns.extend([url for url in cfg_app_urls if url is not None])
+if base_module.is_grpc_enabled():
+    urlpatterns.append(path('cfg/grpc/', include('django_cfg.apps.integrations.grpc.urls')))

django_cfg/cli/commands/info.py

@@ -74,7 +74,7 @@ def info(verbose: bool):
         "🌐 Service Integrations": ["twilio", "sendgrid", "openai", "telegram-bot-api"],
         "🎨 Admin & UI": ["django-unfold", "django-constance"],
         "📊 API & Documentation": ["djangorestframework", "drf-spectacular"],
-        "⚡ Background Processing": ["dramatiq", "redis"],
+        "⚡ Background Processing": ["rearq", "redis"],
         "🛠️  Development Tools": ["ngrok"],
     }
 

django_cfg/cli/utils.py

@@ -166,7 +166,7 @@ def get_standard_dependencies() -> Dict[str, str]:
         "drf-spectacular": "drf_spectacular",
 
         # Tasks & Background Processing
-        "dramatiq": "dramatiq",
+        "rearq": "rearq",
         "redis": "redis",
 
         # Development

django_cfg/config.py

@@ -12,15 +12,16 @@ from .modules.django_unfold.models.dropdown import SiteDropdownItem
 # Library configuration
 LIB_NAME = "django-cfg"
 LIB_SITE_URL = "https://djangocfg.com"
-LIB_DOCS_URL = "https://docs.djangocfg.com"
 LIB_GITHUB_URL = "https://github.com/django-cfg/django-cfg"
-LIB_SUPPORT_URL = "https://djangocfg.com/support"
+LIB_SUPPORT_URL = "https://demo.djangocfg.com"
 LIB_HEALTH_URL = "/cfg/health/"
 
+
 def get_maintenance_url(domain: str) -> str:
     """Get the maintenance URL for the current site."""
     # return f"{LIB_SITE_URL}/maintenance/{domain}/"
-    return f"{LIB_DOCS_URL}/maintenance?site={domain}"
+    return f"{LIB_SITE_URL}/maintenance?site={domain}"
+
 
 def get_default_dropdown_items() -> List[SiteDropdownItem]:
     """Get default dropdown menu items for Unfold admin."""
@@ -28,7 +29,7 @@ def get_default_dropdown_items() -> List[SiteDropdownItem]:
         SiteDropdownItem(
             title="Documentation",
             icon=Icons.HELP_OUTLINE,
-            link=LIB_DOCS_URL,
+            link=LIB_SITE_URL,
         ),
         SiteDropdownItem(
             title="GitHub",
@@ -46,3 +47,4 @@ def get_default_dropdown_items() -> List[SiteDropdownItem]:
             link=LIB_SITE_URL,
         ),
     ]
+

django_cfg/core/backends/__init__.py

@@ -0,0 +1 @@
+"""Custom backends for Django CFG."""

django_cfg/core/backends/smtp.py

@@ -0,0 +1,69 @@
+"""
+Custom SMTP Email Backend for Django CFG.
+
+Supports SMTP with unverified SSL certificates for development environments.
+"""
+
+import smtplib
+import ssl
+
+from django.core.mail.backends.smtp import EmailBackend as DjangoSMTPBackend
+
+
+class UnverifiedSSLEmailBackend(DjangoSMTPBackend):
+    """
+    SMTP backend that accepts self-signed SSL certificates.
+
+    WARNING: Only use in development! In production, use proper SSL certificates
+    with the standard Django SMTP backend.
+
+    This backend disables SSL certificate verification, which makes it vulnerable
+    to man-in-the-middle attacks. It's designed for dev environments where you
+    control the mail server and use self-signed certificates.
+    """
+
+    def open(self):
+        """
+        Open connection with unverified SSL context.
+
+        Overrides parent to use unverified SSL context for self-signed certs.
+        """
+        if self.connection:
+            # Already have a connection
+            return False
+
+        connection_params = {'timeout': self.timeout}
+        if self.ssl_keyfile:
+            connection_params['keyfile'] = self.ssl_keyfile
+        if self.ssl_certfile:
+            connection_params['certfile'] = self.ssl_certfile
+
+        if self.use_ssl:
+            # Create unverified SSL context (accepts self-signed certs)
+            ssl_context = ssl.create_default_context()
+            ssl_context.check_hostname = False
+            ssl_context.verify_mode = ssl.CERT_NONE
+
+            connection_params['context'] = ssl_context
+            self.connection = smtplib.SMTP_SSL(
+                self.host, self.port, **connection_params
+            )
+        else:
+            self.connection = smtplib.SMTP(
+                self.host, self.port, **connection_params
+            )
+
+            if self.use_tls:
+                # Create unverified SSL context for STARTTLS too
+                ssl_context = ssl.create_default_context()
+                ssl_context.check_hostname = False
+                ssl_context.verify_mode = ssl.CERT_NONE
+
+                self.connection.ehlo()
+                self.connection.starttls(context=ssl_context)
+                self.connection.ehlo()
+
+        if self.username and self.password:
+            self.connection.login(self.username, self.password)
+
+        return True

django_cfg/core/base/config_model.py

@@ -15,11 +15,14 @@ from typing import Any, Dict, List, Optional
 
 from pydantic import BaseModel, Field, PrivateAttr, field_validator, model_validator
 
-from ...apps.ipc import DjangoCfgRPCConfig
+from django_cfg.apps.integrations.centrifugo.services.client.config import DjangoCfgCentrifugoConfig
 from ...models import (
     ApiKeys,
+    AxesConfig,
     CacheConfig,
+    CryptoFieldsConfig,
     DatabaseConfig,
+    DjangoRQConfig,
     DRFConfig,
     EmailConfig,
     LimitsConfig,
@@ -27,9 +30,10 @@ from ...models import (
     TelegramConfig,
     UnfoldConfig,
 )
+from ...models.api.grpc import GRPCConfig
 from ...models.ngrok import NgrokConfig
 from ...models.payments import PaymentsConfig
-from ...models.tasks import TaskConfig
+from ...modules.nextjs_admin import NextJsAdminConfig
 from ..exceptions import ConfigurationError
 from ..types.enums import EnvironmentMode, StartupInfoMode
 
@@ -147,6 +151,11 @@ class DjangoConfig(BaseModel):
         description="Enable django-cfg Maintenance application (multi-site maintenance mode with Cloudflare)",
     )
 
+    enable_frontend: bool = Field(
+        default=True,
+        description="Enable django-cfg Frontend application (Next.js admin panel static serving)",
+    )
+
     # === Payment System Configuration ===
     payments: Optional[PaymentsConfig] = Field(
         default=None,
@@ -164,16 +173,6 @@ class DjangoConfig(BaseModel):
         description="Backend API URL",
     )
 
-    ticket_url: str = Field(
-        default="{site_url}/support/ticket/{uuid}",
-        description="Support ticket URL template. Use {site_url} and {uuid} placeholders",
-    )
-
-    otp_url: str = Field(
-        default="{site_url}/auth/otp/{code}",
-        description="OTP verification URL template. Use {site_url} and {code} placeholders",
-    )
-
     # === Core Django Settings ===
     secret_key: str = Field(
         ...,
@@ -187,6 +186,11 @@ class DjangoConfig(BaseModel):
         description="Django DEBUG setting",
     )
 
+    debug_warnings: bool = Field(
+        default=False,
+        description="Enable detailed warnings traceback for debugging (shows full stack trace for RuntimeWarnings)",
+    )
+
     # === URL Configuration ===
     root_urlconf: Optional[str] = Field(
         default=None,
@@ -201,7 +205,7 @@ class DjangoConfig(BaseModel):
     # === Custom User Model ===
     auth_user_model: Optional[str] = Field(
         default=None,
-        description="Custom user model (AUTH_USER_MODEL). If None and enable_accounts=True, uses 'django_cfg.apps.accounts.CustomUser'",
+        description="Custom user model (AUTH_USER_MODEL). If None and enable_accounts=True, uses 'django_cfg.apps.business.accounts.CustomUser'",
         pattern=r"^[a-zA-Z_][a-zA-Z0-9_]*\.[a-zA-Z_][a-zA-Z0-9_]*$",
     )
 
@@ -218,9 +222,19 @@ class DjangoConfig(BaseModel):
     )
 
     # === Cache Configuration ===
+    # Redis URL - used for automatic cache configuration if cache_default is not set
+    redis_url: Optional[str] = Field(
+        default=None,
+        description=(
+            "Redis connection URL (redis://host:port/db). "
+            "If set and cache_default is None, automatically creates RedisCache backend. "
+            "Also used by Django-RQ if queues don't specify connection details."
+        ),
+    )
+
     cache_default: Optional[CacheConfig] = Field(
         default=None,
-        description="Default cache backend",
+        description="Default cache backend (auto-created from redis_url if not set)",
     )
 
     cache_sessions: Optional[CacheConfig] = Field(
@@ -230,7 +244,7 @@ class DjangoConfig(BaseModel):
 
     # === Security Configuration ===
     security_domains: List[str] = Field(
-        default_factory=list,
+        default_factory=lambda: ["localhost", "127.0.0.1"],
         description="Domains for automatic security configuration (CORS, SSL, etc.)",
     )
 
@@ -277,6 +291,17 @@ class DjangoConfig(BaseModel):
         description="Ngrok tunneling service configuration (for development/webhooks)",
     )
 
+    # === Security Configuration ===
+    axes: Optional["AxesConfig"] = Field(
+        default=None,
+        description="Django-Axes brute-force protection configuration (None = smart defaults)",
+    )
+
+    crypto_fields: Optional["CryptoFieldsConfig"] = Field(
+        default=None,
+        description="Django Crypto Fields encryption configuration for sensitive data (API keys, tokens, passwords)",
+    )
+
     # === Admin Interface Configuration ===
     unfold: Optional[UnfoldConfig] = Field(
         default=None,
@@ -303,16 +328,16 @@ class DjangoConfig(BaseModel):
         description="Enable modern Tailwind CSS theme for Django REST Framework Browsable API",
     )
 
-    # === Background Task Processing ===
-    tasks: Optional[TaskConfig] = Field(
+    # === Django-RQ Task Queue & Scheduler ===
+    django_rq: Optional[DjangoRQConfig] = Field(
         default=None,
-        description="Background task processing configuration (Dramatiq)",
+        description="Django-RQ task queue and scheduler configuration (sync tasks, cron scheduling)",
     )
 
-    # === RPC Client Configuration ===
-    django_ipc: Optional[DjangoCfgRPCConfig] = Field(
+    # === Centrifugo Configuration ===
+    centrifugo: Optional[DjangoCfgCentrifugoConfig] = Field(
         default=None,
-        description="Django-CFG RPC Client configuration (WebSocket RPC communication)",
+        description="Centrifugo pub/sub configuration (WebSocket notifications with ACK tracking)",
     )
 
     # === API Configuration ===
@@ -326,6 +351,11 @@ class DjangoConfig(BaseModel):
         description="Extended DRF Spectacular configuration (supplements OpenAPI Client)",
     )
 
+    grpc: Optional[GRPCConfig] = Field(
+        default=None,
+        description="gRPC framework configuration (server, authentication, proto generation)",
+    )
+
     # === Limits Configuration ===
     limits: Optional[LimitsConfig] = Field(
         default=None,
@@ -344,6 +374,15 @@ class DjangoConfig(BaseModel):
         description="Custom middleware classes (standard middleware added automatically)",
     )
 
+    # === Next.js Admin Integration ===
+    nextjs_admin: Optional["NextJsAdminConfig"] = Field(
+        default=None,
+        description=(
+            "Next.js admin panel integration. "
+            "Example: NextJsAdminConfig(project_path='../django_admin')"
+        ),
+    )
+
     # === Internal State (Private) ===
     _base_dir: Optional[Path] = PrivateAttr(default=None)
     _django_settings: Optional[Dict[str, Any]] = PrivateAttr(default=None)
@@ -548,6 +587,10 @@ class DjangoConfig(BaseModel):
         from ..state.registry import set_current_config
         set_current_config(self)
 
+        # Setup warnings debug if enabled in config
+        from ..debug import setup_warnings_debug
+        setup_warnings_debug()
+
         if self._django_settings is None:
             from ..generation import SettingsGenerator
 
@@ -561,36 +604,6 @@ class DjangoConfig(BaseModel):
 
         return self._django_settings
 
-    def get_ticket_url(self, ticket_uuid: str) -> str:
-        """
-        Generate ticket URL using the configured template.
-
-        Args:
-            ticket_uuid: UUID of the support ticket
-
-        Returns:
-            Complete URL to the ticket
-        """
-        return self.ticket_url.format(
-            site_url=self.site_url,
-            uuid=ticket_uuid,
-        )
-
-    def get_otp_url(self, otp_code: str) -> str:
-        """
-        Generate OTP verification URL using the configured template.
-
-        Args:
-            otp_code: OTP verification code
-
-        Returns:
-            Complete URL to the OTP verification page
-        """
-        return self.otp_url.format(
-            site_url=self.site_url,
-            code=otp_code,
-        )
-
     def invalidate_cache(self) -> None:
         """
         Invalidate cached Django settings.
@@ -630,28 +643,19 @@ class DjangoConfig(BaseModel):
             **kwargs
         )
 
-    def should_enable_tasks(self) -> bool:
+    def should_enable_rq(self) -> bool:
         """
-        Determine if background tasks should be enabled.
+        Determine if Django-RQ should be enabled.
 
-        Tasks are enabled if:
-        1. Explicitly configured via tasks field
-        2. Knowledge base is enabled (requires background processing)
-        3. Agents are enabled (requires background processing)
+        Django-RQ is enabled if explicitly configured via django_rq field.
 
         Returns:
-            True if tasks should be enabled, False otherwise
+            True if Django-RQ should be enabled, False otherwise
         """
-        # Check if explicitly configured
-        if hasattr(self, 'tasks') and self.tasks and self.tasks.enabled:
-            return True
-
-        # Check if features that require tasks are enabled
-        if self.enable_knowbase or self.enable_agents:
+        if hasattr(self, 'django_rq') and self.django_rq and self.django_rq.enabled:
             return True
 
         return False
 
-
 # Export main class
 __all__ = ["DjangoConfig"]