Aller au contenu

Notifications d'administration

Les super-admins reçoivent une liste de notifications d'administration, distincte de la boîte personnelle (notify.web) qui reste inchangée.

Niveaux

Niveau Sens Exemples
info rien à faire mise à jour automatique d'un plugin appliquée
todo une action humaine est attendue mise à jour en attente (politique « notify »), secret manquant, CI rouge
warning quelque chose est cassé worker en échec, synchronisation en échec, repli de modèle (model.fallback)

Où les voir

  • Pastille numérotée dans l'en-tête de l'administration (nombre de notifications non lues).
  • Page Notifications (/notifications) : section d'administration, boutons « Acquitter » et « Tout acquitter ».
  • API : GET /api/v1/notifications?scope=admin[&unread_only=true] (sans scope, la boîte personnelle).
  • Opérations : core.notification.list, core.notification.ack (ids), core.notification.ack_all. Réservées aux super-admins.

Dédoublonnage

Chaque notification porte une clé (dedup_key). Tant qu'une notification de même clé est non lue, aucune autre n'est créée. Après acquittement, la même clé ne peut être recréée qu'au bout d'une heure : un problème qui revient se revoit, une boucle de plantages ne noie pas la liste.

Depuis un plugin

await self.notify("warning", "Quota presque atteint", "92 % utilisés", action_url="/admin/plugins/mon-plugin", dedup_key="quota")

Le niveau est info, todo ou warning. La source est forcée au nom du plugin, la clé est préfixée par le plugin, 20 notifications par minute au plus. Le texte est expurgé des secrets et tronqué ; action_url doit être un chemin de l'instance (/…) ou une URL https://.

E-mail des warnings

Chaque nouvelle notification warning (pas les doublons tant qu'elle n'est pas acquittée) est envoyée par e-mail à tous les super-administrateurs actifs dont l'adresse est vérifiée, par la file d'envoi de l'instance (voir Envoi d'e-mails). Sans SMTP configuré, rien ne part. Les niveaux info et todo restent dans l'interface seulement.