django-cfg 1.2.31__py3-none-any.whl → 1.3.3__py3-none-any.whl

django_cfg/utils/smart_defaults.py

@@ -1,11 +1,10 @@
 """
 Smart defaults system for django_cfg.
 
-Following CRITICAL_REQUIREMENTS.md:
-- No raw Dict/Any usage
-- Proper type annotations
-- Environment-aware configuration
-- No mutable default arguments
+Following KISS principle:
+- Simple, clear configuration
+- No complex environment logic
+- Logging handled by django_logger module
 """
 
 from typing import Dict, Any, Optional, List
@@ -16,486 +15,91 @@ from django_cfg.models.services import EmailConfig
 from django_cfg.core.exceptions import ConfigurationError
 
 
-class SmartDefaults:
+def get_log_filename() -> str:
     """
-    Environment-aware smart defaults for Django configuration.
+    Determine the correct log filename based on project type.
     
-    Automatically selects appropriate defaults based on:
-    - Environment (development, production, testing, staging)
-    - DEBUG flag
-    - Available services (Redis, SMTP, etc.)
-    - Security requirements
+    Returns:
+        - 'django-cfg.log' for django-cfg projects  
+        - 'django.log' for regular Django projects
     """
-    
-    @classmethod
-    def configure_cache_backend(
-        cls,
-        cache_config: CacheConfig,
-        environment: Optional[str] = None,
-        debug: bool = False
-    ) -> CacheConfig:
-        """
-        Configure cache backend with environment-aware defaults.
+    try:
+        # Check for django-cfg in installed apps
+        from django.conf import settings
+        if hasattr(settings, 'INSTALLED_APPS'):
+            for app in settings.INSTALLED_APPS:
+                if 'django_cfg' in app:
+                    return 'django-cfg.log'
         
-        Args:
-            cache_config: Base cache configuration
-            environment: Current environment
-            debug: Django DEBUG setting
-            
-        Returns:
-            Configured cache backend
-            
-        Raises:
-            ConfigurationError: If configuration cannot be applied
-        """
-        try:
-            # Create a copy to avoid modifying the original
-            config: CacheConfig = cache_config.model_copy()
-            
-            # Environment-specific adjustments
-            if environment == "testing":
-                # Testing: Use dummy cache with very short timeouts
-                config.backend_override = "django.core.cache.backends.dummy.DummyCache"
-                config.timeout = min(config.timeout, 1)  # Max 1 second for tests
-                
-            elif environment == "development" or debug:
-                # Development: Prefer memory cache, shorter timeouts
-                if not config.redis_url:
-                    # No Redis configured - use memory cache
-                    config.timeout = min(config.timeout, 300)  # Max 5 minutes
-                else:
-                    # Redis available - use it but with shorter timeouts
-                    config.timeout = min(config.timeout, 600)  # Max 10 minutes
-                    config.max_connections = min(config.max_connections, 20)  # Fewer connections
-                    
-            elif environment in ("production", "staging"):
-                # Production: Use Redis if available, longer timeouts
-                if config.redis_url:
-                    config.timeout = max(config.timeout, 300)  # Min 5 minutes
-                    config.max_connections = max(config.max_connections, 50)  # More connections
-                else:
-                    # Production without Redis - warn but use file cache
-                    config.backend_override = "django.core.cache.backends.filebased.FileBasedCache"
-            
-            # Apply compression for production
-            if environment == "production" and config.redis_url:
-                config.compress = True
-            
-            return config
-            
-        except Exception as e:
-            raise ConfigurationError(
-                f"Failed to configure cache backend: {e}",
-                context={
-                    'environment': environment,
-                    'debug': debug,
-                    'cache_config': cache_config.model_dump()
-                }
-            ) from e
-    
-    @classmethod
-    def configure_email_backend(
-        cls,
-        email_config: EmailConfig,
-        environment: Optional[str] = None,
-        debug: bool = False
-    ) -> EmailConfig:
-        """
-        Configure email backend with environment-aware defaults.
+        # Default to regular Django log
+        return 'django.log'
         
-        Args:
-            email_config: Base email configuration
-            environment: Current environment
-            debug: Django DEBUG setting
-            
-        Returns:
-            Configured email backend
-            
-        Raises:
-            ConfigurationError: If configuration cannot be applied
-        """
-        try:
-            # Create a copy to avoid modifying the original
-            config = email_config.model_copy()
-            
-            # Environment-specific adjustments
-            if environment == "testing":
-                # Testing: Use in-memory backend
-                config.backend_override = "django.core.mail.backends.locmem.EmailBackend"
-                config.timeout = min(config.timeout, 5)  # Very short timeout
-                
-            elif environment == "development":
-                # Development: Use SMTP if configured (allow real email sending in dev)
-                if config.username and config.password:
-                    # SMTP configured - use SMTP backend
-                    config.backend_override = "django.core.mail.backends.smtp.EmailBackend"
-                # Note: No fallback to console - let user decide via backend setting
-                    
-            elif environment in ("production", "staging"):
-                # Production: Use SMTP if properly configured
-                if config.username and config.password:
-                    config.backend_override = "django.core.mail.backends.smtp.EmailBackend"
-                    
-                    # Production email security
-                    if config.port == 587:
-                        config.use_tls = True
-                        config.use_ssl = False
-                    elif config.port == 465:
-                        config.use_tls = False
-                        config.use_ssl = True
-                    
-                    # Longer timeout for production
-                    config.timeout = max(config.timeout, 30)
-                else:
-                    # Production without SMTP - fallback to console with warning
-                    config.backend_override = "django.core.mail.backends.console.EmailBackend"
-            
-            return config
-            
-        except Exception as e:
-            raise ConfigurationError(
-                f"Failed to configure email backend: {e}",
-                context={
-                    'environment': environment,
-                    'debug': debug,
-                    'email_config': email_config.model_dump(exclude={'password'})
-                }
-            ) from e
+    except Exception:
+        # Fallback to django-cfg filename (since we're in django-cfg module)
+        return 'django-cfg.log'
+
+
+class SmartDefaults:
+    """
+    Environment-aware smart defaults for Django configuration.
     
-    @classmethod
-    def get_security_defaults(
-        cls,
-        domains: List[str],
-        environment: Optional[str] = None,
-        debug: bool = False,
-        ssl_redirect: Optional[bool] = None,
-        cors_allow_headers: Optional[List[str]] = None
-    ) -> Dict[str, Any]:
-        """
-        Get security defaults based on environment and domains.
-        
-        Args:
-            domains: List of domains for CORS/security configuration
-            environment: Current environment
-            debug: Django DEBUG setting
-            ssl_redirect: Force SSL redirect on/off (None = auto based on domains)
-            cors_allow_headers: Additional CORS headers to extend defaults
-            
-        Returns:
-            Security settings dictionary
-        """
-        try:
-            settings = {}
-            
-            if not domains:
-                return settings
-            
-            is_dev = environment == "development" or debug
-            
-            # Generate CORS settings
-            cors_settings = cls._generate_cors_settings(domains, is_dev, cors_allow_headers)
-            settings.update(cors_settings)
-            
-            # Generate CSRF trusted origins
-            csrf_settings = cls._generate_csrf_settings(domains, is_dev)
-            settings.update(csrf_settings)
-            
-            # Generate security headers for production
-            if environment == "production":
-                security_headers = cls._generate_security_headers(domains, ssl_redirect)
-                settings.update(security_headers)
-            
-            return settings
-            
-        except Exception as e:
-            raise ConfigurationError(
-                f"Failed to generate security defaults: {e}",
-                context={
-                    'domains': domains,
-                    'environment': environment,
-                    'debug': debug
-                }
-            ) from e
+    Provides intelligent defaults based on environment detection
+    with comprehensive type safety and validation.
+    """
     
