feat: add EnterpriseEnrollmentViewProcessor pipeline step for CourseEnrollmentStarted filter

[pwnage101]

Description

An EnterpriseEnrollmentViewProcessor pipeline step is defined in enterprise/filters/enrollment.py for the new openedx-filter CourseEnrollmentViewStarted (here).

The pipeline step checks whether the enrollment user is linked to an enterprise customer, and if so, calls the enterprise and consent API clients to post the enterprise course enrollment and provide consent.

Jira

ENT-11570

Testing instructions

Requires all three branches installed together (follow instructions here)

Use this branch, openedx-filters branch openedx/openedx-filters#363, and edx-platform branch kiram15/ENT-11570

Needs ENABLE_ENTERPRISE_INTEGRATION=True, an API key, an EnterpriseCustomer, and a learner linked to it via EnterpriseCustomerUser.

In the LMS shell, POST to the enrollment endpoint as the worker, patching the two API clients to assert they fire:

from unittest import mock
from django.conf import settings
from rest_framework.test import APIClient

EC_UUID = "<enterprise-uuid>"
CID = "<course-id>"
worker = APIClient(); worker.credentials(HTTP_X_EDX_API_KEY=settings.EDX_API_KEY)

with mock.patch("enterprise.filters.enrollment.EnterpriseApiServiceClient") as MEnt, \
     mock.patch("enterprise.filters.enrollment.ConsentApiServiceClient") as MCon:
    resp = worker.post("/api/enrollment/v1/enrollment",
        {"user": "<username>", "course_details": {"course_id": CID},
         "mode": "audit", "linked_enterprise_customer": EC_UUID}, format="json")
    print(resp.status_code)
    print(MEnt.return_value.post_enterprise_course_enrollment.call_args)
    print(MCon.return_value.provide_consent.call_args)

Expected: 200; the LMS log shows EnterpriseEnrollmentViewProcessor running: …; post_enterprise_course_enrollment is called with (username, course_id); provide_consent is called with username, course_id, and enterprise_customer_uuid.

I also personally tested these other scenarios

• no linked_enterprise: 200, neither client called
• no API-key permission: 200, neither client called
• enterprise post fails: 400, consent not called, no enrollment created
• consent fails: 400, enterprise called once, no enrollment created

---

Related:

• feat: add EnterpriseEnrollmentViewProcessor pipeline step for CourseEnrollmentStarted filter #2553
• feat: adding CourseEnrollmentViewStarted to execute in enrollment view openedx-filters#363
• https://github.com/edx/edx-platform/pull/306/changes

[codecov]

Codecov Report

❌ Patch coverage is 97.56098% with 1 line in your changes missing coverage. Please review.
✅ Project coverage is 86.68%. Comparing base (8ed796e) to head (4679983).

Files with missing lines	Patch %	Lines
enterprise/filters/enrollment.py	97.56%	0 Missing and 1 partial ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #2553      +/-   ##
==========================================
+ Coverage   86.65%   86.68%   +0.02%     
==========================================
  Files         257      258       +1     
  Lines       16954    16995      +41     
  Branches     1677     1680       +3     
==========================================
+ Hits        14692    14732      +40     
  Misses       1927     1927              
- Partials      335      336       +1     

Flag	Coverage Δ
unittests	86.68% <97.56%> (+0.02%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[Copilot]

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Adds an EnterpriseEnrollmentPostProcessor pipeline step to post enterprise enrollment + consent on course enrollment events, with accompanying unit tests.

Changes:

• Introduces enterprise.filters.enrollment.EnterpriseEnrollmentPostProcessor pipeline step.
• Adds unit tests covering enterprise vs non-enterprise paths and exception logging behavior.
• Adds minimal tests/filters package init.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

File	Description
enterprise/filters/enrollment.py	New pipeline step that posts enterprise enrollment and consent, logging failures.
enterprise/filters/init.py	Initializes enterprise.filters package.
tests/filters/test_enrollment.py	New tests validating API client calls and exception logging.
tests/filters/init.py	Initializes tests.filters package.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[pwnage101]

So, I'm just going to submit this review but before you implement fixes I'd like to meet with you synchronously because there's a lot to unpack and we should discuss an alternate path.

It looks like the CourseEnrollmentStarted filter you were planning to use (possibly adopted from my draft) is installed at the model layer, not the view layer containing the enterprise logic we are trying to replace.

Keep in mind enterprise enrollment creation was added nearly 10 years ago to the view layer, and meanwhile the model layer enroll() method is called from management commands, other views, entitlements, program enrollments, auto-auth, tests, etc. (in all over 80 call sites), so THERE BE DRAGONS if we change this.

[pwnage101]

I don't mind this test being added, but curious why you decided to add it? Seems unrelated.

[kiram15]

Not directly related to the work, more related to the general filter initiative as an smoke test

[Copilot]

Pull request overview

Copilot reviewed 12 out of 12 changed files in this pull request and generated 1 comment.

[pwnage101]

LGTM, just remove the dead code and merge.