beardofedu / beardofedu/agentic-workflows-projects
[NOTIF-001] Platform: Email & in-app notification service
- Dominant language
- CSS
- Stars
- 0
- Forks
- 0
- PR merge metrics
- No merged PRs in 30d
Description
## Overview
Build a centralized notification service that sends transactional emails and (in a future phase) in-app notifications. This is a shared infrastructure component consumed by orders, returns, auth, and support.
## Acceptance Criteria
- [ ] `POST /api/notifications/send` — internal endpoint to queue a notification
- [ ] Template types: order confirmation, order shipped, return approved, welcome email, password reset, promotional
- [ ] Email provider: integrate with a transactional email service (e.g., SendGrid — API key in environment variable)
- [ ] Notification queue with retry logic (3 attempts, exponential backoff)
- [ ] Delivery status tracked: `queued` → `sent` → `delivered` / `failed`
- [ ] In-app notification bell icon in header (Sprint 5 — UI only for now, backend ready)
- [ ] User can unsubscribe from promotional emails (one-click unsubscribe link in all emails)
- [ ] Admin dashboard stub showing notification delivery stats
## Depends On
- #14 ORD-001 — order events are the primary notification triggers
## Note
Auth emails (password reset via #7, verification via #6) should be migrated to use this service once available. For Sprint 2 they can use direct mailer calls.
Contributor guide
No contributing guide indexed for this repository
Assessment
This issue has not been assessed yet.