django-cfg 1.4.116__py3-none-any.whl → 1.5.8__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.centrifugo")
+        enabled_apps.append("django_cfg.apps.integrations.centrifugo")
+
+    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,121 +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, Dashboard",
+        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.dashboard.urls')),  # Dashboard API
+    path('cfg/dashboard/', include('django_cfg.apps.system.dashboard.urls')),
+    path('cfg/admin/', include('django_cfg.apps.system.frontend.urls')),
 ]
 
-# Built-in Frontend Admin (always available at /cfg/admin/)
-urlpatterns.append(path('cfg/admin/', include('django_cfg.apps.frontend.urls')))
-
-# External Next.js Admin Integration (conditional - available when configured)
+# 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:
-        # Add external Next.js admin at /cfg/nextjs-admin/
         urlpatterns.append(path('cfg/nextjs-admin/', include('django_cfg.modules.nextjs_admin.urls')))
 except Exception:
-    # Next.js admin not configured - skip
     pass
 
-# 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"),
-    ],
-    "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.centrifugo": [
-        ("cfg/centrifugo/", "django_cfg.apps.centrifugo.urls"),
-    ],
-}
-
-# 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
+# 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/config.py

@@ -16,11 +16,13 @@ LIB_GITHUB_URL = "https://github.com/django-cfg/django-cfg"
 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_SITE_URL}/maintenance?site={domain}"
 
+
 def get_default_dropdown_items() -> List[SiteDropdownItem]:
     """Get default dropdown menu items for Unfold admin."""
     return [
@@ -45,3 +47,4 @@ def get_default_dropdown_items() -> List[SiteDropdownItem]:
             link=LIB_SITE_URL,
         ),
     ]
+

django_cfg/core/base/config_model.py

@@ -15,14 +15,14 @@ from typing import Any, Dict, List, Optional
 
 from pydantic import BaseModel, Field, PrivateAttr, field_validator, model_validator
 
-from ...apps.centrifugo.services.client.config import DjangoCfgCentrifugoConfig
+from django_cfg.apps.integrations.centrifugo.services.client.config import DjangoCfgCentrifugoConfig
 from ...models import (
     ApiKeys,
     AxesConfig,
     CacheConfig,
-    DjangoQ2Config,
     CryptoFieldsConfig,
     DatabaseConfig,
+    DjangoRQConfig,
     DRFConfig,
     EmailConfig,
     LimitsConfig,
@@ -30,9 +30,9 @@ 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
@@ -186,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,
@@ -200,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_]*$",
     )
 
@@ -223,7 +228,7 @@ class DjangoConfig(BaseModel):
         description=(
             "Redis connection URL (redis://host:port/db). "
             "If set and cache_default is None, automatically creates RedisCache backend. "
-            "Also used by tasks (ReArq, Django-Q2) if they don't specify broker_url."
+            "Also used by Django-RQ if queues don't specify connection details."
         ),
     )
 
@@ -323,16 +328,10 @@ 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 (ReArq)",
-    )
-
-    # === Django-Q2 Task Scheduling ===
-    django_q2: Optional[DjangoQ2Config] = Field(
-        default=None,
-        description="Django-Q2 task scheduling and queue configuration",
+        description="Django-RQ task queue and scheduler configuration (sync tasks, cron scheduling)",
     )
 
     # === Centrifugo Configuration ===
@@ -352,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,
@@ -583,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
 
@@ -635,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"]

django_cfg/core/builders/apps_builder.py

@@ -23,7 +23,6 @@ class InstalledAppsBuilder:
     - Combine default Django/third-party apps
     - Add django-cfg apps based on enabled features
     - Handle special ordering (accounts before admin)
-    - Auto-enable tasks if needed
     - Auto-detect dashboard apps from Unfold
     - Add project-specific apps
     - Remove duplicates while preserving order
@@ -55,7 +54,7 @@ class InstalledAppsBuilder:
             >>> config = DjangoConfig(enable_support=True)
             >>> builder = InstalledAppsBuilder(config)
             >>> apps = builder.build()
