django-cfg 1.4.83__py3-none-any.whl → 1.4.85__py3-none-any.whl

django_cfg/apps/dashboard/urls.py

@@ -0,0 +1,42 @@
+"""
+Dashboard URLs
+
+RESTful API endpoints for dashboard data organized by domain.
+
+API Structure:
+- /api/overview/ - Complete dashboard overview
+- /api/statistics/ - Statistics endpoints (cards, users, apps)
+- /api/system/ - System monitoring (health, metrics)
+- /api/activity/ - Activity tracking (recent, actions)
+"""
+
+from django.urls import include, path
+from rest_framework.routers import DefaultRouter
+
+from .views import (
+    OverviewViewSet,
+    StatisticsViewSet,
+    SystemViewSet,
+    ActivityViewSet,
+    ChartsViewSet,
+    CommandsViewSet,
+    APIZonesViewSet,
+)
+
+app_name = 'django_cfg_dashboard'
+
+# Main router for ViewSets
+router = DefaultRouter()
+router.register(r'overview', OverviewViewSet, basename='overview')
+router.register(r'statistics', StatisticsViewSet, basename='statistics')
+router.register(r'system', SystemViewSet, basename='system')
+router.register(r'activity', ActivityViewSet, basename='activity')
+router.register(r'charts', ChartsViewSet, basename='charts')
+router.register(r'commands', CommandsViewSet, basename='commands')
+router.register(r'zones', APIZonesViewSet, basename='zones')
+
+urlpatterns = [
+    # RESTful API endpoints using ViewSets
+    # Mounted at /cfg/dashboard/api/
+    path('api/', include(router.urls)),
+]

django_cfg/apps/dashboard/views/__init__.py

@@ -0,0 +1,23 @@
+"""
+Dashboard Views
+
+ViewSets organized by domain for better maintainability.
+"""
+
+from .overview_views import OverviewViewSet
+from .statistics_views import StatisticsViewSet
+from .system_views import SystemViewSet
+from .activity_views import ActivityViewSet
+from .charts_views import ChartsViewSet
+from .commands_views import CommandsViewSet
+from .apizones_views import APIZonesViewSet
+
+__all__ = [
+    'OverviewViewSet',
+    'StatisticsViewSet',
+    'SystemViewSet',
+    'ActivityViewSet',
+    'ChartsViewSet',
+    'CommandsViewSet',
+    'APIZonesViewSet',
+]

django_cfg/apps/dashboard/views/activity_views.py

@@ -0,0 +1,83 @@
+"""
+Activity ViewSet
+
+Endpoints for activity tracking:
+- GET /activity/recent/ - Recent activity entries
+- GET /activity/actions/ - Quick action buttons
+"""
+
+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 ..services import StatisticsService, SystemHealthService
+from ..serializers import ActivityEntrySerializer, QuickActionSerializer
+
+logger = logging.getLogger(__name__)
+
+
+class ActivityViewSet(viewsets.GenericViewSet):
+    """
+    Activity Tracking ViewSet
+
+    Provides endpoints for recent activity and quick actions.
+    """
+
+    authentication_classes = [SessionAuthentication, BasicAuthentication]
+    permission_classes = [IsAdminUser]
+    serializer_class = ActivityEntrySerializer
+
+    @extend_schema(
+        summary="Get recent activity",
+        description="Retrieve recent system activity entries",
+        parameters=[
+            OpenApiParameter(
+                name='limit',
+                description='Maximum number of entries to return',
+                required=False,
+                type=int,
+                default=10
+            ),
+        ],
+        responses=ActivityEntrySerializer(many=True),
+        tags=["Dashboard - Activity"]
+    )
+    @action(detail=False, methods=['get'], url_path='recent', pagination_class=None, serializer_class=ActivityEntrySerializer)
+    def recent(self, request):
+        """Get recent activity entries."""
+        try:
+            limit = int(request.query_params.get('limit', 10))
+            stats_service = StatisticsService()
+            activity = stats_service.get_recent_activity(limit=limit)
+            return Response(activity)
+
+        except Exception as e:
+            logger.error(f"Recent activity API error: {e}")
+            return Response({
+                'error': str(e)
+            }, status=status.HTTP_500_INTERNAL_SERVER_ERROR)
+
+    @extend_schema(
+        summary="Get quick actions",
+        description="Retrieve quick action buttons for dashboard",
+        responses=QuickActionSerializer(many=True),
+        tags=["Dashboard - Activity"]
+    )
+    @action(detail=False, methods=['get'], url_path='actions', pagination_class=None, serializer_class=QuickActionSerializer)
+    def actions(self, request):
+        """Get quick action buttons."""
+        try:
+            health_service = SystemHealthService()
+            actions = health_service.get_quick_actions()
+            return Response(actions)
+
+        except Exception as e:
+            logger.error(f"Quick actions API error: {e}")
+            return Response({
+                'error': str(e)
+            }, status=status.HTTP_500_INTERNAL_SERVER_ERROR)

