Notifications

Modularous ships two tiers of notifications that serve different purposes.

Tier	Namespace	Purpose
Auth notifications	Unusualify\Modularous\Notifications\	Low-level transactional emails for registration and password flows
System notifications	Modules\SystemNotification\Notifications\	Feature-rich, queue-able, multi-channel notifications tied to model lifecycle events

---

Tier 1 — Auth Notifications

Three standalone notification classes in src/Notifications/:

Class	Triggered by	Email subject
EmailVerification	Registration with email verification	"Email Verification"
GeneratePasswordNotification	New account with generated password	"Generate Your Password For New Account"
ResetPasswordNotification	Forgot-password flow	"Reset your {app} password"

These extend Laravel's Notification directly, deliver only via mail, and are not queued by default.

→ Auth Notifications reference

---

Tier 2 — System Notifications

Fourteen notification classes in the SystemNotification module, all extending FeatureNotification:

Class	Triggered by	Default channels
ModelCreatedNotification	ModelCreated event	mail
ModelUpdatedNotification	ModelUpdated event	mail
ModelDeletedNotification	ModelDeleted event	mail
ModelRestoredNotification	ModelRestored event	mail
ModelForceDeletedNotification	ModelForceDeleted event	mail
StateableUpdatedNotification	StateableUpdated event	configurable
TaskCreatedNotification	AssignmentCreated event	configurable
TaskUpdatedNotification	AssignmentUpdated event	configurable
TaskAssignedToAuthorizableNotification	AssignmentCreated event	database,mail
PaymentCompletedNotification	PaymentCompleted event	configurable
PaymentFailedNotification	PaymentFailed event	database,mail
ChatableUnreadNotification	UnreadChatMessage event	configurable
FeatureNotification	Abstract base — not dispatched directly	—
LogNotification	Monolog handler	mail

→ FeatureNotification base class
→ System Notifications reference

---

Notification Model

The SystemNotification module stores database-channel notifications in a notifications table via the Notification Eloquent model.

notifications table
├── id            (UUID string, non-incrementing)
├── type          (fully-qualified notification class name)
├── notifiable_type / notifiable_id  (polymorphic)
├── data          (JSON — subject, message, htmlMessage, redirector, …)
└── read_at       (nullable datetime)

Appended attributes on the model: is_read, is_mine, subject, message, html_message, redirector, has_redirector, redirector_text.

---

Flow: Event → Listener → Notification

[Model saved / state changed / payment event]
        │
        ▼
  SystemNotification Event dispatched
  (e.g. ModelUpdated, StateableUpdated)
        │
        ▼
  Listener::handle($event)
  (e.g. ModelListener, StateableListener)
        │
        ├─► notification->notify(...)  [database channel]
        │       stored in notifications table
        │
        └─► Notification::route('mail', ...)  [mail channel]
                queued via modularous.notifications.mail_queue

---

Configuration

All system-notification behaviour is governed by config/modularous.php under the notifications key:

Key	Description
modularous.mail.enabled	Master switch — disables all mail from Listener::handle() when false
modularous.notifications.mail_connection	Queue connection used for mail channel
modularous.notifications.database_connection	Queue connection used for database channel
modularous.notifications.mail_queue	Queue name for mail jobs
modularous.notifications.database_queue	Queue name for database notification jobs
modularous.notifications.{ClassName}.channels	Per-class channel override (comma-separated string)
modularous.notifications.authorizable.channels	Channel override for TaskAssignedToAuthorizableNotification