# Notification Architecture {#notification-architecture}


How notifications flow through the Gauzy system.


## Notification Channels {#notification-channels}






```mermaid
graph TB
    Event[Business Event] --> NService[Notification Service]
    NService --> InApp[In-App Notification]
    NService --> Email[Email Notification]
    NService --> Push[Push Notification]
    NService --> WS[WebSocket Real-Time]
```






## Channel Matrix {#channel-matrix}


| Event               | In-App | Email | Push | WebSocket |
| ------------------- | ------ | ----- | ---- | --------- |
| Task assigned       | ✅     | ✅    | ✅   | ✅        |
| Timesheet submitted | ✅     | ✅    | ❌   | ✅        |
| Timesheet approved  | ✅     | ✅    | ✅   | ✅        |
| Invoice sent        | ✅     | ✅    | ❌   | ❌        |
| @mention            | ✅     | ✅    | ✅   | ✅        |
| Team update         | ✅     | ❌    | ❌   | ✅        |
| Timer started       | ❌     | ❌    | ❌   | ✅        |


## Service Implementation {#service-implementation}


```typescript
@Injectable()
export class NotificationService {
  async notify(recipientId: string, type: NotificationType, data: any) {
    // 1. Check user preferences
    const prefs = await this.getPreferences(recipientId);

    // 2. Create in-app notification
    if (prefs.inApp) {
      await this.createInAppNotification(recipientId, type, data);
    }

    // 3. Send email
    if (prefs.email) {
      await this.emailQueue.add("notify", { recipientId, type, data });
    }

    // 4. Push via WebSocket
    if (prefs.push) {
      this.wsGateway.sendToUser(recipientId, "notification", { type, data });
    }
  }
}
```


## User Preferences {#user-preferences}


Users configure notification preferences per channel:

```json
{
  "assignTask": { "inApp": true, "email": true, "push": true },
  "mention": { "inApp": true, "email": true, "push": true },
  "approval": { "inApp": true, "email": true, "push": false },
  "teams": { "inApp": true, "email": false, "push": false }
}
```


## Related Pages {#related-pages}


- [Notification System](https://sourcey-gauzy.pages.dev/features/notification-system/index.md) — feature
- [WebSocket Architecture](https://sourcey-gauzy.pages.dev/architecture/websocket-architecture/index.md) — WebSocket
- [Email Templates](https://sourcey-gauzy.pages.dev/features/email-templates-deep-dive/index.md) — emails