django-cfg 1.4.116__py3-none-any.whl → 1.5.14__py3-none-any.whl

django_cfg/apps/{agents/management/commands/create_agent.py → business/agents/management/commands/load_agent_templates.py}

@@ -1,182 +1,21 @@
 """
-Management command to create agent definitions.
+Management command to load pre-built agent templates.
 """
 
 import asyncio
 
 from django.contrib.auth.models import User
-from django.core.management.base import BaseCommand, CommandError
+from django.core.management.base import CommandError
 
-from django_cfg.apps.agents.models.registry import AgentDefinition
+from django_cfg.management.utils import AdminCommand
 
+from django_cfg.apps.business.agents.models.registry import AgentDefinition
 
-class Command(BaseCommand):
-    """Create agent definition from command line."""
 
-    help = 'Create a new agent definition'
-
-    def add_arguments(self, parser):
-        """Add command arguments."""
-        parser.add_argument('name', type=str, help='Agent name (unique identifier)')
-        parser.add_argument('instructions', type=str, help='Agent instructions/system prompt')
-
-        parser.add_argument(
-            '--deps-type',
-            type=str,
-            default='DjangoDeps',
-            help='Dependencies type (default: DjangoDeps)'
-        )
-        parser.add_argument(
-            '--output-type',
-            type=str,
-            default='ProcessResult',
-            help='Output type (default: ProcessResult)'
-        )
-        parser.add_argument(
-            '--model',
-            type=str,
-            default='openai:gpt-4o-mini',
-            help='LLM model to use (default: openai:gpt-4o-mini)'
-        )
-        parser.add_argument(
-            '--category',
-            type=str,
-            default='',
-            help='Agent category'
-        )
-        parser.add_argument(
-            '--timeout',
-            type=int,
-            default=300,
-            help='Execution timeout in seconds (default: 300)'
-        )
-        parser.add_argument(
-            '--max-retries',
-            type=int,
-            default=3,
-            help='Maximum retry attempts (default: 3)'
-        )
-        parser.add_argument(
-            '--public',
-            action='store_true',
-            help='Make agent public (accessible to all users)'
-        )
-        parser.add_argument(
-            '--no-cache',
-            action='store_true',
-            help='Disable caching for this agent'
-        )
-        parser.add_argument(
-            '--creator',
-            type=str,
-            help='Username of agent creator (defaults to first superuser)'
-        )
-        parser.add_argument(
-            '--description',
-            type=str,
-            default='',
-            help='Agent description'
-        )
-        parser.add_argument(
-            '--tags',
-            type=str,
-            nargs='*',
-            help='Agent tags (space-separated)'
-        )
-
-    def handle(self, *args, **options):
-        """Handle command execution."""
-        # Run async operations
-        asyncio.run(self._create_agent(options))
-
-    async def _create_agent(self, options):
-        """Create agent definition."""
-        name = options['name']
-        instructions = options['instructions']
-
-        # Validate name
-        if await AgentDefinition.objects.filter(name=name).aexists():
-            raise CommandError(f"Agent '{name}' already exists")
-
-        # Get creator user
-        creator = await self._get_creator_user(options.get('creator'))
-
-        # Prepare agent data
-        agent_data = {
-            'name': name,
-            'instructions': instructions,
-            'deps_type': options['deps_type'],
-            'output_type': options['output_type'],
-            'model': options['model'],
-            'category': options['category'],
-            'timeout': options['timeout'],
-            'max_retries': options['max_retries'],
-            'is_public': options['public'],
-            'enable_caching': not options['no_cache'],
-            'created_by': creator,
-            'description': options['description'],
-        }
-
-        # Add tags if provided
-        if options['tags']:
-            agent_data['tags'] = options['tags']
-
-        # Create agent definition
-        try:
-            agent_def = await AgentDefinition.objects.acreate(**agent_data)
-
-            self.stdout.write(
-                self.style.SUCCESS(f"✅ Created agent definition: {agent_def.name}")
-            )
-
-            # Show agent details
-            self.stdout.write("\nAgent Details:")
-            self.stdout.write(f"  Name: {agent_def.name}")
-            self.stdout.write(f"  Display Name: {agent_def.display_name}")
-            self.stdout.write(f"  Category: {agent_def.category or 'None'}")
-            self.stdout.write(f"  Model: {agent_def.model}")
-            self.stdout.write(f"  Dependencies: {agent_def.deps_type}")
-            self.stdout.write(f"  Output Type: {agent_def.output_type}")
-            self.stdout.write(f"  Timeout: {agent_def.timeout}s")
-            self.stdout.write(f"  Max Retries: {agent_def.max_retries}")
-            self.stdout.write(f"  Public: {agent_def.is_public}")
-            self.stdout.write(f"  Caching: {agent_def.enable_caching}")
-            self.stdout.write(f"  Created by: {agent_def.created_by.username}")
-
-            if agent_def.tags:
-                self.stdout.write(f"  Tags: {', '.join(agent_def.tags)}")
-
-            if agent_def.description:
-                self.stdout.write(f"  Description: {agent_def.description}")
-
-            # Instructions preview
-            instructions_preview = agent_def.instructions[:200]
-            if len(agent_def.instructions) > 200:
-                instructions_preview += "..."
-
-            self.stdout.write(f"  Instructions: {instructions_preview}")
-
-        except Exception as e:
-            raise CommandError(f"Failed to create agent: {e}")
-
-    async def _get_creator_user(self, username):
-        """Get creator user."""
-        if username:
-            try:
-                return await User.objects.aget(username=username)
-            except User.DoesNotExist:
-                raise CommandError(f"User '{username}' not found")
-        else:
-            # Use first superuser
-            try:
-                return await User.objects.filter(is_superuser=True).afirst()
-            except User.DoesNotExist:
-                raise CommandError("No superuser found. Please create a superuser first or specify --creator")
-
-
-class Command(BaseCommand):
+class Command(AdminCommand):
     """Load agent definitions from templates."""
 