django_cfg/apps/dashboard/views/apizones_views.py

@@ -0,0 +1,73 @@
+"""
+API Zones ViewSet
+
+Endpoints for OpenAPI zones/groups management:
+- GET /zones/ - All API zones
+- GET /zones/summary/ - Zones summary with statistics
+"""
+
+import logging
+
+from drf_spectacular.utils import 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 ..services import APIZonesService
+from ..serializers import APIZoneSerializer, APIZonesSummarySerializer
+
+logger = logging.getLogger(__name__)
+
+
+class APIZonesViewSet(viewsets.GenericViewSet):
+    """
+    API Zones ViewSet
+
+    Provides endpoints for OpenAPI zones (groups) management.
+    """
+
+    authentication_classes = [SessionAuthentication, BasicAuthentication]
+    permission_classes = [IsAdminUser]
+    serializer_class = APIZoneSerializer
+    pagination_class = None  # Disable pagination for zones list
+
+    @extend_schema(
+        summary="Get all API zones",
+        description="Retrieve all OpenAPI zones/groups with their configuration",
+        responses={200: APIZoneSerializer(many=True)},
+        tags=["Dashboard - API Zones"]
+    )
+    def list(self, request):
+        """Get all API zones."""
+        try:
+            zones_service = APIZonesService()
+            zones_list, _ = zones_service.get_zones_data()
+            return Response(zones_list)
+
+        except Exception as e:
+            logger.error(f"API zones list error: {e}")
+            return Response({
+                'error': str(e)
+            }, status=status.HTTP_500_INTERNAL_SERVER_ERROR)
+
+    @extend_schema(
+        summary="Get zones summary",
+        description="Retrieve zones summary with statistics",
+        responses={200: APIZonesSummarySerializer},
+        tags=["Dashboard - API Zones"]
+    )
+    @action(detail=False, methods=['get'], url_path='summary', serializer_class=APIZonesSummarySerializer)
+    def summary(self, request):
+        """Get zones summary with statistics."""
+        try:
+            zones_service = APIZonesService()
+            summary = zones_service.get_zones_summary()
+            return Response(summary)
+
+        except Exception as e:
+            logger.error(f"API zones summary error: {e}")
+            return Response({
+                'error': str(e)
+            }, status=status.HTTP_500_INTERNAL_SERVER_ERROR)

django_cfg/apps/dashboard/views/charts_views.py

