Add admin action to downgrade learners enrollment (#3055)

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

Author: annagav

courses/admin.py

@@ -9,6 +9,7 @@
 from django.urls import reverse
 from mitol.common.admin import TimestampedModelAdmin
 
+from courses.api import downgrade_learner
 from courses.forms import ProgramAdminForm
 from courses.models import (
     BlockedCountry,
@@ -266,7 +267,7 @@ class CourseRunEnrollmentAdmin(ModelAdminRunActionsForAllMixin, AuditableModelAd
     inlines = [
         CourseRunEnrollmentAuditInline,
     ]
-    actions = ["retry_all_failed_edx_enrollment"]
+    actions = ["retry_all_failed_edx_enrollment", "downgrade_enrollment"]
     run_for_all_actions = ["retry_all_failed_edx_enrollment"]
 
     def get_queryset(self, request):
@@ -305,6 +306,22 @@ def retry_all_failed_edx_enrollment(self, request, queryset):  # noqa: ARG002
             request, "Retry all failed Open edX enrollments successfully requested."
         )
 
+    @admin.action(description="Downgrade users enrollment")
+    def downgrade_enrollment(self, request, queryset):
+        """Admin action to change the status of users enrollment from verified to audit"""
+        enrollment = queryset.first()
+        enrollments, enroll_success = downgrade_learner(enrollment)
+        if not enroll_success:
+            self.message_user(
+                request,
+                f"Failed to downgrade enrollment for user {enrollment.user.email}",
+            )
+        else:
+            self.message_user(
+                request,
+                f"Successfully downgraded users enrollment from verified to audit: {enrollment.user.email}.",
+            )
+
 
 @admin.register(CourseRunEnrollmentAudit)
 class CourseRunEnrollmentAuditAdmin(TimestampedModelAdmin):

courses/api.py

@@ -296,6 +296,21 @@ def create_program_enrollments(user, programs):
     return successful_enrollments
 
 
+def downgrade_learner(enrollment):
+    """
+    Downgrades given enrollment from verified to audit.
+    """
+
+    # Forcing the enrollment here - if the refund comes after the end date
+    # for the course for whatever reason, we still want to revert the mode.
+    return create_run_enrollments(
+        user=enrollment.user,
+        runs=[enrollment.run],
+        keep_failed_enrollments=True,
+        mode=EDX_ENROLLMENT_AUDIT_MODE,
+    )
+
+
 def deactivate_run_enrollment(
     run_enrollment,
     change_status,