How yashx37/notifyr works
Notifyr is a Spring Boot bulk-notification platform. Clients manage recipients, templates and campaigns or submit individual notifications; campaigns are scheduled and dispatched asynchronously, then workers route deliveries by channel and retry failures. The graph captures documented RabbitMQ, Redis, storage, security and monitoring capabilities. Most runtime wiring was not excerpted, so undocumented relationships are omitted or marked unverified.
Main entry points: controller REST controllers · CampaignService.java Campaign engine · NotificationWorker.java Notification worker · NotificationService.java Notification service
Components 22
API and security
- REST controllers
src/main/java/com/yash/Notifyr/controller - Authentication
src/main/java/com/yash/Notifyr/service/AuthService.java - JWT and API-key filters
src/main/java/com/yash/Notifyr/security
Campaign and content
- Recipient management
src/main/java/com/yash/Notifyr/service/RecipientService.java - Template management
src/main/java/com/yash/Notifyr/service/TemplateService.java - Campaign engine
src/main/java/com/yash/Notifyr/service/CampaignService.java
Async delivery
- Campaign scheduling
src/main/java/com/yash/Notifyr/scheduler/CampaignScheduler.java - Dispatch worker
src/main/java/com/yash/Notifyr/worker/CampaignDispatchWorker.java - Notification service
src/main/java/com/yash/Notifyr/service/NotificationService.java - Notification publisher
src/main/java/com/yash/Notifyr/service/NotificationPublisher.java - Notification worker
src/main/java/com/yash/Notifyr/worker/NotificationWorker.java - Channel providers
src/main/java/com/yash/Notifyr/provider - RabbitMQ queues
- Retry and dead-letter queues
Persistence and operations
- PostgreSQL data
- Redis idempotency
- Status reconciliation
src/main/java/com/yash/Notifyr/scheduler/NotificationReconciliationScheduler.java - Metrics and dashboards
Other components
- API client
- Email service
- SMS service
- Push simulation
Connections 30
- API client → REST controllers: calls REST
- REST controllers → Authentication: delegates auth
src/main/java/com/yash/Notifyr/controller/AuthController.java - REST controllers → Recipient management: delegates recipient ops
src/main/java/com/yash/Notifyr/controller/RecipientController.java - REST controllers → Template management: delegates template ops
src/main/java/com/yash/Notifyr/controller/TemplateController.java - REST controllers → Campaign engine: delegates campaign ops
- REST controllers → Notification service: delegates sends
- Authentication → JWT and API-key filters: generates JWT
src/main/java/com/yash/Notifyr/service/AuthService.java - REST controllers → JWT and API-key filters: authenticated by
- Recipient management → PostgreSQL data: reads and writes
src/main/java/com/yash/Notifyr/service/RecipientService.java - Template management → PostgreSQL data: reads and writes
src/main/java/com/yash/Notifyr/service/TemplateService.java - Campaign engine → Template management: renders content
src/main/java/com/yash/Notifyr/service/CampaignService.java - Campaign engine → PostgreSQL data: persists campaigns
- Campaign engine → Recipient management: selects audience
src/main/java/com/yash/Notifyr/service/CampaignService.java - Campaign scheduling → RabbitMQ queues: publishes dispatch
- RabbitMQ queues → Dispatch worker: delivers dispatch
- Dispatch worker → Campaign engine: invokes dispatch
src/main/java/com/yash/Notifyr/worker/CampaignDispatchWorker.java - Campaign engine → Notification publisher: publishes notifications
src/main/java/com/yash/Notifyr/service/CampaignService.java - Notification service → Redis idempotency: checks idempotency
- Notification service → Notification publisher: publishes messages
- Notification publisher → RabbitMQ queues: sends messages
- RabbitMQ queues → Notification worker: delivers messages
- Notification worker → PostgreSQL data: updates status
- Notification worker → Channel providers: routes by channel
src/main/java/com/yash/Notifyr/worker/NotificationWorker.java - Channel providers → Email service: sends email
- Channel providers → SMS service: sends SMS
- Notification worker → Push simulation: simulates push
src/main/java/com/yash/Notifyr/worker/NotificationWorker.java - Notification worker → Retry and dead-letter queues: retries failures
- Retry and dead-letter queues → RabbitMQ queues: requeues or dead-letters
- Status reconciliation → PostgreSQL data: re-drives stuck rows
- REST controllers → Metrics and dashboards: exposes metrics