@@ -0,0 +1,159 @@
+"""
+Charts ViewSet
+
+Endpoints for dashboard charts and analytics:
+- GET /charts/registrations/ - User registration chart
+- GET /charts/activity/ - User activity chart
+- GET /charts/tracker/ - Activity tracker (52 weeks)
+- GET /charts/recent-users/ - Recent users list
+"""
+
+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 ..services import ChartsService, StatisticsService
+from ..serializers import (
+    ChartDataSerializer,
+    ActivityTrackerDaySerializer,
+    RecentUserSerializer,
+)
+
+logger = logging.getLogger(__name__)
+
+
+class ChartsViewSet(viewsets.GenericViewSet):
+    """
+    Charts ViewSet
+
+    Provides endpoints for dashboard charts and analytics.
+    """
+
+    authentication_classes = [SessionAuthentication, BasicAuthentication]
+    permission_classes = [IsAdminUser]
+    serializer_class = ChartDataSerializer
+
+    @extend_schema(
+        summary="Get user registration chart",
+        description="Retrieve user registration data for chart visualization",
+        parameters=[
+            OpenApiParameter(
+                name='days',
+                description='Number of days to include',
+                required=False,
+                type=int,
+                default=7
+            ),
+        ],
+        responses={200: ChartDataSerializer},
+        tags=["Dashboard - Charts"]
+    )
+    @action(detail=False, methods=['get'], url_path='registrations', serializer_class=ChartDataSerializer)
+    def registrations(self, request):
+        """Get user registration chart data."""
+        try:
+            days = int(request.query_params.get('days', 7))
+            charts_service = ChartsService()
+            chart_data = charts_service.get_user_registration_chart(days=days)
+            return Response(chart_data)
+
+        except Exception as e:
+            logger.error(f"Registration chart API error: {e}")
+            return Response({
+                'error': str(e)
+            }, status=status.HTTP_500_INTERNAL_SERVER_ERROR)
+
+    @extend_schema(
+        summary="Get user activity chart",
+        description="Retrieve user activity data for chart visualization",
+        parameters=[
+            OpenApiParameter(
+                name='days',
+                description='Number of days to include',
+                required=False,
+                type=int,
+                default=7
+            ),
+        ],
+        responses={200: ChartDataSerializer},
+        tags=["Dashboard - Charts"]
+    )
+    @action(detail=False, methods=['get'], url_path='activity', serializer_class=ChartDataSerializer)
+    def activity(self, request):
+        """Get user activity chart data."""
+        try:
+            days = int(request.query_params.get('days', 7))
+            charts_service = ChartsService()
+            chart_data = charts_service.get_user_activity_chart(days=days)
+            return Response(chart_data)
+
+        except Exception as e:
+            logger.error(f"Activity chart API error: {e}")
+            return Response({
+                'error': str(e)
+            }, status=status.HTTP_500_INTERNAL_SERVER_ERROR)
+
+    @extend_schema(
+        summary="Get activity tracker",
+        description="Retrieve activity tracker data (GitHub-style contribution graph)",
+        parameters=[
+            OpenApiParameter(
+                name='weeks',
+                description='Number of weeks to include',
+                required=False,
+                type=int,
+                default=52
+            ),
+        ],
+        responses=ActivityTrackerDaySerializer(many=True),
+        tags=["Dashboard - Charts"]
+    )
+    @action(detail=False, methods=['get'], url_path='tracker', pagination_class=None, serializer_class=ActivityTrackerDaySerializer)
+    def tracker(self, request):
+        """Get activity tracker data."""
+        try:
+            weeks = int(request.query_params.get('weeks', 52))
+            charts_service = ChartsService()
+            tracker_data = charts_service.get_activity_tracker(weeks=weeks)
+            return Response(tracker_data)
+
+        except Exception as e:
+            logger.error(f"Activity tracker API error: {e}")
+            return Response({
+                'error': str(e)
+            }, status=status.HTTP_500_INTERNAL_SERVER_ERROR)
+
+    @extend_schema(
+        summary="Get recent users",
+        description="Retrieve list of recently registered users",
+        parameters=[
+            OpenApiParameter(
+                name='limit',
+                description='Maximum number of users to return',
+                required=False,
+                type=int,
+                default=10
+            ),
+        ],
+        responses=RecentUserSerializer(many=True),
+        tags=["Dashboard - Charts"]
+    )
+    @action(detail=False, methods=['get'], url_path='recent-users', pagination_class=None, serializer_class=RecentUserSerializer)
+    def recent_users(self, request):
+        """Get recent users list."""
+        try:
+            limit = int(request.query_params.get('limit', 10))
+            stats_service = StatisticsService()
+            users = stats_service.get_recent_users(limit=limit)
+            return Response(users)
+
+        except Exception as e:
+            logger.error(f"Recent users API error: {e}")
+            return Response({
+                'error': str(e)
+            }, status=status.HTTP_500_INTERNAL_SERVER_ERROR)

django_cfg/apps/dashboard/views/commands_views.py

