Receive Scenario-Based Milestone and Engagement Alert
Beyond operational reminders, the Notification Scenario Engine supports engagement-focused milestone notifications. Configured scenarios include: completion of every 25th activity (encouraging milestone), approaching the honorarium threshold (alert before 3rd and 15th assignment for Blindeforbundet), and availability of the annual impact summary once the year-end calculation is complete. These engagement notifications are delivered through the same FCM/APNs infrastructure as operational alerts but use warmer, more celebratory language. The notifications link to the relevant screens (Personal Statistics, Assignment Count Screen, or Impact Summary Screen). Organizations can configure which milestone thresholds trigger notifications. These notifications are opt-out by default (enabled unless the user disables them) because they are positive engagement events.
User Story
Acceptance Criteria
- Given a peer mentor logs their 25th (or 50th, 100th) activity, when the activity is saved, then a milestone push notification is sent congratulating them and linking to their personal statistics screen
- Given a Blindeforbundet peer mentor is about to receive their 3rd assignment (the honorarium-triggering threshold), when the 3rd assignment dispatch is created, then a notification informs them of their upcoming honorarium eligibility
- Given a peer mentor's annual impact summary has been calculated and is available, when the calculation job completes, then a push notification invites them to view their year-end impact summary
- Given a peer mentor has disabled the 'Milestones & Achievements' notification category, when a milestone event occurs, then no notification is sent
- Given a milestone notification is delivered and tapped, when the app navigates, then the user lands on the screen most relevant to that milestone (statistics, assignment count, or impact summary)
Business Value
Volunteer retention is directly linked to recognition and sense of impact. NHF and HLF both identified gamification and impact visibility as important engagement mechanisms. Milestone notifications serve as micro-recognition moments that appear at the right behavioral trigger point — immediately after a meaningful action — when motivation reinforcement is most effective. By surfacing these moments as push notifications rather than only within the app, the system reaches peer mentors who check notifications but do not proactively open the app, creating organic re-engagement loops that improve long-term volunteer retention and activity logging consistency.
Components
- Notification Scenario Engine service
- Push Notification Service service
- Push Notification Gateway infrastructure
- Notification Repository data
- Notifications Screen ui