edx-enterprise-data 8.6.1__tar.gz → 8.8.0__tar.gz

{edx_enterprise_data-8.6.1 → edx_enterprise_data-8.8.0}/CHANGELOG.rst

@@ -16,6 +16,15 @@ Unreleased
 
 =========================
 
+[8.8.0] - 2024-08-15
+---------------------
+  * feat: Add API endpoints for advance analytics leaderboard data
+  * refactor: Use `response_type` and `chart_type` in advance analytics enrollments API endpoints
+
+[8.7.0] - 2024-08-13
+---------------------
+  * feat: add endpoints to get completion data for an enterprise customer
+
 [8.6.1] - 2024-08-12
 ---------------------
   * Dependency updates

{edx_enterprise_data-8.6.1/edx_enterprise_data.egg-info → edx_enterprise_data-8.8.0}/PKG-INFO

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

{edx_enterprise_data-8.6.1 → edx_enterprise_data-8.8.0/edx_enterprise_data.egg-info}/PKG-INFO

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

{edx_enterprise_data-8.6.1 → edx_enterprise_data-8.8.0}/edx_enterprise_data.egg-info/SOURCES.txt

@@ -21,6 +21,7 @@ enterprise_data/signals.py
 enterprise_data/urls.py
 enterprise_data/utils.py
 enterprise_data/admin_analytics/__init__.py
+enterprise_data/admin_analytics/completions_utils.py
 enterprise_data/admin_analytics/constants.py
 enterprise_data/admin_analytics/data_loaders.py
 enterprise_data/admin_analytics/database.py
@@ -37,8 +38,10 @@ enterprise_data/api/v1/serializers.py
 enterprise_data/api/v1/urls.py
 enterprise_data/api/v1/views/__init__.py
 enterprise_data/api/v1/views/analytics_enrollments.py
+enterprise_data/api/v1/views/analytics_leaderboard.py
 enterprise_data/api/v1/views/base.py
 enterprise_data/api/v1/views/enterprise_admin.py
+enterprise_data/api/v1/views/enterprise_completions.py
 enterprise_data/api/v1/views/enterprise_learner.py
 enterprise_data/api/v1/views/enterprise_offers.py
 enterprise_data/fixtures/enterprise_enrollment.json
@@ -112,9 +115,12 @@ enterprise_data/tests/test_models.py
 enterprise_data/tests/test_utils.py
 enterprise_data/tests/test_views.py
 enterprise_data/tests/admin_analytics/__init__.py
+enterprise_data/tests/admin_analytics/mock_analytics_data.py
 enterprise_data/tests/admin_analytics/mock_enrollments.py
 enterprise_data/tests/admin_analytics/test_analytics_enrollments.py
+enterprise_data/tests/admin_analytics/test_analytics_leaderboard.py
 enterprise_data/tests/admin_analytics/test_data_loaders.py
+enterprise_data/tests/admin_analytics/test_enterprise_completions.py
 enterprise_data/tests/admin_analytics/test_utils.py
 enterprise_data/tests/api/__init__.py
 enterprise_data/tests/api/v0/__init__.py

{edx_enterprise_data-8.6.1 → edx_enterprise_data-8.8.0}/enterprise_data/__init__.py

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

edx_enterprise_data-8.8.0/enterprise_data/admin_analytics/completions_utils.py

