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

django_cfg-1.4.0.dist-info/METADATA

@@ -1,920 +0,0 @@
-Metadata-Version: 2.4
-Name: django-cfg
-Version: 1.4.0
-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://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: 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-tailwind[reload]<5.0.0,>=4.2.0
-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: fakeredis<3.0,>=2.28; 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: fakeredis<3.0,>=2.28; 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: AI-First Enterprise Django Framework
-
-[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg?style=flat-square&logo=python)](https://www.python.org/downloads/)
-[![Django 4.2+](https://img.shields.io/badge/django-4.2+-green.svg?style=flat-square&logo=django)](https://www.djangoproject.com/)
-[![PyPI](https://img.shields.io/pypi/v/django-cfg.svg?style=flat-square&logo=pypi)](https://pypi.org/project/django-cfg/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
-[![Downloads](https://img.shields.io/pypi/dm/django-cfg.svg?style=flat-square)](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)
-
-**The Type-Safe Django Configuration Framework with Built-In AI Agents**
-
-*Transform 3-6 months of Django development into 30 seconds with 90% less boilerplate*
-
-**Links:** [🚀 Quick Start](#-quick-start-30-seconds-to-production) • [📚 Documentation](https://docs.djangocfg.com/) • [🌐 Website](https://djangocfg.com/) • [💬 Community](https://github.com/markolofsen/django-cfg/discussions)
-
----
-
-## 🎯 What is Django-CFG?
-
-**Django-CFG** is a revolutionary Django framework that replaces traditional `settings.py` with **type-safe Pydantic models**, eliminates 90% of boilerplate code, and ships with **8 production-ready enterprise applications** including AI agents, CRM, support ticketing, and payment systems.
-
-### The Problem with Traditional Django
-
-❌ **200+ lines** of configuration in `settings.py`
-❌ **Runtime errors** from typos and type mismatches
-❌ **3-6 months** to build enterprise features
-❌ **Complex multi-database** routing
-❌ **Manual API documentation** setup
-❌ **No AI integration** out of the box
-
-### The Django-CFG Solution
-
-✅ **30 lines** of type-safe Pydantic configuration
-✅ **Compile-time validation** with full IDE autocomplete
-✅ **30 seconds** to production-ready app
-✅ **Smart database routing** with zero config
-✅ **Auto-generated OpenAPI** documentation
-✅ **Built-in AI agents** framework
-
----
-
-## 🚀 Quick Start: 30 Seconds to Production
-
-### Installation
-
-```bash
-# Install Django-CFG
-pip install django-cfg
-
-# Create enterprise project
-django-cfg create-project "My SaaS App"
-
-# Launch application
-cd my-saas-app
-python manage.py runserver
-```
-
-### What You Get Instantly
-
-🎨 **Modern Admin Dashboard** → http://127.0.0.1:8000/admin/
-📚 **Auto-Generated API Docs** → http://127.0.0.1:8000/api/docs/
-🚀 **Production-Ready Frontend** → http://127.0.0.1:8000/
-
-**No configuration. No boilerplate. Just works.**
-
----
-
-## 💡 Core Features
-
-### 🔒 Type-Safe Configuration with Pydantic v2
-
-Replace Django's error-prone dictionaries with **100% type-safe** Pydantic models.
-
-#### Before (Traditional Django) - 200+ lines
-
-```python
-# settings.py - Runtime errors waiting to happen
-DATABASES = {
-    'default': {
-        'ENGINE': 'django.db.backends.postgresql',
-        'NAME': os.getenv('DB_NAME'),  # Typo? Runtime error!
-        'USER': os.getenv('DB_USER'),
-        'PASSWORD': os.getenv('DB_PASSWORD'),
-        'HOST': os.getenv('DB_HOST', 'localhost'),
-        'PORT': os.getenv('DB_PORT', 5432),
-    }
-}
-
-INSTALLED_APPS = [
-    # ... 30+ lines of apps
-]
-
-MIDDLEWARE = [
-    # ... 15+ lines of middleware
-]
-
-# ... 100+ more lines ...
-```
-
-#### After (Django-CFG) - 30 lines
-
-```python
-# config.py - Type-safe, validated at startup
-from django_cfg import DjangoConfig
-from django_cfg.models import DatabaseConfig
-
-class MyConfig(DjangoConfig):
-    project_name: str = "My SaaS App"
-    secret_key: str = "${SECRET_KEY}"
-    debug: bool = False
-
-    # Type-safe database config
-    databases: dict[str, DatabaseConfig] = {
-        "default": DatabaseConfig(
-            name="${DB_NAME}",
-            user="${DB_USER}",
-            password="${DB_PASSWORD}",
-        )
-    }
-
-    # Enable enterprise features
-    enable_accounts: bool = True      # User management + OTP
-    enable_agents: bool = True        # AI workflow automation
-    enable_support: bool = True       # Ticketing system
-    enable_payments: bool = True      # Multi-provider payments
-```
-
-**Benefits:**
-- ✅ **Full IDE autocomplete** - No more docs hunting
-- ✅ **Catch errors at startup** - Not in production
-- ✅ **90% less code** - Focus on business logic
-- ✅ **Environment-aware** - Auto-detect dev/staging/prod
-
----
-
-### 🤖 Built-In AI Agents Framework
-
-**Production-ready AI workflow automation** with type-safe agents and Django ORM integration.
-
-```python
-from django_cfg.agents import Agent, Workflow
-from pydantic import BaseModel
-
-class DocumentAnalysis(BaseModel):
-    sentiment: str
-    topics: list[str]
-    summary: str
-    confidence: float
-
-@Agent.register("document_analyzer")
-class DocumentAnalyzer(Agent[DocumentAnalysis]):
-    """AI-powered document analysis with type safety"""
-
-    model = "gpt-4o-mini"
-    system_prompt = "Analyze documents for sentiment and key topics"
-
-    def process(self, document_id: str) -> DocumentAnalysis:
-        # Access Django ORM directly
-        doc = Document.objects.get(id=document_id)
-
-        # AI analysis with type-safe response
-        result = self.call_llm(f"Analyze: {doc.content}")
-        return DocumentAnalysis.model_validate_json(result)
-
-# Use in views
-from django_cfg.agents import get_agent
-
-def analyze_view(request, doc_id):
-    analyzer = get_agent("document_analyzer")
-    result = analyzer.process(doc_id)
-
-    return JsonResponse({
-        'sentiment': result.sentiment,
-        'topics': result.topics,
-        'confidence': result.confidence
-    })
-```
-
-**Features:**
-- ✅ **Type-safe agents** - Pydantic input/output validation
-- ✅ **Django integration** - Direct ORM access in agents
-- ✅ **Multi-provider** - OpenAI, Anthropic, OpenRouter
-- ✅ **Admin dashboard** - Monitor agent executions
-- ✅ **Background processing** - Async with Dramatiq
-
----
-
-### 🎨 Modern DRF Browsable API Theme
-
-**Beautiful Tailwind 4 UI** for Django REST Framework - 88% smaller bundle, 66% faster.
-
-#### Before: Bootstrap 3 (2013) - 278KB
-
-**Old DRF UI:**
-- ❌ Outdated Bootstrap 3 design
-- ❌ 278KB bundle size
-- ❌ No dark mode
-- ❌ Slow FCP: 3.2s
-- ❌ Lighthouse: 72/100
-
-#### After: Tailwind 4 (2024) - 33KB
-
-```python
-from django_cfg import DjangoConfig
-
-class MyAPIConfig(DjangoConfig):
-    # Modern DRF theme enabled by default!
-    enable_drf_tailwind: bool = True
-```
-
-**What you get:**
-- ✅ **Glass morphism design** - Modern frosted glass UI
-- ✅ **3-mode theme** - Light/Dark/Auto with system sync
-- ✅ **Command palette** - VS Code-style quick actions (⌘K)
-- ✅ **88% smaller bundle** - 278KB → 33KB
-- ✅ **66% faster FCP** - 3.2s → 1.1s
-- ✅ **+23 Lighthouse score** - 72 → 95/100
-
-**Keyboard Shortcuts:**
-```
-⌘K / Ctrl+K  → Open command palette
-⌘D / Ctrl+D  → Toggle dark mode
-⌘C / Ctrl+C  → Copy current URL
-?            → Show all shortcuts
-```
-
-[📚 Full DRF Theme Documentation →](https://djangocfg.com/features/drf-tailwind)
-
----
-
-### 🌐 Multi-Site Cloudflare Maintenance
-
-**Enterprise-grade maintenance mode** with Cloudflare API integration.
-
-```python
-from django_cfg.apps.maintenance 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="🚀 Back online in 30 minutes!"
-)
-
-# CLI automation
-# python manage.py maintenance enable --environment production
-# python manage.py sync_cloudflare --api-token TOKEN
-```
-
-**Features:**
-- ✅ **Zero-config** - Just add API token
-- ✅ **Multi-site** - Manage hundreds of domains
-- ✅ **Health checks** - Auto-enable on failure
-- ✅ **Rich admin** - Bulk operations UI
-- ✅ **CI/CD ready** - CLI for automation
-
----
-
-### 📦 8 Production-Ready Enterprise Apps
-
-Ship features in **days, not months** with built-in enterprise applications.
-
-| App | Description | Time Saved |
-|-----|-------------|------------|
-| **👤 Accounts** | User management + OTP + SMS auth | 2 months |
-| **🎫 Support** | Ticketing system + SLA tracking | 3 months |
-| **📧 Newsletter** | Email campaigns + analytics | 1 month |
-| **📊 Leads** | CRM + sales pipeline | 2 months |
-| **🤖 AI Agents** | Workflow automation framework | 4 months |
-| **📚 KnowBase** | AI knowledge base + vector search | 3 months |
-| **💳 Payments** | Multi-provider crypto/fiat payments | 2 months |
-| **🔧 Maintenance** | Multi-site Cloudflare management | 1 month |
-
-**Total time saved: 18 months of development**
-
----
-
-### 🔄 Smart Multi-Database Routing
-
-**Zero-configuration database routing** with automatic sharding.
-
-```python
-from django_cfg import DjangoConfig
-from django_cfg.models import DatabaseConfig
-
-class EnterpriseConfig(DjangoConfig):
-    databases: dict[str, DatabaseConfig] = {
-        "default": DatabaseConfig(
-            name="${PRIMARY_DB}",
-        ),
-        "analytics": DatabaseConfig(
-            name="${ANALYTICS_DB}",
-            routing_apps=["analytics", "reports"],  # Auto-route!
-        ),
-        "legacy": DatabaseConfig(
-            name="${LEGACY_DB}",
-            routing_apps=["old_system"],
-        ),
-    }
-```
-
-**Smart routing automatically:**
-- ✅ Routes read/write to correct database
-- ✅ Handles transactions across databases
-- ✅ Manages connection pooling
-- ✅ Supports database sharding
-
-**No router code needed!**
-
----
-
-## 📊 Why Django-CFG? Enterprise Comparison
-
-| Feature | Traditional Django | DRF | FastAPI | **Django-CFG** |
-|---------|-------------------|-----|---------|----------------|
-| **Type Safety** | ❌ Runtime errors | ❌ Manual | ✅ Pydantic | ✅ **Full Pydantic v2** |
-| **Admin UI** | 🟡 2010 design | ❌ None | ❌ None | ✅ **Modern Unfold** |
-| **API Docs** | ❌ Manual | 🟡 Basic | ✅ Auto | ✅ **Auto OpenAPI** |
-| **AI Integration** | ❌ Build it | ❌ Build it | ❌ Build it | ✅ **Built-in** |
-| **Setup Time** | 🟡 Weeks | 🟡 Weeks | 🟡 Days | ✅ **30 seconds** |
-| **Boilerplate** | ❌ 200+ lines | ❌ 200+ lines | ❌ 100+ lines | ✅ **30 lines** |
-| **Multi-DB** | 🟡 Manual | 🟡 Manual | ❌ Limited | ✅ **Auto-routing** |
-| **Background Tasks** | 🟡 Setup Celery | 🟡 Setup Celery | ❌ Manual | ✅ **Built-in Dramatiq** |
-| **Enterprise Apps** | ❌ Build all | ❌ Build all | ❌ Build all | ✅ **8 included** |
-| **IDE Support** | 🟡 Basic | 🟡 Basic | ✅ Good | ✅ **Full autocomplete** |
-
-**Legend:** ✅ Excellent | 🟡 Requires Work | ❌ Not Available
-
----
-
-## 💼 ROI & Business Value
-
-### Time to Market Reduction
-
-**Traditional Django:**
-```
-Planning:          2 weeks
-Setup:             1 week
-Auth/Users:        2 months
-Admin Panel:       1 month
-API + Docs:        1 month
-Background Jobs:   2 weeks
-Testing/Debug:     1 month
-───────────────────────────
-TOTAL:            6 months
-```
-
-**Django-CFG:**
-```
-Installation:      30 seconds
-Configuration:     5 minutes
-Customization:     1-2 weeks
-───────────────────────────
-TOTAL:            1-2 weeks
-```
-
-**🚀 20x faster time to market**
-
-### Cost Savings
-
-**Traditional Development:**
-- Senior Django Developer: $120,000/year
-- 6 months × $60,000 = **$60,000**
-- Plus: infrastructure, testing, maintenance
-
-**Django-CFG:**
-- Same developer: 2 weeks × $4,600 = **$4,600**
-- **Savings: $55,400 per project**
-
-### Developer Productivity
-
-**Metrics:**
-- ⚡ **90% less boilerplate** - More feature work
-- 🔒 **Zero runtime config errors** - Fewer bugs
-- 🎯 **Full IDE autocomplete** - Faster coding
-- 📚 **Auto-generated docs** - Less documentation work
-- 🧪 **Built-in testing tools** - Faster QA
-
----
-
-## 🎓 Migration from Existing Django
-
-### Option 1: Fresh Start (Recommended for new features)
-
-```bash
-# Create Django-CFG project
-django-cfg create-project "New Feature"
-
-# Copy your apps
-cp -r /old-project/myapp ./src/
-
-# Migrate data
-python manage.py migrate_legacy_data --source=/old-project/
-```
-
-### Option 2: Gradual Migration (Production systems)
-
-```bash
-# Install in existing project
-pip install django-cfg
-
-# Create config.py
-cat > config.py << 'EOF'
-from django_cfg import DjangoConfig
-
-class MyConfig(DjangoConfig):
-    project_name: str = "Existing Project"
-    secret_key: str = "${SECRET_KEY}"
-
-    # Keep existing apps
-    project_apps: list[str] = ["myapp1", "myapp2"]
-
-    # Gradually enable features
-    enable_accounts: bool = False  # Enable later
-    enable_agents: bool = False
-EOF
-
-# Replace settings.py
-cat > settings.py << 'EOF'
-from .config import config
-globals().update(config.get_all_settings())
-EOF
-
-# Test migration
-python manage.py check
-python manage.py migrate
-```
-
-**Migration time: 1-2 hours for typical Django project**
-
-[📚 Complete Migration Guide →](https://djangocfg.com/guides/migration-guide)
-
----
-
-## 🛠️ Installation Options
-
-### Production Environment
-
-```bash
-# Recommended: pip
-pip install django-cfg[production]
-
-# Poetry
-poetry add django-cfg[production,dev]
-
-# Pipenv
-pipenv install django-cfg[production]
-
-# Conda
-conda install -c conda-forge django-cfg
-```
-
-### Development Environment
-
-```bash
-# Full dev setup
-pip install django-cfg[dev,test,docs]
-
-# Create dev project
-django-cfg create-project "DevApp" --template=development
-
-# Enable dev features
-export DJANGO_CFG_ENV=development
-python manage.py runserver_ngrok
-```
-
-### Docker Deployment
-
-```bash
-# Official image
-docker pull djangocfg/django-cfg:latest
-
-# Docker Compose
-docker-compose up -d
-```
-
----
-
-## 📚 Documentation & Resources
-
-### 🚀 Getting Started
-- [Installation Guide](https://djangocfg.com/getting-started/installation) - Complete setup
-- [First Project](https://djangocfg.com/getting-started/first-project) - Build your app
-- [Configuration](https://djangocfg.com/getting-started/configuration) - Type-safe config
-
-### 🏗️ Architecture
-- [System Architecture](https://djangocfg.com/fundamentals/architecture) - Design patterns
-- [Environment Detection](https://djangocfg.com/fundamentals/environment-detection) - Auto-config
-- [Registry System](https://djangocfg.com/fundamentals/registry) - Component loading
-
-### 🚀 Enterprise Features
-- [Built-in Apps](https://djangocfg.com/features/built-in-apps/overview) - 8 production apps
-- [AI Agents](https://djangocfg.com/ai-agents/introduction) - Workflow automation
-- [DRF Tailwind Theme](https://djangocfg.com/features/drf-tailwind) - Modern API UI
-- [Multi-Database](https://djangocfg.com/guides/multi-database) - Smart routing
-
-### 🛠️ Development
-- [CLI Tools](https://djangocfg.com/cli/introduction) - Command-line interface
-- [Management Commands](https://djangocfg.com/cli/commands) - 50+ commands
-- [Testing](https://djangocfg.com/guides/testing) - Built-in test tools
-
-### 🚀 Deployment
-- [Docker Production](https://djangocfg.com/deployment/docker-production) - Containers
-- [Production Config](https://djangocfg.com/guides/production-config) - Best practices
-- [Monitoring](https://djangocfg.com/deployment/monitoring) - Observability
-
----
-
-## 🔧 Management Commands
-
-Django-CFG includes **50+ production-ready commands**:
-
-### Database & Migration
-```bash
-# Interactive migrations
-python manage.py migrator --auto
-
-# Multi-database
-python manage.py migrate_all --databases=default,analytics
-
-# Health check
-python manage.py check_databases
-```
-
-### Configuration & Validation
-```bash
-# Validate config
-python manage.py validate_config --strict
-
-# Show current config
-python manage.py show_config --format=yaml
-
-# System check
-python manage.py system_check --enterprise
-```
-
-### Background Tasks
-```bash
-# Start workers
-python manage.py rundramatiq --processes=8 --threads=4
-
-# Monitor queues
-python manage.py task_status --queue=high
-
-# Clear failed
-python manage.py task_clear --failed
-```
-
-### Testing & Communication
-```bash
-# Test email
-python manage.py test_email --recipient=admin@company.com
-
-# Test SMS
-python manage.py test_twilio --phone=+1-555-0123
-
-# Test AI agents
-python manage.py test_agents --agent=document_processor
-```
-
-### Maintenance Management
-```bash
-# Enable maintenance
-python manage.py maintenance enable --environment production
-
-# Sync Cloudflare
-python manage.py sync_cloudflare --api-token TOKEN
-
-# Check status
-python manage.py maintenance status --format json
-```
-
----
-
-## 🔒 Security & Compliance
-
-### Security Features
-- ✅ **Type-safe config** - Prevents injection attacks
-- ✅ **Multi-factor auth** - OTP + SMS verification
-- ✅ **Audit logging** - All user actions tracked
-- ✅ **Rate limiting** - DDoS protection
-- ✅ **SQL injection prevention** - ORM-only access
-- ✅ **CSRF protection** - Enabled by default
-- ✅ **Secure headers** - HTTPS enforcement
-
-### Compliance Standards
-- 🏢 **SOC 2 Type II** compatible
-- 🔒 **GDPR** compliant data handling
-- 🏥 **HIPAA** ready with encryption
-- 💳 **PCI DSS** payment processing
-- 📋 **ISO 27001** security alignment
-
----
-
-## 📈 Performance & Scalability
-
-### Benchmarks
-- ⚡ **Startup time:** <50ms overhead
-- 💾 **Memory usage:** <1MB additional
-- 🔄 **Request latency:** <1ms config overhead
-- 📊 **Throughput:** 10,000+ req/sec (tested)
-
-### Scalability Features
-- 🏗️ **Horizontal scaling** - Multi-database routing
-- 🔄 **Background processing** - Dramatiq task queue
-- 💾 **Intelligent caching** - Redis integration
-- 📊 **Connection pooling** - High concurrency
-- 🌐 **CDN integration** - Static asset delivery
-
-### Production Optimization
-
-```python
-class ProductionConfig(DjangoConfig):
-    debug: bool = False
-
-    # Connection pooling
-    databases: dict[str, DatabaseConfig] = {
-        "default": DatabaseConfig(
-            conn_max_age=600,
-            conn_health_checks=True,
-            options={"MAX_CONNS": 20}
-        )
-    }
-
-    # Redis caching
-    caches: dict[str, CacheConfig] = {
-        "default": CacheConfig(
-            backend="django_redis.cache.RedisCache",
-            options={"CONNECTION_POOL_KWARGS": {"max_connections": 50}}
-        )
-    }
-
-    # Skip validation in prod
-    skip_validation: bool = True  # DJANGO_CFG_SKIP_VALIDATION=1
-```
-
----
-
-## 🧪 Testing & Quality
-
-### Built-In Testing Tools
-
-```python
-from django_cfg.testing import EnterpriseTestCase
-
-class MyAppTest(EnterpriseTestCase):
-    def test_configuration(self):
-        config = self.get_test_config()
-        self.assertFalse(config.debug)
-
-    def test_database_connections(self):
-        self.assert_database_connection("default")
-
-    def test_ai_agents(self):
-        agent = self.create_test_agent("analyzer")
-        result = agent.process({"test": "data"})
-        self.assertEqual(result["status"], "completed")
-```
-
-### Quality Metrics
-- 🧪 **95%+ test coverage**
-- 🔍 **100% type annotations**
-- 📊 **Automated benchmarking**
-- 🛡️ **Security scanning**
-- 📋 **Code quality:** Black, isort, mypy, flake8
-
----
-
-## 🤝 Support & Community
-
-### Professional Support
-- 🏢 **Enterprise support plans** - 24/7 critical support
-- 📞 **Dedicated success manager** - For enterprise
-- 🛠️ **Custom development** - Tailored features
-- 🎓 **Training & workshops** - Team onboarding
-
-### Community Resources
-- 🌐 **Website:** [djangocfg.com](https://djangocfg.com/)
-- 📚 **Docs:** [djangocfg.com](https://djangocfg.com/)
-- 🐙 **GitHub:** [github.com/markolofsen/django-cfg](https://github.com/markolofsen/django-cfg)
-- 📦 **PyPI:** [pypi.org/project/django-cfg](https://pypi.org/project/django-cfg/)
-- 💬 **Discussions:** [GitHub Discussions](https://github.com/markolofsen/django-cfg/discussions)
-- ❓ **Stack Overflow:** Tag `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
-
-# Code quality
-black . && isort . && mypy .
-
-# Submit PR
-git push origin feature/my-feature
-```
-
----
-
-## 🏆 Success Stories
-
-### 💼 CarAPIS - Automotive Data Platform
-
-> *"Django-CFG reduced our development time by 80% and eliminated configuration errors in production."*
-
-**Results:**
-- 🚀 **80% faster development**
-- 🔒 **Zero config errors in production**
-- 📊 **Real-time analytics dashboard**
-- 🤖 **AI-powered data processing**
-
-### 🏢 TechCorp - Enterprise SaaS
-
-> *"The built-in support system and user management saved us 6 months of development."*
-
-**Results:**
-- ⏰ **6 months saved**
-- 👥 **Enterprise user management**
-- 🎫 **Professional support ticketing**
-- 📈 **Automated reporting**
-
----
-
-## 📄 License
-
-Django-CFG is released under the **MIT License** - see [LICENSE](LICENSE) for details.
-
-### Enterprise License
-
-For custom licensing, dedicated support, or enterprise features, contact: [enterprise@djangocfg.com](mailto:info@djangocfg.com)
-
----
-
-## 🙏 Acknowledgments
-
-Built on the shoulders of giants:
-
-- **[Django](https://djangoproject.com/)** - Web framework for perfectionists
-- **[Pydantic](https://pydantic.dev/)** - Data validation with type hints
-- **[Django Unfold](https://unfold.site/)** - Modern admin interface
-- **[Dramatiq](https://dramatiq.io/)** - Background task processing
-- **[Twilio](https://twilio.com/)** - Communications platform
-
----
-
-**Made with ❤️ by the Django-CFG Team**
-
-*Transforming Django development with type safety, AI agents, and enterprise features*
-
-**Get Started:** [Documentation](https://docs.djangocfg.com/) | [Website](https://djangocfg.com/) | [GitHub](https://github.com/markolofsen/django-cfg)
-
----
-
-## 🔍 Keywords for Search
-
-**Primary:** django-cfg, type-safe django configuration, django pydantic, django ai agents, enterprise django framework, django configuration validation, pydantic django settings
-
-**Features:** django multi-database routing, django background tasks dramatiq, django admin unfold, django rest framework tailwind, django ai workflow automation, django enterprise applications
-
-**Integration:** django openai integration, django llm framework, django cloudflare maintenance, django crypto payments, django sms authentication, django vector database
-
-**Comparison:** django-cfg vs django-environ, pydantic-settings django, type-safe django vs traditional, django configuration best practices, django settings alternative
-
-**Use Cases:** django saas starter, enterprise django boilerplate, rapid django development, django startup framework, production-ready django, django time to market reduction