@@ -0,0 +1,73 @@
+"""
+Commands ViewSet
+
+Endpoints for Django management commands:
+- GET /commands/ - All available commands
+- GET /commands/summary/ - Commands summary with statistics
+"""
+
+import logging
+
+from drf_spectacular.utils import 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 ..services import CommandsService
+from ..serializers import CommandSerializer, CommandsSummarySerializer
+
+logger = logging.getLogger(__name__)
+
+
+class CommandsViewSet(viewsets.GenericViewSet):
+    """
+    Commands ViewSet
+
+    Provides endpoints for Django management commands discovery.
+    """
+
+    authentication_classes = [SessionAuthentication, BasicAuthentication]
+    permission_classes = [IsAdminUser]
+    serializer_class = CommandSerializer
+    pagination_class = None  # Disable pagination for commands list
+
+    @extend_schema(
+        summary="Get all commands",
+        description="Retrieve all available Django management commands",
+        responses=CommandSerializer(many=True),
+        tags=["Dashboard - Commands"]
+    )
+    def list(self, request):
+        """Get all Django management commands."""
+        try:
+            commands_service = CommandsService()
+            commands = commands_service.get_all_commands()
+            return Response(commands)
+
+        except Exception as e:
+            logger.error(f"Commands list API error: {e}")
+            return Response({
+                'error': str(e)
+            }, status=status.HTTP_500_INTERNAL_SERVER_ERROR)
+
+    @extend_schema(
+        summary="Get commands summary",
+        description="Retrieve commands summary with statistics and categorization",
+        responses={200: CommandsSummarySerializer},
+        tags=["Dashboard - Commands"]
+    )
+    @action(detail=False, methods=['get'], url_path='summary', serializer_class=CommandsSummarySerializer)
+    def summary(self, request):
+        """Get commands summary with statistics."""
+        try:
+            commands_service = CommandsService()
+            summary = commands_service.get_commands_summary()
+            return Response(summary)
+
+        except Exception as e:
+            logger.error(f"Commands summary API error: {e}")
+            return Response({
+                'error': str(e)
+            }, status=status.HTTP_500_INTERNAL_SERVER_ERROR)

django_cfg/apps/dashboard/views/overview_views.py

@@ -0,0 +1,92 @@
+"""
+Overview ViewSet
+
+Endpoint for complete dashboard overview:
+- GET /overview/ - Complete dashboard data in single request
+"""
+
+import logging
+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 rest_framework.decorators import action
+from rest_framework.permissions import IsAdminUser
+from rest_framework.response import Response
+
+from ..services import StatisticsService, SystemHealthService, ChartsService
+from ..serializers import DashboardOverviewSerializer
+
+logger = logging.getLogger(__name__)
+
+
+class OverviewViewSet(viewsets.GenericViewSet):
+    """
+    Dashboard Overview ViewSet
+
+    Provides a single endpoint that returns all dashboard data at once.
+    Useful for initial page load.
+    """
+
+    authentication_classes = [SessionAuthentication, BasicAuthentication]
+    permission_classes = [IsAdminUser]
+    serializer_class = DashboardOverviewSerializer
+
+    @extend_schema(
+        summary="Get dashboard overview",
+        description="Retrieve complete dashboard data including stats, health, actions, and metrics",
+        responses={200: DashboardOverviewSerializer},
+        tags=["Dashboard - Overview"]
+    )
+    @action(detail=False, methods=['get'], url_path='', url_name='overview')
+    def overview(self, request):
+        """
+        Get complete dashboard overview.
+
+        Returns all dashboard data in a single request:
+        - Statistics cards
+        - System health status
+        - Quick actions
+        - Recent activity
+        - System metrics
+        - User statistics
+        """
+        try:
+            stats_service = StatisticsService()
+            health_service = SystemHealthService()
+            charts_service = ChartsService()
+
+            data = {
+                # Statistics
+                'stat_cards': stats_service.get_stat_cards(),
+                'user_statistics': stats_service.get_user_statistics(),
+                'app_statistics': stats_service.get_app_statistics(),
+
+                # System
+                'system_health': health_service.get_all_health_checks(),
+                'system_metrics': stats_service.get_system_metrics(),
+
+                # Activity
+                'recent_activity': stats_service.get_recent_activity(limit=10),
+                'recent_users': stats_service.get_recent_users(limit=10),
+                'quick_actions': health_service.get_quick_actions(),
+
+                # Charts
+                'charts': {
+                    'user_registrations': charts_service.get_user_registration_chart(days=7),
+                    'user_activity': charts_service.get_user_activity_chart(days=7),
+                },
+                'activity_tracker': charts_service.get_activity_tracker(weeks=52),
+
+                # Meta
+                'timestamp': datetime.now().isoformat(),
+            }
+
+            return Response(data)
+
+        except Exception as e:
+            logger.error(f"Dashboard overview API error: {e}", exc_info=True)
+            return Response({
+                'error': str(e)
+            }, status=status.HTTP_500_INTERNAL_SERVER_ERROR)

