django-cfg 1.4.107__py3-none-any.whl → 1.4.108__py3-none-any.whl

django_cfg/__init__.py

@@ -32,7 +32,7 @@ Example:
 default_app_config = "django_cfg.apps.DjangoCfgConfig"
 
 # Version information
-__version__ = "1.4.107"
+__version__ = "1.4.108"
 __license__ = "MIT"
 
 # Import registry for organized lazy loading

django_cfg/apps/accounts/views/profile.py

@@ -4,6 +4,7 @@ from rest_framework import generics, permissions, status
 from rest_framework.decorators import api_view, permission_classes
 from rest_framework.response import Response
 
+from django_cfg.mixins import ClientAPIMixin
 from ..serializers.profile import (
     AvatarUploadSerializer,
     UserProfileUpdateSerializer,
@@ -22,10 +23,13 @@ User = get_user_model()
         401: {"description": "Authentication credentials were not provided."}
     }
 )
-class UserProfileView(generics.RetrieveAPIView):
-    """Get current user profile details."""
+class UserProfileView(ClientAPIMixin, generics.RetrieveAPIView):
+    """
+    Get current user profile details.
+
+    Requires authenticated user (JWT or Session).
+    """
     serializer_class = UserSerializer
-    permission_classes = [permissions.IsAuthenticated]
 
     def get_object(self):
         return self.request.user
@@ -56,10 +60,13 @@ class UserProfileView(generics.RetrieveAPIView):
         )
     ]
 )
-class UserProfileUpdateView(generics.UpdateAPIView):
-    """Update current user profile."""
+class UserProfileUpdateView(ClientAPIMixin, generics.UpdateAPIView):
+    """
+    Update current user profile.
+
+    Requires authenticated user (JWT or Session).
+    """
     serializer_class = UserProfileUpdateSerializer
-    permission_classes = [permissions.IsAuthenticated]
 
     def get_object(self):
         return self.request.user
@@ -102,10 +109,13 @@ class UserProfileUpdateView(generics.UpdateAPIView):
         )
     ]
 )
-class UserProfilePartialUpdateView(generics.UpdateAPIView):
-    """Partially update current user profile."""
+class UserProfilePartialUpdateView(ClientAPIMixin, generics.UpdateAPIView):
+    """
+    Partially update current user profile.
+
+    Requires authenticated user (JWT or Session).
+    """
     serializer_class = UserProfileUpdateSerializer
-    permission_classes = [permissions.IsAuthenticated]
 
     def get_object(self):
         return self.request.user

django_cfg/apps/centrifugo/views/admin_api.py

@@ -11,11 +11,10 @@ from django.http import JsonResponse
 from django_cfg.modules.django_logging import get_logger
 from drf_spectacular.utils import OpenApiParameter, extend_schema
 from rest_framework import status, viewsets
-from rest_framework.authentication import SessionAuthentication
 from rest_framework.decorators import action
-from rest_framework.permissions import IsAdminUser
 from rest_framework.response import Response
 