+    command_name = 'load_agent_templates'
     help = 'Load pre-built agent templates'
 
     def add_arguments(self, parser):

django_cfg/apps/{agents → business/agents}/management/commands/orchestrator_status.py

@@ -5,17 +5,19 @@ Management command to show orchestrator status.
 import asyncio
 from datetime import timedelta
 
-from django.core.management.base import BaseCommand
 from django.utils import timezone
 
-from django_cfg.apps.agents.integration.registry import get_registry
-from django_cfg.apps.agents.models.execution import AgentExecution, WorkflowExecution
-from django_cfg.apps.agents.models.registry import AgentDefinition
+from django_cfg.management.utils import SafeCommand
 
+from django_cfg.apps.business.agents.integration.registry import get_registry
+from django_cfg.apps.business.agents.models.execution import AgentExecution, WorkflowExecution
+from django_cfg.apps.business.agents.models.registry import AgentDefinition
 
-class Command(BaseCommand):
+
+class Command(SafeCommand):
     """Show Django Orchestrator status and statistics."""
 
+    command_name = 'orchestrator_status'
     help = 'Display Django Orchestrator status and statistics'
 
     def add_arguments(self, parser):

django_cfg/apps/{knowbase → business/knowbase}/__init__.py

@@ -24,4 +24,4 @@ Architecture:
 - Admin: Unfold-optimized interfaces with statistics
 """
 
-default_app_config = 'django_cfg.apps.knowbase.apps.KnowbaseConfig'
+default_app_config = 'django_cfg.apps.business.knowbase.apps.KnowbaseConfig'

django_cfg/apps/{knowbase → business/knowbase}/apps.py

@@ -10,7 +10,7 @@ class KnowbaseConfig(AppConfig):
     """Knowledge Base application configuration."""
 
     default_auto_field = 'django.db.models.BigAutoField'
-    name = 'django_cfg.apps.knowbase'
+    name = 'django_cfg.apps.business.knowbase'
     label = 'django_cfg_knowbase'
     verbose_name = 'Django CFG Knowledge Base'
 
@@ -21,8 +21,8 @@ class KnowbaseConfig(AppConfig):
         # Connect post-migrate signal for database setup
         post_migrate.connect(self.create_pgvector_extension, sender=self)
 
-        # Note: Task system initialization removed - ReArq doesn't need it
-        # Tasks are auto-discovered from decorated functions
+        # Note: Task system initialization removed - tasks are handled by Django-RQ
+        # Background tasks can be scheduled using django_rq.enqueue()
 
     def create_pgvector_extension(self, sender, **kwargs):
         """Create pgvector extension and indexes if they don't exist."""