@@ -0,0 +1,261 @@
+"""This module contains utility functions for completions analytics."""
+from enterprise_data.utils import date_filter
+
+
+def date_aggregation(level, group, date, df, type_="count"):
+    """Perform date aggregation on a DataFrame.
+
+    This function aggregates data based on the specified level of aggregation (e.g., daily, weekly, monthly, quarterly)
+    and returns the aggregated data.
+
+    Args:
+        level (str): The level of aggregation. Possible values are "Daily", "Weekly", "Monthly", and "Quarterly".
+        group (list): A list of column names to group the data by.
+        date (str): The name of the date column in the DataFrame.
+        df (pandas.DataFrame): The DataFrame containing the data to be aggregated.
+        type_ (str, optional): The type of aggregation to perform. Possible values
+            are "count" and "sum". Defaults to "count".
+
+    Returns:
+        pandas.DataFrame: The aggregated data.
+
+    """
+    if type_ == "count":
+        if level == "Daily":
+            df = df.groupby(group).size().reset_index()
+            group.append("count")
+            df.columns = group
+        elif level == "Weekly":
+            df[date] = df[date].dt.to_period("W").dt.start_time
+            df = df.groupby(group).size().reset_index()
+            group.append("count")
+            df.columns = group
+        elif level == "Monthly":
+            df[date] = df[date].dt.to_period("M").dt.start_time
+            df = df.groupby(group).size().reset_index()
+            group.append("count")
+            df.columns = group
+        elif level == "Quarterly":
+            df[date] = df[date].dt.to_period("Q").dt.start_time
+            df = df.groupby(group).size().reset_index()
+            group.append("count")
+            df.columns = group
+    elif type_ == "sum":
+        if level == "Daily":
+            df = df.groupby(group).sum().reset_index()
+            group.append("sum")
+            df.columns = group
+        elif level == "Weekly":
+            df[date] = df[date].dt.to_period("W").dt.start_time
+            df = df.groupby(group).sum().reset_index()
+            group.append("sum")
+            df.columns = group
+        elif level == "Monthly":
+            df[date] = df[date].dt.to_period("M").dt.start_time
+            df = df.groupby(group).sum().reset_index()
+            group.append("sum")
+            df.columns = group
+        elif level == "Quarterly":
+            df[date] = df[date].dt.to_period("Q").dt.start_time
+            df = df.groupby(group).sum().reset_index()
+            group.append("sum")
+            df.columns = group
+
+    return df
+
+
+def calculation(calc, df, type_="count"):
+    """Perform a calculation on the given DataFrame based on the specified calculation type.
+
+    Args:
+        calc (str): The calculation type. Possible values are "Total", "Running Total",
+                    "Moving Average (3 Period)", and "Moving Average (7 Period)".
+        df (pandas.DataFrame): The filtered enrollments data.
+        type_ (str, optional): The type of calculation to perform. Default is "count".
+
+    Returns:
+        pandas.DataFrame: The aggregated data after performing the calculation.
+    """
+    if type_ == "count":
+        if calc == "Total":
+            pass
+        elif calc == "Running Total":
+            df["count"] = df.groupby("enroll_type")["count"].cumsum()
+        elif calc == "Moving Average (3 Period)":
+            df["count"] = (
+                df.groupby("enroll_type")["count"]
+                .rolling(3)
+                .mean()
+                .droplevel(level=[0])
+            )
+        elif calc == "Moving Average (7 Period)":
+            df["count"] = (
+                df.groupby("enroll_type")["count"]
+                .rolling(7)
+                .mean()
+                .droplevel(level=[0])
+            )
+    elif type_ == "sum":
+        if calc == "Total":
+            pass
+        elif calc == "Running Total":
+            df["sum"] = df.groupby("enroll_type")["sum"].cumsum()
+        elif calc == "Moving Average (3 Period)":
+            df["sum"] = (
+                df.groupby("enroll_type")["sum"].rolling(3).mean().droplevel(level=[0])
+            )
+        elif calc == "Moving Average (7 Period)":
+            df["sum"] = (
+                df.groupby("enroll_type")["sum"].rolling(7).mean().droplevel(level=[0])
+            )
+
+    return df
+
+
+def get_completions_over_time(start_date, end_date, dff, date_agg, calc):
+    """Get agreggated data for completions over time graph.
+
+    Args:
+        start_date (datetime): The start date for the date filter.
+        end_date (datetime): The end date for the date filter.
+        dff (pandas.DataFrame): enrollments data
+        date_agg (str): It denotes the granularity of the aggregated date which can be Daily, Weekly, Monthly, Quarterly
+        calc (str): Calculations denoiated the period for the running averages. It can be Total, Running Total, Moving
+            Average (3 Period), Moving Average (7 Period)
+    """
+
+    dff = dff[dff["has_passed"] == 1]
+
+    # Date filtering.
+    dff = date_filter(start=start_date, end=end_date, data_frame=dff, date_column="passed_date")
+
+    # Date aggregation.
+    dff = date_aggregation(
+        level=date_agg, group=["passed_date", "enroll_type"], date="passed_date", df=dff
+    )
+
+    # Calculating metric.
+    dff = calculation(calc=calc, df=dff)
+
+    return dff
+
+
+def get_top_courses_by_completions(start_date, end_date, dff):
+    """Get top 10 courses by completions.
+
+    Args:
+        start_date (datetime): The start date for the date filter.
+        end_date (datetime): The end date for the date filter.
+        dff (pandas.DataFrame): Enrollments data
+    """
+
+    dff = dff[dff["has_passed"] == 1]
+
+    # Date filtering.
+    dff = date_filter(start=start_date, end=end_date, data_frame=dff, date_column="passed_date")
+
+    courses = list(
+        dff.groupby(["course_key"]).size().sort_values(ascending=False)[:10].index
+    )
+
+    dff = (
+        dff[dff.course_key.isin(courses)]
+        .groupby(["course_key", "course_title", "enroll_type"])
+        .size()
+        .reset_index()
+    )
+    dff.columns = ["course_key", "course_title", "enroll_type", "count"]
+
+    return dff
+
+
+def get_top_subjects_by_completions(start_date, end_date, dff):
+    """Get top 10 subjects by completions.
+
+    Args:
+        start_date (datetime): The start date for the date filter.
+        end_date (datetime): The end date for the date filter.
+        dff (pandas.DataFrame): Enrollments data
+    """
+
+    dff = dff[dff["has_passed"] == 1]
+
+    # Date filtering.
+    dff = date_filter(start=start_date, end=end_date, data_frame=dff, date_column="passed_date")
+
+    subjects = list(
+        dff.groupby(["course_subject"]).size().sort_values(ascending=False)[:10].index
+    )
+
+    dff = (
+        dff[dff.course_subject.isin(subjects)]
+        .groupby(["course_subject", "enroll_type"])
+        .size()
+        .reset_index()
+    )
+    dff.columns = ["course_subject", "enroll_type", "count"]
+
+    return dff
+
+
+def get_csv_data_for_completions_over_time(
+    start_date, end_date, enrollments, date_agg, calc
+):
+    """Get csv data for completions over time graph.
+
+    Args:
+        start_date (datetime): The start date for the date filter.
+        end_date (datetime): The end date for the date filter.
+        enrollments (pandas.DataFrame): Filtered enrollments data
+        date_agg (str): it denotes the granularity of the aggregated date which can be Daily, Weekly, Monthly, Quarterly
+        calc (str): calculations denoiated the period for the running averages. It can be Total, Running Total, Moving
+            Average (3 Period), Moving Average (7 Period)
+
+    Returns:
+        dict: csv data
+    """
+
+    dff = get_completions_over_time(start_date, end_date, enrollments, date_agg, calc)
+    dff = dff.pivot(index="passed_date", columns="enroll_type", values="count")
+    filename = (
+        f"Completions Timeseries, {start_date} - {end_date} ({date_agg} {calc}).csv"
+    )
+    return {"filename": filename, "data": dff}
+
+
+def get_csv_data_for_top_courses_by_completions(start_date, end_date, enrollments):
+    """Get csv data for top 10 courses by completions.
+
+    Args:
+        start_date (datetime): The start date for the date filter.
+        end_date (datetime): The end date for the date filter.
+        enrollments (pandas.DataFrame): Filtered enrollments data
+
+    Returns:
+        dict: csv data
+    """
+
+    dff = get_top_courses_by_completions(start_date, end_date, enrollments)
+    dff = dff.pivot(
+        index=["course_key", "course_title"], columns="enroll_type", values="count"
+    )
+    filename = f"Top 10 Courses by Completions, {start_date} - {end_date}.csv"
+    return {"filename": filename, "data": dff}
+
+
+def get_csv_data_for_top_subjects_by_completions(start_date, end_date, enrollments):
+    """Get csv data for top 10 subjects by completions.
+
+    Args:
+        start_date (datetime): The start date for the date filter.
+        end_date (datetime): The end date for the date filter.
+        enrollments (pandas.DataFrame): Filtered enrollments data
+
+    Returns:
+        dict: csv data
+    """
+
+    dff = get_top_subjects_by_completions(start_date, end_date, enrollments)
+    dff = dff.pivot(index="course_subject", columns="enroll_type", values="count")
+    filename = f"Top 10 Subjects by Completions, {start_date} - {end_date}.csv"
+    return {"filename": filename, "data": dff}

