edx-enterprise-data 8.8.2__py3-none-any.whl → 8.10.0__py3-none-any.whl

{edx_enterprise_data-8.8.2.dist-info → edx_enterprise_data-8.10.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: edx-enterprise-data
-Version: 8.8.2
+Version: 8.10.0
 Summary: Enterprise Reporting
 Home-page: https://github.com/openedx/edx-enterprise-data
 Author: edX

{edx_enterprise_data-8.8.2.dist-info → edx_enterprise_data-8.10.0.dist-info}/RECORD

@@ -1,18 +1,18 @@
-enterprise_data/__init__.py,sha256=-VIr7vbXyC6NZ93tVq80ymKwQlt-e7RNEMF68U0vAV0,123
+enterprise_data/__init__.py,sha256=Cji_MQl_02kLp1gNtiDwEL03f3XaG45wQPHOFScJs1I,124
 enterprise_data/apps.py,sha256=aF6hZwDfI2oWj95tUTm_2ikHueQj-jLj-u0GrgzpsQI,414
 enterprise_data/clients.py,sha256=GvQupy5TVYfO_IKC3yzXSAgNP54r-PtIjidM5ws9Iks,3947
 enterprise_data/constants.py,sha256=uCKjfpdlMYFZJsAj3n9RMw4Cmg5_6s3NuwocO-fch3s,238
 enterprise_data/filters.py,sha256=D2EiK12MMpBoz6eOUmTpoJEhj_sH7bA93NRRAdvkDVo,6163
 enterprise_data/models.py,sha256=khGcOh7NWP8KGu84t78Y2zAu3knREeXA_prApmU2NX8,24428
 enterprise_data/paginators.py,sha256=YPrC5TeXFt-ymenT2H8H2nCbDCnAzJQlH9kFPElRxWE,269
-enterprise_data/renderers.py,sha256=9gIzavWspZTk4vDfVKXJtdn0tSZ2xNgkF-Akf7AWIDM,2389
+enterprise_data/renderers.py,sha256=VaCymaZUhYEZ6yvryoASEohKeeL6lcPSWhFCnyfzjps,2699
 enterprise_data/signals.py,sha256=8eqNPnlvmfsKf19lGWv5xTIuBgQIqR8EZSp9UYzC8Rc,1024
 enterprise_data/urls.py,sha256=bqtKF5OEWEwrNmHG3os-pZNuNsmjlhxEqp7yM4TbPf4,243
 enterprise_data/utils.py,sha256=_zK3BErjZSIkP_JNzK8m-DR5pRTnxKylP9I-vURaRcE,3009
 enterprise_data/admin_analytics/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 enterprise_data/admin_analytics/completions_utils.py,sha256=kGmLy7x6aD0coNYgzLa5XzJypLkGTT5clDHLSH_QFDE,9442
-enterprise_data/admin_analytics/constants.py,sha256=aHDgTHdsjbKNpgtNLDsl4giqhhrRkCGi72ysGIEk0Ao,817
-enterprise_data/admin_analytics/data_loaders.py,sha256=YpSyygATVFtItcWlkIHvjsX5Lh1qMw6onDK-ZHP_AUw,5586
+enterprise_data/admin_analytics/constants.py,sha256=7WturLuMISekgcHHlgj45PPdPrDTYM-l21lA8-Q_Tfc,1107
+enterprise_data/admin_analytics/data_loaders.py,sha256=4PSsIveNBtpFqwrLUjTl5oywHVYFAMdZrNRHRGMk4XY,6116
 enterprise_data/admin_analytics/database.py,sha256=mNS_9xE5h6O7oMMzr6kr6LDTTSNvKzo8vaM-YG8tOd8,1312
 enterprise_data/admin_analytics/utils.py,sha256=CQuTlg36AALJiopp4us-JN8oTXsw-jDXSJenbphLDME,12270
 enterprise_data/api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -23,14 +23,15 @@ enterprise_data/api/v0/urls.py,sha256=vzJjqIo_S3AXWs9Us8XTaJc3FnxLbYzAkmLyuDQqum
 enterprise_data/api/v0/views.py,sha256=4RslZ4NZOU-844bnebEQ71ji2utRY7jEijqC45oQQD0,14380
 enterprise_data/api/v1/__init__.py,sha256=1aAzAYU5hk-RW6cKUxa1645cbZMxn7GIZ7OMjWc9MKI,46
 enterprise_data/api/v1/paginators.py,sha256=f0xsilLaU94jSBltJk46tR1rLEIt7YrqSzMAAVtPXjA,3592
-enterprise_data/api/v1/serializers.py,sha256=9F2LGa8IKvglgeYNHw3Q0eEZUWknwHZMNZOdpDviEo4,12327
-enterprise_data/api/v1/urls.py,sha256=xFsBf3TTsdblFAiHq1Bj3h82Ye1PS3cgqLC0pIso2js,3504
+enterprise_data/api/v1/serializers.py,sha256=Kk4zuRNcr4bfMYIwi2iXQAr_NM3OXuXNfxfrz7xO2iE,13194
+enterprise_data/api/v1/urls.py,sha256=nFcbPSfAIKW6Eiwd1vN0WMqdtBfh9_bBqAFCVrzRm5I,4091
 enterprise_data/api/v1/views/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-enterprise_data/api/v1/views/analytics_enrollments.py,sha256=om8i5HTDxDMSny1fy49Wh38LdYLLz-k-oFQJqlQLOxg,16812
-enterprise_data/api/v1/views/analytics_leaderboard.py,sha256=EE34fJWYp8OGbIj8oRLlgMhbSm37w98oPXn1aPIZWWE,5860
+enterprise_data/api/v1/views/analytics_engagements.py,sha256=8H3Fk-hTqJaU3H5Lpu1kFWq7p7xDp1pjge-sK7osDbg,17553
+enterprise_data/api/v1/views/analytics_enrollments.py,sha256=trC92GOej6vUoju53KT3dPEDnoPHdukfXEIXPThz76A,16886
+enterprise_data/api/v1/views/analytics_leaderboard.py,sha256=2DALqzUIbe4-ZGgHHIkYAKJ5L1ik2ruPtQNYtTdPba4,5974
 enterprise_data/api/v1/views/base.py,sha256=FTAxlz5EzvAY657wzVgzhJPFSCHHzct7IDcvm71Smt8,866
-enterprise_data/api/v1/views/enterprise_admin.py,sha256=F34FbOz1gLwHPUAQOg3mOjZoKirbCRrjZS2xFJSUBpw,9274
-enterprise_data/api/v1/views/enterprise_completions.py,sha256=OkH6eYNql6UGVU-Xjx7PzwzaHeUHfa6e4WJmkUoHGDM,8221
+enterprise_data/api/v1/views/enterprise_admin.py,sha256=HiFJLFWCHn4UbRIlN9TlqIwTJWrse5b4qf3gQmx4QLY,9352
+enterprise_data/api/v1/views/enterprise_completions.py,sha256=bJG2ZtTbLyiBrj64iJHQNHEKLrJCzl9OuJ7nDtw-9aY,8377
 enterprise_data/api/v1/views/enterprise_learner.py,sha256=yABjJje3CT8I8YOhWr1_tTkdKtnGJom8eu3EFz_-0BU,18517
 enterprise_data/api/v1/views/enterprise_offers.py,sha256=VifxgqTLFLVw4extYPlHcN1N_yjXcsYsAlYEnAbpb10,1266
 enterprise_data/fixtures/enterprise_enrollment.json,sha256=6onPXXR29pMdTdbl_mn81sDi3Re5jkLUZz2TPMB_1IY,5786
@@ -104,8 +105,9 @@ enterprise_data/tests/test_models.py,sha256=MWBY-LY5TPBjZ4GlvpM-h4W-BvRKr2Rml8Bz
 enterprise_data/tests/test_utils.py,sha256=vbmYM7DMN-lHS2p4yaa0Yd6uSGXd2qoZRDE9X3J4Sec,18385
 enterprise_data/tests/test_views.py,sha256=UvDRNTxruy5zBK_KgUy2cBMbwlaTW_vkM0-TCXbQZiY,69667
 enterprise_data/tests/admin_analytics/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-enterprise_data/tests/admin_analytics/mock_analytics_data.py,sha256=mLGTIP89VAQgqKtYlYnKUAKyZATzKnBtI_5aJwMmr7Q,18344
+enterprise_data/tests/admin_analytics/mock_analytics_data.py,sha256=LoYAh5cn_4rv2stGcMP5PELv2l7Eu2DTKG-v7viNTCs,20266
 enterprise_data/tests/admin_analytics/mock_enrollments.py,sha256=LfuMo9Kn-OQD4z42G3BRuM5MXUUXXlaAMhTqfJf46XE,7266
+enterprise_data/tests/admin_analytics/test_analytics_engagements.py,sha256=KPXtBPaAOrzfff7W-xERSGx9KtZAJndLbIJx3gopSnE,15689
 enterprise_data/tests/admin_analytics/test_analytics_enrollments.py,sha256=UdKRkP6BNbsSo-gm0YCoddT-ReUMI1x9E6HNLSHT7pY,15177
 enterprise_data/tests/admin_analytics/test_analytics_leaderboard.py,sha256=VSEyDAHfWBJvqmx9yzd4NnPAqK3TqaKrMBWswMAdzfU,6206
 enterprise_data/tests/admin_analytics/test_data_loaders.py,sha256=o3denJ4aUS1pI5Crksl4C6m-NtCBm8ynoHBnLkf-v2U,4641
@@ -159,8 +161,8 @@ enterprise_reporting/tests/test_send_enterprise_reports.py,sha256=WtL-RqGgu2x5PP
 enterprise_reporting/tests/test_utils.py,sha256=Zt_TA0LVb-B6fQGkUkAKKVlUKKnQh8jnw1US1jKe7g8,9493
 enterprise_reporting/tests/test_vertica_client.py,sha256=-R2yNCGUjRtoXwLMBloVFQkFYrJoo613VCr61gwI3kQ,140
 enterprise_reporting/tests/utils.py,sha256=xms2LM7DV3wczXEfctOK1ddel1EE0J_YSr17UzbCDy4,1401
-edx_enterprise_data-8.8.2.dist-info/LICENSE,sha256=dql8h4yceoMhuzlcK0TT_i-NgTFNIZsgE47Q4t3dUYI,34520
-edx_enterprise_data-8.8.2.dist-info/METADATA,sha256=xBoBTQy1LaX3WMjZLX5t8d-OVlkbxRQgyF9f0nLbrro,1569
-edx_enterprise_data-8.8.2.dist-info/WHEEL,sha256=R0nc6qTxuoLk7ShA2_Y-UWkN8ZdfDBG2B6Eqpz2WXbs,91
-edx_enterprise_data-8.8.2.dist-info/top_level.txt,sha256=f5F2kU-dob6MqiHJpgZkFzoCD5VMhsdpkTV5n9Tvq3I,59
-edx_enterprise_data-8.8.2.dist-info/RECORD,,
+edx_enterprise_data-8.10.0.dist-info/LICENSE,sha256=dql8h4yceoMhuzlcK0TT_i-NgTFNIZsgE47Q4t3dUYI,34520
+edx_enterprise_data-8.10.0.dist-info/METADATA,sha256=AYOfkH_4tZ4ANxQ--Pk_2jmmkxfbg0bRlBDaVA8YuSM,1570
+edx_enterprise_data-8.10.0.dist-info/WHEEL,sha256=R0nc6qTxuoLk7ShA2_Y-UWkN8ZdfDBG2B6Eqpz2WXbs,91
+edx_enterprise_data-8.10.0.dist-info/top_level.txt,sha256=f5F2kU-dob6MqiHJpgZkFzoCD5VMhsdpkTV5n9Tvq3I,59
+edx_enterprise_data-8.10.0.dist-info/RECORD,,

enterprise_data/__init__.py

@@ -2,4 +2,4 @@
 Enterprise data api application. This Django app exposes API endpoints used by enterprises.
 """
 
-__version__ = "8.8.2"
+__version__ = "8.10.0"

enterprise_data/admin_analytics/constants.py

@@ -31,3 +31,11 @@ class ResponseType(Enum):
     """Response type choices"""
     JSON = 'json'
     CSV = 'csv'
+
+
+class EngagementChart(Enum):
+    """Response Choices"""
+    ENGAGEMENTS_OVER_TIME = 'engagements_over_time'
+    TOP_COURSES_BY_ENGAGEMENTS = 'top_courses_by_engagements'
+    TOP_SUBJECTS_BY_ENGAGEMENTS = 'top_subjects_by_engagements'
+    INDIVIDUAL_ENGAGEMENTS = 'individual_engagements'

enterprise_data/admin_analytics/data_loaders.py

@@ -1,6 +1,8 @@
 """
 Utility functions for fetching data from the database.
 """
+from logging import getLogger
+
 import numpy
 import pandas
 
@@ -9,6 +11,8 @@ from django.http import Http404
 from enterprise_data.admin_analytics.database import run_query
 from enterprise_data.utils import timer
 
+LOGGER = getLogger(__name__)
+
 
 def get_select_query(table: str, columns: list, enterprise_uuid: str) -> str:
     """
@@ -68,10 +72,13 @@ def fetch_enrollment_data(enterprise_uuid: str):
 
     with timer('fetch_enrollment_data'):
         results = run_query(query=query)
+
     if not results:
         raise Http404(f'No enrollment data found for enterprise {enterprise_uuid}')
 
+    LOGGER.info(f'[PLOTLY] Enrollment data fetched successfully. Records: {len(results)}')
     enrollments = pandas.DataFrame(numpy.array(results), columns=columns)
+    LOGGER.info('[PLOTLY] Enrollment data converted to DataFrame.')
 
     # Convert date columns to datetime.
     enrollments['enterprise_enrollment_date'] = enrollments['enterprise_enrollment_date'].astype('datetime64[ns]')
@@ -120,7 +127,9 @@ def fetch_engagement_data(enterprise_uuid: str):
     if not results:
         raise Http404(f'No engagement data found for enterprise {enterprise_uuid}')
 
+    LOGGER.info(f'[PLOTLY] Engagement data fetched successfully. Records: {len(results)}')
     engagement = pandas.DataFrame(numpy.array(results), columns=columns)
+    LOGGER.info('[PLOTLY] Engagement data converted to DataFrame.')
     engagement['activity_date'] = engagement['activity_date'].astype('datetime64[ns]')
 
     return engagement
@@ -180,7 +189,9 @@ def fetch_skills_data(enterprise_uuid: str):
     if not skills:
         raise Http404(f'No skills data found for enterprise {enterprise_uuid}')
 
+    LOGGER.info(f'[PLOTLY] Skills data fetched successfully. Records: {len(skills)}')
     skills = pandas.DataFrame(numpy.array(skills), columns=cols)
+    LOGGER.info('[PLOTLY] Skills data converted to DataFrame.')
     skills['date'] = skills['date'].astype('datetime64[ns]')
 
     return skills

enterprise_data/api/v1/serializers.py

@@ -5,7 +5,13 @@ from uuid import UUID
 
 from rest_framework import serializers
 
-from enterprise_data.admin_analytics.constants import Calculation, EnrollmentChart, Granularity, ResponseType
+from enterprise_data.admin_analytics.constants import (
+    Calculation,
+    EngagementChart,
+    EnrollmentChart,
+    Granularity,
+    ResponseType,
+)
 from enterprise_data.models import (
     EnterpriseAdminLearnerProgress,
     EnterpriseAdminSummarizeInsights,
@@ -331,3 +337,27 @@ class AdvanceAnalyticsEnrollmentStatsSerializer(
         if value not in self.CHART_TYPES:
             raise serializers.ValidationError(f"chart_type must be one of {self.CHART_TYPES}")
         return value
+
+
+class AdvanceAnalyticsEngagementStatsSerializer(
+    AdvanceAnalyticsQueryParamSerializer
+):  # pylint: disable=abstract-method
+    """Serializer for validating Advance Analytics Engagements Stats API"""
+    CHART_TYPES = [
+        EngagementChart.ENGAGEMENTS_OVER_TIME.value,
+        EngagementChart.TOP_COURSES_BY_ENGAGEMENTS.value,
+        EngagementChart.TOP_SUBJECTS_BY_ENGAGEMENTS.value
+    ]
+
+    chart_type = serializers.CharField(required=False)
+
+    def validate_chart_type(self, value):
+        """
+        Validate the chart_type value.
+
+        Raises:
+            serializers.ValidationError: If chart_type is not one of the valid choices
+        """
+        if value not in self.CHART_TYPES:
+            raise serializers.ValidationError(f"chart_type must be one of {self.CHART_TYPES}")
+        return value

enterprise_data/api/v1/urls.py

@@ -11,6 +11,10 @@ from enterprise_data.api.v1.views import enterprise_admin as enterprise_admin_vi
 from enterprise_data.api.v1.views import enterprise_completions as enterprise_completions_views
 from enterprise_data.api.v1.views import enterprise_learner as enterprise_learner_views
 from enterprise_data.api.v1.views import enterprise_offers as enterprise_offers_views
+from enterprise_data.api.v1.views.analytics_engagements import (
+    AdvanceAnalyticsEngagementStatsView,
+    AdvanceAnalyticsIndividualEngagementsView,
+)
 from enterprise_data.api.v1.views.analytics_enrollments import (
     AdvanceAnalyticsEnrollmentStatsView,
     AdvanceAnalyticsIndividualEnrollmentsView,
@@ -73,6 +77,16 @@ urlpatterns = [
         AdvanceAnalyticsIndividualEnrollmentsView.as_view(),
         name='enterprise-admin-analytics-enrollments'
     ),
+    re_path(
+        fr'^admin/analytics/(?P<enterprise_uuid>{UUID4_REGEX})/engagements/stats$',
+        AdvanceAnalyticsEngagementStatsView.as_view(),
+        name='enterprise-admin-analytics-engagements-stats'
+    ),
+    re_path(
+        fr'^admin/analytics/(?P<enterprise_uuid>{UUID4_REGEX})/engagements$',
+        AdvanceAnalyticsIndividualEngagementsView.as_view(),
+        name='enterprise-admin-analytics-engagements'
+    ),
     re_path(
         fr'^admin/analytics/(?P<enterprise_id>{UUID4_REGEX})/skills/stats',
         enterprise_admin_views.EnterpriseAdminAnalyticsSkillsView.as_view(),

enterprise_data/api/v1/views/analytics_engagements.py

@@ -0,0 +1,395 @@
+"""Advance Analytics for Engagements"""
+from datetime import datetime
+
+from edx_rbac.decorators import permission_required
+from edx_rest_framework_extensions.auth.jwt.authentication import JwtAuthentication
+from rest_framework import status as rest_status
+from rest_framework.response import Response
+from rest_framework.views import APIView
+
+from django.http import HttpResponse, StreamingHttpResponse
+
+from enterprise_data.admin_analytics.constants import Calculation, EngagementChart, Granularity, ResponseType
+from enterprise_data.admin_analytics.utils import (
+    calculation_aggregation,
+    fetch_and_cache_engagements_data,
+    fetch_and_cache_enrollments_data,
+    fetch_enrollments_cache_expiry_timestamp,
+    granularity_aggregation,
+)
+from enterprise_data.api.v1 import serializers
+from enterprise_data.api.v1.paginators import AdvanceAnalyticsPagination
+from enterprise_data.renderers import IndividualEngagementsCSVRenderer
+from enterprise_data.utils import date_filter
+
+
+class AdvanceAnalyticsIndividualEngagementsView(APIView):
+    """
+    API for getting the advance analytics individual engagements data.
+    """
+
+    authentication_classes = (JwtAuthentication,)
+    pagination_class = AdvanceAnalyticsPagination
+    http_method_names = ["get"]
+
+    @permission_required('can_access_enterprise', fn=lambda request, enterprise_uuid: enterprise_uuid)
+    def get(self, request, enterprise_uuid):
+        """
+        HTTP GET endpoint to retrieve the enterprise engagements data.
+        """
+        serializer = serializers.AdvanceAnalyticsEngagementStatsSerializer(data=request.GET)
+        serializer.is_valid(raise_exception=True)
+        cache_expiry = fetch_enrollments_cache_expiry_timestamp()
+
+        enrollment_df = fetch_and_cache_enrollments_data(enterprise_uuid, cache_expiry).copy()
+        engagement_df = fetch_and_cache_engagements_data(enterprise_uuid, cache_expiry).copy()
+        # Use start and end date if provided by the client, if client has not provided then use
+        # 1. minimum enrollment date from the data as the start_date
+        # 2. today's date as the end_date
+        start_date = serializer.data.get('start_date', enrollment_df.enterprise_enrollment_date.min())
+        end_date = serializer.data.get('end_date', datetime.now())
+        response_type = request.query_params.get('response_type', ResponseType.JSON.value)
+        # Date filtering.
+        engagements = date_filter(
+            start=start_date, end=end_date, data_frame=engagement_df.copy(), date_column='activity_date'
+        )
+        engagements["learning_time_hours"] = engagements["learning_time_seconds"] / 60 / 60
+        engagements = engagements[engagements["learning_time_hours"] > 0]
+        engagements["learning_time_hours"] = round(engagements["learning_time_hours"].astype(float), 1)
+
+        # Select only the columns that will be in the table.
+        engagements = engagements[
+            [
+                "email",
+                "course_title",
+                "activity_date",
+                "course_subject",
+                "learning_time_hours",
+            ]
+        ]
+        engagements["activity_date"] = engagements["activity_date"].dt.date
+        engagements = engagements.sort_values(by="activity_date", ascending=False).reset_index(drop=True)
+        if response_type == ResponseType.CSV.value:
+            response = StreamingHttpResponse(
+                IndividualEngagementsCSVRenderer().render(self._stream_serialized_data(engagements)),
+                content_type="text/csv"
+            )
+            start_date = start_date.strftime('%Y/%m/%d')
+            end_date = end_date.strftime('%Y/%m/%d')
+            filename = f"""Individual Engagements, {start_date} - {end_date}.csv"""
+            response['Content-Disposition'] = f'attachment; filename="{filename}"'
+            response['Access-Control-Expose-Headers'] = 'Content-Disposition'
+            return response
+
+        paginator = self.pagination_class()
+        page = paginator.paginate_queryset(engagements, request)
+        serialized_data = page.data.to_dict(orient='records')
+        response = paginator.get_paginated_response(serialized_data)
+
+        return response
+
+    def _stream_serialized_data(self, engagements, chunk_size=50000):
+        """
+        Stream the serialized data.
+        """
+        total_rows = engagements.shape[0]
+        for start_index in range(0, total_rows, chunk_size):
+            end_index = min(start_index + chunk_size, total_rows)
+            chunk = engagements.iloc[start_index:end_index]
+            yield from chunk.to_dict(orient='records')
+
+
+class AdvanceAnalyticsEngagementStatsView(APIView):
+    """
+    API for getting the advance analytics engagements statistics data.
+    """
+
+    authentication_classes = (JwtAuthentication,)
+    http_method_names = ["get"]
+
+    @permission_required('can_access_enterprise', fn=lambda request, enterprise_uuid: enterprise_uuid)
+    def get(self, request, enterprise_uuid):
+        """
+        HTTP GET endpoint to retrieve the enterprise engagements statistics data.
+        """
+        serializer = serializers.AdvanceAnalyticsEngagementStatsSerializer(data=request.GET)
+        serializer.is_valid(raise_exception=True)
+
+        cache_expiry = fetch_enrollments_cache_expiry_timestamp()
+
+        enrollment_df = fetch_and_cache_enrollments_data(enterprise_uuid, cache_expiry).copy()
+        engagement_df = fetch_and_cache_engagements_data(enterprise_uuid, cache_expiry).copy()
+        # Use start and end date if provided by the client, if client has not provided then use
+        # 1. minimum enrollment date from the data as the start_date
+        # 2. today's date as the end_date
+        start_date = serializer.data.get('start_date', enrollment_df.enterprise_enrollment_date.min())
+        end_date = serializer.data.get('end_date', datetime.now())
+        granularity = serializer.data.get('granularity', Granularity.DAILY.value)
+        calculation = serializer.data.get('calculation', Calculation.TOTAL.value)
+        chart_type = serializer.data.get('chart_type')
+
+        if chart_type is None:
+            data = {
+                "engagements_over_time": self.construct_engagements_over_time(
+                    engagement_df.copy(),
+                    start_date,
+                    end_date,
+                    granularity,
+                    calculation,
+                ),
+                "top_courses_by_engagement": self.construct_top_courses_by_engagements(
+                    engagement_df.copy(),
+                    start_date,
+                    end_date,
+                ),
+                "top_subjects_by_engagement": self.construct_top_subjects_by_engagements(
+                    engagement_df.copy(),
+                    start_date,
+                    end_date,
+                ),
+            }
+            return Response(data)
+        elif chart_type == EngagementChart.ENGAGEMENTS_OVER_TIME.value:
+            return self.construct_engagements_over_time_csv(
+                engagement_df.copy(),
+                start_date,
+                end_date,
+                granularity,
+                calculation,
+            )
+        elif chart_type == EngagementChart.TOP_COURSES_BY_ENGAGEMENTS.value:
+            return self.construct_top_courses_by_engagements_csv(
+                engagement_df.copy(),
+                start_date,
+                end_date,
+            )
+        elif chart_type == EngagementChart.TOP_SUBJECTS_BY_ENGAGEMENTS.value:
+            return self.construct_top_subjects_by_engagements_csv(
+                engagement_df.copy(),
+                start_date,
+                end_date,
+            )
+        return Response(data='Not Found', status=rest_status.HTTP_400_BAD_REQUEST)
+
+    def engagements_over_time_common(self, engagements_df, start_date, end_date, granularity, calculation):
+        """
+        Common method for constructing engagements over time data.
+
+        Arguments:
+            engagements_df {DataFrame} -- DataFrame of engagements
+            start_date {datetime} -- Engagement start date in the format 'YYYY-MM-DD'
+            end_date {datetime} -- Engagement end date in the format 'YYYY-MM-DD'
+            granularity {str} -- Granularity of the data. One of Granularity choices
+            calculation {str} -- Calculation of the data. One of Calculation choices
+        """
+        engagements_df["learning_time_hours"] = engagements_df["learning_time_seconds"] / 60 / 60
+        engagements_df = engagements_df[engagements_df["learning_time_hours"] > 0]
+        engagements_df["learning_time_hours"] = round(engagements_df["learning_time_hours"].astype(float), 1)
+
+        engagements_df = engagements_df[["activity_date", "enroll_type", "learning_time_hours"]]
+
+        # Date filtering.
+        engagements_df = date_filter(
+            start=start_date, end=end_date, data_frame=engagements_df, date_column="activity_date"
+        )
+
+        # Date aggregation.
+        engagements_df = granularity_aggregation(
+            level=granularity,
+            group=["activity_date", "enroll_type"],
+            date="activity_date",
+            data_frame=engagements_df,
+            aggregation_type="sum",
+        )
+
+        # Calculating metric.
+        engagements = calculation_aggregation(calc=calculation, aggregation_type="sum", data_frame=engagements_df)
+        return engagements
+
+    def construct_engagements_over_time(self, engagements_df, start_date, end_date, granularity, calculation):
+        """
+        Construct engagements over time data.
+
+        Arguments:
+            engagements_df {DataFrame} -- DataFrame of engagements
+            start_date {datetime} -- Engagement start date in the format 'YYYY-MM-DD'
+            end_date {datetime} -- Engagement end date in the format 'YYYY-MM-DD'
+            granularity {str} -- Granularity of the data. One of Granularity choices
+            calculation {str} -- Calculation of the data. One of Calculation choices
+        """
+        engagements = self.engagements_over_time_common(engagements_df, start_date, end_date, granularity, calculation)
+        # convert dataframe to a list of records
+        return engagements.to_dict(orient='records')
+
+    def construct_engagements_over_time_csv(self, engagements_df, start_date, end_date, granularity, calculation):
+        """
+        Construct engagements over time CSV.
+
+        Arguments:
+            engagements_df {DataFrame} -- DataFrame of engagements
+            start_date {datetime} -- Engagement start date in the format 'YYYY-MM-DD'
+            end_date {datetime} -- Engagement end date in the format 'YYYY-MM-DD'
+            granularity {str} -- Granularity of the data. One of Granularity choices
+            calculation {str} -- Calculation of the data. One of Calculation choices
+        """
+        engagements = self.engagements_over_time_common(engagements_df, start_date, end_date, granularity, calculation)
+
+        engagements = engagements.pivot(
+            index="activity_date", columns="enroll_type", values="sum"
+        )
+
+        filename = f"Engagement Timeseries, {start_date} - {end_date} ({granularity} {calculation}).csv"
+        return self.construct_csv_response(engagements, filename)
+
+    def top_courses_by_engagements_common(self, engagements_df, start_date, end_date):
+        """
+        Common method for constructing top courses by engagements data.
+
+        Arguments:
+            engagements_df {DataFrame} -- DataFrame of engagements
+            start_date {datetime} -- Engagement start date in the format 'YYYY-MM-DD'
+            end_date {datetime} -- Engagement end date in the format 'YYYY-MM-DD'
+            group_by_columns {list} -- List of columns to group by
+            columns {list} -- List of column for the final result
+        """
+        engagements_df["learning_time_hours"] = engagements_df["learning_time_seconds"] / 60 / 60
+        engagements_df["learning_time_hours"] = engagements_df["learning_time_hours"].astype("float")
+
+        # Date filtering.
+        engagements = date_filter(
+            start=start_date, end=end_date, data_frame=engagements_df, date_column="activity_date"
+        )
+
+        courses = list(
+            engagements.groupby(["course_key"])
+            .learning_time_hours.sum()
+            .sort_values(ascending=False)[:10]
+            .index
+        )
+
+        engagements = (
+            engagements_df[engagements_df.course_key.isin(courses)]
+            .groupby(["course_key", "course_title", "enroll_type"])
+            .learning_time_hours.sum()
+            .reset_index()
+        )
+
+        engagements.columns = ["course_key", "course_title", "enroll_type", "count"]
+
+        return engagements
+
+    def construct_top_courses_by_engagements(self, engagements_df, start_date, end_date):
+        """
+        Construct top courses by engagements data.
+
+        Arguments:
+            engagements_df {DataFrame} -- DataFrame of engagements
+            start_date {datetime} -- Engagement start date in the format 'YYYY-MM-DD'
+            end_date {datetime} -- Engagement end date in the format 'YYYY-MM-DD'
+        """
+        engagements = self.top_courses_by_engagements_common(
+            engagements_df,
+            start_date,
+            end_date
+        )
+
+        # convert dataframe to a list of records
+        return engagements.to_dict(orient='records')
+
+    def construct_top_courses_by_engagements_csv(self, engagements_df, start_date, end_date):
+        """
+        Construct top courses by engagements CSV.
+
+        Arguments:
+            engagements_df {DataFrame} -- DataFrame of engagements
+            start_date {datetime} -- Engagement start date in the format 'YYYY-MM-DD'
+            end_date {datetime} -- Engagement end date in the format 'YYYY-MM-DD'
+        """
+        engagements = self.top_courses_by_engagements_common(
+            engagements_df,
+            start_date,
+            end_date
+        )
+
+        engagements = engagements.pivot(
+            index=["course_key", "course_title"], columns="enroll_type", values="count"
+        )
+
+        filename = f"Top 10 Courses by Learning Hours, {start_date} - {end_date}.csv"
+        return self.construct_csv_response(engagements, filename)
+
+    def top_subjects_by_engagements_common(self, engagements_df, start_date, end_date):
+        """
+        Common method for constructing top subjects by engagements data.
+
+        Arguments:
+            engagements_df {DataFrame} -- DataFrame of engagements
+            start_date {datetime} -- Engagement start date in the format 'YYYY-MM-DD'
+            end_date {datetime} -- Engagement end date in the format 'YYYY-MM-DD'
+        """
+        engagements_df["learning_time_hours"] = engagements_df["learning_time_seconds"] / 60 / 60
+        engagements_df["learning_time_hours"] = engagements_df["learning_time_hours"].astype("float")
+
+        # Date filtering.
+        engagements = date_filter(
+            start=start_date, end=end_date, data_frame=engagements_df, date_column="activity_date"
+        )
+
+        subjects = list(
+            engagements.groupby(["course_subject"])
+            .learning_time_hours.sum()
+            .sort_values(ascending=False)[:10]
+            .index
+        )
+
+        engagements = (
+            engagements[engagements.course_subject.isin(subjects)]
+            .groupby(["course_subject", "enroll_type"])
+            .learning_time_hours.sum()
+            .reset_index()
+        )
+        engagements.columns = ["course_subject", "enroll_type", "count"]
+
+        return engagements
+
+    def construct_top_subjects_by_engagements(self, engagements_df, start_date, end_date):
+        """
+        Construct top subjects by engagements data.
+
+        Arguments:
+            engagements_df {DataFrame} -- DataFrame of engagements
+            start_date {datetime} -- Engagement start date in the format 'YYYY-MM-DD'
+            end_date {datetime} -- Engagement end date in the format 'YYYY-MM-DD'
+        """
+        engagements = self.top_subjects_by_engagements_common(engagements_df, start_date, end_date)
+        # convert dataframe to a list of records
+        return engagements.to_dict(orient='records')
+
+    def construct_top_subjects_by_engagements_csv(self, engagements_df, start_date, end_date):
+        """
+        Construct top subjects by engagements CSV.
+
+        Arguments:
+            engagements_df {DataFrame} -- DataFrame of engagements
+            start_date {datetime} -- Engagement start date in the format 'YYYY-MM-DD'
+            end_date {datetime} -- Engagement end date in the format 'YYYY-MM-DD'
+        """
+        engagements = self.top_subjects_by_engagements_common(engagements_df, start_date, end_date)
+        engagements = engagements.pivot(index="course_subject", columns="enroll_type", values="count")
+        filename = f"Top 10 Subjects by Learning Hours, {start_date} - {end_date}.csv"
+        return self.construct_csv_response(engagements, filename)
+
+    def construct_csv_response(self, engagements, filename):
+        """
+        Construct CSV response.
+
+        Arguments:
+            engagements {DataFrame} -- DataFrame of engagements
+            filename {str} -- Filename for the CSV
+        """
+        response = HttpResponse(content_type='text/csv')
+        response['Content-Disposition'] = f'attachment; filename="{filename}"'
+        response['Access-Control-Expose-Headers'] = 'Content-Disposition'
+        engagements.to_csv(path_or_buf=response)
+
+        return response

enterprise_data/api/v1/views/analytics_enrollments.py

@@ -382,6 +382,7 @@ class AdvanceAnalyticsEnrollmentStatsView(APIView):
         """
         response = HttpResponse(content_type='text/csv')
         response['Content-Disposition'] = f'attachment; filename="{filename}"'
+        response['Access-Control-Expose-Headers'] = 'Content-Disposition'
         enrollments.to_csv(path_or_buf=response)
 
         return response

enterprise_data/api/v1/views/analytics_leaderboard.py

@@ -120,7 +120,10 @@ class AdvanceAnalyticsLeaderboardView(APIView):
             return StreamingHttpResponse(
                 LeaderboardCSVRenderer().render(self._stream_serialized_data(leaderboard_df)),
                 content_type="text/csv",
-                headers={"Content-Disposition": f'attachment; filename="{filename}"'},
+                headers={
+                    "Content-Disposition": f'attachment; filename="{filename}"',
+                    "Access-Control-Expose-Headers": "Content-Disposition"
+                },
             )
 
         paginator = self.pagination_class()

enterprise_data/api/v1/views/enterprise_admin.py

@@ -208,6 +208,7 @@ class EnterpriseAdminAnalyticsSkillsView(APIView):
             response = HttpResponse(content_type='text/csv')
             filename = f"Skills by Enrollment and Completion, {start_date} - {end_date}.csv"
             response['Content-Disposition'] = f'attachment; filename="{filename}"'
+            response['Access-Control-Expose-Headers'] = 'Content-Disposition'
             csv_data.to_csv(path_or_buf=response, index=False)
             return response
 

enterprise_data/api/v1/views/enterprise_completions.py

@@ -90,6 +90,7 @@ class EnterrpiseAdminCompletionsStatsView(APIView):
                     )
             filename = csv_data['filename']
             response['Content-Disposition'] = f'attachment; filename="{filename}"'
+            response['Access-Control-Expose-Headers'] = 'Content-Disposition'
             csv_data['data'].to_csv(path_or_buf=response)
             return response
 
@@ -187,6 +188,7 @@ class EnterrpiseAdminCompletionsView(APIView):
             response = HttpResponse(content_type='text/csv')
             filename = f"Individual Completions, {start_date} - {end_date}.csv"
             response['Content-Disposition'] = f'attachment; filename="{filename}"'
+            response['Access-Control-Expose-Headers'] = 'Content-Disposition'
             dff.to_csv(path_or_buf=response, index=False)
             return response
 

enterprise_data/renderers.py

@@ -57,3 +57,17 @@ class LeaderboardCSVRenderer(CSVStreamingRenderer):
         'average_session_length',
         'course_completions',
     ]
+
+
+class IndividualEngagementsCSVRenderer(CSVStreamingRenderer):
+    """
+    Custom streaming csv renderer for advance analytics individual engagements data.
+    """
+
+    header = [
+        'email',
+        'course_title',
+        'activity_date',
+        'course_subject',
+        'learning_time_hours',
+    ]

enterprise_data/tests/admin_analytics/mock_analytics_data.py

@@ -2,7 +2,7 @@
 
 import pandas as pd
 
-from enterprise_data.admin_analytics.constants import EnrollmentChart
+from enterprise_data.admin_analytics.constants import EngagementChart, EnrollmentChart
 from enterprise_data.admin_analytics.utils import ChartType
 
 ENROLLMENTS = [
@@ -339,6 +339,30 @@ ENROLLMENT_STATS_CSVS = {
     )
 }
 
+ENGAGEMENT_STATS_CSVS = {
+    EngagementChart.ENGAGEMENTS_OVER_TIME.value: (
+        b'activity_date,certificate\n'
+        b'2021-07-19,0.0\n'
+        b'2021-07-26,4.4\n'
+        b'2021-07-27,1.2\n'
+        b'2021-08-05,3.6\n'
+        b'2021-08-21,2.7\n'
+        b'2021-09-02,1.3\n'
+        b'2021-09-21,1.5\n'
+        b'2022-05-17,0.0\n'
+    ),
+    EngagementChart.TOP_COURSES_BY_ENGAGEMENTS.value: (
+        b'course_key,course_title,certificate\n'
+        b'Kcpr+XoR30,Assimilated even-keeled focus group,0.0\n'
+        b'luGg+KNt30,Synergized reciprocal encoding,14.786944444444444\n'
+    ),
+    EngagementChart.TOP_SUBJECTS_BY_ENGAGEMENTS.value: (
+        b'course_subject,certificate\n'
+        b'business-management,14.786944444444444\n'
+        b'engineering,0.0\n'
+    )
+}
+
 
 def enrollments_dataframe():
     """Return a DataFrame of enrollments."""
@@ -509,3 +533,19 @@ COMPLETIONS_STATS_CSVS = {
         b'business-management,2\n'
     )
 }
+
+
+def engagements_csv_content():
+    """Return the CSV content of engagements."""
+    return (
+        b'email,course_title,activity_date,course_subject,learning_time_hours\r\n'
+        b'graceperez@example.com,Synergized reciprocal encoding,2022-05-17,business-management,0.0\r\n'
+        b'webertodd@example.com,Synergized reciprocal encoding,2021-09-21,business-management,1.5\r\n'
+        b'yferguson@example.net,Synergized reciprocal encoding,2021-09-02,business-management,1.3\r\n'
+        b'seth57@example.org,Synergized reciprocal encoding,2021-08-21,business-management,2.7\r\n'
+        b'padillamichelle@example.org,Synergized reciprocal encoding,2021-08-05,business-management,1.0\r\n'
+        b'weaverpatricia@example.net,Synergized reciprocal encoding,2021-08-05,business-management,2.6\r\n'
+        b'yallison@example.org,Synergized reciprocal encoding,2021-07-27,business-management,1.2\r\n'
+        b'paul77@example.org,Synergized reciprocal encoding,2021-07-26,business-management,4.4\r\n'
+        b'samanthaclarke@example.org,Synergized reciprocal encoding,2021-07-19,business-management,0.0\r\n'
+    )

enterprise_data/tests/admin_analytics/test_analytics_engagements.py

@@ -0,0 +1,390 @@
+"""Unittests for analytics_enrollments.py"""
+
+from datetime import datetime
+
+import ddt
+from mock import patch
+from rest_framework import status
+from rest_framework.reverse import reverse
+from rest_framework.test import APITransactionTestCase
+
+from enterprise_data.admin_analytics.constants import EngagementChart, ResponseType
+from enterprise_data.api.v1.serializers import AdvanceAnalyticsEngagementStatsSerializer as EngagementSerializer
+from enterprise_data.tests.admin_analytics.mock_analytics_data import (
+    ENGAGEMENT_STATS_CSVS,
+    ENGAGEMENTS,
+    engagements_csv_content,
+    engagements_dataframe,
+    enrollments_dataframe,
+)
+from enterprise_data.tests.mixins import JWTTestMixin
+from enterprise_data.tests.test_utils import UserFactory
+from enterprise_data_roles.constants import ENTERPRISE_DATA_ADMIN_ROLE
+from enterprise_data_roles.models import EnterpriseDataFeatureRole, EnterpriseDataRoleAssignment
+
+INVALID_CALCULATION_ERROR = (
+    f"Calculation must be one of {EngagementSerializer.CALCULATION_CHOICES}"
+)
+INVALID_GRANULARITY_ERROR = (
+    f"Granularity must be one of {EngagementSerializer.GRANULARITY_CHOICES}"
+)
+INVALID_CSV_ERROR1 = f"chart_type must be one of {EngagementSerializer.CHART_TYPES}"
+
+
+@ddt.ddt
+class TestIndividualEngagementsAPI(JWTTestMixin, APITransactionTestCase):
+    """Tests for AdvanceAnalyticsIndividualEngagementsView."""
+
+    def setUp(self):
+        """
+        Setup method.
+        """
+        super().setUp()
+        self.user = UserFactory(is_staff=True)
+        role, __ = EnterpriseDataFeatureRole.objects.get_or_create(
+            name=ENTERPRISE_DATA_ADMIN_ROLE
+        )
+        self.role_assignment = EnterpriseDataRoleAssignment.objects.create(
+            role=role, user=self.user
+        )
+        self.client.force_authenticate(user=self.user)
+
+        self.enterprise_uuid = "ee5e6b3a-069a-4947-bb8d-d2dbc323396c"
+        self.set_jwt_cookie()
+
+        self.url = reverse(
+            "v1:enterprise-admin-analytics-engagements",
+            kwargs={"enterprise_uuid": self.enterprise_uuid},
+        )
+
+        fetch_max_enrollment_datetime_patcher = patch(
+            'enterprise_data.admin_analytics.utils.fetch_max_enrollment_datetime',
+            return_value=datetime.now()
+        )
+
+        fetch_max_enrollment_datetime_patcher.start()
+        self.addCleanup(fetch_max_enrollment_datetime_patcher.stop)
+
+    def verify_engagement_data(self, results, results_count):
+        """Verify the received engagement data."""
+        attrs = [
+            "email",
+            "course_title",
+            "activity_date",
+            "course_subject",
+        ]
+
+        assert len(results) == results_count
+
+        filtered_data = []
+        for engagement in ENGAGEMENTS:
+            for result in results:
+                if engagement["email"] == result["email"]:
+                    data = {attr: engagement[attr] for attr in attrs}
+                    data["learning_time_hours"] = round(engagement["learning_time_seconds"] / 3600, 1)
+                    filtered_data.append(data)
+                    break
+
+        received_data = sorted(results, key=lambda x: x["email"])
+        expected_data = sorted(filtered_data, key=lambda x: x["email"])
+        assert received_data == expected_data
+
+    @patch(
+        "enterprise_data.api.v1.views.analytics_engagements.fetch_and_cache_enrollments_data"
+    )
+    @patch(
+        "enterprise_data.api.v1.views.analytics_engagements.fetch_and_cache_engagements_data"
+    )
+    def test_get(self, mock_fetch_and_cache_engagements_data, mock_fetch_and_cache_enrollments_data):
+        """
+        Test the GET method for the AdvanceAnalyticsIndividualEngagementsView works.
+        """
+        mock_fetch_and_cache_enrollments_data.return_value = enrollments_dataframe()
+        mock_fetch_and_cache_engagements_data.return_value = engagements_dataframe()
+
+        response = self.client.get(self.url, {"page_size": 2})
+        assert response.status_code == status.HTTP_200_OK
+        data = response.json()
+        assert data["next"] == f"http://testserver{self.url}?page=2&page_size=2"
+        assert data["previous"] is None
+        assert data["current_page"] == 1
+        assert data["num_pages"] == 5
+        assert data["count"] == 9
+        self.verify_engagement_data(data["results"], 2)
+
+        response = self.client.get(self.url, {"page_size": 2, "page": 2})
+        assert response.status_code == status.HTTP_200_OK
+        data = response.json()
+        assert data["next"] == f"http://testserver{self.url}?page=3&page_size=2"
+        assert data["previous"] == f"http://testserver{self.url}?page_size=2"
+        assert data["current_page"] == 2
+        assert data["num_pages"] == 5
+        assert data["count"] == 9
+        self.verify_engagement_data(data["results"], 2)
+
+        response = self.client.get(self.url, {"page_size": 2, "page": 5})
+        assert response.status_code == status.HTTP_200_OK
+        data = response.json()
+        assert data["next"] is None
+        assert data["previous"] == f"http://testserver{self.url}?page=4&page_size=2"
+        assert data["current_page"] == 5
+        assert data["num_pages"] == 5
+        assert data["count"] == 9
+        self.verify_engagement_data(data["results"], 1)
+
+        response = self.client.get(self.url, {"page_size": 9})
+        assert response.status_code == status.HTTP_200_OK
+        data = response.json()
+        assert data["next"] is None
+        assert data["previous"] is None
+        assert data["current_page"] == 1
+        assert data["num_pages"] == 1
+        assert data["count"] == 9
+        self.verify_engagement_data(data["results"], 9)
+
+    @patch(
+        "enterprise_data.api.v1.views.analytics_engagements.fetch_and_cache_enrollments_data"
+    )
+    @patch(
+        "enterprise_data.api.v1.views.analytics_engagements.fetch_and_cache_engagements_data"
+    )
+    def test_get_csv(self, mock_fetch_and_cache_engagements_data, mock_fetch_and_cache_enrollments_data):
+        """
+        Test the GET method for the AdvanceAnalyticsIndividualEngagementsView return correct CSV data.
+        """
+        mock_fetch_and_cache_enrollments_data.return_value = enrollments_dataframe()
+        mock_fetch_and_cache_engagements_data.return_value = engagements_dataframe()
+        start_date = enrollments_dataframe().enterprise_enrollment_date.min().strftime('%Y/%m/%d')
+        end_date = datetime.now().strftime('%Y/%m/%d')
+        response = self.client.get(self.url, {"response_type": ResponseType.CSV.value})
+        assert response.status_code == status.HTTP_200_OK
+
+        # verify the response headers
+        assert response["Content-Type"] == "text/csv"
+        filename = f"""Individual Engagements, {start_date} - {end_date}.csv"""
+        assert (
+            response["Content-Disposition"] == f'attachment; filename="{filename}"'
+        )
+
+        # verify the response content
+        content = b"".join(response.streaming_content)
+        assert content == engagements_csv_content()
+
+    @ddt.data(
+        {
+            "params": {"start_date": 1},
+            "error": {
+                "start_date": [
+                    "Date has wrong format. Use one of these formats instead: YYYY-MM-DD."
+                ]
+            },
+        },
+        {
+            "params": {"end_date": 2},
+            "error": {
+                "end_date": [
+                    "Date has wrong format. Use one of these formats instead: YYYY-MM-DD."
+                ]
+            },
+        },
+        {
+            "params": {"start_date": "2024-01-01", "end_date": "2023-01-01"},
+            "error": {
+                "non_field_errors": [
+                    "start_date should be less than or equal to end_date."
+                ]
+            },
+        },
+        {
+            "params": {"calculation": "invalid"},
+            "error": {"calculation": [INVALID_CALCULATION_ERROR]},
+        },
+        {
+            "params": {"granularity": "invalid"},
+            "error": {"granularity": [INVALID_GRANULARITY_ERROR]},
+        },
+        {"params": {"chart_type": "invalid"}, "error": {"chart_type": [INVALID_CSV_ERROR1]}},
+    )
+    @ddt.unpack
+    def test_get_invalid_query_params(self, params, error):
+        """
+        Test the GET method return correct error if any query param value is incorrect.
+        """
+        response = self.client.get(self.url, params)
+        assert response.status_code == status.HTTP_400_BAD_REQUEST
+        assert response.json() == error
+
+
+@ddt.ddt
+class TestEngagementStatsAPI(JWTTestMixin, APITransactionTestCase):
+    """Tests for AdvanceAnalyticsEngagementStatsView."""
+
+    def setUp(self):
+        """
+        Setup method.
+        """
+        super().setUp()
+        self.user = UserFactory(is_staff=True)
+        role, __ = EnterpriseDataFeatureRole.objects.get_or_create(
+            name=ENTERPRISE_DATA_ADMIN_ROLE
+        )
+        self.role_assignment = EnterpriseDataRoleAssignment.objects.create(
+            role=role, user=self.user
+        )
+        self.client.force_authenticate(user=self.user)
+
+        self.enterprise_uuid = "ee5e6b3a-069a-4947-bb8d-d2dbc323396c"
+        self.set_jwt_cookie()
+
+        self.url = reverse(
+            "v1:enterprise-admin-analytics-engagements-stats",
+            kwargs={"enterprise_uuid": self.enterprise_uuid},
+        )
+
+        fetch_max_enrollment_datetime_patcher = patch(
+            'enterprise_data.admin_analytics.utils.fetch_max_enrollment_datetime',
+            return_value=datetime.now()
+        )
+
+        fetch_max_enrollment_datetime_patcher.start()
+        self.addCleanup(fetch_max_enrollment_datetime_patcher.stop)
+
+    def verify_engagement_data(self, results):
+        """Verify the received engagement data."""
+        attrs = [
+            "email",
+            "course_title",
+            "activity_date",
+            "course_subject",
+        ]
+
+        filtered_data = []
+        for engagement in ENGAGEMENTS:
+            for result in results:
+                if engagement["email"] == result["email"]:
+                    data = {attr: engagement[attr] for attr in attrs}
+                    data["learning_time_hours"] = round(engagement["learning_time_seconds"] / 3600, 1)
+                    filtered_data.append(data)
+                    break
+
+        received_data = sorted(results, key=lambda x: x["email"])
+        expected_data = sorted(filtered_data, key=lambda x: x["email"])
+        assert received_data == expected_data
+
+    @patch(
+        "enterprise_data.api.v1.views.analytics_engagements.fetch_and_cache_enrollments_data"
+    )
+    @patch(
+        "enterprise_data.api.v1.views.analytics_engagements.fetch_and_cache_engagements_data"
+    )
+    def test_get(self, mock_fetch_and_cache_engagements_data, mock_fetch_and_cache_enrollments_data):
+        """
+        Test the GET method for the AdvanceAnalyticsEnrollmentStatsView works.
+        """
+        mock_fetch_and_cache_enrollments_data.return_value = enrollments_dataframe()
+        mock_fetch_and_cache_engagements_data.return_value = engagements_dataframe()
+
+        response = self.client.get(self.url)
+        assert response.status_code == status.HTTP_200_OK
+        data = response.json()
+        assert data == {
+            'engagements_over_time': [
+                {'activity_date': '2021-07-19T00:00:00', 'enroll_type': 'certificate', 'sum': 0.0},
+                {'activity_date': '2021-07-26T00:00:00', 'enroll_type': 'certificate', 'sum': 4.4},
+                {'activity_date': '2021-07-27T00:00:00', 'enroll_type': 'certificate', 'sum': 1.2},
+                {'activity_date': '2021-08-05T00:00:00', 'enroll_type': 'certificate', 'sum': 3.6},
+                {'activity_date': '2021-08-21T00:00:00', 'enroll_type': 'certificate', 'sum': 2.7},
+                {'activity_date': '2021-09-02T00:00:00', 'enroll_type': 'certificate', 'sum': 1.3},
+                {'activity_date': '2021-09-21T00:00:00', 'enroll_type': 'certificate', 'sum': 1.5},
+                {'activity_date': '2022-05-17T00:00:00', 'enroll_type': 'certificate', 'sum': 0.0}
+            ],
+            'top_courses_by_engagement': [
+                {
+                    'course_key': 'Kcpr+XoR30',
+                    'course_title': 'Assimilated even-keeled focus group',
+                    'enroll_type': 'certificate',
+                    'count': 0.0
+                },
+                {
+                    'course_key': 'luGg+KNt30',
+                    'course_title': 'Synergized reciprocal encoding',
+                    'enroll_type': 'certificate',
+                    'count': 14.786944444444444
+                }
+            ],
+            'top_subjects_by_engagement': [
+                {
+                    'course_subject': 'business-management',
+                    'enroll_type': 'certificate',
+                    'count': 14.786944444444444
+                },
+                {
+                    'course_subject': 'engineering',
+                    'enroll_type': 'certificate',
+                    'count': 0.0
+                }
+            ]
+        }
+
+    @patch("enterprise_data.api.v1.views.analytics_engagements.fetch_and_cache_enrollments_data")
+    @patch("enterprise_data.api.v1.views.analytics_engagements.fetch_and_cache_engagements_data")
+    @ddt.data(
+        EngagementChart.ENGAGEMENTS_OVER_TIME.value,
+        EngagementChart.TOP_COURSES_BY_ENGAGEMENTS.value,
+        EngagementChart.TOP_SUBJECTS_BY_ENGAGEMENTS.value,
+    )
+    def test_get_csv(self, chart_type, mock_fetch_and_cache_engagements_data, mock_fetch_and_cache_enrollments_data):
+        """
+        Test that AdvanceAnalyticsEngagementStatsView return correct CSV data.
+        """
+        mock_fetch_and_cache_enrollments_data.return_value = enrollments_dataframe()
+        mock_fetch_and_cache_engagements_data.return_value = engagements_dataframe()
+        response = self.client.get(self.url, {"response_type": ResponseType.CSV.value, "chart_type": chart_type})
+        assert response.status_code == status.HTTP_200_OK
+        assert response["Content-Type"] == "text/csv"
+        # verify the response content
+        assert response.content == ENGAGEMENT_STATS_CSVS[chart_type]
+
+    @ddt.data(
+        {
+            "params": {"start_date": 1},
+            "error": {
+                "start_date": [
+                    "Date has wrong format. Use one of these formats instead: YYYY-MM-DD."
+                ]
+            },
+        },
+        {
+            "params": {"end_date": 2},
+            "error": {
+                "end_date": [
+                    "Date has wrong format. Use one of these formats instead: YYYY-MM-DD."
+                ]
+            },
+        },
+        {
+            "params": {"start_date": "2024-01-01", "end_date": "2023-01-01"},
+            "error": {
+                "non_field_errors": [
+                    "start_date should be less than or equal to end_date."
+                ]
+            },
+        },
+        {
+            "params": {"calculation": "invalid"},
+            "error": {"calculation": [INVALID_CALCULATION_ERROR]},
+        },
+        {
+            "params": {"granularity": "invalid"},
+            "error": {"granularity": [INVALID_GRANULARITY_ERROR]},
+        },
+        {"params": {"chart_type": "invalid"}, "error": {"chart_type": [INVALID_CSV_ERROR1]}},
+    )
+    @ddt.unpack
+    def test_get_invalid_query_params(self, params, error):
+        """
+        Test the GET method return correct error if any query param value is incorrect.
+        """
+        response = self.client.get(self.url, params)
+        assert response.status_code == status.HTTP_400_BAD_REQUEST
+        assert response.json() == error