django_cfg/apps/business/knowbase/examples/__init__.py

@@ -0,0 +1,3 @@
+"""
+Examples for using the External Data system in django_cfg.apps.business.knowbase.
+"""

django_cfg/apps/{knowbase → business/knowbase}/examples/external_data_usage.py

@@ -7,7 +7,7 @@
 
 from django.contrib.auth import get_user_model
 
-from django_cfg.apps.knowbase.utils.external_data_manager import (
+from django_cfg.apps.business.knowbase.utils.external_data_manager import (
     ExternalDataManager,
     quick_search,
 )

django_cfg/apps/{knowbase → business/knowbase}/management/commands/knowbase_stats.py

@@ -3,17 +3,19 @@ Knowledge Base statistics command.
 """
 
 from django.contrib.auth import get_user_model
-from django.core.management.base import BaseCommand
 from django.db import models
 from django.db.models import Avg, Count, ExpressionWrapper, F, Q, Sum
 from django.db.models.functions import Extract
 
+from django_cfg.management.utils import SafeCommand
+
 User = get_user_model()
 
 
-class Command(BaseCommand):
+class Command(SafeCommand):
     """Display Knowledge Base statistics."""
 
+    command_name = 'knowbase_stats'
     help = 'Display Knowledge Base usage statistics'
 
     def add_arguments(self, parser):

django_cfg/apps/{knowbase → business/knowbase}/management/commands/setup_knowbase.py

@@ -2,13 +2,15 @@
 Setup command for Knowledge Base application.
 """
 
-from django.core.management.base import BaseCommand
 from django.db import connection
 
+from django_cfg.management.utils import AdminCommand
 
-class Command(BaseCommand):
+
+class Command(AdminCommand):
     """Setup Knowledge Base with pgvector extension and initial data."""
 
+    command_name = 'setup_knowbase'
     help = 'Setup Knowledge Base with pgvector extension and run migrations'
 
     def add_arguments(self, parser):

django_cfg/apps/{knowbase → business/knowbase}/mixins/examples/vehicle_model_example.py

@@ -6,8 +6,8 @@ This shows how to integrate VehicleModel with knowbase using the mixin.
 
 from django.db import models
 
-from django_cfg.apps.knowbase.mixins import ExternalDataMixin
-from django_cfg.apps.knowbase.models.external_data import ExternalDataType
+from django_cfg.apps.business.knowbase.mixins import ExternalDataMixin
+from django_cfg.apps.business.knowbase.models.external_data import ExternalDataType
 
 
 class VehicleModelWithMixin(ExternalDataMixin, models.Model):

django_cfg/apps/{knowbase → business/knowbase}/mixins/service.py

@@ -27,7 +27,7 @@ logger = logging.getLogger(__name__)
 
 class ExternalDataService(BaseService):
     """
-    Service for managing external data sources within django_cfg.apps.knowbase.
+    Service for managing external data sources within django_cfg.apps.business.knowbase.
     
     This service provides backward compatibility with the old ExternalDataService
     while using the new mixin-based architecture internally.

django_cfg/apps/{knowbase → business/knowbase}/models/external_data.py

@@ -1,5 +1,5 @@
 """
-External Data models for integrating external Django models into django_cfg.apps.knowbase.
+External Data models for integrating external Django models into django_cfg.apps.business.knowbase.
 
 Provides a unified way to vectorize and search any external data source.
 """

django_cfg/apps/{knowbase → business/knowbase}/services/archive/vectorization_service.py

@@ -148,7 +148,7 @@ class ArchiveVectorizationService(BaseService):
             logger.debug(f"🔮 Prepared content for embedding: {len(content_for_embedding)} chars")
 
             # Generate embedding using LLM client with specified model
-            from django_cfg.apps.knowbase.utils.chunk_settings import get_embedding_model
+            from django_cfg.apps.business.knowbase.utils.chunk_settings import get_embedding_model
             embedding_model = get_embedding_model()
             embedding_result = self.llm_client.generate_embedding(
                 text=content_for_embedding,

django_cfg/apps/{knowbase → business/knowbase}/services/embedding/async_processor.py

@@ -12,7 +12,7 @@ from typing import Any, Dict, List, Optional
 
 from asgiref.sync import async_to_sync
 
-from django_cfg.apps.knowbase.models import ArchiveItemChunk, DocumentChunk
+from django_cfg.apps.business.knowbase.models import ArchiveItemChunk, DocumentChunk
 
 from .batch_processor import OptimizedEmbeddingProcessor
 from .models import BatchProcessingResult, ChunkData, EmbeddingResult

django_cfg/apps/{knowbase → business/knowbase}/services/embedding/batch_processor.py

@@ -9,8 +9,8 @@ import logging
 import time
 from typing import List, Optional
 
-from django_cfg.apps.knowbase.config.settings import get_cache_settings
-from django_cfg.apps.knowbase.utils.chunk_settings import (
+from django_cfg.apps.business.knowbase.config.settings import get_cache_settings
+from django_cfg.apps.business.knowbase.utils.chunk_settings import (
     get_embedding_batch_size,
     get_embedding_model,
 )

django_cfg/apps/{knowbase → business/knowbase}/services/embedding/processors.py

@@ -8,7 +8,7 @@ document and archive chunks with their specific requirements.
 import logging
 from typing import Protocol
 
-from django_cfg.apps.knowbase.models import ArchiveItemChunk, DocumentChunk, ExternalDataChunk
+from django_cfg.apps.business.knowbase.models import ArchiveItemChunk, DocumentChunk, ExternalDataChunk
 
 from .models import ChunkData, EmbeddingResult
 

django_cfg/apps/{knowbase → business/knowbase}/services/embedding/utils.py

@@ -8,7 +8,7 @@ embedding processing operations.
 import logging
 from typing import List, Union
 
-from django_cfg.apps.knowbase.models import ArchiveItemChunk, DocumentChunk, ExternalDataChunk
+from django_cfg.apps.business.knowbase.models import ArchiveItemChunk, DocumentChunk, ExternalDataChunk
 
 from .async_processor import AsyncOptimizedEmbeddingProcessor
 from .batch_processor import OptimizedEmbeddingProcessor

django_cfg/apps/{knowbase → business/knowbase}/tasks/document_processing.py

@@ -193,7 +193,7 @@ def generate_embeddings_batch(
         List of (chunk_text, embedding, tokens, cost) tuples
     """
     try:
-        from django_cfg.apps.knowbase.config.settings import (
+        from django_cfg.apps.business.knowbase.config.settings import (
             get_cache_settings,
             get_openai_api_key,
             get_openrouter_api_key,

django_cfg/apps/{knowbase → business/knowbase}/utils/chunk_settings.py

@@ -256,8 +256,9 @@ def get_chunking_params_for_type(content_type: str) -> Dict[str, Any]:
     return get_chunking_params_for_type(content_type)
 
 
-# Initialize settings logging on module import
-try:
-    ChunkSettingsManager.log_current_settings()
-except Exception as e:
-    logger.debug(f"Could not log settings on import: {e}")
+# NOTE: Do NOT log settings on module import - it causes database access during app initialization
+# Settings will be logged when first accessed or via management command
+# try:
+#     ChunkSettingsManager.log_current_settings()
+# except Exception as e:
+#     logger.debug(f"Could not log settings on import: {e}")

django_cfg/apps/{knowbase → business/knowbase}/views/archive_views.py

@@ -213,7 +213,7 @@ class DocumentArchiveViewSet(BaseKnowledgeViewSet):
             vectorization_service = ArchiveVectorizationService(request.user)
 
             # Generate query embedding
-            from django_cfg.apps.knowbase.config.settings import (
+            from django_cfg.apps.business.knowbase.config.settings import (
                 get_cache_settings,
                 get_openai_api_key,
                 get_openrouter_api_key,
@@ -228,7 +228,7 @@ class DocumentArchiveViewSet(BaseKnowledgeViewSet):
                 max_cache_size=cache_settings.max_cache_size
             )
             # Generate query embedding with specified model
-            from django_cfg.apps.knowbase.utils.chunk_settings import get_embedding_model
+            from django_cfg.apps.business.knowbase.utils.chunk_settings import get_embedding_model
             embedding_model = get_embedding_model()
             embedding_result = llm_client.generate_embedding(
                 text=search_data['query'],

django_cfg/apps/{leads → business/leads}/apps.py

@@ -5,12 +5,12 @@ class LeadsConfig(AppConfig):
     """Leads application configuration."""
 
     default_auto_field = "django.db.models.BigAutoField"
-    name = "django_cfg.apps.leads"
+    name = "django_cfg.apps.business.leads"
     label = "django_cfg_leads"
     verbose_name = "Django CFG Leads"
 
     def ready(self):
         try:
-            import django_cfg.apps.leads.signals  # noqa
+            import django_cfg.apps.business.leads.signals  # noqa
         except ImportError:
             pass

django_cfg/apps/{newsletter → business/newsletter}/admin/newsletter_admin.py

@@ -243,19 +243,20 @@ class EmailLogAdmin(PydanticAdmin):
     @computed_field("Tracking")
     def tracking_display(self, obj: EmailLog) -> str:
         """Display tracking status with badges."""
-        badges = []
-
-        if obj.is_opened:
-            badges.append(self.html.badge("Opened", variant="success", icon=Icons.VISIBILITY))
-        else:
-            badges.append(self.html.badge("Not Opened", variant="secondary", icon=Icons.VISIBILITY_OFF))
+        # Declarative approach - no imperative .append()
+        opened_badge = (
+            self.html.badge("Opened", variant="success", icon=Icons.VISIBILITY)
+            if obj.is_opened else
+            self.html.badge("Not Opened", variant="secondary", icon=Icons.VISIBILITY_OFF)
+        )
 
-        if obj.is_clicked:
-            badges.append(self.html.badge("Clicked", variant="info", icon=Icons.MOUSE))
-        else:
-            badges.append(self.html.badge("Not Clicked", variant="secondary", icon=Icons.TOUCH_APP))
+        clicked_badge = (
+            self.html.badge("Clicked", variant="info", icon=Icons.MOUSE)
+            if obj.is_clicked else
+            self.html.badge("Not Clicked", variant="secondary", icon=Icons.TOUCH_APP)
+        )
 
-        return " | ".join(badges)
+        return self.html.inline(opened_badge, clicked_badge, separator=" | ")
 
 
 # ===== Newsletter Admin Config =====

django_cfg/apps/{newsletter → business/newsletter}/apps.py

@@ -9,7 +9,7 @@ class NewsletterConfig(AppConfig):
     """Newsletter application configuration."""
 
     default_auto_field = "django.db.models.BigAutoField"
-    name = "django_cfg.apps.newsletter"
+    name = "django_cfg.apps.business.newsletter"
     label = "django_cfg_newsletter"
     verbose_name = "Django CFG Newsletter"
 
@@ -17,6 +17,6 @@ class NewsletterConfig(AppConfig):
         """Initialize the newsletter application."""
         # Import signal handlers
         try:
-            import django_cfg.apps.newsletter.signals  # noqa
+            import django_cfg.apps.business.newsletter.signals  # noqa
         except ImportError:
             pass

django_cfg/apps/{newsletter → business/newsletter}/management/commands/test_newsletter.py

@@ -3,15 +3,18 @@ Management command to test newsletter sending functionality.
 """
 
 from django.contrib.auth import get_user_model
-from django.core.management.base import BaseCommand, CommandError
+from django.core.management.base import CommandError
 
-from django_cfg.apps.newsletter.models import Newsletter, NewsletterCampaign, NewsletterSubscription
-from django_cfg.apps.newsletter.services.email_service import NewsletterEmailService
+from django_cfg.management.utils import SafeCommand
+
+from django_cfg.apps.business.newsletter.models import Newsletter, NewsletterCampaign, NewsletterSubscription
+from django_cfg.apps.business.newsletter.services.email_service import NewsletterEmailService
 
 User = get_user_model()
 
 
-class Command(BaseCommand):
+class Command(SafeCommand):
+    command_name = 'test_newsletter'
     help = 'Test newsletter sending functionality'
 
     def add_arguments(self, parser):

django_cfg/apps/{payments → business/payments}/__init__.py

@@ -8,7 +8,7 @@ Features:
 - Simplified currency model (token+network combined)
 
 Configuration:
-    from django_cfg.apps.payments.config import get_nowpayments_config
+    from django_cfg.apps.business.payments.config import get_nowpayments_config
 """
 
-default_app_config = 'django_cfg.apps.payments.apps.PaymentsConfig'
+default_app_config = 'django_cfg.apps.business.payments.apps.PaymentsConfig'

django_cfg/apps/{payments → business/payments}/admin/balance_admin.py

@@ -187,48 +187,38 @@ class UserBalanceAdmin(PydanticAdmin):
         if not obj.pk:
             return "Save to see breakdown"
 
-        # Build breakdown list
-        details = []
-
-        # Current Balance
-        details.append(self.html.inline([
-            self.html.span("Current Balance:", "font-semibold"),
-            self.html.span(f"${obj.balance_usd:.2f} USD", "")
-        ], separator=" "))
-
-        # Total Deposited
-        details.append(self.html.inline([
-            self.html.span("Total Deposited:", "font-semibold"),
-            self.html.span(f"${obj.total_deposited:.2f} USD", "")
-        ], separator=" "))
-
-        # Total Withdrawn
-        details.append(self.html.inline([
-            self.html.span("Total Withdrawn:", "font-semibold"),
-            self.html.span(f"${obj.total_withdrawn:.2f} USD", "")
-        ], separator=" "))
-
         # Calculate net
         net = obj.total_deposited - obj.total_withdrawn
-        details.append(self.html.inline([
-            self.html.span("Net Deposits:", "font-semibold"),
-            self.html.span(f"${net:.2f} USD", "")
-        ], separator=" "))
-
-        if obj.last_transaction_at:
-            details.append(self.html.inline([
-                self.html.span("Last Transaction:", "font-semibold"),
-                self.html.span(str(obj.last_transaction_at), "")
-            ], separator=" "))
 
         # Transaction count
         txn_count = Transaction.objects.filter(user=obj.user).count()
-        details.append(self.html.inline([
-            self.html.span("Total Transactions:", "font-semibold"),
-            self.html.span(str(txn_count), "")
-        ], separator=" "))
 
-        return "<br>".join(details)
+        return self.html.breakdown(
+            self.html.key_value(
+                "Current Balance",
+                self.html.number(obj.balance_usd, precision=2, prefix="$", suffix=" USD")
+            ),
+            self.html.key_value(
+                "Total Deposited",
+                self.html.number(obj.total_deposited, precision=2, prefix="$", suffix=" USD")
+            ),
+            self.html.key_value(
+                "Total Withdrawn",
+                self.html.number(obj.total_withdrawn, precision=2, prefix="$", suffix=" USD")
+            ),
+            self.html.key_value(
+                "Net Deposits",
+                self.html.number(net, precision=2, prefix="$", suffix=" USD")
+            ),
+            self.html.key_value(
+                "Last Transaction",
+                str(obj.last_transaction_at)
+            ) if obj.last_transaction_at else None,
+            self.html.key_value(
+                "Total Transactions",
+                str(txn_count)
+            )
+        )
 
     balance_breakdown_display.short_description = "Balance Breakdown"