Notifications #4

New Issue

2026-04-07T13:18:33Z

thatguygriff commented

2026-04-07 13:18:33 +00:00

Implement all email notification flows for volunteers and admins.

Spec

See docs/features/notifications.md

Requirements

Monthly Schedule Publish (FR-N01–N03)

Each assigned volunteer receives one summary email listing all their shifts for the month
Email includes a single 'I've seen my schedule' acknowledgement button (covers the whole month)
Admin sees acknowledged vs. unacknowledged status per volunteer; unacknowledged are visually flagged

Shift Reminders (FR-N04–N07)

24-hour and 1-hour reminders sent to all assigned volunteers
24-hour reminder includes 'I'll be there' and 'Cannot Attend' actions
'Cannot Attend' requires a mandatory reason: Sick, Emergency, Work conflict, Other (free text)
On 'Cannot Attend': shift spot marked open, reason recorded, Admin notified immediately

Other Volunteer Notifications (FR-N08–N10)

Published shift edited → assigned volunteers notified, acknowledgement status reset
Volunteer added mid-month → that volunteer notified
Month unpublished → all assigned volunteers notified

Admin Notifications (FR-N11–N15)

Volunteer clicks 'Cannot Attend' (with name, shift, reason)
Volunteer submits time off (with name, dates, reason)
Volunteer claims an open shift
Shift drops below minimum capacity (one alert per threshold breach)
Trainee completes 2 shifts and becomes eligible for promotion (informational)

Delivery

Email only for MVP; SMS is post-MVP
Each Admin can configure which notification types they receive (TBD: toggle list vs. more complex)

Open Decisions

Default acknowledgement state when volunteer never responds to monthly email
Whether monthly email should include a direct link to the time-off page
Understaffing alert timing (how many days before shift)

Implement all email notification flows for volunteers and admins. ## Spec See `docs/features/notifications.md` ## Requirements ### Monthly Schedule Publish (FR-N01–N03) - Each assigned volunteer receives one summary email listing all their shifts for the month - Email includes a single 'I've seen my schedule' acknowledgement button (covers the whole month) - Admin sees acknowledged vs. unacknowledged status per volunteer; unacknowledged are visually flagged ### Shift Reminders (FR-N04–N07) - 24-hour and 1-hour reminders sent to all assigned volunteers - 24-hour reminder includes 'I'll be there' and 'Cannot Attend' actions - 'Cannot Attend' requires a mandatory reason: Sick, Emergency, Work conflict, Other (free text) - On 'Cannot Attend': shift spot marked open, reason recorded, Admin notified immediately ### Other Volunteer Notifications (FR-N08–N10) - Published shift edited → assigned volunteers notified, acknowledgement status reset - Volunteer added mid-month → that volunteer notified - Month unpublished → all assigned volunteers notified ### Admin Notifications (FR-N11–N15) - Volunteer clicks 'Cannot Attend' (with name, shift, reason) - Volunteer submits time off (with name, dates, reason) - Volunteer claims an open shift - Shift drops below minimum capacity (one alert per threshold breach) - Trainee completes 2 shifts and becomes eligible for promotion (informational) ## Delivery - Email only for MVP; SMS is post-MVP - Each Admin can configure which notification types they receive *(TBD: toggle list vs. more complex)* ## Open Decisions - Default acknowledgement state when volunteer never responds to monthly email - Whether monthly email should include a direct link to the time-off page - Understaffing alert timing (how many days before shift)

thatguygriff added the open-decision feature mvp labels 2026-04-07 13:18:33 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: thatguygriff/walkies#4