How dhruvjain01/notifyhub works
NotifyHub is a multi-tenant email notification platform with a React admin dashboard and a Spring backend. The principal workflow is: an application submits a notification, the backend persists it, background scheduling dispatches it, the engine renders a versioned template and selects an email provider, then records delivery or retry status for tracking. The dashboard also supports authentication, application/key management, template administration, metrics, audit logs, and an interactive API playground. The graph uses sampled source and README evidence; some dashboard-to-endpoint wiring and unsampled capabilities are documented but not independently verified.
Main entry points: NotificationEngine.java Delivery engine · NotificationService.java Submission service · Notification.java Notification records · TemplateService.java Template management
Components 26
Admin dashboard
- Dashboard UI
frontend/src/App.tsx - API playground
frontend/src/playground/PlaygroundPage.tsx - Dashboard API client
frontend/src/api/client.ts - Audit log view
frontend/src/pages/AuditLogsPage.tsx - Metrics dashboard
frontend/src/pages/DashboardPage.tsx
Identity and tenants
- Authentication API
backend/src/main/java/com/notifyhub/auth/controller/AuthController.java - Authentication service
backend/src/main/java/com/notifyhub/auth/service/AuthService.java - Users and tokens
backend/src/main/java/com/notifyhub/auth/entity/User.java
Platform management
- Application management
backend/src/main/java/com/notifyhub/application/service/ApplicationService.java - Application records
backend/src/main/java/com/notifyhub/application/entity/Application.java - Template management
backend/src/main/java/com/notifyhub/template/service/TemplateService.java - Template versions
backend/src/main/java/com/notifyhub/template/entity/Template.java
Notification delivery
- Notification API
backend/src/main/java/com/notifyhub/notification/controller/NotificationController.java - Batch API
backend/src/main/java/com/notifyhub/notification/controller/BatchNotificationController.java - Submission service
backend/src/main/java/com/notifyhub/notification/service/NotificationService.java - Notification records
backend/src/main/java/com/notifyhub/notification/entity/Notification.java - Background scheduler
backend/src/main/java/com/notifyhub/scheduler/NotificationSchedulerService.java - Delivery engine
backend/src/main/java/com/notifyhub/notification/engine/NotificationEngine.java - Template renderer
backend/src/main/java/com/notifyhub/template/service/PlaceholderTemplateRenderer.java - Email providers
backend/src/main/java/com/notifyhub/provider/DefaultProviderSelector.java
Tracking and reliability
- Idempotency service
backend/src/main/java/com/notifyhub/notification/idempotency/IdempotencyService.java - Audit logging
backend/src/main/java/com/notifyhub/audit/DatabaseAuditPublisher.java - Dashboard metrics
backend/src/main/java/com/notifyhub/dashboard/MetricsService.java
Other components
- Platform admin
- Client application
- SMTP / Brevo
Connections 24
- Platform admin → Dashboard UI: uses
README.md - Dashboard UI → Dashboard API client: requests data
- Client application → Notification API: submits request
README.md - Notification API → Submission service: handles submission
backend/src/main/java/com/notifyhub/notification/controller/NotificationController.java - Batch API → Submission service: submits batch
- Submission service → Idempotency service: checks and stores
backend/src/main/java/com/notifyhub/notification/service/NotificationService.java - Submission service → Notification records: persists notification
backend/src/main/java/com/notifyhub/notification/service/NotificationService.java - Background scheduler → Notification records: loads due work
backend/src/main/java/com/notifyhub/scheduler/NotificationSchedulerService.java - Background scheduler → Delivery engine: dispatches processing
backend/src/main/java/com/notifyhub/scheduler/NotificationSchedulerService.java - Delivery engine → Template management: resolves template
backend/src/main/java/com/notifyhub/notification/engine/NotificationEngine.java - Delivery engine → Template renderer: renders content
backend/src/main/java/com/notifyhub/notification/engine/NotificationEngine.java - Delivery engine → Email providers: selects provider
backend/src/main/java/com/notifyhub/notification/engine/NotificationEngine.java - Email providers → SMTP / Brevo: sends email
README.md - Delivery engine → Notification records: updates status
backend/src/main/java/com/notifyhub/notification/engine/NotificationEngine.java - Authentication API → Authentication service: handles login
- Authentication service → Users and tokens: reads and saves
backend/src/main/java/com/notifyhub/auth/service/AuthService.java - Application management → Application records: persists applications
backend/src/main/java/com/notifyhub/application/service/ApplicationService.java - Application management → Audit logging: publishes changes
backend/src/main/java/com/notifyhub/application/service/ApplicationService.java - Template management → Template versions: stores versions
backend/src/main/java/com/notifyhub/template/service/TemplateService.java - Template management → Audit logging: publishes changes
backend/src/main/java/com/notifyhub/template/service/TemplateService.java - Metrics dashboard → Dashboard metrics: shows metrics
README.md - Dashboard metrics → Notification records: queries counts
backend/src/main/java/com/notifyhub/dashboard/MetricsService.java - Audit log view → Audit logging: shows audit history
README.md - API playground → Client application: tests API
README.md