-            >>> "django_cfg.apps.support" in apps
+            >>> "django_cfg.apps.business.support" in apps
             True
         """
         apps = []
@@ -92,7 +91,7 @@ class InstalledAppsBuilder:
             if app == "django.contrib.admin":
                 # Insert accounts before admin if enabled (for proper migration order)
                 if self.config.enable_accounts:
-                    apps.append("django_cfg.apps.accounts")
+                    apps.append("django_cfg.apps.business.accounts")
             apps.append(app)
 
         return apps
@@ -109,36 +108,39 @@ class InstalledAppsBuilder:
             "django_cfg.modules.django_tailwind",  # Universal Tailwind layouts
             "django_cfg.apps.api.health",
             "django_cfg.apps.api.commands",
-            "django_cfg.apps.dashboard",  # Dashboard API
+            "django_cfg.apps.system.dashboard",  # Dashboard API
         ]
 
         if self.config.enable_frontend:
-            apps.append("django_cfg.apps.frontend")
+            apps.append("django_cfg.apps.system.frontend")
 
         # Add optional apps based on configuration
         if self.config.enable_support:
-            apps.append("django_cfg.apps.support")
+            apps.append("django_cfg.apps.business.support")
 
         if self.config.enable_newsletter:
-            apps.append("django_cfg.apps.newsletter")
+            apps.append("django_cfg.apps.business.newsletter")
 
         if self.config.enable_leads:
-            apps.append("django_cfg.apps.leads")
+            apps.append("django_cfg.apps.business.leads")
 
         if self.config.enable_knowbase:
-            apps.append("django_cfg.apps.knowbase")
+            apps.append("django_cfg.apps.business.knowbase")
 
         if self.config.enable_agents:
-            apps.append("django_cfg.apps.agents")
+            apps.append("django_cfg.apps.business.agents")
 
         if self.config.enable_maintenance:
-            apps.append("django_cfg.apps.maintenance")
+            apps.append("django_cfg.apps.system.maintenance")
 
         if self.config.payments and self.config.payments.enabled:
-            apps.append("django_cfg.apps.payments")
+            apps.append("django_cfg.apps.business.payments")
 
         if self.config.centrifugo and self.config.centrifugo.enabled:
-            apps.append("django_cfg.apps.centrifugo")
+            apps.append("django_cfg.apps.integrations.centrifugo")
+
+        if self.config.grpc and self.config.grpc.enabled:
+            apps.append("django_cfg.apps.integrations.grpc")
 
         if self.config.crypto_fields and self.config.crypto_fields.enabled:
             apps.append("django_crypto_fields.apps.AppConfig")
@@ -158,14 +160,10 @@ class InstalledAppsBuilder:
         """
         apps = []
 
-        # Auto-enable tasks if needed by other features
-        if self.config.should_enable_tasks():
-            # No external app needed - ReArq is embedded
-            apps.append("django_cfg.apps.tasks")
-
-        # Add django-q2 if enabled
-        if hasattr(self.config, "django_q2") and self.config.django_q2 and self.config.django_q2.enabled:
-            apps.append("django_q")
+        # Add Django-RQ if enabled
+        if hasattr(self.config, "django_rq") and self.config.django_rq and self.config.django_rq.enabled:
+            apps.append("django_rq")  # Core django-rq package
+            apps.append("django_cfg.apps.integrations.rq")  # Django-CFG monitoring & API
 
         # Add DRF Tailwind theme module (uses Tailwind via CDN)
         if self.config.enable_drf_tailwind:

django_cfg/core/constants.py

@@ -45,6 +45,7 @@ DEFAULT_APPS: List[str] = [
     # Django CFG Core
     "django_cfg",
     "django_cfg.modules.django_client",
+    "django_cfg.modules.django_admin",
 ]
 
 # Default middleware stack

django_cfg/core/debug/README.md