{edx_enterprise_data-8.6.1 → edx_enterprise_data-8.8.0}/enterprise_data/admin_analytics/constants.py

@@ -3,7 +3,7 @@
 from enum import Enum
 
 
-class GRANULARITY(Enum):
+class Granularity(Enum):
     """Granularity choices"""
     DAILY = 'Daily'
     WEEKLY = 'Weekly'
@@ -11,7 +11,7 @@ class GRANULARITY(Enum):
     QUARTERLY = 'Quarterly'
 
 
-class CALCULATION(Enum):
+class Calculation(Enum):
     """Calculation choices"""
     TOTAL = 'Total'
     RUNNING_TOTAL = 'Running Total'
@@ -19,9 +19,15 @@ class CALCULATION(Enum):
     MOVING_AVERAGE_7_PERIOD = 'Moving Average (7 Period)'
 
 
-class ENROLLMENT_CSV(Enum):
+class EnrollmentChart(Enum):
     """CSV choices"""
     ENROLLMENTS_OVER_TIME = 'enrollments_over_time'
     TOP_COURSES_BY_ENROLLMENTS = 'top_courses_by_enrollments'
     TOP_SUBJECTS_BY_ENROLLMENTS = 'top_subjects_by_enrollments'
     INDIVIDUAL_ENROLLMENTS = 'individual_enrollments'
