Renewal Reminder Service
Component Detail
Service Layer
medium complexity
backend
0
Dependencies
0
Dependents
0
Entities
0
Integrations
Description
Evaluates each issued certificate's expiry date and decides which reminders are due. Creates persisted reminder records, dispatches them through the push notification channel, and emits a lapse follow-up when a certificate passes its expiry without renewal.
renewal-reminder-service
Sources & reasoning
Defined in the canonical area taxonomy (line 363). HLF explicitly requires automatic reminders on certificate expiry (line 72) and ties expiry to mentor visibility (line 49), motivating a scheduled-reminder feature. Phase 3 placement follows from the source roadmap listing course/certification work under Growth & Engagement.
-
docs/source/likeperson.md · line 363certification-training | Certification & Training | Course Registration, Digital Peer Mentor Certificate, Certificate Renewal Reminder
-
docs/source/likeperson.md · line 72automatisk påminnelse ved utløp
-
docs/source/likeperson.md · line 49HLF kobler dette til sertifisering: ved utgått sertifikat forsvinner likepersonen fra lokallagets nettsider automatisk.
Responsibilities
- Query certificates approaching expiry and determine which reminder windows apply
- Create persisted reminder records so mentors and coordinators can audit what was sent
- Dispatch reminder payloads to the push notification component for delivery
- Emit a follow-up lapse notification when a certificate's expiry date has passed
- Expose reminder history for a given certificate or mentor
Interfaces
evaluateExpiringCertificates(asOf: Date): ReminderBatch
dispatchReminder(certificateId, reminderType): ReminderRecord
getRemindersForCertificate(certificateId): ReminderRecord[]
handleLapsedCertificate(certificateId): ReminderRecord