@@ -0,0 +1,116 @@
+# Django-CFG Debug Utilities
+
+Debug utilities to help troubleshoot Django-CFG issues.
+
+## Warnings Debug Helper
+
+Shows full stack traceback for specific warnings to help identify their source.
+
+### Quick Start
+
+**Method 1: Via Config (Recommended)**
+
+```python
+# In your config.py
+from django_cfg import DjangoConfig
+
+class MyConfig(DjangoConfig):
+    project_name: str = "My Project"
+    debug_warnings: bool = True  # ← Enable warnings traceback
+```
+
+**Method 2: Via Environment Variable**
+
+```bash
+export DJANGO_CFG_DEBUG_WARNINGS=1
+python manage.py runserver
+```
+
+This will show full traceback for:
+- RuntimeWarnings about database access during app initialization
+- APPS_NOT_READY warnings
+- Other app initialization warnings
+
+### Example Output
+
+```
+================================================================================
+⚠️  WARNING TRACEBACK (to help find the source)
+================================================================================
+  File "/path/to/your/code/apps.py", line 42, in ready
+    self.setup_database()
+  File "/path/to/your/code/apps.py", line 55, in setup_database
+    MyModel.objects.all()
+    ^^^^^^^^^^^^^^^^^^^^
+
+--------------------------------------------------------------------------------
+⚠️  WARNING MESSAGE:
+/usr/lib/python3.12/site-packages/django/db/backends/utils.py:98: RuntimeWarning:
+Accessing the database during app initialization is discouraged. To fix this
+warning, avoid executing queries in AppConfig.ready() or when your app modules
+are imported.
+================================================================================
+```
+
+### Manual Usage
+
+```python
+# In your manage.py or wsgi.py, BEFORE django.setup():
+from django_cfg.core.debug import setup_warnings_debug
+
+# Enable with default settings
+setup_warnings_debug(enabled=True)
+
+# Or customize:
+setup_warnings_debug(
+    enabled=True,
+    categories=[RuntimeWarning, DeprecationWarning],
+    patterns=['.*database.*', '.*deprecated.*']
+)
+```
+
+### Common Issues Found
+
+1. **Database access in AppConfig.ready()**
+   ```python
+   # ❌ Bad
+   def ready(self):
+       from .models import MyModel
+       MyModel.objects.create(...)
+
+   # ✅ Good - use post_migrate signal
+   def ready(self):
+       from django.db.models.signals import post_migrate
+       post_migrate.connect(self.setup_data, sender=self)
+   ```
+
+2. **Model queries at module level**
+   ```python
+   # ❌ Bad - runs during import
+   from .models import MyModel
+   DEFAULT_SETTINGS = MyModel.objects.first()
+
+   # ✅ Good - lazy evaluation
+   def get_default_settings():
+       from .models import MyModel
+       return MyModel.objects.first()
+   ```
+
+3. **Database connection in __init__.py**
+   ```python
+   # ❌ Bad
+   from django.db import connection
+   cursor = connection.cursor()
+
+   # ✅ Good - move to views/services
+   ```
+
+### Disabling
+
+Simply unset or set to 0:
+
+```bash
+export DJANGO_CFG_DEBUG_WARNINGS=0
+# or
+unset DJANGO_CFG_DEBUG_WARNINGS
+```

django_cfg/core/debug/__init__.py

@@ -0,0 +1,7 @@
+"""
+Debug utilities for Django-CFG.
+"""
+
+from .warnings_helper import setup_warnings_debug
+
+__all__ = ['setup_warnings_debug']

django_cfg/core/debug/example_config.py

@@ -0,0 +1,63 @@
+"""
+Example configuration with debug_warnings enabled.
+
+This shows how to enable warnings traceback through DjangoConfig.
+"""
+
+from django_cfg import DjangoConfig, DatabaseConfig
+
+
+class DebugConfig(DjangoConfig):
+    """
+    Example configuration with warnings debug enabled.
+
+    Usage:
+        # In your settings.py or config.py
+        from path.to.config import DebugConfig
+
+        config = DebugConfig()
+        settings = config.get_all_settings()
+    """
+
+    # Project basics
+    project_name: str = "Debug Example"
+    secret_key: str = "django-insecure-example-key-change-in-production"
+
+    # Enable debug mode for development
+    debug: bool = True
+
+    # Enable warnings traceback for debugging
+    # This will show full stack trace for RuntimeWarnings about:
+    # - Database access during app initialization
+    # - APPS_NOT_READY warnings
+    # - Other app initialization issues
+    debug_warnings: bool = True
+
+    # Database configuration
+    databases: dict[str, DatabaseConfig] = {
+        "default": DatabaseConfig(
+            engine="django.db.backends.sqlite3",
+            name=":memory:",
+        )
+    }
+
+
+# Alternative: Enable only in development
+class SmartDebugConfig(DjangoConfig):
+    """Automatically enable debug_warnings in development mode."""
+
+    project_name: str = "Smart Debug Example"
+    secret_key: str = "django-insecure-example-key"
+
+    # Auto-enable debug_warnings in development
+    @property
+    def debug_warnings(self) -> bool:
+        """Enable warnings debug only in development."""
+        return self.env_mode.is_development
+
+    databases: dict[str, DatabaseConfig] = {
+        "default": DatabaseConfig(
+            engine="django.db.backends.sqlite3",
+            name=":memory:",
+        )
+    }