+
+
+class ResponseType(Enum):
+    """Response type choices"""
+    JSON = 'json'
+    CSV = 'csv'

{edx_enterprise_data-8.6.1 → edx_enterprise_data-8.8.0}/enterprise_data/admin_analytics/utils.py

@@ -1,13 +1,18 @@
 """
 Utility functions for fetching data from the database.
 """
-from datetime import datetime
+from datetime import datetime, timedelta
 from enum import Enum
 
 from edx_django_utils.cache import TieredCache, get_cache_key
 
-from enterprise_data.admin_analytics.constants import CALCULATION, GRANULARITY
-from enterprise_data.admin_analytics.data_loaders import fetch_engagement_data, fetch_enrollment_data, fetch_skills_data
+from enterprise_data.admin_analytics.constants import Calculation, Granularity
+from enterprise_data.admin_analytics.data_loaders import (
+    fetch_engagement_data,
+    fetch_enrollment_data,
+    fetch_max_enrollment_datetime,
+    fetch_skills_data,
+)
 from enterprise_data.utils import date_filter, primary_subject_truncate
 
 
@@ -18,6 +23,40 @@ class ChartType(Enum):
     BUBBLE = 'bubble'
     TOP_SKILLS_ENROLLMENT = 'top_skills_enrollment'
     TOP_SKILLS_COMPLETION = 'top_skills_completion'
+    COMPLETIONS_OVER_TIME = 'completions_over_time'
+    TOP_COURSES_BY_COMPLETIONS = 'top_courses_by_completions'
+    TOP_SUBJECTS_BY_COMPLETIONS = 'top_subjects_by_completions'
+
+
+def fetch_enrollments_cache_expiry_timestamp():
+    """Calculate cache expiry timestamp"""
+    # TODO: Implement correct cache expiry logic for `enrollments` data.
+    #       Current cache expiry logic is based on `enterprise_learner_enrollment` table,
+    #       Which has nothing to do with the `enrollments` data. Instead cache expiry should
+    #       be based on `fact_enrollment_admin_dash` table. Currently we have no timestamp in
+    #       `fact_enrollment_admin_dash` table that can be used for cache expiry. Add a new
+    #       column in the table for this purpose and then use that column for cache expiry.
+    last_updated_at = fetch_max_enrollment_datetime()
+    cache_expiry = (
+        last_updated_at + timedelta(days=1) if last_updated_at else datetime.now()
+    )
+    return cache_expiry
+
+
+def fetch_engagements_cache_expiry_timestamp():
+    """Calculate cache expiry timestamp"""
+    # TODO: Implement correct cache expiry logic for `engagements` data.
+    #       Current cache expiry logic is based on `enterprise_learner_enrollment` table,
+    #       Which has nothing to do with the `engagements` data. Instead cache expiry should
+    #       be based on `fact_enrollment_engagement_day_admin_dash` table. Currently we have
+    #       no timestamp in `fact_enrollment_engagement_day_admin_dash` table that can be used
+    #       for cache expiry. Add a new column in the table for this purpose and then use that
+    #       column for cache expiry.
+    last_updated_at = fetch_max_enrollment_datetime()
+    cache_expiry = (
+        last_updated_at + timedelta(days=1) if last_updated_at else datetime.now()
+    )
+    return cache_expiry
 
 
 def granularity_aggregation(level, group, date, data_frame, aggregation_type="count"):
