Skip to content

Build Notifications module: email, push, in-app with queue & retries #351

Description

@devIKargi

Direction:
Create a Notifications module to support sending transactional emails, push notifications, and in-app notifications with a deliverability queue and retry logic.

Key responsibilities:

  • Unified API for creating notifications (POST /notifications) and endpoints to fetch user notifications (GET /users/:id/notifications) and mark read/archived.
  • Implement email sending via a provider (SendGrid/Mailgun) with templating and throttling.
  • Support push notifications (FCM/APNs) and an in-app store for unread counts.
  • Queue notifications in a reliable job queue with retry/backoff and dead-letter handling.
  • Tests for delivery, retry behavior, and UI-facing unread counts.

Acceptance criteria:

  • APIs to create, list, mark-read, and delete notifications are implemented and documented.
  • Email and push integrations send messages in test mode; failures are retried according to backoff policy.
  • Notification queue persists jobs and exposes metrics (pending, failed counts).
  • Unit and integration tests validate end-to-end flows and failure handling.

Metadata

Metadata

Assignees

Labels

GrantFox OSSIssue tracked in GrantFox OSSMaybe RewardedIssue may be eligible for a GrantFox rewardOfficial Campaign | FWC26Campaign: Official Campaign | FWC26enhancementNew feature or request

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions