high complexity extracted Notifications & Communications Confidence: 100%
4
Components
58
Shared
0
User Stories
Yes
Analyzed

Description

This feature delivers automated, context-aware push reminders triggered by specific scenarios in the platform workflow. Scenarios include: no contact registered within 10 days of an assignment dispatch (Blindeforbundet-critical), upcoming or expired peer mentor certification, missed activity follow-up, and configurable coordinator-defined reminder rules. Users can manage their reminder preferences through a dedicated settings screen, and coordinators can configure scenario thresholds at the organization level. The feature merges Automatic Follow-Up Reminders, 10-Day Contact Reminder, Certification Expiry Alerts, and Scenario Push Messages into a unified rules engine.

User Flow

Scenario-Based Reminders & Automated Follow-Up Alerts user flow
Click to expand

Analysis

Business Value

Scenario-based reminders directly address two of the most critical operational pain points identified across workshops. For Blindeforbundet, the 10-day automatic reminder after assignment dispatch ensures no vulnerable individual falls through the cracks when a peer mentor fails to make contact — this is a safeguarding requirement, not merely a convenience. For HLF, certification expiry alerts prevent situations where uncertified peer mentors remain listed as active, which has reputational and compliance implications. By automating follow-up logic that coordinators currently manage manually, this feature reduces administrative burden, increases reliability of outreach, and enables coordinators to focus on escalations rather than routine chasing.

Implementation Notes

The reminder engine is implemented as a scheduled job on the Next.js backend, running at configurable intervals (e.g., every 6 hours) via Vercel Cron Jobs. Each scenario is modeled as a rule with trigger conditions (e.g., assignment.status = 'dispatched' AND days_since_dispatch >= 10 AND contact_activity_count = 0), a target audience (assignee, coordinator, or both), and a notification template. Rules are evaluated against the PostgreSQL database on each cron cycle. Scheduled notifications (e.g., certification expiry 30 days before) are pre-computed and stored in a reminders table with a scheduled_at timestamp, consumed by the cron job. The reminder settings screen allows users to opt out of non-critical reminders. Notification delivery reuses the FCM infrastructure from the push-notifications feature. Care must be taken to avoid notification flooding — deduplication logic ensures each scenario fires at most once per trigger event.

Components (62)

User Interface (1)

Service Layer (1)

Data Layer (1)

Infrastructure (1)

Shared Components

These components are reused across multiple features

Infrastructure (20)

User Stories

No user stories have been generated for this feature yet.