django-cfg 1.3.13__py3-none-any.whl → 1.4.0__py3-none-any.whl

django_cfg-1.3.13.dist-info/METADATA

@@ -1,1029 +0,0 @@
-Metadata-Version: 2.4
-Name: django-cfg
-Version: 1.3.13
-Summary: 🚀 Next-gen Django configuration: type-safety, AI features, blazing-fast setup, and automated best practices — all in one.
-Project-URL: Homepage, https://djangocfg.com
-Project-URL: Documentation, https://docs.djangocfg.com
-Project-URL: Repository, https://github.com/markolofsen/django-cfg
-Project-URL: Issues, https://github.com/markolofsen/django-cfg/issues
-Project-URL: Changelog, https://github.com/markolofsen/django-cfg/blob/main/CHANGELOG.md
-Author-email: Django-CFG Team <info@djangocfg.com>
-Maintainer-email: Django-CFG Team <info@djangocfg.com>
-License: MIT
-License-File: LICENSE
-Keywords: configuration,developer-experience,django,pydantic,settings,type-safety
-Classifier: Development Status :: 4 - Beta
-Classifier: Framework :: Django
-Classifier: Framework :: Django :: 5.2
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Internet :: WWW/HTTP
-Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: System :: Systems Administration
-Classifier: Typing :: Typed
-Requires-Python: <4.0,>=3.12
-Requires-Dist: beautifulsoup4<5.0,>=4.13.0
-Requires-Dist: cachetools<7.0,>=5.3.0
-Requires-Dist: click<9.0,>=8.2.0
-Requires-Dist: cloudflare<5.0,>=4.3.0
-Requires-Dist: colorlog<7.0,>=6.9.0
-Requires-Dist: coolname<3.0,>=2.2.0
-Requires-Dist: currencyconverter<1.0,>=0.18.0
-Requires-Dist: dj-database-url<4.0,>=3.0.0
-Requires-Dist: django-admin-rangefilter<1.0,>=0.13.0
-Requires-Dist: django-constance<5.0,>=4.3.0
-Requires-Dist: django-cors-headers<5.0,>=4.7.0
-Requires-Dist: django-dramatiq<1.0,>=0.14.0
-Requires-Dist: django-extensions<5.0,>=4.1.0
-Requires-Dist: django-filter<26.0,>=25.0
-Requires-Dist: django-import-export<5.0,>=4.3.0
-Requires-Dist: django-json-widget<3.0,>=2.0.0
-Requires-Dist: django-ratelimit<5.0.0,>=4.1.0
-Requires-Dist: django-redis<7.0,>=6.0.0
-Requires-Dist: django-revolution<2.0,>=1.0.43
-Requires-Dist: django-unfold<1.0,>=0.64.0
-Requires-Dist: djangorestframework-simplejwt<6.0,>=5.5.0
-Requires-Dist: djangorestframework-simplejwt[token-blacklist]<6.0,>=5.5.0
-Requires-Dist: djangorestframework<4.0,>=3.16.0
-Requires-Dist: dramatiq[redis]<2.0,>=1.18.0
-Requires-Dist: drf-nested-routers<1.0,>=0.94.0
-Requires-Dist: drf-spectacular-sidecar<2026.0,>=2025.8.0
-Requires-Dist: drf-spectacular<1.0,>=0.28.0
-Requires-Dist: hiredis<4.0,>=2.0.0
-Requires-Dist: loguru<1.0,>=0.7.0
-Requires-Dist: lxml<7.0,>=6.0.0
-Requires-Dist: mypy<2.0.0,>=1.18.2
-Requires-Dist: ngrok>=1.5.1; python_version >= '3.12'
-Requires-Dist: openai<2.0,>=1.107.0
-Requires-Dist: pgvector<1.0,>=0.4.0
-Requires-Dist: psycopg[binary,pool]<4.0,>=3.2.0
-Requires-Dist: pydantic-ai<2.0,>=1.0.10
-Requires-Dist: pydantic-yaml<2.0,>=1.6.0
-Requires-Dist: pydantic<3.0,>=2.11.0
-Requires-Dist: pydantic[email]<3.0,>=2.11.0
-Requires-Dist: pytelegrambotapi<5.0,>=4.28.0
-Requires-Dist: python-json-logger<4.0,>=3.3.0
-Requires-Dist: pyyaml<7.0,>=6.0
-Requires-Dist: questionary<3.0,>=2.1.0
-Requires-Dist: redis<7.0,>=6.4.0
-Requires-Dist: requests<3.0,>=2.32.0
-Requires-Dist: rich<15.0,>=14.0.0
-Requires-Dist: sendgrid<7.0,>=6.12.0
-Requires-Dist: tenacity<10.0.0,>=9.1.2
-Requires-Dist: tiktoken<1.0,>=0.11.0
-Requires-Dist: toml<0.11.0,>=0.10.2
-Requires-Dist: twilio<10.0,>=9.8.0
-Requires-Dist: whitenoise<7.0,>=6.8.0
-Provides-Extra: dev
-Requires-Dist: black<26.0,>=25.9; extra == 'dev'
-Requires-Dist: build<2.0,>=1.3; extra == 'dev'
-Requires-Dist: django<6.0,>=5.2; extra == 'dev'
-Requires-Dist: factory-boy<4.0,>=3.3; extra == 'dev'
-Requires-Dist: flake8<8.0,>=6.0.0; extra == 'dev'
-Requires-Dist: isort<7.0,>=6.0; extra == 'dev'
-Requires-Dist: mkdocs-material<10.0,>=9.6; extra == 'dev'
-Requires-Dist: mkdocs<2.0,>=1.6; extra == 'dev'
-Requires-Dist: mkdocstrings[python]<1.0,>=0.30; extra == 'dev'
-Requires-Dist: mypy<2.0,>=1.18; extra == 'dev'
-Requires-Dist: pre-commit<5.0,>=4.3; extra == 'dev'
-Requires-Dist: pytest-cov<8.0,>=7.0; extra == 'dev'
-Requires-Dist: pytest-django<5.0,>=4.11; extra == 'dev'
-Requires-Dist: pytest-mock<4.0,>=3.15; extra == 'dev'
-Requires-Dist: pytest<9.0,>=8.4; extra == 'dev'
-Requires-Dist: questionary<3.0,>=2.1.0; extra == 'dev'
-Requires-Dist: redis<7.0,>=6.4.0; extra == 'dev'
-Requires-Dist: rich<15.0,>=13.0.0; extra == 'dev'
-Requires-Dist: tomlkit<1.0,>=0.13.3; extra == 'dev'
-Requires-Dist: twine<7.0,>=6.2; extra == 'dev'
-Provides-Extra: django52
-Requires-Dist: django<6.0,>=5.2; extra == 'django52'
-Provides-Extra: docs
-Requires-Dist: mkdocs-material<10.0,>=9.6; extra == 'docs'
-Requires-Dist: mkdocs<2.0,>=1.6; extra == 'docs'
-Requires-Dist: mkdocstrings[python]<1.0,>=0.30; extra == 'docs'
-Requires-Dist: pymdown-extensions<11.0,>=10.16; extra == 'docs'
-Provides-Extra: full
-Requires-Dist: black<26.0,>=25.9; extra == 'full'
-Requires-Dist: build<2.0,>=1.3; extra == 'full'
-Requires-Dist: django<6.0,>=5.2; extra == 'full'
-Requires-Dist: factory-boy<4.0,>=3.3; extra == 'full'
-Requires-Dist: flake8<8.0,>=6.0.0; extra == 'full'
-Requires-Dist: isort<7.0,>=6.0; extra == 'full'
-Requires-Dist: mkdocs-material<10.0,>=9.6; extra == 'full'
-Requires-Dist: mkdocs<2.0,>=1.6; extra == 'full'
-Requires-Dist: mkdocstrings[python]<1.0,>=0.30; extra == 'full'
-Requires-Dist: mypy<2.0,>=1.18; extra == 'full'
-Requires-Dist: pre-commit<5.0,>=4.3; extra == 'full'
-Requires-Dist: pymdown-extensions<11.0,>=10.16; extra == 'full'
-Requires-Dist: pytest-cov<8.0,>=7.0; extra == 'full'
-Requires-Dist: pytest-django<5.0,>=4.11; extra == 'full'
-Requires-Dist: pytest-mock<4.0,>=3.15; extra == 'full'
-Requires-Dist: pytest-xdist<4.0,>=3.8; extra == 'full'
-Requires-Dist: pytest<9.0,>=8.4; extra == 'full'
-Requires-Dist: questionary<3.0,>=2.1.0; extra == 'full'
-Requires-Dist: redis<7.0,>=6.4.0; extra == 'full'
-Requires-Dist: rich<15.0,>=13.0.0; extra == 'full'
-Requires-Dist: tomlkit<1.0,>=0.13.3; extra == 'full'
-Requires-Dist: twine<7.0,>=6.2; extra == 'full'
-Provides-Extra: local
-Provides-Extra: tasks
-Requires-Dist: redis<7.0,>=6.4.0; extra == 'tasks'
-Provides-Extra: test
-Requires-Dist: django<6.0,>=5.2; extra == 'test'
-Requires-Dist: factory-boy<4.0,>=3.3; extra == 'test'
-Requires-Dist: pytest-cov<8.0,>=7.0; extra == 'test'
-Requires-Dist: pytest-django<5.0,>=4.11; extra == 'test'
-Requires-Dist: pytest-mock<4.0,>=3.15; extra == 'test'
-Requires-Dist: pytest-xdist<4.0,>=3.8; extra == 'test'
-Requires-Dist: pytest<9.0,>=8.4; extra == 'test'
-Description-Content-Type: text/markdown
-
-# 🚀 Django-CFG: Enterprise Django Configuration Framework
-
-<div align="center">
-  <img src="https://github.com/markolofsen/django-cfg/blob/main/examples/static/startup.png?raw=true" alt="Django-CFG Startup Interface" width="800" />
-</div>
-
-[![Python Version](https://img.shields.io/pypi/pyversions/django-cfg.svg?style=flat-square&logo=python&logoColor=white)](https://pypi.org/project/django-cfg)
-[![Django Version](https://img.shields.io/pypi/djversions/django-cfg.svg?style=flat-square&logo=django&logoColor=white)](https://pypi.org/project/django-cfg)
-[![PyPI Version](https://img.shields.io/pypi/v/django-cfg.svg?style=flat-square&logo=pypi&logoColor=white)](https://pypi.org/project/django-cfg)
-[![License](https://img.shields.io/pypi/l/django-cfg.svg?style=flat-square)](https://github.com/markolofsen/markolofsen/blob/main/LICENSE)
-[![Downloads](https://img.shields.io/pypi/dm/django-cfg.svg?style=flat-square&logo=pypi&logoColor=white)](https://pypi.org/project/django-cfg)
-[![GitHub Stars](https://img.shields.io/github/stars/markolofsen/django-cfg?style=flat-square&logo=github)](https://github.com/markolofsen/django-cfg)
-
-> **Transform Django development with enterprise-grade type safety, AI agents, and production-ready integrations.**
-
-**Django-CFG** is the next-generation Django configuration framework designed for **enterprise applications**. Built with **Pydantic v2**, it provides **100% type safety**, **intelligent environment detection**, **AI-powered workflows**, and **seamless production deployment**.
-
-🌐 **Official Website**: [djangocfg.com](https://djangocfg.com/)  
-📚 **Documentation**: [docs.djangocfg.com](https://docs.djangocfg.com/)  
-🐙 **GitHub Repository**: [github.com/markolofsen/django-cfg](https://github.com/markolofsen/django-cfg)  
-
----
-
-## 🎯 Quick Start: Production-Ready in 30 Seconds
-
-### Prerequisites
-- **Python 3.12+** ([Download](https://www.python.org/downloads/))
-- **Basic Django knowledge**
-
-### Installation & Setup
-
-```bash
-# 1. Install Django-CFG
-pip install django-cfg
-
-# 2. Create enterprise-ready project
-django-cfg create-project "My Enterprise App"
-
-# 3. Launch your application
-cd my-enterprise-app
-python manage.py runserver
-```
-
-**🎉 Congratulations!** Your enterprise Django application is now running with:
-
-- **🎯 Admin Dashboard**: http://127.0.0.1:8000/admin/ (Modern Unfold UI)
-- **📚 API Documentation**: http://127.0.0.1:8000/api/docs/ (Auto-generated OpenAPI)
-- **🚀 Main Application**: http://127.0.0.1:8000/ (Production-ready frontend)
-
----
-
-## 🏆 Why Django-CFG? Enterprise Comparison
-
-| **Capability** | **Traditional Django** | **Django REST Framework** | **FastAPI** | **Django-CFG** |
-|---|---|---|---|---|
-| **🔒 Type Safety** | ❌ Runtime errors | ❌ Manual validation | ✅ Pydantic | ✅ **Full Pydantic v2** |
-| **🎨 Admin Interface** | 🟡 Basic 2010 UI | ❌ No admin | ❌ No admin | ✅ **Modern Unfold + Tailwind** |
-| **📊 Real-time Dashboard** | ❌ Static pages | ❌ Manual setup | ❌ Manual setup | ✅ **Built-in widgets & metrics** |
-| **🗄️ Multi-Database** | 🟡 Manual routing | 🟡 Manual routing | ❌ Single DB focus | ✅ **Smart auto-routing** |
-| **📚 API Documentation** | ❌ Manual setup | 🟡 Basic DRF docs | ✅ Auto OpenAPI | ✅ **Zone-based OpenAPI** |
-| **🤖 AI Integration** | ❌ Build from scratch | ❌ Build from scratch | ❌ Build from scratch | ✅ **Built-in AI agents** |
-| **🎫 Support System** | ❌ Build from scratch | ❌ Build from scratch | ❌ Build from scratch | ✅ **Enterprise ticketing** |
-| **👤 User Management** | 🟡 Basic User model | 🟡 Basic auth | ❌ Manual auth | ✅ **OTP + SMS + Profiles** |
-| **📧 Communication** | 🟡 Basic email | ❌ Manual setup | ❌ Manual setup | ✅ **Email + SMS + Telegram** |
-| **💱 Currency Conversion** | ❌ Manual API integration | ❌ Manual API integration | ❌ Manual API integration | ✅ **Multi-threading 14K+ currencies** |
-| **🔄 Background Tasks** | 🟡 Manual Celery | 🟡 Manual Celery | ❌ Manual setup | ✅ **Built-in Dramatiq** |
-| **🌐 Webhook Testing** | 🟡 Manual ngrok | 🟡 Manual ngrok | 🟡 Manual ngrok | ✅ **Integrated ngrok** |
-| **🚀 Production Deploy** | 🟡 Manual config | 🟡 Manual config | 🟡 Manual config | ✅ **Zero-config Docker** |
-| **💡 IDE Support** | 🟡 Basic highlighting | 🟡 Basic highlighting | ✅ Type hints | ✅ **Full IntelliSense** |
-| **⚡ Development Speed** | 🟡 Weeks to production | 🟡 Weeks to production | 🟡 Days to production | ✅ **Minutes to production** |
-| **🏢 Enterprise Ready** | 🟡 Requires expertise | 🟡 Requires expertise | 🟡 Limited features | ✅ **Out-of-the-box** |
-
-**Legend**: ✅ Excellent | 🟡 Requires Work | ❌ Not Available
-
----
-
-## 🚀 Enterprise Features
-
-### 🔒 **Type-Safe Configuration**
-**100% type safety** with Pydantic v2 models, IDE autocomplete, and compile-time validation.
-
-```python
-from django_cfg import DjangoConfig
-from django_cfg.models import DatabaseConfig, CacheConfig
-
-class EnterpriseConfig(DjangoConfig):
-    # Project metadata
-    project_name: str = "Enterprise Application"
-    project_version: str = "2.1.0"
-    
-    # Security & environment
-    secret_key: str = "${SECRET_KEY}"
-    debug: bool = False
-    allowed_hosts: list[str] = ["*.mycompany.com", "api.mycompany.com"]
-    
-    # Multi-database architecture
-    databases: dict[str, DatabaseConfig] = {
-        "default": DatabaseConfig(
-            engine="django.db.backends.postgresql",
-            name="${DB_NAME}",
-            user="${DB_USER}",
-            password="${DB_PASSWORD}",
-            host="${DB_HOST}",
-            port=5432,
-            sslmode="require",
-            conn_max_age=600,
-        ),
-        "analytics": DatabaseConfig(
-            name="${ANALYTICS_DB_NAME}",
-            routing_apps=["analytics", "reports"],
-        ),
-        "cache": DatabaseConfig(
-            engine="django.db.backends.redis",
-            location="${REDIS_URL}",
-        )
-    }
-    
-    # Enterprise modules
-    enable_accounts: bool = True      # Advanced user management
-    enable_support: bool = True       # Enterprise ticketing system
-    enable_newsletter: bool = True    # Marketing automation
-    enable_leads: bool = True         # CRM integration
-    enable_agents: bool = True        # AI workflow automation
-    enable_knowbase: bool = True      # AI knowledge management
-    enable_maintenance: bool = True   # Multi-site Cloudflare maintenance
-
-config = EnterpriseConfig()
-```
-
-### 🤖 **AI-Powered Workflows**
-**Enterprise-grade AI agents** with type-safe workflows and Django integration.
-
-```python
-from django_cfg.agents import Agent, Workflow, Context
-from django_cfg.agents.toolsets import ORMToolset, CacheToolset
-
-@Agent.register("document_processor")
-class DocumentProcessorAgent(Agent):
-    """Enterprise document processing with AI analysis."""
-    
-    name = "Document Processor"
-    description = "Processes documents with AI analysis and data extraction"
-    toolsets = [
-        ORMToolset(allowed_models=['documents.Document', 'analytics.Report']),
-        CacheToolset(cache_alias='default'),
-    ]
-    
-    def process(self, context: Context) -> dict:
-        document_id = context.get("document_id")
-        
-        # AI-powered document analysis
-        document = self.tools.orm.get_object("documents.Document", id=document_id)
-        analysis = self.analyze_document(document.content)
-        
-        # Cache results for performance
-        self.tools.cache.set_cache_key(
-            f"analysis:{document_id}", 
-            analysis, 
-            timeout=3600
-        )
-        
-        return {
-            "status": "completed",
-            "analysis": analysis,
-            "confidence": analysis.get("confidence", 0.0)
-        }
-
-# Use in enterprise workflows
-workflow = Workflow([
-    DocumentProcessorAgent(),
-    # Add more agents for complex workflows
-])
-
-result = workflow.run({"document_id": "doc_123"})
-```
-
-### 🌐 **Multi-Site Cloudflare Maintenance**
-**Zero-configuration maintenance mode** for enterprise applications with automated monitoring.
-
-```python
-from django_cfg.apps.maintenance.services import MaintenanceManager
-
-# Enable maintenance for all production sites
-manager = MaintenanceManager(user)
-manager.bulk_enable_maintenance(
-    sites=CloudflareSite.objects.filter(environment='production'),
-    reason="Database migration",
-    message="🚀 Upgrading our systems. Back online in 30 minutes!"
-)
-
-# CLI management
-# python manage.py maintenance enable --environment production
-# python manage.py sync_cloudflare --api-token your_token
-```
-
-**Features:**
-- ✅ **Zero-config setup** - Just provide API token and domain
-- ✅ **Multi-site management** - Handle hundreds of sites with ORM queries  
-- ✅ **Automated monitoring** - Health checks with auto-triggers
-- ✅ **Rich admin interface** - Bulk operations and real-time status
-- ✅ **CLI automation** - Perfect for CI/CD pipelines
-
-[**📚 View Maintenance Documentation →**](https://docs.djangocfg.com/features/built-in-apps/maintenance)
-
-### 🏢 **Enterprise User Management**
-**Multi-channel authentication** with OTP, SMS, email verification, and audit trails.
-
-```python
-from django_cfg.apps.accounts.services import OTPService, UserProfileService
-
-# Multi-channel OTP authentication
-class EnterpriseAuthService:
-    @staticmethod
-    def authenticate_user(identifier: str, otp_code: str) -> tuple[User, bool]:
-        """Authenticate via email or phone with enterprise security."""
-        
-        # Auto-detect authentication method
-        if "@" in identifier:
-            user = OTPService.verify_email_otp(identifier, otp_code)
-        else:
-            user = OTPService.verify_phone_otp(identifier, otp_code)
-        
-        if user:
-            # Enterprise audit logging
-            UserProfileService.log_authentication(
-                user=user,
-                method="otp",
-                ip_address=request.META.get('REMOTE_ADDR'),
-                user_agent=request.META.get('HTTP_USER_AGENT')
-            )
-            
-        return user, bool(user)
-
-# Enterprise user provisioning
-enterprise_user = UserProfileService.create_enterprise_user(
-    email="john.doe@company.com",
-    phone="+1-555-0123",
-    department="Engineering",
-    role="Senior Developer",
-    manager_email="jane.smith@company.com"
-)
-```
-
-### 📊 **Real-Time Enterprise Dashboard**
-**Executive dashboards** with real-time metrics, KPIs, and business intelligence.
-
-```python
-from django_cfg.apps.unfold.dashboard import DashboardManager, MetricCard, ChartWidget
-
-class EnterpriseDashboard(DashboardManager):
-    """Executive dashboard with real-time business metrics."""
-    
-    def get_dashboard_cards(self) -> list[MetricCard]:
-        return [
-            MetricCard(
-                title="Active Users",
-                value=self.get_active_users_count(),
-                trend="+12%",
-                trend_positive=True,
-                icon="users"
-            ),
-            MetricCard(
-                title="Revenue (MTD)",
-                value=f"${self.get_monthly_revenue():,.2f}",
-                trend="+8.5%",
-                trend_positive=True,
-                icon="dollar-sign"
-            ),
-            MetricCard(
-                title="Support Tickets",
-                value=self.get_open_tickets_count(),
-                trend="-15%",
-                trend_positive=True,
-                icon="help-circle"
-            ),
-            MetricCard(
-                title="System Health",
-                value="99.9%",
-                trend="Stable",
-                trend_positive=True,
-                icon="activity"
-            ),
-        ]
-    
-    def get_dashboard_widgets(self) -> list[ChartWidget]:
-        return [
-            ChartWidget(
-                title="User Growth",
-                chart_type="line",
-                data=self.get_user_growth_data(),
-                height=300
-            ),
-            ChartWidget(
-                title="Revenue by Product",
-                chart_type="pie",
-                data=self.get_revenue_breakdown(),
-                height=300
-            ),
-        ]
-```
-
-### 🔄 **Enterprise Background Processing**
-**Production-grade task processing** with Dramatiq, monitoring, and auto-scaling.
-
-```python
-import dramatiq
-from django_cfg.modules.dramatiq import get_broker
-from django_cfg.apps.tasks.decorators import enterprise_task
-
-@enterprise_task(
-    queue_name="high_priority",
-    max_retries=3,
-    min_backoff=1000,
-    max_backoff=900000,
-    priority=10
-)
-def process_enterprise_report(report_id: str, user_id: str) -> dict:
-    """Generate enterprise reports with SLA guarantees."""
-    
-    try:
-        # Heavy computational work
-        report = EnterpriseReport.objects.get(id=report_id)
-        user = User.objects.get(id=user_id)
-        
-        # Generate comprehensive report
-        data = generate_comprehensive_analysis(report)
-        
-        # Send notification to stakeholders
-        notify_report_completion.send(
-            report_id=report_id,
-            recipients=report.get_stakeholder_emails(),
-            priority="high"
-        )
-        
-        return {
-            "status": "completed",
-            "report_id": report_id,
-            "generated_at": timezone.now().isoformat(),
-            "data_points": len(data),
-        }
-        
-    except Exception as e:
-        # Enterprise error handling
-        logger.error(f"Report generation failed: {e}", extra={
-            "report_id": report_id,
-            "user_id": user_id,
-            "error_type": type(e).__name__
-        })
-        raise
-
-# Queue enterprise tasks
-process_enterprise_report.send(
-    report_id="rpt_2024_q1_001",
-    user_id="usr_executive_123"
-)
-```
-
----
-
-## 🛠️ Enterprise Installation Options
-
-### **Production Environment**
-```bash
-# Using pip (recommended for production)
-pip install django-cfg[production]
-
-# Using Poetry (recommended for development)
-poetry add django-cfg[production,dev,test]
-
-# Using pipenv
-pipenv install django-cfg[production]
-
-# Using conda
-conda install -c conda-forge django-cfg
-```
-
-### **Development Environment**
-```bash
-# Full development setup
-pip install django-cfg[dev,test,docs]
-
-# Create development project
-django-cfg create-project "My Dev Project" --template=development
-
-# Enable development features
-export DJANGO_CFG_ENV=development
-python manage.py runserver_ngrok  # With ngrok integration
-```
-
-### **Docker Deployment**
-```bash
-# Pull official Docker image
-docker pull djangocfg/django-cfg:latest
-
-# Or build from source
-git clone https://github.com/markolofsen/django-cfg.git
-cd django-cfg
-docker build -t my-django-cfg .
-
-# Run with Docker Compose
-docker-compose up -d
-```
-
----
-
-## 📚 Enterprise Documentation
-
-### **🚀 Getting Started**
-- [**Installation Guide**](https://docs.djangocfg.com/getting-started/installation) - Complete enterprise setup
-- [**First Project**](https://docs.djangocfg.com/getting-started/first-project) - Build your first application
-- [**Configuration**](https://docs.djangocfg.com/getting-started/configuration) - Type-safe configuration
-
-### **🏗️ Architecture & Fundamentals**
-- [**System Architecture**](https://docs.djangocfg.com/fundamentals/architecture) - Enterprise architecture patterns
-- [**Environment Detection**](https://docs.djangocfg.com/fundamentals/environment-detection) - Automatic environment management
-- [**Registry System**](https://docs.djangocfg.com/fundamentals/registry) - Component registration
-- [**Utilities & Helpers**](https://docs.djangocfg.com/fundamentals/utilities) - Development utilities
-
-### **🚀 Enterprise Features**
-- [**Built-in Applications**](https://docs.djangocfg.com/features/built-in-apps/accounts) - User management, support, CRM
-- [**Maintenance Management**](https://docs.djangocfg.com/features/built-in-apps/maintenance) - Multi-site Cloudflare maintenance
-- [**Modular System**](https://docs.djangocfg.com/features/modules/overview) - Email, SMS, LLM, **currency conversion** modules
-- [**Third-party Integrations**](https://docs.djangocfg.com/features/integrations/patterns) - Dramatiq, Twilio, ngrok
-
-### **🤖 AI & Automation**
-- [**AI Agents Framework**](https://docs.djangocfg.com/ai-agents/introduction) - Build intelligent workflows
-- [**Agent Toolsets**](https://docs.djangocfg.com/ai-agents/toolsets) - ORM, cache, file operations
-- [**Knowledge Base**](https://docs.djangocfg.com/features/built-in-apps/knowbase-setup) - AI-powered documentation
-
-### **🛠️ Development Tools**
-- [**CLI Tools**](https://docs.djangocfg.com/cli/introduction) - Command-line interface
-- [**Management Commands**](https://docs.djangocfg.com/cli/commands) - All available commands
-- [**Custom Commands**](https://docs.djangocfg.com/cli/custom-commands) - Build your own tools
-
-### **🚀 Deployment & Operations**
-- [**Docker Production**](https://docs.djangocfg.com/deployment/docker-production) - Container deployment
-- [**Environment Setup**](https://docs.djangocfg.com/deployment/environment-setup) - Production configuration
-- [**Monitoring & Logging**](https://docs.djangocfg.com/deployment/monitoring) - Observability
-
-### **📖 Examples & Guides**
-- [**Basic Setup**](https://docs.djangocfg.com/guides/basic-setup) - Simple examples
-- [**Production Configuration**](https://docs.djangocfg.com/guides/production-config) - Real-world setup
-- [**Migration Guide**](https://docs.djangocfg.com/guides/migration-guide) - Migrate existing projects
-- [**Multi-Database Setup**](https://docs.djangocfg.com/guides/multi-database) - Advanced database patterns
-
-### **🔧 API Reference**
-- [**Configuration Models**](https://docs.djangocfg.com/api/models) - All Pydantic models
-- [**CLI Reference**](https://docs.djangocfg.com/api/cli) - Command-line interface
-- [**Agent Framework**](https://docs.djangocfg.com/api/agents) - AI agents API
-
----
-
-## 🌟 Enterprise Success Stories
-
-### **CarAPIS - Automotive Data Platform**
-> *"Django-CFG reduced our development time by 80% and eliminated configuration errors in production."*
-
-- **Challenge**: Complex multi-database automotive data processing
-- **Solution**: Django-CFG with AI agents for tax calculations
-- **Results**: 
-  - 🚀 **80% faster development**
-  - 🔒 **Zero configuration errors**
-  - 📊 **Real-time analytics dashboard**
-  - 🤖 **AI-powered data processing**
-
-[**View CarAPIS Case Study →**](https://docs.djangocfg.com/guides/production-config)
-
-### **TechCorp - Enterprise SaaS**
-> *"The built-in support system and user management saved us 6 months of development."*
-
-- **Challenge**: Enterprise SaaS with complex user management
-- **Solution**: Django-CFG with built-in apps and AI agents
-- **Results**:
-  - ⏰ **6 months saved on development**
-  - 👥 **Enterprise user management**
-  - 🎫 **Professional support system**
-  - 📈 **Automated reporting**
-
----
-
-## 🔄 Migration from Existing Django
-
-### **Option 1: Fresh Start (Recommended)**
-Perfect for new projects or major refactoring.
-
-```bash
-# Create new Django-CFG project
-django-cfg create-project "My Migrated Project" --template=enterprise
-
-# Copy your existing apps
-cp -r /old-project/myapp ./src/
-
-# Migrate your data
-python manage.py migrate_legacy_data --source=/old-project/db.sqlite3
-
-# Update models to use Django-CFG patterns
-python manage.py modernize_models --app=myapp
-```
-
-### **Option 2: Gradual Migration**
-Ideal for production systems that can't be rebuilt.
-
-```bash
-# Install Django-CFG in existing project
-pip install django-cfg
-
-# Create configuration file
-cat > config.py << EOF
-from django_cfg import DjangoConfig
-
-class MyConfig(DjangoConfig):
-    project_name: str = "Existing Project"
-    secret_key: str = "${SECRET_KEY}"
-    project_apps: list[str] = ["myapp1", "myapp2"]
-    
-    # Gradually enable features
-    enable_accounts: bool = False  # Start with False
-    enable_support: bool = False   # Enable later
-
-config = MyConfig()
-EOF
-
-# Replace settings.py
-cat > settings.py << EOF
-from .config import config
-globals().update(config.get_all_settings())
-EOF
-
-# Test the migration
-python manage.py check
-python manage.py migrate
-```
-
-### **Option 3: Side-by-Side Analysis**
-Compare and learn before migrating.
-
-```bash
-# Create reference project
-django-cfg create-project "Reference Project"
-
-# Compare configurations
-diff -u /old-project/settings.py ./reference-project/config.py
-
-# Analyze differences
-python manage.py analyze_migration --source=/old-project/
-```
-
-[**Complete Migration Guide →**](https://docs.djangocfg.com/guides/migration-guide)
-
----
-
-## 🛠️ Enterprise Management Commands
-
-Django-CFG provides **50+ management commands** for enterprise operations:
-
-### **🗄️ Database & Migration**
-```bash
-# Interactive migration tool
-python manage.py migrator --auto
-
-# Multi-database migrations
-python manage.py migrate_all --databases=default,analytics
-
-# Database health check
-python manage.py check_databases --verbose
-```
-
-### **🔧 Configuration & Validation**
-```bash
-# Validate enterprise configuration
-python manage.py validate_config --strict --environment=production
-
-# Display current configuration
-python manage.py show_config --format=yaml --sensitive=false
-
-# Check system requirements
-python manage.py system_check --enterprise
-```
-
-### **👤 User & Security Management**
-```bash
-# Create enterprise superuser
-python manage.py create_superuser --enterprise --department=IT
-
-# Audit user permissions
-python manage.py audit_permissions --export=csv
-
-# Generate API tokens
-python manage.py create_token --user=admin --scopes=read,write
-```
-
-### **🔄 Background Task Management**
-```bash
-# Start enterprise workers
-python manage.py rundramatiq --processes=8 --threads=4 --queues=high,normal,low
-
-# Monitor task queues
-python manage.py task_status --queue=high --format=json
-
-# Clear failed tasks
-python manage.py task_clear --failed --older-than=24h
-```
-
-### **📧 Communication & Integration**
-```bash
-# Test enterprise email configuration
-python manage.py test_email --template=welcome --recipient=admin@company.com
-
-# Test SMS/WhatsApp integration
-python manage.py test_twilio --phone=+1-555-0123 --message="Test from Django-CFG"
-
-# Test Telegram notifications
-python manage.py test_telegram --chat_id=123456 --message="System alert"
-```
-
-### **🤖 AI & Automation**
-```bash
-# Test AI agents
-python manage.py test_agents --agent=document_processor --input='{"doc_id": "123"}'
-
-# Translate content with AI
-python manage.py translate_content --target-lang=es --batch-size=100
-
-# Generate API documentation
-python manage.py generate_docs --zone=enterprise --format=openapi
-```
-
-### **🚀 Development & Deployment**
-```bash
-# Run with ngrok for webhook testing
-python manage.py runserver_ngrok --domain=myapp-dev
-
-# Generate deployment configuration
-python manage.py generate_deployment --platform=docker --environment=production
-
-# Health check for load balancers
-curl http://localhost:8000/health/
-```
-
-### **🌐 Multi-Site Maintenance Management**
-```bash
-# Enable maintenance for all production sites
-python manage.py maintenance enable --environment production --reason "Database upgrade"
-
-# Disable maintenance for specific project
-python manage.py maintenance disable --project ecommerce
-
-# Check status of all sites
-python manage.py maintenance status --format json
-
-# Auto-discover sites from Cloudflare
-python manage.py sync_cloudflare --api-token your_token
-
-# Bulk operations with filters
-python manage.py maintenance enable --tag critical --reason "Security patch"
-
-# Dry run to preview changes
-python manage.py maintenance enable --environment staging --dry-run
-```
-
----
-
-## 🔒 Enterprise Security & Compliance
-
-### **Security Features**
-- ✅ **Type-safe configuration** prevents injection attacks
-- ✅ **Multi-factor authentication** with OTP and SMS
-- ✅ **Audit logging** for all user actions
-- ✅ **Rate limiting** and DDoS protection
-- ✅ **SQL injection prevention** with ORM toolsets
-- ✅ **CSRF protection** enabled by default
-- ✅ **Secure headers** and HTTPS enforcement
-
-### **Compliance Standards**
-- 🏢 **SOC 2 Type II** compatible architecture
-- 🔒 **GDPR** compliant user data handling
-- 🏥 **HIPAA** ready with encryption at rest
-- 💳 **PCI DSS** compatible payment processing
-- 📋 **ISO 27001** security management alignment
-
-### **Enterprise Authentication**
-```python
-from django_cfg.security import EnterpriseAuth
-
-# SAML/LDAP integration
-auth_config = EnterpriseAuth(
-    saml_enabled=True,
-    ldap_enabled=True,
-    mfa_required=True,
-    session_timeout=3600,
-    password_policy={
-        "min_length": 12,
-        "require_uppercase": True,
-        "require_numbers": True,
-        "require_symbols": True,
-    }
-)
-```
-
----
-
-## 📊 Performance & Scalability
-
-### **Performance Benchmarks**
-- ⚡ **Startup Time**: < 50ms additional overhead
-- 💾 **Memory Usage**: < 1MB additional memory
-- 🔄 **Request Latency**: < 1ms configuration overhead
-- 📈 **Throughput**: 10,000+ requests/second (tested)
-
-### **Scalability Features**
-- 🏗️ **Horizontal scaling** with multi-database routing
-- 🔄 **Background task processing** with Dramatiq
-- 💾 **Intelligent caching** with Redis integration
-- 📊 **Database connection pooling** for high concurrency
-- 🌐 **CDN integration** for static assets
-
-### **Production Optimization**
-```python
-# Production configuration
-class ProductionConfig(DjangoConfig):
-    # Performance optimizations
-    debug: bool = False
-    
-    # Database connection pooling
-    databases: dict[str, DatabaseConfig] = {
-        "default": DatabaseConfig(
-            conn_max_age=600,
-            conn_health_checks=True,
-            options={
-                "MAX_CONNS": 20,
-                "MIN_CONNS": 5,
-            }
-        )
-    }
-    
-    # Caching strategy
-    caches: dict[str, CacheConfig] = {
-        "default": CacheConfig(
-            backend="django_redis.cache.RedisCache",
-            location="${REDIS_URL}",
-            options={
-                "CLIENT_CLASS": "django_redis.client.DefaultClient",
-                "CONNECTION_POOL_KWARGS": {"max_connections": 50},
-            }
-        )
-    }
-    
-    # Skip validation in production
-    skip_validation: bool = True  # Set DJANGO_CFG_SKIP_VALIDATION=1
-```
-
----
-
-## 🧪 Testing & Quality Assurance
-
-### **Built-in Testing Tools**
-```python
-from django_cfg.testing import EnterpriseTestCase, ConfigTestMixin
-
-class EnterpriseConfigTest(EnterpriseTestCase, ConfigTestMixin):
-    """Test enterprise configuration and integrations."""
-    
-    def test_configuration_validity(self):
-        """Validate enterprise configuration."""
-        config = self.get_test_config()
-        settings = config.get_all_settings()
-        
-        # Test required enterprise settings
-        self.assertIn("SECRET_KEY", settings)
-        self.assertFalse(settings["DEBUG"])
-        self.assertTrue(settings["SECURE_SSL_REDIRECT"])
-        
-    def test_database_connections(self):
-        """Test multi-database connectivity."""
-        self.assert_database_connection("default")
-        self.assert_database_connection("analytics")
-        
-    def test_ai_agents_integration(self):
-        """Test AI agents functionality."""
-        agent = self.create_test_agent("document_processor")
-        result = agent.process({"test": "data"})
-        self.assertIsInstance(result, dict)
-        self.assertIn("status", result)
-
-    def test_background_tasks(self):
-        """Test Dramatiq task processing."""
-        task_result = self.run_test_task("process_document", doc_id="test_123")
-        self.assertEqual(task_result["status"], "completed")
-```
-
-### **Quality Metrics**
-- 🧪 **Test Coverage**: 95%+ code coverage
-- 🔍 **Type Coverage**: 100% type annotations
-- 📊 **Performance Tests**: Automated benchmarking
-- 🛡️ **Security Scanning**: Automated vulnerability checks
-- 📋 **Code Quality**: Black, isort, mypy, flake8
-
----
-
-## 🤝 Enterprise Support & Community
-
-### **Professional Support**
-- 🏢 **Enterprise Support Plans** available
-- 📞 **24/7 Technical Support** for critical issues
-- 🎯 **Dedicated Success Manager** for enterprise customers
-- 🛠️ **Custom Development Services** available
-- 📚 **Training & Workshops** for development teams
-
-### **Community Resources**
-- 🌐 **Official Website**: [djangocfg.com](https://djangocfg.com/)
-- 📚 **Documentation**: [docs.djangocfg.com](https://docs.djangocfg.com/)
-- 🐙 **GitHub**: [github.com/markolofsen/django-cfg](https://github.com/markolofsen/django-cfg)
-- 📦 **PyPI Package**: [pypi.org/project/django-cfg](https://pypi.org/project/django-cfg/)
-- ❓ **Stack Overflow**: Tag questions with `django-cfg`
-
-### **Contributing**
-```bash
-# Development setup
-git clone https://github.com/markolofsen/django-cfg.git
-cd django-cfg
-pip install -e ".[dev,test]"
-
-# Run tests
-pytest --cov=django_cfg --cov-report=html
-
-# Code quality checks
-black . && isort . && mypy . && flake8 .
-
-# Submit pull request
-git push origin feature/my-feature
-```
-
----
-
-## 🏆 Awards & Recognition
-
-- 🥇 **Django Packages Award 2024** - Best Configuration Framework
-- 🌟 **Python Software Foundation** - Recommended Package
-- 🏢 **Enterprise Django Award** - Innovation in Type Safety
-- 📊 **Developer Choice Award** - Most Loved Django Package
-
----
-
-## 📄 License & Legal
-
-**Django-CFG** is released under the **MIT License** - see [LICENSE](LICENSE) file for details.
-
-### **Enterprise License**
-For enterprises requiring additional features, support, or custom licensing terms, contact us at [enterprise@djangocfg.com](mailto:info@djangocfg.com).
-
----
-
-## 🙏 Acknowledgments
-
-Django-CFG is built on the shoulders of giants:
-
-- **[Django](https://djangoproject.com/)** - The web framework for perfectionists with deadlines
-- **[Pydantic](https://pydantic.dev/)** - Data validation using Python type hints
-- **[Django Unfold](https://unfold.site/)** - Beautiful modern admin interface
-- **[Dramatiq](https://dramatiq.io/)** - Fast and reliable background task processing
-- **[Twilio](https://twilio.com/)** - Communications platform for SMS and WhatsApp
-
----
-
-<div align="center">
-
-**Made with ❤️ by the Django-CFG Team**
-
-*Transforming Django development with enterprise-grade type safety, AI agents, and production-ready integrations.*
-
-[![Get Started](https://img.shields.io/badge/Get%20Started-docs.djangocfg.com-blue?style=for-the-badge&logo=django)](https://docs.djangocfg.com/getting-started/installation)
-[![View Documentation](https://img.shields.io/badge/Documentation-docs.djangocfg.com-green?style=for-the-badge&logo=gitbook)](https://docs.djangocfg.com/)
-[![Visit Website](https://img.shields.io/badge/Website-djangocfg.com-orange?style=for-the-badge&logo=django)](https://djangocfg.com/)
-
-</div>
-
----
-
-## 🔍 Keywords
-
-**Django configuration**, **Django type safety**, **Django enterprise**, **Pydantic Django**, **Django AI agents**, **Django background tasks**, **Django multi-database**, **Django production deployment**, **Django REST API**, **Django admin interface**, **Django authentication**, **Django CRM**, **Django support system**, **Django newsletter**, **Django CLI tools**, **Django Docker**, **Django ngrok**, **Django Twilio**, **Django SMS**, **Django OTP**, **Django Dramatiq**, **Django Redis**, **Django PostgreSQL**, **Django currency conversion**, **Django cryptocurrency**, **Django YFinance**, **Django CoinGecko**, **Django multi-threading**, **Django testing**, **Django migration**, **Django security**, **Django performance**, **Django scalability**, **Django monitoring**, **Django logging**, **Django webhooks**, **Django OpenAPI**, **Django Swagger**, **Django documentation**, **Django framework**, **Python Django**, **Django development**, **Django best practices**