+from django_cfg.mixins import AdminAPIMixin
 from ..serializers import (
     CentrifugoInfoRequest,
     CentrifugoInfoResponse,
@@ -33,17 +32,15 @@ from ..services import get_centrifugo_config
 logger = get_logger("centrifugo.admin_api")
 
 
-class CentrifugoAdminAPIViewSet(viewsets.ViewSet):
+class CentrifugoAdminAPIViewSet(AdminAPIMixin, viewsets.ViewSet):
     """
     Centrifugo Admin API Proxy ViewSet.
 
     Provides type-safe proxy endpoints to Centrifugo server API.
-    All requests are authenticated via Django session and proxied to Centrifugo.
+    All requests are authenticated via Django session/JWT and proxied to Centrifugo.
+    Requires admin authentication (JWT, Session, or Basic Auth).
     """
 
-    # authentication_classes = [SessionAuthentication]
-    permission_classes = [IsAdminUser]
-
     def __init__(self, *args, **kwargs):
         super().__init__(*args, **kwargs)
         self._http_client = None

django_cfg/apps/centrifugo/views/monitoring.py

@@ -13,11 +13,10 @@ from django_cfg.modules.django_logging import get_logger
 from drf_spectacular.types import OpenApiTypes
 from drf_spectacular.utils import OpenApiParameter, extend_schema
 from rest_framework import status, viewsets
-from rest_framework.authentication import SessionAuthentication
 from rest_framework.decorators import action
-from rest_framework.permissions import IsAdminUser
 from rest_framework.response import Response
 
+from django_cfg.mixins import AdminAPIMixin
 from ..models import CentrifugoLog
 from ..serializers import (
     ChannelListSerializer,
@@ -31,7 +30,7 @@ from ..services import get_centrifugo_config
 logger = get_logger("centrifugo.monitoring")
 
 
-class CentrifugoMonitorViewSet(viewsets.ViewSet):
+class CentrifugoMonitorViewSet(AdminAPIMixin, viewsets.ViewSet):
     """
     ViewSet for Centrifugo monitoring and statistics.
 
@@ -40,11 +39,9 @@ class CentrifugoMonitorViewSet(viewsets.ViewSet):
     - Overview statistics
     - Recent publishes
     - Channel-level statistics
+    Requires admin authentication (JWT, Session, or Basic Auth).
     """
 
-    # authentication_classes = [SessionAuthentication]
-    permission_classes = [IsAdminUser]
-
     @extend_schema(
         tags=["Centrifugo Monitoring"],
         summary="Get Centrifugo health status",

django_cfg/apps/centrifugo/views/testing_api.py

@@ -17,11 +17,10 @@ from django_cfg.modules.django_logging import get_logger
 from drf_spectacular.utils import extend_schema
 from pydantic import BaseModel, Field
 from rest_framework import status, viewsets
-from rest_framework.authentication import SessionAuthentication
 from rest_framework.decorators import action
-from rest_framework.permissions import IsAdminUser
 from rest_framework.response import Response
 
+from django_cfg.mixins import AdminAPIMixin
 from ..services import get_centrifugo_config
 from ..services.client import CentrifugoClient
 
@@ -94,18 +93,16 @@ class ManualAckResponse(BaseModel):
 # ========================================================================
 
 
-class CentrifugoTestingAPIViewSet(viewsets.ViewSet):
+class CentrifugoTestingAPIViewSet(AdminAPIMixin, viewsets.ViewSet):
     """
     Centrifugo Testing API ViewSet.
 
     Provides endpoints for interactive testing of Centrifugo integration
     from the dashboard. Includes connection token generation, test message
     publishing, and manual ACK management.
+    Requires admin authentication (JWT, Session, or Basic Auth).
     """
 
-    # authentication_classes = [SessionAuthentication]
-    permission_classes = [IsAdminUser]
-
     def __init__(self, *args, **kwargs):
         super().__init__(*args, **kwargs)
         self._http_client = None

django_cfg/apps/dashboard/services/system_health_service.py

@@ -105,34 +105,39 @@ class SystemHealthService:
 
     def check_queue_health(self) -> Dict[str, Any]:
         """
-        Check task queue (Celery/Dramatiq) health.
+        Check task queue (ReArq) health via Redis connection.
 
         Returns:
             Health status dictionary
         """
         try:
-            # TODO: Add real queue health check
-            # Example: Check Redis connection, queue sizes, worker status
-            from django_cfg.modules.django_tasks import DjangoTasks
+            # Check Redis connection directly (used by task queue)
+            from django.core.cache import cache
+
+            # Try to ping Redis through cache backend
+            cache_backend = cache._cache if hasattr(cache, '_cache') else cache
 
-            tasks = DjangoTasks()
-            redis_client = tasks.get_redis_client()
+            # Simple check - if cache works, Redis is available
+            test_key = 'queue_health_check'
+            cache.set(test_key, 'ok', timeout=5)
+            result = cache.get(test_key)
 
-            if redis_client and redis_client.ping():
+            if result == 'ok':
+                cache.delete(test_key)
                 return {
                     'component': 'queue',
                     'status': 'healthy',
-                    'description': 'Queue system is operational',
+                    'description': 'Queue system (Redis) is operational',
                     'last_check': datetime.now().isoformat(),
                     'health_percentage': 100,
                 }
             else:
                 return {
                     'component': 'queue',
-                    'status': 'error',
-                    'description': 'Queue system unavailable',
+                    'status': 'warning',
+                    'description': 'Queue system check inconclusive',
                     'last_check': datetime.now().isoformat(),
-                    'health_percentage': 0,
+                    'health_percentage': 50,
                 }
 
         except Exception as e:

django_cfg/apps/dashboard/views/activity_views.py

@@ -10,26 +10,24 @@ import logging
 
 from drf_spectacular.utils import OpenApiParameter, extend_schema
 from rest_framework import status, viewsets
-from rest_framework.authentication import BasicAuthentication, SessionAuthentication
 from rest_framework.decorators import action
-from rest_framework.permissions import IsAdminUser
 from rest_framework.response import Response
 
+from django_cfg.mixins import AdminAPIMixin
 from ..services import StatisticsService, SystemHealthService
 from ..serializers import ActivityEntrySerializer, QuickActionSerializer
 
 logger = logging.getLogger(__name__)
 
 
-class ActivityViewSet(viewsets.GenericViewSet):
+class ActivityViewSet(AdminAPIMixin, viewsets.GenericViewSet):
     """
     Activity Tracking ViewSet
 
     Provides endpoints for recent activity and quick actions.
+    Requires admin authentication (JWT, Session, or Basic Auth).
     """
 
-    authentication_classes = [SessionAuthentication, BasicAuthentication]
-    permission_classes = [IsAdminUser]
     serializer_class = ActivityEntrySerializer
 
     @extend_schema(

django_cfg/apps/dashboard/views/apizones_views.py

@@ -10,9 +10,9 @@ import logging
 
 from drf_spectacular.utils import extend_schema
 from rest_framework import status, viewsets
-from rest_framework.authentication import BasicAuthentication, SessionAuthentication
+
+from django_cfg.mixins import AdminAPIMixin
 from rest_framework.decorators import action
-from rest_framework.permissions import IsAdminUser
 from rest_framework.response import Response
 
 from ..services import APIZonesService
@@ -21,15 +21,14 @@ from ..serializers import APIZoneSerializer, APIZonesSummarySerializer
 logger = logging.getLogger(__name__)
 
 
-class APIZonesViewSet(viewsets.GenericViewSet):
+class APIZonesViewSet(AdminAPIMixin, viewsets.GenericViewSet):
     """
     API Zones ViewSet
 
     Provides endpoints for OpenAPI zones (groups) management.
+    Requires admin authentication (JWT, Session, or Basic Auth).
     """
 
-    authentication_classes = [SessionAuthentication, BasicAuthentication]
-    permission_classes = [IsAdminUser]
     serializer_class = APIZoneSerializer
     pagination_class = None  # Disable pagination for zones list
 

django_cfg/apps/dashboard/views/charts_views.py

@@ -12,9 +12,9 @@ import logging
 
 from drf_spectacular.utils import OpenApiParameter, extend_schema
 from rest_framework import status, viewsets
-from rest_framework.authentication import BasicAuthentication, SessionAuthentication
+
+from django_cfg.mixins import AdminAPIMixin
 from rest_framework.decorators import action
-from rest_framework.permissions import IsAdminUser
 from rest_framework.response import Response
 
 from ..services import ChartsService, StatisticsService
@@ -27,15 +27,14 @@ from ..serializers import (
 logger = logging.getLogger(__name__)
 
 
-class ChartsViewSet(viewsets.GenericViewSet):
+class ChartsViewSet(AdminAPIMixin, viewsets.GenericViewSet):
     """
     Charts ViewSet
 
     Provides endpoints for dashboard charts and analytics.
+    Requires admin authentication (JWT, Session, or Basic Auth).
     """
 
-    authentication_classes = [SessionAuthentication, BasicAuthentication]
-    permission_classes = [IsAdminUser]
     serializer_class = ChartDataSerializer
 
     @extend_schema(

django_cfg/apps/dashboard/views/overview_views.py

@@ -10,9 +10,9 @@ from datetime import datetime
 
 from drf_spectacular.utils import extend_schema
 from rest_framework import status, viewsets
-from rest_framework.authentication import BasicAuthentication, SessionAuthentication
+
+from django_cfg.mixins import AdminAPIMixin
 from rest_framework.decorators import action
-from rest_framework.permissions import IsAdminUser
 from rest_framework.response import Response
 
 from ..services import StatisticsService, SystemHealthService, ChartsService
@@ -21,16 +21,15 @@ from ..serializers import DashboardOverviewSerializer
 logger = logging.getLogger(__name__)
 
 
-class OverviewViewSet(viewsets.GenericViewSet):
+class OverviewViewSet(AdminAPIMixin, viewsets.GenericViewSet):
     """
     Dashboard Overview ViewSet
 
     Provides a single endpoint that returns all dashboard data at once.
     Useful for initial page load.
+    Requires admin authentication (JWT, Session, or Basic Auth).
     """
 
-    authentication_classes = [SessionAuthentication, BasicAuthentication]
-    permission_classes = [IsAdminUser]
     serializer_class = DashboardOverviewSerializer
 
     @extend_schema(

django_cfg/apps/dashboard/views/statistics_views.py

@@ -11,9 +11,9 @@ import logging
 
 from drf_spectacular.utils import extend_schema
 from rest_framework import status, viewsets
-from rest_framework.authentication import BasicAuthentication, SessionAuthentication
+
+from django_cfg.mixins import AdminAPIMixin
 from rest_framework.decorators import action
-from rest_framework.permissions import IsAdminUser
 from rest_framework.response import Response
 
 from ..services import StatisticsService
@@ -26,15 +26,14 @@ from ..serializers import (
 logger = logging.getLogger(__name__)
 
 
-class StatisticsViewSet(viewsets.GenericViewSet):
+class StatisticsViewSet(AdminAPIMixin, viewsets.GenericViewSet):
     """
     Statistics ViewSet
 
     Provides endpoints for retrieving various dashboard statistics.
+    Requires admin authentication (JWT, Session, or Basic Auth).
     """
 
-    authentication_classes = [SessionAuthentication, BasicAuthentication]
-    permission_classes = [IsAdminUser]
     serializer_class = StatCardSerializer
 
     @extend_schema(

django_cfg/apps/dashboard/views/system_views.py

@@ -10,9 +10,9 @@ import logging
 
 from drf_spectacular.utils import extend_schema
 from rest_framework import status, viewsets
-from rest_framework.authentication import BasicAuthentication, SessionAuthentication
+
+from django_cfg.mixins import AdminAPIMixin
 from rest_framework.decorators import action
-from rest_framework.permissions import IsAdminUser
 from rest_framework.response import Response
 
 from ..services import SystemHealthService, StatisticsService
@@ -21,15 +21,14 @@ from ..serializers import SystemHealthSerializer, SystemMetricsSerializer
 logger = logging.getLogger(__name__)
 
 
-class SystemViewSet(viewsets.GenericViewSet):
+class SystemViewSet(AdminAPIMixin, viewsets.GenericViewSet):
     """
     System Monitoring ViewSet
 
     Provides endpoints for system health and performance metrics.
+    Requires admin authentication (JWT, Session, or Basic Auth).
     """
 
-    authentication_classes = [SessionAuthentication, BasicAuthentication]
-    permission_classes = [IsAdminUser]
     serializer_class = SystemHealthSerializer
 
     @extend_schema(

django_cfg/apps/knowbase/__init__.py

@@ -2,7 +2,7 @@
 Django SaaS Knowledge Assistant
 
 Enterprise-grade RAG (Retrieval-Augmented Generation) application built on Django 5.2
-with pgvector semantic search, Dramatiq background processing, and comprehensive
+with pgvector semantic search, ReArq background processing, and comprehensive
 API endpoints for document management and AI-powered chat.
 
 Key Features:
@@ -10,7 +10,7 @@ Key Features:
 - Semantic search using pgvector cosine similarity
 - RAG-powered chat with context retrieval
 - Multi-tenant user isolation
-- Background processing with Dramatiq
+- Background processing with ReArq
 - Cost tracking for LLM usage monitoring
 - Comprehensive admin interface with Unfold styling
 - Type-safe APIs with Pydantic v2 validation

django_cfg/apps/knowbase/apps.py

@@ -21,14 +21,8 @@ class KnowbaseConfig(AppConfig):
         # Connect post-migrate signal for database setup
         post_migrate.connect(self.create_pgvector_extension, sender=self)
 
-        # Initialize task system and auto-start worker if configured
-        try:
-            from django_cfg.modules.django_tasks import initialize_task_system
-            initialize_task_system()
-        except Exception as e:
-            import logging
-            logger = logging.getLogger(__name__)
-            logger.warning(f"Failed to initialize task system: {e}")
+        # Note: Task system initialization removed - ReArq doesn't need it
+        # Tasks are auto-discovered from decorated functions
 
     def create_pgvector_extension(self, sender, **kwargs):
         """Create pgvector extension and indexes if they don't exist."""

django_cfg/apps/knowbase/views/base.py

@@ -5,15 +5,20 @@ Base views for knowledge base API.
 import logging
 
 from rest_framework import viewsets
-from rest_framework.permissions import IsAuthenticated
+
+from django_cfg.mixins import ClientAPIMixin
 
 logger = logging.getLogger(__name__)
 
 
-class BaseKnowledgeViewSet(viewsets.ModelViewSet):
-    """Base ViewSet with common knowledge base functionality."""
+class BaseKnowledgeViewSet(ClientAPIMixin, viewsets.ModelViewSet):
+    """
+    Base ViewSet with common knowledge base functionality.
+
+    Requires authenticated user (JWT or Session).
+    Automatically filters queryset by user and sets user on creation.
+    """
 
-    permission_classes = [IsAuthenticated]
     lookup_field = 'pk'
 
     def get_queryset(self):

django_cfg/apps/support/views/api.py

@@ -5,17 +5,22 @@ REST API ViewSets for tickets and messages.
 """
 
 from drf_spectacular.utils import OpenApiParameter, OpenApiTypes, extend_schema
-from rest_framework import permissions, viewsets
+from rest_framework import viewsets
 
+from django_cfg.mixins import ClientAPIMixin
 from ..models import Message, Ticket
 from ..serializers import MessageCreateSerializer, MessageSerializer, TicketSerializer
 
 
-class TicketViewSet(viewsets.ModelViewSet):
-    """ViewSet for managing support tickets."""
+class TicketViewSet(ClientAPIMixin, viewsets.ModelViewSet):
+    """
+    ViewSet for managing support tickets.
+
+    Requires authenticated user (JWT or Session).
+    Staff users can see all tickets, regular users see only their own.
+    """
 
     serializer_class = TicketSerializer
-    permission_classes = [permissions.IsAuthenticated]
     lookup_field = 'uuid'
     lookup_url_kwarg = 'uuid'
 
@@ -32,11 +37,15 @@ class TicketViewSet(viewsets.ModelViewSet):
         serializer.save(user=self.request.user)
 
 
-class MessageViewSet(viewsets.ModelViewSet):
-    """ViewSet for managing support messages."""
+class MessageViewSet(ClientAPIMixin, viewsets.ModelViewSet):
+    """
+    ViewSet for managing support messages.
+
+    Requires authenticated user (JWT or Session).
+    Users can only access messages for their own tickets.
+    """
 
     serializer_class = MessageSerializer
-    permission_classes = [permissions.IsAuthenticated]
     lookup_field = 'uuid'
     lookup_url_kwarg = 'uuid'
 

django_cfg/apps/tasks/__init__.py

@@ -1,5 +1,64 @@
 """
-Django CFG Tasks App
+ReArq tasks app for Django-CFG.
 
-Provides admin interface for Dramatiq task management.
+Provides async background task processing with Redis queue.
 """
+
+__all__ = [
+    "ReArqClient",
+    "get_rearq_client",
+    "get_tasks_config",
+    "get_tasks_config_or_default",
+    "task",
+    "cron_task",
+]
+
+
+def __getattr__(name):
+    """Lazy imports to avoid loading ReArq at Django startup."""
+    if name in ("ReArqClient", "get_rearq_client"):
+        from .services.client import ReArqClient, get_rearq_client
+        return ReArqClient if name == "ReArqClient" else get_rearq_client
+    elif name in ("get_tasks_config", "get_tasks_config_or_default"):
+        from .services.config_helper import get_tasks_config, get_tasks_config_or_default
+        return get_tasks_config if name == "get_tasks_config" else get_tasks_config_or_default
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
+def task(queue: str = "default", **kwargs):
+    """
+    Task decorator shortcut.
+
+    Example:
+        >>> from django_cfg.apps.tasks import task
+        >>>
+        >>> @task(queue="default")
+        >>> async def my_task(data: str):
+        ...     return f"Processed {data}"
+        >>>
+        >>> # Execute task
+        >>> job = await my_task.delay(data="test")
+        >>> result = await job.result(timeout=30)
+    """
+    from .services.client import get_rearq_client
+    client = get_rearq_client()
+    return client.task(queue=queue, **kwargs)
+
+
+def cron_task(cron: str, **kwargs):
+    """
+    Cron task decorator shortcut.
+
+    Args:
+        cron: Cron expression (e.g., "0 * * * *" for hourly)
+
+    Example:
+        >>> from django_cfg.apps.tasks import cron_task
+        >>>
+        >>> @cron_task(cron="0 0 * * *")  # Daily at midnight
+        >>> async def daily_cleanup():
+        ...     return "Cleanup complete"
+    """
+    from .services.client import get_rearq_client
+    client = get_rearq_client()
+    return client.cron_task(cron=cron, **kwargs)

django_cfg/apps/tasks/admin/__init__.py

@@ -1,11 +1,4 @@
-"""
-Tasks admin interfaces using Django-CFG admin system.
+"""Admin configuration for tasks app."""
+from .config import tasklog_config
 
-Enhanced Dramatiq task management with Material Icons and optimized queries.
-"""
-
-from .tasks_admin import TaskAdmin
-
-__all__ = [
-    'TaskAdmin',
-]
+__all__ = ["tasklog_config"]