django_cfg/apps/dashboard/views/statistics_views.py

@@ -0,0 +1,105 @@
+"""
+Statistics ViewSet
+
+Endpoints for dashboard statistics:
+- GET /statistics/cards/ - Statistics cards
+- GET /statistics/users/ - User statistics
+- GET /statistics/apps/ - Application statistics
+"""
+
+import logging
+
+from drf_spectacular.utils import 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 ..services import StatisticsService
+from ..serializers import (
+    StatCardSerializer,
+    UserStatisticsSerializer,
+    AppStatisticsSerializer,
+)
+
+logger = logging.getLogger(__name__)
+
+
+class StatisticsViewSet(viewsets.GenericViewSet):
+    """
+    Statistics ViewSet
+
+    Provides endpoints for retrieving various dashboard statistics.
+    """
+
+    authentication_classes = [SessionAuthentication, BasicAuthentication]
+    permission_classes = [IsAdminUser]
+    serializer_class = StatCardSerializer
+
+    @extend_schema(
+        summary="Get statistics cards",
+        description="Retrieve dashboard statistics cards with key metrics",
+        responses=StatCardSerializer(many=True),
+        tags=["Dashboard - Statistics"]
+    )
+    @action(detail=False, methods=['get'], url_path='cards', pagination_class=None, serializer_class=StatCardSerializer)
+    def cards(self, request):
+        """Get dashboard statistics cards."""
+        try:
+            stats_service = StatisticsService()
+            cards = stats_service.get_stat_cards()
+            return Response(cards)
+
+        except Exception as e:
+            logger.error(f"Stat cards API error: {e}")
+            return Response({
+                'error': str(e)
+            }, status=status.HTTP_500_INTERNAL_SERVER_ERROR)
+
+    @extend_schema(
+        summary="Get user statistics",
+        description="Retrieve user-related statistics",
+        responses={200: UserStatisticsSerializer},
+        tags=["Dashboard - Statistics"]
+    )
+    @action(detail=False, methods=['get'], url_path='users', serializer_class=UserStatisticsSerializer)
+    def users(self, request):
+        """Get user statistics."""
+        try:
+            stats_service = StatisticsService()
+            user_stats = stats_service.get_user_statistics()
+            return Response(user_stats)
+
+        except Exception as e:
+            logger.error(f"User statistics API error: {e}")
+            return Response({
+                'error': str(e)
+            }, status=status.HTTP_500_INTERNAL_SERVER_ERROR)
+
+    @extend_schema(
+        summary="Get application statistics",
+        description="Retrieve statistics for all enabled django-cfg applications",
+        responses=AppStatisticsSerializer(many=True),
+        tags=["Dashboard - Statistics"]
+    )
+    @action(detail=False, methods=['get'], url_path='apps', pagination_class=None, serializer_class=AppStatisticsSerializer)
+    def apps(self, request):
+        """Get application-specific statistics."""
+        try:
+            stats_service = StatisticsService()
+            app_stats = stats_service.get_app_statistics()
+
+            # Convert dict to list of {app_name, statistics} objects
+            data = [
+                {'app_name': app_name, 'statistics': stats}
+                for app_name, stats in app_stats.items()
+            ]
+
+            return Response(data)
+
+        except Exception as e:
+            logger.error(f"App statistics API error: {e}")
+            return Response({
+                'error': str(e)
+            }, status=status.HTTP_500_INTERNAL_SERVER_ERROR)