@@ -25,9 +64,9 @@ def granularity_aggregation(level, group, date, data_frame, aggregation_type="co
     df = data_frame
 
     period_mapping = {
-        GRANULARITY.WEEKLY.value: "W",
-        GRANULARITY.MONTHLY.value: "M",
-        GRANULARITY.QUARTERLY.value: "Q"
+        Granularity.WEEKLY.value: "W",
+        Granularity.MONTHLY.value: "M",
+        Granularity.QUARTERLY.value: "Q"
     }
 
     if level in period_mapping:
@@ -49,15 +88,15 @@ def calculation_aggregation(calc, data_frame, aggregation_type="count"):
     df = data_frame
 
     window_mapping = {
-        CALCULATION.MOVING_AVERAGE_3_PERIOD.value: 3,
-        CALCULATION.MOVING_AVERAGE_7_PERIOD.value: 7,
+        Calculation.MOVING_AVERAGE_3_PERIOD.value: 3,
+        Calculation.MOVING_AVERAGE_7_PERIOD.value: 7,
     }
 
     aggregation_column = "count" if aggregation_type == "count" else "sum"
 
-    if calc == CALCULATION.RUNNING_TOTAL.value:
+    if calc == Calculation.RUNNING_TOTAL.value:
         df[aggregation_column] = df.groupby("enroll_type")[aggregation_column].cumsum()
-    elif calc in [CALCULATION.MOVING_AVERAGE_3_PERIOD.value, CALCULATION.MOVING_AVERAGE_7_PERIOD.value]:
+    elif calc in [Calculation.MOVING_AVERAGE_3_PERIOD.value, Calculation.MOVING_AVERAGE_7_PERIOD.value]:
         df[aggregation_column] = (
             df.groupby("enroll_type")[aggregation_column]
             .rolling(window_mapping[calc])
@@ -172,7 +211,7 @@ def get_skills_bubble_chart_df(skills_filtered):
     """ Get the skills data for the bubble chart.
 
     Args:
-        skills_filtered (list): The skills data.
+        skills_filtered (pandas.DataFrame): The skills data.
 
     Returns:
         (pandas.DataFrame): The skills data for the bubble chart.

{edx_enterprise_data-8.6.1 → edx_enterprise_data-8.8.0}/enterprise_data/api/v1/paginators.py

@@ -72,7 +72,7 @@ class AdvanceAnalyticsPagination(PageNumberPagination):
         max_page_size (int): The maximum allowed page size.
     """
     page_size_query_param = "page_size"
-    page_size = 10
+    page_size = 50
     max_page_size = 100
 
     def paginate_queryset(self, queryset, request, view=None):

{edx_enterprise_data-8.6.1 → edx_enterprise_data-8.8.0}/enterprise_data/api/v1/serializers.py

@@ -5,7 +5,7 @@ from uuid import UUID
 
 from rest_framework import serializers
 
-from enterprise_data.admin_analytics.constants import CALCULATION, ENROLLMENT_CSV, GRANULARITY
+from enterprise_data.admin_analytics.constants import Calculation, EnrollmentChart, Granularity, ResponseType
 from enterprise_data.models import (
     EnterpriseAdminLearnerProgress,
     EnterpriseAdminSummarizeInsights,
@@ -206,6 +206,11 @@ class AdminAnalyticsAggregatesQueryParamsSerializer(serializers.Serializer):  #
     """
     start_date = serializers.DateField(required=False)
     end_date = serializers.DateField(required=False)
+    granularity = serializers.CharField(required=False)
+    calculation = serializers.CharField(required=False)
+    response_type = serializers.CharField(required=False)
+    page = serializers.IntegerField(required=False)
+    chart_type = serializers.CharField(required=False)
 
     def validate(self, attrs):
         """
@@ -232,23 +237,28 @@ class EnterpriseExecEdLCModulePerformanceSerializer(serializers.ModelSerializer)
 
 class AdvanceAnalyticsQueryParamSerializer(serializers.Serializer):  # pylint: disable=abstract-method
     """Serializer for validating query params"""
+    RESPONSE_TYPES = [
+        ResponseType.JSON.value,
+        ResponseType.CSV.value
+    ]
     GRANULARITY_CHOICES = [
-        GRANULARITY.DAILY.value,
-        GRANULARITY.WEEKLY.value,
-        GRANULARITY.MONTHLY.value,
-        GRANULARITY.QUARTERLY.value
+        Granularity.DAILY.value,
+        Granularity.WEEKLY.value,
+        Granularity.MONTHLY.value,
+        Granularity.QUARTERLY.value
     ]
     CALCULATION_CHOICES = [
-        CALCULATION.TOTAL.value,
-        CALCULATION.RUNNING_TOTAL.value,
-        CALCULATION.MOVING_AVERAGE_3_PERIOD.value,
-        CALCULATION.MOVING_AVERAGE_7_PERIOD.value
+        Calculation.TOTAL.value,
+        Calculation.RUNNING_TOTAL.value,
+        Calculation.MOVING_AVERAGE_3_PERIOD.value,
+        Calculation.MOVING_AVERAGE_7_PERIOD.value
     ]
 
     start_date = serializers.DateField(required=False)
     end_date = serializers.DateField(required=False)
     granularity = serializers.CharField(required=False)
     calculation = serializers.CharField(required=False)
+    response_type = serializers.CharField(required=False)
 
     def validate(self, attrs):
         """
@@ -265,6 +275,17 @@ class AdvanceAnalyticsQueryParamSerializer(serializers.Serializer):  # pylint: d
 
         return attrs
 
+    def validate_response_type(self, value):
+        """
+        Validate the response_type value.
+
+        Raises:
+            serializers.ValidationError: If response_type is not one of the valid choices in `RESPONSE_TYPES`.
+        """
+        if value not in self.RESPONSE_TYPES:
+            raise serializers.ValidationError(f"response_type must be one of {self.RESPONSE_TYPES}")
+        return value
+
     def validate_granularity(self, value):
         """
         Validate the granularity value.
@@ -288,32 +309,25 @@ class AdvanceAnalyticsQueryParamSerializer(serializers.Serializer):  # pylint: d
         return value
 
 
-class AdvanceAnalyticsEnrollmentSerializer(AdvanceAnalyticsQueryParamSerializer):  # pylint: disable=abstract-method
-    """Serializer for validating Advance Analytics Enrollments API"""
-    CSV_TYPES = [
-        ENROLLMENT_CSV.INDIVIDUAL_ENROLLMENTS.value
+class AdvanceAnalyticsEnrollmentStatsSerializer(
+    AdvanceAnalyticsQueryParamSerializer
+):  # pylint: disable=abstract-method
+    """Serializer for validating Advance Analytics Enrollments Stats API"""
+    CHART_TYPES = [
+        EnrollmentChart.ENROLLMENTS_OVER_TIME.value,
+        EnrollmentChart.TOP_COURSES_BY_ENROLLMENTS.value,
+        EnrollmentChart.TOP_SUBJECTS_BY_ENROLLMENTS.value
     ]
 
-    csv_type = serializers.CharField(required=False)
+    chart_type = serializers.CharField(required=False)
 
-    def validate_csv_type(self, value):
+    def validate_chart_type(self, value):
         """
-        Validate the csv_type value.
+        Validate the chart_type value.
 
         Raises:
-            serializers.ValidationError: If csv_type is not one of the valid choices
+            serializers.ValidationError: If chart_type is not one of the valid choices
         """
-        if value not in self.CSV_TYPES:
-            raise serializers.ValidationError(f"csv_type must be one of {self.CSV_TYPES}")
+        if value not in self.CHART_TYPES:
+            raise serializers.ValidationError(f"chart_type must be one of {self.CHART_TYPES}")
         return value
-
-
-class AdvanceAnalyticsEnrollmentStatsSerializer(
-    AdvanceAnalyticsEnrollmentSerializer
-):  # pylint: disable=abstract-method
-    """Serializer for validating Advance Analytics Enrollments Stats API"""
-    CSV_TYPES = [
-        ENROLLMENT_CSV.ENROLLMENTS_OVER_TIME.value,
-        ENROLLMENT_CSV.TOP_COURSES_BY_ENROLLMENTS.value,
-        ENROLLMENT_CSV.TOP_SUBJECTS_BY_ENROLLMENTS.value
-    ]

{edx_enterprise_data-8.6.1 → edx_enterprise_data-8.8.0}/enterprise_data/api/v1/urls.py

@@ -8,12 +8,14 @@ from rest_framework.routers import DefaultRouter
 from django.urls import re_path
 
 from enterprise_data.api.v1.views import enterprise_admin as enterprise_admin_views
+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_enrollments import (
     AdvanceAnalyticsEnrollmentStatsView,
     AdvanceAnalyticsIndividualEnrollmentsView,
 )
+from enterprise_data.api.v1.views.analytics_leaderboard import AdvanceAnalyticsLeaderboardView
 from enterprise_data.constants import UUID4_REGEX
 
 app_name = 'enterprise_data_api_v1'
@@ -52,25 +54,40 @@ urlpatterns = [
         name='enterprise-admin-insights'
     ),
     re_path(
-        fr'^admin/anlaytics/(?P<enterprise_id>{UUID4_REGEX})$',
+        fr'^admin/analytics/(?P<enterprise_id>{UUID4_REGEX})$',
         enterprise_admin_views.EnterpriseAdminAnalyticsAggregatesView.as_view(),
         name='enterprise-admin-analytics-aggregates'
     ),
     re_path(
-        fr'^admin/anlaytics/(?P<enterprise_uuid>{UUID4_REGEX})/enrollments/stats$',
+        fr'^admin/analytics/(?P<enterprise_uuid>{UUID4_REGEX})/leaderboard$',
+        AdvanceAnalyticsLeaderboardView.as_view(),
+        name='enterprise-admin-analytics-leaderboard'
+    ),
+    re_path(
+        fr'^admin/analytics/(?P<enterprise_uuid>{UUID4_REGEX})/enrollments/stats$',
         AdvanceAnalyticsEnrollmentStatsView.as_view(),
         name='enterprise-admin-analytics-enrollments-stats'
     ),
     re_path(
-        fr'^admin/anlaytics/(?P<enterprise_uuid>{UUID4_REGEX})/enrollments$',
+        fr'^admin/analytics/(?P<enterprise_uuid>{UUID4_REGEX})/enrollments$',
         AdvanceAnalyticsIndividualEnrollmentsView.as_view(),
         name='enterprise-admin-analytics-enrollments'
     ),
     re_path(
-        fr'^admin/anlaytics/(?P<enterprise_id>{UUID4_REGEX})/skills/stats',
+        fr'^admin/analytics/(?P<enterprise_id>{UUID4_REGEX})/skills/stats',
         enterprise_admin_views.EnterpriseAdminAnalyticsSkillsView.as_view(),
         name='enterprise-admin-analytics-skills'
     ),
+    re_path(
+        fr'^admin/analytics/(?P<enterprise_id>{UUID4_REGEX})/completions/stats$',
+        enterprise_completions_views.EnterrpiseAdminCompletionsStatsView.as_view(),
+        name='enterprise-admin-analytics-completions-stats'
+    ),
+    re_path(
+        fr'^admin/analytics/(?P<enterprise_id>{UUID4_REGEX})/completions$',
+        enterprise_completions_views.EnterrpiseAdminCompletionsView.as_view(),
+        name='enterprise-admin-analytics-completions'
+    ),
 ]
 
 urlpatterns += router.urls