feat: added ora reminder notification

Author: AhtishamShahid

lms/envs/common.py

@@ -2350,6 +2350,36 @@
 # .. setting_description: Amount of time before a lease on a staff submission expires
 ORA_STAFF_LEASE_EXPIRATION_HOURS = 8
 
+# .. setting_name: ORA_REMINDER_MAX_COUNT
+# .. setting_default: 3
+# .. setting_description: Maximum number of reminder notifications sent per learner per ORA
+#   for incomplete peer/self review steps.
+ORA_REMINDER_MAX_COUNT = 3
+
+# .. setting_name: ORA_REMINDER_INTERVAL_HOURS
+# .. setting_default: 48
+# .. setting_description: Number of hours between consecutive ORA reminder notifications.
+ORA_REMINDER_INTERVAL_HOURS = 48
+
+# .. setting_name: ORA_REMINDER_INITIAL_DELAY_HOURS
+# .. setting_default: 0
+# .. setting_description: Number of hours after ORA submission before the first reminder
+#   notification is sent. Set to 0 for an immediate first reminder upon submission.
+ORA_REMINDER_INITIAL_DELAY_HOURS = 0
+
+# .. setting_name: ORA_REMINDER_SWEEP_INTERVAL_SECONDS
+# .. setting_default: 1800
+# .. setting_description: How often (in seconds) the platform-wide ORA reminder sweeper
+#   task re-schedules itself. Each sweep picks up all reminders whose next_reminder_at
+#   has passed. Default is 1800 (30 minutes).
+ORA_REMINDER_SWEEP_INTERVAL_SECONDS = 1800
+
+# .. setting_name: ORA_REMINDER_SWEEP_BATCH_SIZE
+# .. setting_default: 1000
+# .. setting_description: Maximum number of ORA reminder rows processed per sweep cycle.
+#   If more are due, the remaining will be picked up in the next sweep.
+ORA_REMINDER_SWEEP_BATCH_SIZE = 1000
+
 ##### LMS DEADLINE DISPLAY TIME_ZONE #######
 TIME_ZONE_DISPLAYED_FOR_DEADLINES = 'UTC'
 

openedx/core/djangoapps/notifications/base_notification.py

@@ -274,6 +274,25 @@ class NotificationType(TypedDict):
 
         'filters': [FILTER_AUDIT_EXPIRED_USERS_WITH_NO_ROLE],
     },
+    'ora_reminder': {
+        'notification_app': 'grading',
+        'name': 'ora_reminder',
+
+        'info': 'Reminder notifications for learners who have pending self or peer review steps in an ORA.',
+        'web': True,
+        'email': True,
+        'push': False,
+        'email_cadence': EmailCadence.DAILY,
+        'non_editable': ['push'],
+        'content_template': _('<{p}>You have <{strong}>{pending_step}</{strong}> to complete for assessment '
+                              '<{strong}>{ora_name}</{strong}></{p}>'),
+        'content_context': {
+            'ora_name': 'Name of ORA in course',
+            'pending_step': 'Pending step description (e.g. "self review" or "peer reviews")',
+        },
+
+        'filters': [FILTER_AUDIT_EXPIRED_USERS_WITH_NO_ROLE],
+    },
     'new_instructor_all_learners_post': {
         'notification_app': 'discussion',
         'name': 'new_instructor_all_learners_post',

openedx/core/djangoapps/notifications/config/waffle.py

@@ -38,3 +38,17 @@
 # .. toggle_target_removal_date: 2026-05-27
 # .. toggle_warning: When the flag is ON, Notifications will go through ace push channels.
 ENABLE_PUSH_NOTIFICATIONS = CourseWaffleFlag(f'{WAFFLE_NAMESPACE}.enable_push_notifications', __name__)
+
+# .. toggle_name: notifications.enable_ora_reminders
+# .. toggle_implementation: WaffleFlag
+# .. toggle_default: False
+# .. toggle_description: Waffle flag to enable ORA reminder notifications for learners
+#   who have pending self or peer review steps after submitting an ORA response.
+# .. toggle_use_cases: open_edx
+# .. toggle_creation_date: 2026-03-26
+# .. toggle_target_removal_date: None
+# .. toggle_warning: When the flag is ON, learners will receive periodic reminders
+#   for incomplete peer/self review steps.
+# .. toggle_tickets: None
+ENABLE_ORA_REMINDERS = WaffleFlag(f'{WAFFLE_NAMESPACE}.enable_ora_reminders', __name__)
+

openedx/core/djangoapps/notifications/docs/settings.md

@@ -47,6 +47,7 @@ Notification keys are listed in the table below. More notifications may be added
 | 12 | updates | course_updates | False             | Course updates |
 | 13 | grading | ora_staff_notifications | False             | New ORA submission for staff |
 | 14 | grading | ora_grade_assigned | False             | ORA grade received |
+| 15 | grading | ora_reminder | False             | ORA peer/self review reminder |
 
 ### Example configuration for overriding notification preferences:
 

openedx/core/djangoapps/notifications/email/notification_icons.py

@@ -36,6 +36,7 @@ def get_icon_name_for_notification_type(cls, notification_type, default="POST_OU
             "course_updates": cls.NEWSPAPER,
             "ora_staff_notifications": cls.OPEN_RESPONSE_OUTLINE,
             "ora_grade_assigned": cls.OPEN_RESPONSE_OUTLINE,
+            "ora_reminder": cls.OPEN_RESPONSE_OUTLINE,
         }
         return notification_type_dict.get(notification_type, default)
 

openedx/core/djangoapps/notifications/handlers.py

@@ -24,6 +24,10 @@
 User = get_user_model()
 log = logging.getLogger(__name__)
 
+# Notification type emitted by ora2 on submission for ORAs with peer/self review steps.
+# This type is used only as a trigger; it is not stored as a notification itself.
+ORA_SUBMISSION_NOTIFICATION_TYPE = 'ora_submission_created'
+
 AUDIENCE_FILTER_CLASSES = {
     'discussion_roles': ForumRoleAudienceFilter,
     'course_roles': CourseRoleAudienceFilter,