feat: add learners enrolment list api

[tehreem-sadat]

Add enrollment api.

Example usage:

To get all enrolments:

/api/fx/learners/v1/enrollments/

[ 
    {
            "user_id": 10,
            "full_name": "user1",
            "alternative_full_name": "عالي",
            "username": "user1",
            "national_id": "",
            "email": "[[email protected]](mailto:[email protected])",
            "mobile_no": null,
            "year_of_birth": null,
            "gender": "",
            "gender_display": null,
            "date_joined": "2024-11-08T12:31:06.322903Z",
            "last_login": "2024-11-15T08:23:03.539659Z",
            "certificate_available": false,
            "course_score": null,
            "active_in_course": false,
            "course_id": "course-v1:bragi_org+111+11"
        },
]
...

To get all enrolments - with complete details

/api/fx/learners/v1/enrollments/?optional_field_tags=__all__

[
    {
            "user_id": 10,
            "full_name": "user1",
            "alternative_full_name": "عالي",
            "username": "user1",
            "national_id": "",
            "email": "[[email protected]](mailto:[email protected])",
            "mobile_no": null,
            "year_of_birth": null,
            "gender": "",
            "gender_display": null,
            "date_joined": "2024-11-08T12:31:06.322903Z",
            "last_login": "2024-11-15T08:23:03.539659Z",
            "certificate_available": false,
            "course_score": null,
            "active_in_course": false,
            "progress": 0.0,
            "certificate_url": null,
            "course_id": "course-v1:bragi_org+111+11",
            "earned - Final Exam: Subsection": "no attempt",
            "possible - Final Exam: Subsection": "no attempt",
            "earned - another: Subsection": "no attempt",
            "possible - another: Subsection": "no attempt"
    }.
...
]

To get all enrolments - for certain courses -> Send ',' separated list of course ids:

/api/fx/learners/v1/enrollments/?course_ids=course_id1, course_id2

To get all enrolments - for certain users -> Send ',' separated list of user ids:

/api/fx/learners/v1/enrollments/?user_ids=1,2

To get all enrolments - for specific user and course -> Send ',' separated list of user ids and course_ids:

/api/fx/learners/v1/enrollments/?user_ids=1,2&course_ids=course_id1

Note:
500 error will be raised for invalid course_ids.

[shadinaif]

great work @tehreem-sadat !

please address my comment about str then it's good to go 👍🏼

[shadinaif]

don't trust str when converting date and time. At least it is not timezone-aware

Suggested change

	def get_date_joined(self, obj: get_user_model) -> str:
	"""Return user ID."""
	return str(self._get_user(obj).date_joined) # type: ignore
	def get_last_login(self, obj: get_user_model) -> str:
	"""Return user ID."""
	return str(self._get_user(obj).last_login) # type: ignore
	def get_date_joined(self, obj: Any) -> str:
	date_joined = self._get_user(obj).date_joined
	return date_joined.isoformat() if date_joined else None
	def get_last_login(self, obj: Any) -> str:
	last_login = self._get_user(obj).last_login
	return last_login.isoformat() if last_login else None

[shadinaif]

please recover the deleted empty line, here and everywhere unless you intentionally want to delete it

For this one, it is more readable to have the empty lines separating the logic