-    @classmethod
-    def _generate_cors_settings(
-        cls,
-        domains: List[str],
-        is_dev: bool,
-        cors_allow_headers: Optional[List[str]] = None
-    ) -> Dict[str, Any]:
-        """Generate CORS-specific settings."""
-        settings = {
-            'CORS_ALLOW_CREDENTIALS': True,
-            'CORS_ALLOW_HEADERS': cls._get_cors_headers(cors_allow_headers)
+    @staticmethod
+    def get_database_defaults(environment: str = "development", debug: bool = False, engine: str = "sqlite3") -> Dict[str, Any]:
+        """Get database configuration defaults."""
+        defaults = {
+            'ENGINE': 'django.db.backends.sqlite3',
+            'NAME': Path('db') / 'db.sqlite3',
+            'ATOMIC_REQUESTS': True,
+            'CONN_MAX_AGE': 60,
+            'OPTIONS': {}
         }
         
-        if is_dev:
-            # Development: Allow all origins for convenience
-            settings['CORS_ALLOW_ALL_ORIGINS'] = True
-        else:
-            # Production: Restrict to specified domains
-            settings['CORS_ALLOWED_ORIGINS'] = cls._build_allowed_origins(domains)
-        
-        return settings
-    
-    @classmethod
-    def _generate_csrf_settings(cls, domains: List[str], is_dev: bool) -> Dict[str, Any]:
-        """Generate CSRF trusted origins."""
-        if is_dev:
-            csrf_origins = cls._build_dev_csrf_origins(domains)
-        else:
-            csrf_origins = cls._build_prod_csrf_origins(domains)
-        
-        # Only return CSRF settings if we have origins to set
-        if csrf_origins:
-            return {'CSRF_TRUSTED_ORIGINS': csrf_origins}
+        # Add engine-specific options
+        if engine == "django.db.backends.postgresql":
+            defaults['OPTIONS']['connect_timeout'] = 20
+        elif engine == "django.db.backends.sqlite3":
+            defaults['OPTIONS']['timeout'] = 20  # SQLite uses 'timeout'
         
-        return {}
+        return defaults
     
-    @classmethod
-    def _generate_security_headers(
-        cls,
-        domains: List[str],
-        ssl_redirect: Optional[bool] = None
-    ) -> Dict[str, Any]:
-        """Generate security headers for production."""
-        settings = {
-            'SECURE_BROWSER_XSS_FILTER': True,
-            'SECURE_CONTENT_TYPE_NOSNIFF': True,
-            'SECURE_HSTS_SECONDS': 31536000,  # 1 year
-            'SECURE_HSTS_INCLUDE_SUBDOMAINS': True,
-            'SECURE_HSTS_PRELOAD': True,
-            'X_FRAME_OPTIONS': 'DENY',
+    @staticmethod
+    def get_cache_defaults() -> Dict[str, Any]:
+        """Get cache configuration defaults."""
+        return {
+            'default': {
+                'BACKEND': 'django.core.cache.backends.locmem.LocMemCache',
+                'LOCATION': 'default-cache',
+                'TIMEOUT': 300,
+                'OPTIONS': {
+                    'MAX_ENTRIES': 1000,
+                }
+            }
         }
-        
-        # SSL settings - configurable or auto-detect based on domains
-        should_use_ssl = ssl_redirect if ssl_redirect is not None else bool(domains)
-        
-        if should_use_ssl:
-            settings.update({
-                'SECURE_SSL_REDIRECT': True,
-                'SESSION_COOKIE_SECURE': True,
-                'CSRF_COOKIE_SECURE': True,
-            })
-        elif ssl_redirect is False:
-            # Explicitly disable SSL redirect
-            settings.update({
-                'SECURE_SSL_REDIRECT': False,
-                'SESSION_COOKIE_SECURE': False,
-                'CSRF_COOKIE_SECURE': False,
-            })
-        
-        return settings
-    
-    @classmethod
-    def _get_cors_headers(cls, cors_allow_headers: Optional[List[str]] = None) -> List[str]:
-        """
-        Get CORS headers with defaults extended by custom headers.
-        
-        Note: The default headers are defined in DjangoConfig.cors_allow_headers.
-        This method should be consistent with those defaults.
-        """
-        # Default headers - should match DjangoConfig.cors_allow_headers defaults
-        default_headers = [
-            "accept",
-            "accept-encoding", 
-            "authorization",
-            "content-type",
-            "dnt",
-            "origin",
-            "user-agent",
-            "x-csrftoken",
-            "x-requested-with",
-            "x-api-key",
-            "x-api-token",
-        ]
-        
-        if not cors_allow_headers:
-            return default_headers
-        
-        # Extend with custom headers and remove duplicates while preserving order
-        return cls._merge_headers(default_headers, cors_allow_headers)
-    
-    @classmethod
-    def _merge_headers(cls, default_headers: List[str], custom_headers: List[str]) -> List[str]:
-        """Merge header lists removing duplicates while preserving order."""
-        all_headers = default_headers + custom_headers
-        seen = set()
-        unique_headers = []
-        
-        for header in all_headers:
-            header_lower = header.lower()
-            if header_lower not in seen:
-                seen.add(header_lower)
-                unique_headers.append(header)
-        
-        return unique_headers
-    
-    @classmethod
-    def _build_allowed_origins(cls, domains: List[str]) -> List[str]:
-        """Build CORS allowed origins for production."""
-        allowed_origins = []
-        
-        for domain in domains:
-            # Add HTTPS version
-            allowed_origins.append(f"https://{domain}")
-            
-            # Add www. version if applicable
-            if cls._should_add_www_variant(domain):
-                allowed_origins.append(f"https://www.{domain}")
-        
-        return allowed_origins
     
-    @classmethod
-    def _build_dev_csrf_origins(cls, domains: List[str]) -> List[str]:
-        """Build CSRF trusted origins for development."""
-        csrf_origins = []
-        
-        for domain in domains:
-            if domain.startswith(('localhost', '127.0.0.1', '0.0.0.0')):
-                # Local domains: add HTTP with common ports
-                csrf_origins.extend([
-                    f"http://{domain}",
-                    f"http://{domain}:8000",
-                    f"http://{domain}:3000",
-                ])
-            elif domain.endswith('.local'):
-                # .local domains: add both HTTP and HTTPS
-                csrf_origins.extend([
-                    f"http://{domain}",
-                    f"https://{domain}",
-                ])
-            else:
-                # External domains: add both for dev flexibility
-                csrf_origins.extend([
-                    f"https://{domain}",
-                    f"http://{domain}",
-                ])
-        
-        return csrf_origins
-    
-    @classmethod
-    def _build_prod_csrf_origins(cls, domains: List[str]) -> List[str]:
-        """Build CSRF trusted origins for production."""
-        csrf_origins = []
-        
-        for domain in domains:
-            # Add HTTPS version
-            csrf_origins.append(f"https://{domain}")
-            
-            # Add www. version if applicable
-            if cls._should_add_www_variant(domain):
-                csrf_origins.append(f"https://www.{domain}")
-        
-        return csrf_origins
-    
-    @classmethod
-    def _should_add_www_variant(cls, domain: str) -> bool:
-        """
-        Check if domain should get a www. variant added.
-        
-        Simple rule: add www. variant only if domain doesn't already start with www.
-        Let users handle complex subdomain logic themselves by providing exact domains they want.
-        
-        Examples:
-        - example.com -> True (add www.example.com)
-        - www.example.com -> False (already has www)
-        - api.example.com -> True (add www.api.example.com - let user decide)
-        - localhost -> False (no dot)
-        """
-        if not domain or '.' not in domain:
-            return False
-            
-        # Don't add www if domain already starts with www
-        return not domain.startswith('www.')
-    
-    @classmethod
-    def get_database_defaults(
-        cls,
-        environment: Optional[str] = None,
+    @staticmethod
+    def get_security_defaults(
+        security_domains=None, 
+        environment: str = "development", 
         debug: bool = False,
-        engine: Optional[str] = None
+        ssl_redirect=None,
+        cors_allow_headers=None
     ) -> Dict[str, Any]:
-        """
-        Get database defaults based on environment and engine.
-        
-        Args:
-            environment: Current environment
-            debug: Django DEBUG setting
-            engine: Database engine (to determine which options to apply)
-            
-        Returns:
-            Database settings dictionary
-        """
-        try:
-            defaults = {}
-            
-            if environment == "testing":
-                # Testing: Use in-memory SQLite
-                defaults = {
-                    'ENGINE': 'django.db.backends.sqlite3',
-                    'NAME': ':memory:',
-                    'OPTIONS': {
-                        'timeout': 1,  # Very short timeout for tests
-                    }
-                }
-                
-            elif environment == "development" or debug:
-                # Development: Only add PostgreSQL/MySQL specific options
-                if engine and engine in ("django.db.backends.postgresql", "django.db.backends.mysql"):
-                    defaults = {
-                        'OPTIONS': {
-                            'connect_timeout': 5,  # Short timeout for dev
-                        }
-                    }
-                    # Add sslmode only for PostgreSQL
-                    if engine == "django.db.backends.postgresql":
-                        defaults['OPTIONS']['sslmode'] = 'prefer'
-                else:
-                    # For SQLite, no special options needed
-                    defaults = {}
-                
-            elif environment in ("production", "staging"):
-                # Production: Only add PostgreSQL/MySQL specific options
-                if engine and engine in ("django.db.backends.postgresql", "django.db.backends.mysql"):
-                    if engine == "django.db.backends.postgresql":
-                        # psycopg3 supports connection pooling with proper parameters
-                        defaults = {
-                            'OPTIONS': {
-                                'connect_timeout': 10,
-                                # psycopg3 connection pool parameters
-                                'pool': {
-                                    'min_size': 1,
-                                    'max_size': 20,
-                                    'timeout': 30.0,
-                                }
-                            }
-                        }
-                    else:
-                        # MySQL
-                        defaults = {
-                            'OPTIONS': {
-                                'connect_timeout': 10,
-                            }
-                        }
-                    # Add sslmode only for PostgreSQL
-                    if engine == "django.db.backends.postgresql":
-                        defaults['OPTIONS']['sslmode'] = 'require'  # Require SSL in production
-                else:
-                    # For SQLite, no special options needed
-                    defaults = {}
-            
-            return defaults
-            
-        except Exception as e:
-            raise ConfigurationError(
-                f"Failed to generate database defaults: {e}",
-                context={
-                    'environment': environment,
-                    'debug': debug
-                }
-            ) from e
+        """Get security configuration defaults."""
+        return {
+            'USE_TZ': True,
+            'USE_I18N': True,
+            'USE_L10N': True,
+            'SECURE_BROWSER_XSS_FILTER': not debug,
+            'SECURE_CONTENT_TYPE_NOSNIFF': not debug,
+            'X_FRAME_OPTIONS': 'DENY' if not debug else 'SAMEORIGIN',
+            'SECURE_HSTS_SECONDS': 31536000 if not debug else 0,
+            'SECURE_HSTS_INCLUDE_SUBDOMAINS': not debug,
+            'SECURE_HSTS_PRELOAD': not debug,
+        }
     
     @classmethod
     def get_logging_defaults(
@@ -504,116 +108,169 @@ class SmartDefaults:
         debug: bool = False
     ) -> Dict[str, Any]:
         """
-        Get logging defaults based on environment.
+        Simple logging configuration.
+        
+        NOTE: Real logging setup is handled by django_cfg.modules.django_logger
+        This provides minimal fallback configuration only.
         
         Args:
-            environment: Current environment
-            debug: Django DEBUG setting
+            environment: Environment name (ignored - for compatibility)
+            debug: Debug mode (ignored - for compatibility)
             
         Returns:
-            Logging configuration dictionary
+            Minimal Django logging configuration
         """
-        try:
-            if environment == "testing":
-                # Testing: Minimal logging
-                return {
-                    'version': 1,
-                    'disable_existing_loggers': False,
-                    'handlers': {
-                        'null': {
-                            'class': 'logging.NullHandler',
-                        },
-                    },
-                    'root': {
-                        'handlers': ['null'],
-                    },
-                }
-                
-            elif environment == "development" or debug:
-                # Development: Console logging with colors
-                return {
-                    'version': 1,
-                    'disable_existing_loggers': False,
-                    'formatters': {
-                        'verbose': {
-                            'format': '{levelname} {asctime} {module} {process:d} {thread:d} {message}',
-                            'style': '{',
-                        },
-                    },
-                    'handlers': {
-                        'console': {
-                            'class': 'logging.StreamHandler',
-                            'formatter': 'verbose',
-                        },
-                    },
-                    'root': {
-                        'handlers': ['console'],
-                        'level': 'DEBUG',
-                    },
-                    'loggers': {
-                        'django': {
-                            'handlers': ['console'],
-                            'level': 'INFO',
-                            'propagate': False,
-                        },
-                    },
-                }
-                
-            elif environment in ("production", "staging"):
-                # Production: File and structured logging
-                return {
-                    'version': 1,
-                    'disable_existing_loggers': False,
-                    'formatters': {
-                        'json': {
-                            'class': 'pythonjsonlogger.jsonlogger.JsonFormatter',
-                            'format': '%(asctime)s %(name)s %(levelname)s %(message)s'
-                        },
-                        'standard': {
-                            'format': '{levelname} {asctime} {name} {message}',
-                            'style': '{',
-                        },
-                    },
-                    'handlers': {
-                        'file': {
-                            'class': 'logging.handlers.RotatingFileHandler',
-                            'filename': 'logs/django.log',
-                            'maxBytes': 1024*1024*10,  # 10MB
-                            'backupCount': 5,
-                            'formatter': 'json' if environment == "production" else 'standard',
-                        },
-                        'console': {
-                            'class': 'logging.StreamHandler',
-                            'formatter': 'standard',
-                        },
-                    },
-                    'root': {
-                        'handlers': ['file', 'console'],
-                        'level': 'WARNING' if environment == "production" else 'INFO',
-                    },
-                    'loggers': {
-                        'django': {
-                            'handlers': ['file'],
-                            'level': 'INFO',
-                            'propagate': False,
-                        },
-                    },
-                }
+        # Minimal fallback - actual logging is configured by django_logger module
+        return {
+            'version': 1,
+            'disable_existing_loggers': False,
+            'handlers': {
+                'console': {
+                    'class': 'logging.StreamHandler',
+                },
+            },
+            'root': {
+                    'handlers': ['console'],
+                    'level': 'INFO',
+            },
+        }
+    
+    @staticmethod
+    def get_middleware_defaults() -> List[str]:
+        """Get middleware configuration defaults."""
+        return [
+            'corsheaders.middleware.CorsMiddleware',
+            'django.middleware.security.SecurityMiddleware',
+            'django.contrib.sessions.middleware.SessionMiddleware',
+            'django.middleware.common.CommonMiddleware',
+            'django.middleware.csrf.CsrfViewMiddleware',
+            'django.contrib.auth.middleware.AuthenticationMiddleware',
+            'django.contrib.messages.middleware.MessageMiddleware',
+            'django.middleware.clickjacking.XFrameOptionsMiddleware',
+        ]
+    
+    @staticmethod
+    def get_installed_apps_defaults() -> List[str]:
+        """Get default installed apps."""
+        return [
+            # Unfold admin
+            "unfold",
+            "unfold.contrib.filters",
+            "unfold.contrib.forms",
+            "unfold.contrib.inlines",
+            "import_export",
+            "unfold.contrib.import_export",
+            "unfold.contrib.guardian",
+            "unfold.contrib.simple_history",
+            "unfold.contrib.location_field",
+            "unfold.contrib.constance",
             
-            # Fallback
-            return {}
+            # Django core
+            "django.contrib.admin",
+            "django.contrib.auth",
+            "django.contrib.contenttypes",
+            "django.contrib.sessions",
+            "django.contrib.messages",
+            "django.contrib.staticfiles",
+            "django.contrib.humanize",
             
-        except Exception as e:
-            raise ConfigurationError(
-                f"Failed to generate logging defaults: {e}",
-                context={
-                    'environment': environment,
-                    'debug': debug
-                }
-            ) from e
+            # Third-party
+            "corsheaders",
+            "rest_framework",
+            "rest_framework.authtoken",
+            "rest_framework_simplejwt",
+            "rest_framework_simplejwt.token_blacklist",
+            "rest_framework_nested",
+            "rangefilter",
+            "django_filters",
+            "drf_spectacular",
+            "drf_spectacular_sidecar",
+            "django_json_widget",
+            "django_extensions",
+            "constance",
+            "constance.backends.database",
+            
+            # Django CFG
+            "django_cfg",
+        ]
+    
+    @staticmethod
+    def get_templates_defaults() -> List[Dict[str, Any]]:
+        """Get templates configuration defaults."""
+        return [
+            {
+                'BACKEND': 'django.template.backends.django.DjangoTemplates',
+                'DIRS': ['templates'],
+                'APP_DIRS': True,
+                'OPTIONS': {
+                    'context_processors': [
+                        'django.template.context_processors.debug',
+                        'django.template.context_processors.request',
+                        'django.contrib.auth.context_processors.auth',
+                        'django.contrib.messages.context_processors.messages',
+                    ],
+                },
+            },
+        ]
+    
+    @staticmethod
+    def get_static_files_defaults() -> Dict[str, Any]:
+        """Get static files configuration defaults."""
+        return {
+            'STATIC_URL': '/static/',
+            'STATIC_ROOT': Path('staticfiles'),
+            'STATICFILES_DIRS': [
+                Path('static'),
+            ],
+            'MEDIA_URL': '/media/',
+            'MEDIA_ROOT': Path('media'),
+        }
+    
+    @staticmethod
+    def get_rest_framework_defaults() -> Dict[str, Any]:
+        """Get Django REST Framework defaults."""
+        return {
+            'DEFAULT_AUTHENTICATION_CLASSES': [
+                'rest_framework_simplejwt.authentication.JWTAuthentication',
+                'rest_framework.authentication.SessionAuthentication',
+            ],
+            'DEFAULT_PERMISSION_CLASSES': [
+                'rest_framework.permissions.IsAuthenticated',
+            ],
+            'DEFAULT_PAGINATION_CLASS': 'rest_framework.pagination.PageNumberPagination',
+            'PAGE_SIZE': 20,
+            'DEFAULT_SCHEMA_CLASS': 'drf_spectacular.openapi.AutoSchema',
+        }
+    
+    @staticmethod
+    def get_cors_defaults() -> Dict[str, Any]:
+        """Get CORS configuration defaults."""
+        return {
+            'CORS_ALLOWED_ORIGINS': [
+                "http://localhost:3000",
+                "http://127.0.0.1:3000",
+            ],
+            'CORS_ALLOW_CREDENTIALS': True,
+            'CORS_ALLOW_ALL_ORIGINS': False,
+        }
+    
+    @staticmethod
+    def configure_cache_backend(cache_config, environment: str, debug: bool):
+        """Configure cache backend - simplified."""
+        if cache_config is None:
+            return CacheConfig()
+        return cache_config
+    
+    @staticmethod
+    def configure_email_backend(email_config, environment: str, debug: bool):
+        """Configure email backend - simplified."""
+        if email_config is None:
+            return EmailConfig()
+        return email_config
 
 
 # Export the main class
 __all__ = [
     "SmartDefaults",
+    "get_log_filename",
 ]