alma/NeahStable

Fork 0

alma a1e4e14b30 notifications

2026-01-11 22:29:40 +01:00

4.5 KiB

Raw Blame History

🔔 Système de Notifications Complet

✅ Adapters Implémentés

Le système de notifications agrège maintenant 3 sources :

Leantime (leantime-adapter.ts)
- Notifications de tâches, commentaires, mentions
- Polling toutes les 30 secondes
RocketChat (rocketchat-adapter.ts) ⚡ NOUVEAU
- Messages non lus dans Parole
- Déclenchement en temps réel quand nouveau message détecté
Email (email-adapter.ts) ⚡ NOUVEAU
- Emails non lus dans Courrier (INBOX uniquement)
- Déclenchement en temps réel quand nouvel email détecté

🎯 Flow Complet

Badge de Notification

Le badge rouge affiche maintenant le total agrégé :

Total = Leantime (unread) + RocketChat (unread) + Email (unread)

Déclenchement Temps Réel

1. Nouveau Message Parole

Widget Parole détecte nouveau message
  └─> totalUnreadCount augmente
      └─> triggerNotificationRefresh()
          └─> Invalide cache notifications
              └─> NotificationService.getNotificationCount()
                  ├─> LeantimeAdapter.getNotificationCount()
                  ├─> RocketChatAdapter.getNotificationCount() ⚡
                  └─> EmailAdapter.getNotificationCount() ⚡
                      └─> Badge mis à jour (< 1 seconde)

2. Nouvel Email Courrier

checkForNewEmails() détecte nouvel email
  └─> newestEmailId > lastKnownEmailId
      └─> triggerNotificationRefresh() ⚡
          └─> Invalide cache notifications
              └─> NotificationService.getNotificationCount()
                  ├─> LeantimeAdapter.getNotificationCount()
                  ├─> RocketChatAdapter.getNotificationCount()
                  └─> EmailAdapter.getNotificationCount() ⚡
                      └─> Badge mis à jour (< 1 seconde)

3. Notification Leantime

Polling toutes les 30s
  └─> LeantimeAdapter.getNotificationCount()
      └─> Badge mis à jour

📊 Structure des Counts

NotificationCount {
  total: number,        // Total de toutes les sources
  unread: number,       // Total non lus de toutes les sources
  sources: {
    leantime: {
      total: number,
      unread: number
    },
    rocketchat: {
      total: number,
      unread: number
    },
    email: {
      total: number,
      unread: number
    }
  }
}

🔧 Fichiers Modifiés/Créés

Nouveaux Fichiers

lib/services/notifications/rocketchat-adapter.ts - Adapter RocketChat
lib/services/notifications/email-adapter.ts - Adapter Email
hooks/use-trigger-notification.ts - Hook pour déclencher refresh

Fichiers Modifiés

lib/services/notifications/notification-service.ts - Enregistrement des nouveaux adapters
components/parole.tsx - Détection et déclenchement pour RocketChat
hooks/use-email-state.ts - Déclenchement pour Email (déjà présent)
hooks/use-notifications.ts - Écoute d'événements custom
app/api/notifications/count/route.ts - Support ?force=true
app/api/rocket-chat/messages/route.ts - Retourne totalUnreadCount

🎨 Avantages

⚡ Temps Réel : Notifications instantanées (< 1 seconde)
📊 Multi-Sources : Leantime + RocketChat + Email
💚 Efficace : Déclenchement uniquement quand nécessaire
🔄 Rétrocompatible : Le polling reste en fallback
📈 Scalable : Facile d'ajouter d'autres adapters

🚀 Résultat Final

Le badge de notification affiche maintenant :

✅ Notifications Leantime (polling 30s)
✅ Messages non lus RocketChat (temps réel)
✅ Emails non lus Courrier (temps réel)

Total = Leantime + RocketChat + Email 🎉

📝 Notes Techniques

RocketChat Adapter

Utilise les subscriptions RocketChat
Compte les messages non lus (unread > 0)
Supporte channels, groups, et DMs

Email Adapter

Utilise le cache Redis de /api/courrier/unread-counts
Focus sur INBOX (principal dossier pour notifications)
Peut être étendu pour d'autres dossiers si besoin

Cache Strategy

Leantime : Cache 30s (aligné avec polling)
RocketChat : Pas de cache dédié (utilise cache messages)
Email : Cache 2 minutes (via unread-counts API)

🔍 Debugging

Pour voir les logs :

[ROCKETCHAT_ADAPTER] - Adapter RocketChat
[EMAIL_ADAPTER] - Adapter Email
[Parole] - Détection dans widget Parole
[useTriggerNotification] - Déclenchement refresh
[NOTIFICATION_SERVICE] - Agrégation des counts

4.5 KiB Raw Blame History